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
@@ -7,11 +7,11 @@
7
7
  "src/components/semiotic-ai.ts",
8
8
  "ai/mcp-server.ts"
9
9
  ],
10
- "version": "3.9.1",
10
+ "version": "3.10.0",
11
11
  "components": {
12
- "schema": 57,
13
- "aiChartExports": 54,
14
- "mcpRenderable": 52,
12
+ "schema": 61,
13
+ "aiChartExports": 56,
14
+ "mcpRenderable": 56,
15
15
  "browserOnly": 5,
16
16
  "requiresLiveData": [
17
17
  "RealtimeHeatmap",
@@ -35,7 +35,8 @@
35
35
  "QuadrantChart",
36
36
  "Scatterplot",
37
37
  "ScatterplotMatrix",
38
- "StackedAreaChart"
38
+ "StackedAreaChart",
39
+ "WaterfallChart"
39
40
  ],
40
41
  "ordinal": [
41
42
  "BarChart",
@@ -48,6 +49,7 @@
48
49
  "Histogram",
49
50
  "LikertChart",
50
51
  "PieChart",
52
+ "RadarChart",
51
53
  "RidgelinePlot",
52
54
  "StackedBarChart",
53
55
  "SwarmPlot",
@@ -92,6 +94,10 @@
92
94
  ],
93
95
  "value": [
94
96
  "BigNumber"
97
+ ],
98
+ "recipe": [
99
+ "CalendarHeatmapRecipe",
100
+ "ParallelCoordinatesRecipe"
95
101
  ]
96
102
  },
97
103
  "suggestionPropContracts": {
@@ -161,6 +167,12 @@
161
167
  "mobile"
162
168
  ]
163
169
  },
170
+ "CalendarHeatmapRecipe": {
171
+ "componentKind": "chart-recipe",
172
+ "commonChartProps": "supported",
173
+ "headingProp": "title",
174
+ "modeValues": []
175
+ },
164
176
  "CandlestickChart": {
165
177
  "componentKind": "chart-hoc",
166
178
  "commonChartProps": "supported",
@@ -470,6 +482,12 @@
470
482
  "mobile"
471
483
  ]
472
484
  },
485
+ "ParallelCoordinatesRecipe": {
486
+ "componentKind": "chart-recipe",
487
+ "commonChartProps": "supported",
488
+ "headingProp": "title",
489
+ "modeValues": []
490
+ },
473
491
  "PieChart": {
474
492
  "componentKind": "chart-hoc",
475
493
  "commonChartProps": "supported",
@@ -525,6 +543,17 @@
525
543
  "mobile"
526
544
  ]
527
545
  },
546
+ "RadarChart": {
547
+ "componentKind": "chart-hoc",
548
+ "commonChartProps": "supported",
549
+ "headingProp": "title",
550
+ "modeValues": [
551
+ "primary",
552
+ "context",
553
+ "sparkline",
554
+ "mobile"
555
+ ]
556
+ },
528
557
  "RealtimeHeatmap": {
529
558
  "componentKind": "chart-hoc",
530
559
  "commonChartProps": "supported",
@@ -724,6 +753,17 @@
724
753
  "sparkline",
725
754
  "mobile"
726
755
  ]
756
+ },
757
+ "WaterfallChart": {
758
+ "componentKind": "chart-hoc",
759
+ "commonChartProps": "supported",
760
+ "headingProp": "title",
761
+ "modeValues": [
762
+ "primary",
763
+ "context",
764
+ "sparkline",
765
+ "mobile"
766
+ ]
727
767
  }
728
768
  },
729
769
  "aiChartExportNames": [
@@ -763,6 +803,7 @@
763
803
  "ProcessFlowChart",
764
804
  "ProcessSankey",
765
805
  "QuadrantChart",
806
+ "RadarChart",
766
807
  "RealtimeHeatmap",
767
808
  "RealtimeHistogram",
768
809
  "RealtimeLineChart",
@@ -780,7 +821,8 @@
780
821
  "TreeDiagram",
781
822
  "Treemap",
782
823
  "UnitPileChart",
783
- "ViolinPlot"
824
+ "ViolinPlot",
825
+ "WaterfallChart"
784
826
  ],
785
827
  "geoExcludedFromAIExports": [
786
828
  "ChoroplethMap",
@@ -790,24 +832,28 @@
790
832
  ]
791
833
  },
792
834
  "mcp": {
793
- "toolCount": 24,
835
+ "toolCount": 28,
794
836
  "tools": [
795
837
  "applyTheme",
796
838
  "auditAccessibility",
839
+ "auditArtifact",
797
840
  "auditChart",
798
841
  "auditMobileVisualization",
799
842
  "createChart",
800
843
  "diagnoseConfig",
801
844
  "evaluateChart",
802
845
  "explainChart",
846
+ "explainRefusal",
803
847
  "getChartSchema",
804
848
  "getSchema",
805
849
  "groundChart",
806
850
  "improveChart",
807
851
  "interrogateChart",
808
852
  "proposeChartVariants",
853
+ "recommendRepresentation",
809
854
  "renderChart",
810
855
  "renderInteractiveChart",
856
+ "repairArtifact",
811
857
  "repairChartConfig",
812
858
  "reportIssue",
813
859
  "suggestChart",
@@ -828,16 +874,21 @@
828
874
  ],
829
875
  "activation": "semiotic-mcp --profile public or MCP_TOOL_PROFILE=public"
830
876
  },
831
- "resourceCount": 8,
877
+ "resourceCount": 13,
832
878
  "resources": [
879
+ "semiotic-artifact-contract-schema",
833
880
  "semiotic-behavior-contracts",
834
881
  "semiotic-build-info",
835
882
  "semiotic-chatgpt-chart-widget",
883
+ "semiotic-component-schema",
836
884
  "semiotic-components",
837
885
  "semiotic-examples",
838
886
  "semiotic-schema",
887
+ "semiotic-schema-index",
839
888
  "semiotic-surface-manifest",
840
- "semiotic-system-prompt"
889
+ "semiotic-system-prompt",
890
+ "semiotic-task-index",
891
+ "semiotic-task-packet"
841
892
  ],
842
893
  "promptCount": 2,
843
894
  "prompts": [
@@ -1,6 +1,7 @@
1
1
  # Semiotic — React Data Visualization
2
2
 
3
- Use family subpath imports such as `semiotic/xy`, `semiotic/ordinal`,
3
+ Use family subpath imports such as `semiotic/line` for LineChart-only routes and
4
+ `semiotic/xy`, `semiotic/ordinal`,
4
5
  `semiotic/network`, `semiotic/geo`, or `semiotic/realtime` in production code.
5
6
  Use `semiotic/ai` or `semiotic/ai/core` for generation helpers. Current bundle
6
7
  measurements live in the README and the complete AI reference.
@@ -18,7 +19,9 @@ request.
18
19
  2. Use `suggestCharts` when the component is not already determined, then verify
19
20
  the selected component's exact schema instead of guessing props.
20
21
  3. Produce a serializable `{ component, props }` proposal before translating it
21
- to JSX; import chart components from their family subpath in production code.
22
+ to JSX; import chart components from the smallest applicable public subpath
23
+ in production code. For a route whose only XY chart is `LineChart`, use
24
+ `semiotic/line`; otherwise use its family subpath.
22
25
  4. Validate with `prepareChart`, `diagnoseConfig`, or `evaluateChart`, or
23
26
  `npx semiotic-ai --doctor`; repair reported contract failures.
24
27
  5. When a renderer is available, require non-empty render evidence and run the
@@ -28,6 +31,11 @@ request.
28
31
 
29
32
  - Flat observations: XY charts for trends/relationships; ordinal charts for
30
33
  categorical comparison, ranking, distribution, and part-to-whole.
34
+ Multivariate comparable magnitudes: `RadarChart`. Cumulative signed
35
+ steps: `WaterfallChart` (each row is a delta). For multivariate profile
36
+ comparison across independently scaled fields, consider the schema-backed
37
+ `ParallelCoordinatesRecipe`; for single-year daily seasonality, consider
38
+ `CalendarHeatmapRecipe`.
31
39
  - Trees: `TreeDiagram`, `Treemap`, `CirclePack`, or animated `OrbitDiagram`.
32
40
  - Nodes/edges: `ForceDirectedGraph`, `SankeyDiagram`, `ProcessSankey`, or
33
41
  `ChordDiagram`. Prefer these HOCs to `StreamNetworkFrame` unless the task
@@ -49,6 +57,11 @@ identity, not quantitative measures or unique-value categories.
49
57
 
50
58
  - Static JSX, SSR, MCP rendering, and serialized configurations keep the
51
59
  initial data snapshot in the component's real data prop.
60
+ - Built-in portable recipes are serialized under their recipe component name
61
+ and rendered in React with `<ChartRecipe recipeId="..." />` from
62
+ `semiotic/ai`. Their `layoutConfig` is JSON-safe and schema-validated; use
63
+ the lower-level layout from `semiotic/recipes` only when React callbacks or
64
+ bespoke layout control are required.
52
65
  - React push mode omits `data` entirely and mutates through a ref. Do not pass
53
66
  `data={[]}`. Supply the schema's stable ID accessor before using `remove` or
54
67
  `update`.
@@ -112,6 +125,8 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
112
125
  - **Proportional symbol maps use geographic props** (`geo.proportional-symbol-wire-shape`): ProportionalSymbolMap reads point rows from points, longitude from xAccessor (default lon), latitude from yAccessor (default lat), and radius from sizeBy. sizeRange is the two-number pixel-radius range.
113
126
  - **Physics charts separate chart mode from simulation input** (`physics.sample-and-mechanical-inputs`): Sample simulations use data plus the chart's accessors. Seeded no-data demonstrations use simulationMode="mechanical" (legacy mode="mechanical" remains accepted); mode otherwise carries chart display modes such as primary or sparkline.
114
127
  - **Physics push methods ingest source records** (`physics.push-uses-source-records`): Physics HOC refs push source records through the chart's accessors. pushRows and dataIdAccessor are not component props; stable source id fields are retained on spawned bodies without an invented accessor.
128
+ - **Distribution physics charts update bodies and projections together** (`physics.live-source-reconciliation`): Bodies, categories, domains, and totals update together without changing React keys. getData() returns source rows. New data replaces live rows; rerunMS restores the seed.
129
+ - **EventDrop distinguishes admission history from current closure** (`physics.event-admission-history`): Arrival order determines historical lateness with a delay/function watermark. Equal arrival times keep source order. A window is closed when its end is at or below the watermark; previously accepted events stay accepted as later events advance it. An explicit watermark.value instead tests one fixed policy.
115
130
 
116
131
  <!-- semiotic-behavior-contracts:end -->
117
132
 
@@ -120,6 +135,6 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
120
135
  - **SSR**: `renderChart("BarChart", props)` from `semiotic/server` — uses HOC names. Also `"Sparkline"` (no axes, 2px margins). `renderChartWithEvidence()` returns `{ svg, evidence }` (mark counts by scene type, axis domains, empty flag, semantic status/diagnostics, annotation count, accessible name). Check `empty`/`markCount` for paint and `semanticStatus` separately for meaning; `degenerate` marks are not trustworthy even when paint `status` is `ok`, while `not-assessed` means no capability check exists. `renderToImage()` (PNG), `renderToAnimatedGif()` (GIF), `renderDashboard()` (multi-chart). All accept `theme`. Required props: StackedBarChart needs `stackBy`, GroupedBarChart needs `groupBy`, StackedAreaChart needs `areaBy`, BubbleChart needs `sizeBy`, FunnelChart uses `stepAccessor`, GaugeChart needs `value` (`thresholds` optional).
121
136
  - **Serializable chart-adjacent text**: use a `frame-text` annotation instead of splicing server SVG. It anchors to the resolved plot rectangle without data coordinates: `{ type: "frame-text", text: "100", position: "bottom-right", dy: 16 }`. Positions cover the plot's nine edge/center anchors; `dx`/`dy` may move text into a caller-reserved margin. The same annotation renders in CSR and SSR.
122
137
  - **CLI**: `npx semiotic-ai --list` shows components/import paths/renderability; `npx semiotic-ai --schema GaugeChart` prints one component schema with metadata; `--doctor` validates props JSON and behavior contracts.
123
- - **MCP**: `npx semiotic-mcp` exposes schema, chart suggestion, token-encoding suggestion (`suggestTokenEncoding` for ISOTYPE/dot/icon arrays), diagnosis, accessibility, grounding, issue, theme, static render (`renderChart`), and ChatGPT Apps render (`renderInteractiveChart`) tools. Resources include `semiotic://schema`, `semiotic://components`, `semiotic://behavior-contracts`, `semiotic://system-prompt`, `semiotic://examples`, and the widget template `ui://semiotic/chart-widget.html`. Prompts: `build-semiotic-chart`, `debug-semiotic-chart`.
138
+ - **MCP**: `npx semiotic-mcp` exposes schema, chart suggestion, token-encoding suggestion (`suggestTokenEncoding` for ISOTYPE/dot/icon arrays), diagnosis, accessibility, grounding, issue, theme, static render (`renderChart`), and ChatGPT Apps render (`renderInteractiveChart`) tools. Discover schemas through `semiotic://schema-index`, then read only `semiotic://schema/{component}`; `semiotic://schema` remains the complete catalog for bulk tooling. Other resources include `semiotic://components`, `semiotic://behavior-contracts`, `semiotic://system-prompt`, `semiotic://examples`, and the widget template `ui://semiotic/chart-widget.html`. Prompts: `build-semiotic-chart`, `debug-semiotic-chart`.
124
139
  - **Data Pitfalls bridge**: `toDataPitfallsChain(component, props, { rendered, context, narrative })` from `semiotic/ai` returns a dependency-free `datapitfalls` chain input containing config, JSX, reader grounding, diagnostics, accessibility audit, and optional render evidence/image.
125
140
  - **exportChart**: Pass the wrapper div, not the SVG element: `exportChart(wrapperDiv, { format: "png" })`. It finds canvas+SVG internally.
@@ -0,0 +1,301 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "generatedBy": "scripts/generate-ai-task-packets.mjs",
4
+ "id": "compare-category-totals",
5
+ "title": "Compare category totals you can check",
6
+ "summary": "Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.",
7
+ "route": "/tasks/compare-category-totals",
8
+ "identity": {
9
+ "packageName": "semiotic",
10
+ "packageVersion": "3.10.0",
11
+ "channel": "source",
12
+ "sourceRevision": "sha256:5e5a22378c5f0f2ba897818a2d9a0daedca6f6a7b7465f8e248548b231ec1eae",
13
+ "revisionKind": "content-digest",
14
+ "runtime": {
15
+ "digest": "sha256:cf510709caa078398644ff232870d8405551b420c1b8967da1d08dbc9c7fc821",
16
+ "fileCount": 1082
17
+ },
18
+ "taskSources": {
19
+ "digest": "sha256:62733dc8fadd1c8655adc743fb1fcb2c555c73dd191c1df8cf8f6c689e2085ba",
20
+ "fileCount": 36
21
+ },
22
+ "availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
23
+ },
24
+ "job": "Compare categories and keep a usable route to the values when the picture is unavailable.",
25
+ "dataShape": "One already aggregated, nonnegative total per category, all in the same unit. The synthetic fixture is North 12, South 30, West 18.",
26
+ "fit": [
27
+ "Use in an existing Semiotic React application or when structured chart access and schema-guided validation meet an explicit project requirement."
28
+ ],
29
+ "exclusions": [
30
+ "A small chart change alone need not justify replacing a working visualization library.",
31
+ "This fixture does not establish that an external source is accurate or that every reader can use the result."
32
+ ],
33
+ "api": {
34
+ "name": "BarChart",
35
+ "category": "ordinal",
36
+ "importPath": "semiotic/ordinal",
37
+ "schemaResourceUri": "semiotic://schema/BarChart",
38
+ "renderable": true,
39
+ "requiresLiveData": false,
40
+ "description": "Vertical or horizontal bars for categorical comparisons.",
41
+ "component": "BarChart",
42
+ "usageMode": "static",
43
+ "dataRequired": true,
44
+ "schema": {
45
+ "type": "object",
46
+ "properties": {
47
+ "data": {
48
+ "type": "array",
49
+ "description": "Array of data objects"
50
+ },
51
+ "categoryAccessor": {
52
+ "type": "string",
53
+ "description": "Key for category labels",
54
+ "default": "category",
55
+ "x-semiotic-runtime-types": [
56
+ "string",
57
+ "function"
58
+ ]
59
+ },
60
+ "valueAccessor": {
61
+ "type": "string",
62
+ "description": "Key for bar values",
63
+ "default": "value",
64
+ "x-semiotic-runtime-types": [
65
+ "string",
66
+ "function"
67
+ ]
68
+ },
69
+ "sort": {
70
+ "type": [
71
+ "boolean",
72
+ "string"
73
+ ],
74
+ "description": "Sort bars: false, true, 'asc', 'desc', or comparator function",
75
+ "default": false,
76
+ "x-semiotic-runtime-types": [
77
+ "boolean",
78
+ "string",
79
+ "function"
80
+ ]
81
+ },
82
+ "orientation": {
83
+ "type": "string",
84
+ "enum": [
85
+ "vertical",
86
+ "horizontal"
87
+ ],
88
+ "default": "vertical"
89
+ },
90
+ "title": {
91
+ "type": "string",
92
+ "description": "Visible chart title and the chart's accessible name."
93
+ },
94
+ "description": {
95
+ "type": "string",
96
+ "description": "Concise accessible description that overrides the chart's generated aria-label."
97
+ },
98
+ "summary": {
99
+ "type": "string",
100
+ "description": "Screen-reader-only summary of the chart's key takeaway; include keyboard interaction guidance when relevant."
101
+ },
102
+ "accessibleTable": {
103
+ "type": [
104
+ "boolean",
105
+ "object"
106
+ ],
107
+ "description": "Expose the chart data through Semiotic's screen-reader data table. Object form `{ portalTarget: string }` relocates its interactive UI to the DOM element with that ID.",
108
+ "default": true,
109
+ "oneOf": [
110
+ {
111
+ "type": "boolean"
112
+ },
113
+ {
114
+ "type": "object",
115
+ "additionalProperties": false,
116
+ "required": [
117
+ "portalTarget"
118
+ ],
119
+ "properties": {
120
+ "portalTarget": {
121
+ "type": "string",
122
+ "description": "ID of a DOM element outside any consumer-owned role=img wrapper. React callers may also pass an Element or a callback through the typed API."
123
+ }
124
+ }
125
+ }
126
+ ]
127
+ },
128
+ "height": {
129
+ "type": "number",
130
+ "default": 400
131
+ },
132
+ "responsiveWidth": {
133
+ "type": "boolean"
134
+ },
135
+ "valueLabel": {
136
+ "type": "string"
137
+ }
138
+ },
139
+ "requiredForStatic": [
140
+ "data"
141
+ ]
142
+ },
143
+ "schemaScope": "Selected properties copied from ai/schema.json; retrieve the component resource for the full schema. React push mode follows the included behavior contracts.",
144
+ "contracts": [
145
+ {
146
+ "id": "accessibility.description-props",
147
+ "title": "Accessible chart text uses direct chart props",
148
+ "summary": "High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.",
149
+ "action": "Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. If a consumer-owned role=img wraps the chart, use accessibleTable: { portalTarget: \"element-id\" } and render that target outside the image. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields."
150
+ },
151
+ {
152
+ "id": "props.data-required-by-usage-mode",
153
+ "title": "Data required by usage mode",
154
+ "summary": "Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref.",
155
+ "action": "Pass usageMode=\"push\" to `semiotic-ai --doctor` when validating ref-based JSX with no data prop. Keep usageMode=\"static\" or omit it for renderChart/MCP/static configs where data must be present."
156
+ },
157
+ {
158
+ "id": "rendering.renderchart-static-props",
159
+ "title": "renderChart uses static props only",
160
+ "summary": "MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot. Browser-only realtime components and future ref pushes are not renderable through that path.",
161
+ "action": "Use renderChart only with renderable HOC components and complete static data. For live behavior, return React code with a ref and do not promise MCP-rendered output."
162
+ },
163
+ {
164
+ "id": "serialization.formatters-are-react-callbacks",
165
+ "title": "Axis formatters are React callbacks",
166
+ "summary": "xFormat, yFormat, categoryFormat, and valueFormat are callback props, not d3 format strings or axis-title strings. They are intentionally absent from JSON/MCP schemas and string values fail validation.",
167
+ "action": "In serialized props, omit formatter callbacks and use xLabel, yLabel, categoryLabel, or valueLabel for axis titles. In React JSX, pass a function such as xFormat={value => formatAxis(value)}."
168
+ }
169
+ ]
170
+ },
171
+ "examples": [
172
+ {
173
+ "title": "React component",
174
+ "environment": "React browser",
175
+ "path": "docs/src/pages/tasks/examples/CategoryComparisonExample.tsx",
176
+ "source": "import { useState } from \"react\"\nimport { BarChart } from \"semiotic/ordinal\"\nimport { categoryComparisonProps } from \"./category-comparison\"\n\nexport default function CategoryComparisonExample() {\n const [orientation, setOrientation] = useState<\"vertical\" | \"horizontal\">(\"vertical\")\n return (\n <section aria-label=\"Category comparison example\" className=\"task-example\">\n <p>Synthetic fixture: three already aggregated regional totals, all measured in units.</p>\n <label>\n Bar direction{\" \"}\n <select\n value={orientation}\n onChange={(event) => setOrientation(event.target.value as typeof orientation)}\n >\n <option value=\"vertical\">Vertical</option>\n <option value=\"horizontal\">Horizontal</option>\n </select>\n </label>\n <BarChart {...categoryComparisonProps} orientation={orientation} responsiveWidth />\n <p>\n South accounts for 30 of the 60 units. Changing direction preserves the values and category\n order.\n </p>\n </section>\n )\n}\n",
177
+ "digest": "sha256:1cbc3f7dc27a4114e0b1b208c4eab532230ef5fda623116f5c734a51582f764b"
178
+ },
179
+ {
180
+ "title": "Shared fixture and chart props",
181
+ "environment": "Browser and server",
182
+ "path": "docs/src/pages/tasks/examples/category-comparison.ts",
183
+ "source": "import type { BarChartProps } from \"semiotic/ordinal\"\n\nexport const regionalTotals = [\n { region: \"North\", total: 12 },\n { region: \"South\", total: 30 },\n { region: \"West\", total: 18 },\n]\n\nexport const categoryComparisonProps = {\n data: regionalTotals,\n categoryAccessor: \"region\",\n valueAccessor: \"total\",\n sort: false,\n title: \"Regional totals\",\n description: \"Synthetic regional totals in the same unit: North 12, South 30, West 18.\",\n summary:\n \"South has the largest total, 30. The three regions total 60 units. Open the data table for exact values.\",\n accessibleTable: true,\n valueLabel: \"Units\",\n height: 300,\n} satisfies BarChartProps<(typeof regionalTotals)[number]>\n",
184
+ "digest": "sha256:385eb02b937bced7c4a7d6bbf88232ace90c56a7e06bb7935fdba37f0ee30c53"
185
+ },
186
+ {
187
+ "title": "Optional server verification",
188
+ "environment": "Node authoring only",
189
+ "path": "docs/src/pages/tasks/examples/check-category-comparison.ts",
190
+ "source": "// Server-side authoring only: keep validation and SVG rendering out of the React route.\nimport { prepareChart } from \"semiotic/ai/core\"\nimport { renderChartWithEvidence } from \"semiotic/server\"\nimport { categoryComparisonProps } from \"./category-comparison\"\n\nexport function checkCategoryComparison() {\n const result = prepareChart(\n { component: \"BarChart\", props: categoryComparisonProps },\n { render: renderChartWithEvidence },\n )\n if (!result.ok || !result.evidence || !result.svg) {\n throw new Error(result.reasons.join(\"; \") || \"Render evidence is unavailable\")\n }\n return result\n}\n",
191
+ "digest": "sha256:a0e2cfe29c1985899f360b447b9bc223026d9954e26790adf30a5bf4473da56b"
192
+ }
193
+ ],
194
+ "evidence": {
195
+ "claimId": "task.compare-category-totals",
196
+ "statement": "Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.",
197
+ "owner": "Semiotic repository maintainers",
198
+ "status": "supported-in-scope",
199
+ "observed": {
200
+ "verifiedAt": "2026-09-11T03:13:52.427Z",
201
+ "environment": {
202
+ "node": "v22.22.1",
203
+ "platform": "darwin",
204
+ "architecture": "arm64",
205
+ "browser": "Playwright Chromium"
206
+ },
207
+ "runs": [
208
+ {
209
+ "kind": "unit",
210
+ "targets": [
211
+ "docs/src/pages/tasks/examples/category-comparison.test.ts",
212
+ "docs/src/pages/tasks/examples/live-chart.test.tsx",
213
+ "docs/src/pages/tasks/examples/source-correction.test.ts"
214
+ ],
215
+ "name": "Task source units",
216
+ "command": "node node_modules/vitest/vitest.mjs run ./docs/src/pages/tasks/examples/category-comparison.test.ts ./docs/src/pages/tasks/examples/live-chart.test.tsx ./docs/src/pages/tasks/examples/source-correction.test.ts --reporter=default --reporter=json --outputFile=<temporary-report-directory>/unit.json --allowOnly=false",
217
+ "exitCode": 0,
218
+ "passed": 14,
219
+ "skipped": 0,
220
+ "passedByFile": {
221
+ "docs/src/pages/tasks/examples/category-comparison.test.ts": 4,
222
+ "docs/src/pages/tasks/examples/live-chart.test.tsx": 5,
223
+ "docs/src/pages/tasks/examples/source-correction.test.ts": 5
224
+ }
225
+ },
226
+ {
227
+ "kind": "browser",
228
+ "targets": [
229
+ "integration-tests/docs-examples-task-live.spec.ts",
230
+ "integration-tests/docs-examples-tasks.spec.ts"
231
+ ],
232
+ "name": "Task browser behavior",
233
+ "command": "node node_modules/@playwright/test/cli.js test --config playwright.docs-examples.config.ts ./integration-tests/docs-examples-task-live.spec.ts ./integration-tests/docs-examples-tasks.spec.ts --reporter=list,json --forbid-only",
234
+ "exitCode": 0,
235
+ "passed": 6,
236
+ "skipped": 0,
237
+ "passedByFile": {
238
+ "integration-tests/docs-examples-task-live.spec.ts": 2,
239
+ "integration-tests/docs-examples-tasks.spec.ts": 4
240
+ }
241
+ }
242
+ ],
243
+ "record": "ai/tasks/verification.json",
244
+ "authorship": "Agent-observed execution of repository tests; independent review is not recorded."
245
+ },
246
+ "validity": "Only the content digests and environment recorded here; not a release range or an adoption result.",
247
+ "invalidation": "Changes to runtime source, schemas, manifests, task examples, tests, verification tooling or this task definition invalidate the recorded result.",
248
+ "commands": [
249
+ "npx vitest run docs/src/pages/tasks/examples/category-comparison.test.ts",
250
+ "npx playwright test --config playwright.docs-examples.config.ts integration-tests/docs-examples-tasks.spec.ts"
251
+ ],
252
+ "checks": {
253
+ "unit": "docs/src/pages/tasks/examples/category-comparison.test.ts",
254
+ "browser": "integration-tests/docs-examples-tasks.spec.ts"
255
+ },
256
+ "expected": [
257
+ "North 12, South 30, West 18; total 60, with South largest.",
258
+ "Three SVG bars retain 12:30:18 proportions and insertion order in both orientations.",
259
+ "The browser data table retains the exact category/value mapping.",
260
+ "An invalid value accessor is refused; the repaired configuration preserves the rows."
261
+ ],
262
+ "unassessed": [
263
+ "Underlying source accuracy: this is a synthetic fixture.",
264
+ "Assistive-technology reception and usability with actual readers.",
265
+ "Organic discovery, model preference, and published-package parity."
266
+ ]
267
+ },
268
+ "recovery": [
269
+ {
270
+ "symptom": "The chart has no useful values after a field was renamed.",
271
+ "contractId": "props.data-required-by-usage-mode",
272
+ "action": "Set valueAccessor to the actual numeric field, total, while preserving data. Run the server check and inspect the exact-value table.",
273
+ "recheck": "The bars must encode 12, 30 and 18; a nonempty scene alone is insufficient."
274
+ },
275
+ {
276
+ "symptom": "prepareChart returned ok, but there is no SVG.",
277
+ "contractId": "rendering.renderchart-static-props",
278
+ "action": "Inject renderChartWithEvidence from semiotic/server in Node authoring code when rendered evidence is required.",
279
+ "recheck": "Inspect evidence and svg explicitly. Without a renderer, ok covers a different set of checks."
280
+ }
281
+ ],
282
+ "continuation": {
283
+ "rationale": "This project needs React rendering with inspectable category values.",
284
+ "recheck": [
285
+ "Category/value mapping, units, order, summary and the accessible table after source or dependency changes."
286
+ ],
287
+ "loss": "An image alone omits the source rows and verification context. Keep the config and fixture when the next reader needs exact values."
288
+ },
289
+ "update": {
290
+ "status": "source-only",
291
+ "introducedIn": null,
292
+ "previousAssumption": "A valid configuration or a nonempty render establishes that the values are mapped correctly.",
293
+ "action": "Run configuration checks, inspect the rendered geometry and compare the category/value table with independent fixture facts.",
294
+ "recheck": [
295
+ "Rendering evidence must be present when a render is claimed.",
296
+ "An installed package version different from the packet's packageVersion needs matching guidance."
297
+ ],
298
+ "remaining": "Source truth and usability with actual readers remain separate obligations."
299
+ },
300
+ "definition": "ai/tasks/compare-category-totals.json"
301
+ }