semiotic 3.9.2 → 3.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (537) hide show
  1. package/README.md +97 -76
  2. package/agent-skill/semiotic-charts/SKILL.md +13 -7
  3. package/ai/artifact-contract-reference.md +408 -0
  4. package/ai/artifact-surface-inventory.json +5586 -0
  5. package/ai/behaviorContracts.cjs +24 -2
  6. package/ai/cli.js +480 -56
  7. package/ai/componentMetadata.cjs +3 -1
  8. package/ai/dist/mcp-server.js +68 -68
  9. package/ai/examples.md +68 -1
  10. package/ai/reference.md +105 -14
  11. package/ai/schema.json +6646 -18
  12. package/ai/surface-manifest.json +34 -6
  13. package/ai/system-prompt.md +2 -0
  14. package/ai/task-packets/compare-category-totals.json +301 -0
  15. package/ai/task-packets/compare-category-totals.md +188 -0
  16. package/ai/task-packets/correct-published-chart.json +271 -0
  17. package/ai/task-packets/correct-published-chart.md +597 -0
  18. package/ai/task-packets/index.json +40 -0
  19. package/ai/task-packets/update-live-chart.json +289 -0
  20. package/ai/task-packets/update-live-chart.md +424 -0
  21. package/dist/c-2N7IU2NY.min.js +1 -0
  22. package/dist/c-2RL2QPZJ.min.js +1 -0
  23. package/dist/c-2WK7YJLL.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-45CQWZZ6.min.js +1 -0
  26. package/dist/c-4BRHKVKV.min.js +1 -0
  27. package/dist/c-7242NXSG.min.js +1 -0
  28. package/dist/c-7DVPSB5C.min.js +1 -0
  29. package/dist/c-7EGHJU2F.min.js +1 -0
  30. package/dist/c-A7OGOFSL.min.js +1 -0
  31. package/dist/c-AFBSWT77.min.js +1 -0
  32. package/dist/c-AH5HWZWS.min.js +1 -0
  33. package/dist/c-AJ7EC32V.min.js +1 -0
  34. package/dist/c-AQADQNY7.min.js +1 -0
  35. package/dist/c-ATM475SA.min.js +1 -0
  36. package/dist/c-AVO3Q7T7.min.js +1 -0
  37. package/dist/c-B7GW7IHJ.min.js +1 -0
  38. package/dist/c-BNFJMDHN.min.js +1 -0
  39. package/dist/c-BOHCQILI.min.js +1 -0
  40. package/dist/c-C3TZLTZK.min.js +1 -0
  41. package/dist/c-CGQAQWBV.min.js +1 -0
  42. package/dist/c-CPV4N35K.min.js +1 -0
  43. package/dist/c-D6HAAPTX.min.js +1 -0
  44. package/dist/c-DIPEYUOW.min.js +1 -0
  45. package/dist/c-E4JDJH4I.min.js +1 -0
  46. package/dist/c-E72OTUZU.min.js +1 -0
  47. package/dist/c-E7I2L7CU.min.js +1 -0
  48. package/dist/c-ELDWAO2V.min.js +1 -0
  49. package/dist/c-EUBTECGM.min.js +1 -0
  50. package/dist/c-EUMPMDCS.min.js +1 -0
  51. package/dist/c-EZZT2WAE.min.js +1 -0
  52. package/dist/c-FHBVFCQB.min.js +1 -0
  53. package/dist/c-G4HCO2IQ.min.js +1 -0
  54. package/dist/c-G5VIJEOK.min.js +1 -0
  55. package/dist/c-GHVOXAYH.min.js +1 -0
  56. package/dist/c-GNTXRXRN.min.js +1 -0
  57. package/dist/c-GXV3C3MO.min.js +1 -0
  58. package/dist/c-HHTK2R75.min.js +1 -0
  59. package/dist/c-HLLFJYTY.min.js +1 -0
  60. package/dist/c-HP4ZFM47.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HYDTS5OP.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IK33LNZ6.min.js +1 -0
  65. package/dist/c-IK3PZHRY.min.js +1 -0
  66. package/dist/c-J6DVC236.min.js +1 -0
  67. package/dist/c-JIMJF6F6.min.js +1 -0
  68. package/dist/c-JUKIWTBJ.min.js +1 -0
  69. package/dist/c-KKPMHAZC.min.js +1 -0
  70. package/dist/c-L6WNDBHV.min.js +1 -0
  71. package/dist/c-LDEX5OFW.min.js +1 -0
  72. package/dist/c-LESEUVC5.min.js +1 -0
  73. package/dist/c-LYQMZMZQ.min.js +1 -0
  74. package/dist/c-MB6CV5NC.min.js +1 -0
  75. package/dist/c-MOKJOIPE.min.js +1 -0
  76. package/dist/c-MVR3RWF3.min.js +1 -0
  77. package/dist/c-N3FXLRNT.min.js +1 -0
  78. package/dist/c-N5NPTJVJ.min.js +1 -0
  79. package/dist/c-NHBL4J67.min.js +1 -0
  80. package/dist/c-ODG6TFSY.min.js +1 -0
  81. package/dist/c-ORLEBW72.min.js +1 -0
  82. package/dist/c-P65V6HLO.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSKKFZNP.min.js +1 -0
  85. package/dist/c-PSNI6KAZ.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-R2P4RR7Q.min.js +1 -0
  88. package/dist/c-RFC7UAG7.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-SGAURYHG.min.js +1 -0
  91. package/dist/c-SJMWU6UX.min.js +1 -0
  92. package/dist/c-STIIGQOD.min.js +1 -0
  93. package/dist/c-T2ASIJVZ.min.js +1 -0
  94. package/dist/c-T2V7O2LO.min.js +1 -0
  95. package/dist/c-TKG2NP7G.min.js +1 -0
  96. package/dist/c-TX3THUTO.min.js +1 -0
  97. package/dist/c-TX7XJM3Z.min.js +1 -0
  98. package/dist/c-UC7SIU2W.min.js +1 -0
  99. package/dist/c-UMXSJIOV.min.js +1 -0
  100. package/dist/c-VJTDST2R.min.js +1 -0
  101. package/dist/c-VRSXMLYF.min.js +1 -0
  102. package/dist/c-VSLWSAN2.min.js +1 -0
  103. package/dist/c-VXLOLYTO.min.js +1 -0
  104. package/dist/c-W4ZUKSEQ.min.js +1 -0
  105. package/dist/c-WCBRPILW.min.js +1 -0
  106. package/dist/c-WGHT7OCY.min.js +1 -0
  107. package/dist/c-WUWXGQYA.min.js +1 -0
  108. package/dist/c-WWCW3APR.min.js +1 -0
  109. package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
  110. package/dist/c-Y6PYUMFU.min.js +1 -0
  111. package/dist/c-YDECTEUW.min.js +1 -0
  112. package/dist/c-YF3YKVQI.min.js +1 -0
  113. package/dist/c-YLZIV3VS.min.js +1 -0
  114. package/dist/c-ZIVPFTOC.min.js +1 -0
  115. package/dist/components/Annotation.d.ts +2 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
  117. package/dist/components/ai/chartRecipes.d.ts +4 -0
  118. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  119. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  120. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  121. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  122. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  123. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  124. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  125. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  126. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  127. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  128. package/dist/components/artifact/claimGraph.d.ts +5 -0
  129. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  130. package/dist/components/artifact/claims.d.ts +24 -0
  131. package/dist/components/artifact/collection.d.ts +10 -0
  132. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  133. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  134. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  135. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  136. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  137. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  138. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  139. package/dist/components/artifact/contract.d.ts +30 -0
  140. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  141. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  142. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  143. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  144. package/dist/components/artifact/exportPaths.d.ts +8 -0
  145. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  146. package/dist/components/artifact/fingerprint.d.ts +36 -0
  147. package/dist/components/artifact/grounding.d.ts +51 -0
  148. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  149. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  150. package/dist/components/artifact/identity.d.ts +19 -0
  151. package/dist/components/artifact/inheritance.d.ts +48 -0
  152. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  153. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  154. package/dist/components/artifact/obligations.d.ts +3 -0
  155. package/dist/components/artifact/policies.d.ts +45 -0
  156. package/dist/components/artifact/policyRelations.d.ts +3 -0
  157. package/dist/components/artifact/recordProjection.d.ts +7 -0
  158. package/dist/components/artifact/representation.d.ts +50 -0
  159. package/dist/components/artifact/serialization.d.ts +40 -0
  160. package/dist/components/artifact/temporal.d.ts +32 -0
  161. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  162. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  163. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  164. package/dist/components/artifact/types.d.ts +341 -0
  165. package/dist/components/artifact/validation.d.ts +13 -0
  166. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  167. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  168. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  169. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  170. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  171. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  172. package/dist/components/charts/ordinal/DonutChart.d.ts +2 -0
  173. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  174. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  175. package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
  176. package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
  177. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  178. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  179. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  180. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  181. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  182. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  183. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  184. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  185. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  186. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  187. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  188. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  189. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  190. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  191. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  192. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  193. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  194. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  195. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  196. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  197. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +4 -0
  198. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
  199. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
  200. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
  201. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
  202. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  203. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
  204. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  205. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  206. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  207. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  208. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  209. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  210. package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
  211. package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
  212. package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
  213. package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
  214. package/dist/components/charts/shared/hooks.d.ts +3 -1
  215. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  216. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  217. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  218. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  219. package/dist/components/charts/shared/useChartLegend.d.ts +4 -0
  220. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  221. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  222. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  223. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  224. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  225. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  226. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  227. package/dist/components/charts/xy/WaterfallChart.d.ts +8 -0
  228. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  229. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  230. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  231. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +16 -8
  232. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  233. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  234. package/dist/components/evidence/evidenceGate.d.ts +3 -1
  235. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  236. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  237. package/dist/components/export/chartConfig.d.ts +40 -5
  238. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  239. package/dist/components/legendLayout.d.ts +18 -0
  240. package/dist/components/legendStyles.d.ts +4 -0
  241. package/dist/components/recipes/atlas/DependencyForestChart.d.ts +20 -0
  242. package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
  243. package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
  244. package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
  245. package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
  246. package/dist/components/recipes/atlas/braid.d.ts +62 -0
  247. package/dist/components/recipes/atlas/capsules.d.ts +18 -0
  248. package/dist/components/recipes/atlas/compare.d.ts +4 -0
  249. package/dist/components/recipes/atlas/completeness.d.ts +2 -0
  250. package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
  251. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
  252. package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
  253. package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
  254. package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
  255. package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
  256. package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
  257. package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
  258. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
  259. package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
  260. package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
  261. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
  262. package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
  263. package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
  264. package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
  265. package/dist/components/recipes/atlas/forests.d.ts +11 -0
  266. package/dist/components/recipes/atlas/ids.d.ts +6 -0
  267. package/dist/components/recipes/atlas/index.d.ts +26 -0
  268. package/dist/components/recipes/atlas/ledger.d.ts +7 -0
  269. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
  270. package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
  271. package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
  272. package/dist/components/recipes/atlas/motifs.d.ts +3 -0
  273. package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
  274. package/dist/components/recipes/atlas/prepare.d.ts +14 -0
  275. package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
  276. package/dist/components/recipes/atlas/profile.d.ts +19 -0
  277. package/dist/components/recipes/atlas/publish.d.ts +10 -0
  278. package/dist/components/recipes/atlas/queries.d.ts +34 -0
  279. package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
  280. package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
  281. package/dist/components/recipes/atlas/sections.d.ts +3 -0
  282. package/dist/components/recipes/atlas/support.d.ts +7 -0
  283. package/dist/components/recipes/atlas/types.d.ts +278 -0
  284. package/dist/components/recipes/atlas/validate.d.ts +12 -0
  285. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  286. package/dist/components/recipes/intervals.d.ts +1 -1
  287. package/dist/components/semiotic-ai-core.d.ts +33 -22
  288. package/dist/components/semiotic-ai.d.ts +15 -3
  289. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  290. package/dist/components/semiotic-artifact.d.ts +23 -0
  291. package/dist/components/semiotic-atlas-core.d.ts +20 -0
  292. package/dist/components/semiotic-atlas.d.ts +8 -0
  293. package/dist/components/semiotic-experimental.d.ts +1 -1
  294. package/dist/components/semiotic-physics.d.ts +4 -4
  295. package/dist/components/semiotic-recipes-core.d.ts +9 -0
  296. package/dist/components/semiotic-text.d.ts +2 -0
  297. package/dist/components/semiotic-utils-core.d.ts +18 -18
  298. package/dist/components/semiotic.d.ts +3 -3
  299. package/dist/components/server/renderEvidence.d.ts +12 -0
  300. package/dist/components/server/renderToStaticSVG.d.ts +3 -0
  301. package/dist/components/server/serverChartConfigs.d.ts +3 -0
  302. package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
  303. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  304. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  305. package/dist/components/server/staticXYGrid.d.ts +1 -1
  306. package/dist/components/server/svgSizing.d.ts +6 -0
  307. package/dist/components/shared/svgRoot.d.ts +17 -0
  308. package/dist/components/store/selectionProvenance.d.ts +6 -0
  309. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  310. package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
  311. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  312. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  313. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  314. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  315. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  316. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  317. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  318. package/dist/components/stream/XYGrid.d.ts +11 -0
  319. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  320. package/dist/components/stream/canvasSetup.d.ts +1 -2
  321. package/dist/components/stream/fontLoading.d.ts +4 -0
  322. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  323. package/dist/components/stream/networkCustomLayout.d.ts +8 -0
  324. package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
  325. package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
  326. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  327. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  328. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  329. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  330. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  331. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +3 -0
  332. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  333. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  334. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  335. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  336. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  337. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  338. package/dist/components/stream/physics/physicsSemanticUI.d.ts +11 -0
  339. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
  340. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
  341. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  342. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  343. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  344. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  345. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  346. package/dist/components/stream/shallowEqual.d.ts +2 -0
  347. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  348. package/dist/components/stream/types.d.ts +4 -53
  349. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
  350. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  351. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  352. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  353. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  354. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  355. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  356. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  357. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  358. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  359. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  360. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  361. package/dist/controls.module.min.js +1 -1
  362. package/dist/geo.min.js +1 -1
  363. package/dist/geo.module.min.js +1 -1
  364. package/dist/network.module.min.js +1 -1
  365. package/dist/ordinal.module.min.js +1 -1
  366. package/dist/physics-matter.min.js +1 -1
  367. package/dist/physics-matter.module.min.js +1 -1
  368. package/dist/physics-rapier.min.js +1 -1
  369. package/dist/physics-rapier.module.min.js +1 -1
  370. package/dist/physics.module.min.js +1 -1
  371. package/dist/physicsWorker.js +1 -1
  372. package/dist/processSankeyLayoutWorker.js +1 -1
  373. package/dist/rough.min.js +1 -1
  374. package/dist/rough.module.min.js +1 -1
  375. package/dist/semiotic-access.module.min.js +1 -1
  376. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  377. package/dist/semiotic-ai-core.d.ts +33 -22
  378. package/dist/semiotic-ai-core.min.js +1 -1
  379. package/dist/semiotic-ai-core.module.min.js +1 -1
  380. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  381. package/dist/semiotic-ai.d.ts +15 -3
  382. package/dist/semiotic-ai.module.min.js +1 -1
  383. package/dist/semiotic-artifact-react.d.ts +10 -0
  384. package/dist/semiotic-artifact-react.min.js +2 -0
  385. package/dist/semiotic-artifact-react.module.min.js +2 -0
  386. package/dist/semiotic-artifact.d.ts +23 -0
  387. package/dist/semiotic-artifact.min.js +1 -0
  388. package/dist/semiotic-artifact.module.min.js +1 -0
  389. package/dist/semiotic-atlas-core.d.ts +20 -0
  390. package/dist/semiotic-atlas-core.min.js +1 -0
  391. package/dist/semiotic-atlas-core.module.min.js +1 -0
  392. package/dist/semiotic-atlas-selection.module.min.js +2 -0
  393. package/dist/semiotic-atlas.d.ts +8 -0
  394. package/dist/semiotic-atlas.min.js +2 -0
  395. package/dist/semiotic-atlas.module.min.js +2 -0
  396. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  397. package/dist/semiotic-client-glyph.module.min.js +1 -1
  398. package/dist/semiotic-client-responsive.module.min.js +1 -1
  399. package/dist/semiotic-client-shared.module.min.js +1 -1
  400. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  401. package/dist/semiotic-data.min.js +1 -1
  402. package/dist/semiotic-data.module.min.js +1 -1
  403. package/dist/semiotic-evidence.min.js +1 -1
  404. package/dist/semiotic-evidence.module.min.js +1 -1
  405. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  406. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  407. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  408. package/dist/semiotic-experimental-vacp.min.js +1 -1
  409. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  410. package/dist/semiotic-experimental.d.ts +1 -1
  411. package/dist/semiotic-line.module.min.js +1 -1
  412. package/dist/semiotic-physics.d.ts +4 -4
  413. package/dist/semiotic-realtime-core.module.min.js +1 -1
  414. package/dist/semiotic-realtime-react.module.min.js +1 -1
  415. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  416. package/dist/semiotic-recipes-core.d.ts +9 -0
  417. package/dist/semiotic-recipes-core.module.min.js +1 -1
  418. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  419. package/dist/semiotic-recipes-react.min.js +1 -1
  420. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  421. package/dist/semiotic-server-edge.min.js +1 -1
  422. package/dist/semiotic-server-edge.module.min.js +1 -1
  423. package/dist/semiotic-server-node.min.js +1 -1
  424. package/dist/semiotic-server-node.module.min.js +1 -1
  425. package/dist/semiotic-text.d.ts +2 -0
  426. package/dist/semiotic-text.min.js +2 -0
  427. package/dist/semiotic-text.module.min.js +2 -0
  428. package/dist/semiotic-themes-core.min.js +1 -1
  429. package/dist/semiotic-themes-core.module.min.js +1 -1
  430. package/dist/semiotic-themes.min.js +1 -1
  431. package/dist/semiotic-themes.module.min.js +1 -1
  432. package/dist/semiotic-utils-core.d.ts +18 -18
  433. package/dist/semiotic-utils-core.min.js +1 -1
  434. package/dist/semiotic-utils-core.module.min.js +1 -1
  435. package/dist/semiotic-value.module.min.js +1 -1
  436. package/dist/semiotic.d.ts +3 -3
  437. package/dist/semiotic.module.min.js +1 -1
  438. package/dist/server.min.js +1 -1
  439. package/dist/server.module.min.js +1 -1
  440. package/dist/xy.module.min.js +1 -1
  441. package/package.json +70 -14
  442. package/spec/README.md +8 -3
  443. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  444. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  445. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  446. package/dist/c-3BLJEQNG.min.js +0 -1
  447. package/dist/c-3SCUN5HI.min.js +0 -1
  448. package/dist/c-3VVKFA4M.min.js +0 -1
  449. package/dist/c-43TJZS3F.min.js +0 -1
  450. package/dist/c-4DTZPSUD.min.js +0 -1
  451. package/dist/c-4ES5367Y.min.js +0 -1
  452. package/dist/c-52TEGIUJ.min.js +0 -1
  453. package/dist/c-54IRWOGM.min.js +0 -1
  454. package/dist/c-5D2S4RMI.min.js +0 -1
  455. package/dist/c-5JWCTX3G.min.js +0 -1
  456. package/dist/c-6CMMSN6N.min.js +0 -1
  457. package/dist/c-6HRB2L7H.min.js +0 -1
  458. package/dist/c-6O5EVOPH.min.js +0 -1
  459. package/dist/c-7W4SV36A.min.js +0 -1
  460. package/dist/c-A4WRGZFX.min.js +0 -1
  461. package/dist/c-AG7WWVIH.min.js +0 -1
  462. package/dist/c-AH6J4MTN.min.js +0 -1
  463. package/dist/c-AKAF6JAD.min.js +0 -1
  464. package/dist/c-ALYR5LKK.min.js +0 -1
  465. package/dist/c-BBKITSXB.min.js +0 -1
  466. package/dist/c-BYDPC44I.min.js +0 -1
  467. package/dist/c-CFFIU2MW.min.js +0 -1
  468. package/dist/c-CGNHBHCE.min.js +0 -1
  469. package/dist/c-CJYSXIFV.min.js +0 -1
  470. package/dist/c-CZF7MV67.min.js +0 -1
  471. package/dist/c-D53OKBSY.min.js +0 -1
  472. package/dist/c-DADXPJXV.min.js +0 -1
  473. package/dist/c-DBQ2V7CH.min.js +0 -1
  474. package/dist/c-DPMVAUAW.min.js +0 -1
  475. package/dist/c-ECJCKLYY.min.js +0 -1
  476. package/dist/c-EGATGOWJ.min.js +0 -1
  477. package/dist/c-EGR6VYBW.min.js +0 -1
  478. package/dist/c-ESNR43AN.min.js +0 -1
  479. package/dist/c-F3LIKINL.min.js +0 -1
  480. package/dist/c-F5ZB5GJ6.min.js +0 -1
  481. package/dist/c-G36WS6LN.min.js +0 -1
  482. package/dist/c-G3VYMHKE.min.js +0 -1
  483. package/dist/c-GGISSW5E.min.js +0 -1
  484. package/dist/c-GR6MOEQC.min.js +0 -1
  485. package/dist/c-GSVCN34B.min.js +0 -1
  486. package/dist/c-GYOQCEFP.min.js +0 -1
  487. package/dist/c-H3DNMTCC.min.js +0 -1
  488. package/dist/c-I6J3FEZE.min.js +0 -1
  489. package/dist/c-IGH6MGJ5.min.js +0 -1
  490. package/dist/c-II2EEAJN.min.js +0 -1
  491. package/dist/c-IUHFPMHD.min.js +0 -1
  492. package/dist/c-J6M4JHRS.min.js +0 -1
  493. package/dist/c-JM3MGLQV.min.js +0 -1
  494. package/dist/c-KM3N7F7R.min.js +0 -1
  495. package/dist/c-LF5BZFNC.min.js +0 -1
  496. package/dist/c-LKBSGFQC.min.js +0 -1
  497. package/dist/c-MNF2S4AA.min.js +0 -1
  498. package/dist/c-MT3WBK7M.min.js +0 -1
  499. package/dist/c-NDJADPIF.min.js +0 -1
  500. package/dist/c-NVPQCIL5.min.js +0 -1
  501. package/dist/c-NY3JWV2K.min.js +0 -1
  502. package/dist/c-OFWJBEE5.min.js +0 -1
  503. package/dist/c-OYFHP5F5.min.js +0 -1
  504. package/dist/c-PGKQGGQ2.min.js +0 -1
  505. package/dist/c-PPWDL5ZI.min.js +0 -1
  506. package/dist/c-Q2IPZ3MU.min.js +0 -1
  507. package/dist/c-QKHMBE2E.min.js +0 -1
  508. package/dist/c-QMVM3AY6.min.js +0 -1
  509. package/dist/c-QSGWX53A.min.js +0 -1
  510. package/dist/c-RJKEKZOO.min.js +0 -1
  511. package/dist/c-RSVIHIQ4.min.js +0 -1
  512. package/dist/c-S6U5CGT5.min.js +0 -1
  513. package/dist/c-SFDIIU5G.min.js +0 -1
  514. package/dist/c-SLGMUBUL.min.js +0 -1
  515. package/dist/c-SRTBCRVE.min.js +0 -1
  516. package/dist/c-T6UAIKBH.min.js +0 -1
  517. package/dist/c-TMCTEVVW.min.js +0 -1
  518. package/dist/c-TMOSJLT3.min.js +0 -1
  519. package/dist/c-TZW3JGJ5.min.js +0 -1
  520. package/dist/c-U6ESPM7V.min.js +0 -1
  521. package/dist/c-UC5PTTFI.min.js +0 -1
  522. package/dist/c-USFMFKIH.min.js +0 -1
  523. package/dist/c-VGKUEZBC.min.js +0 -1
  524. package/dist/c-VGW3VG3I.min.js +0 -1
  525. package/dist/c-VN2HG5BS.min.js +0 -1
  526. package/dist/c-VPZDY5Q4.min.js +0 -1
  527. package/dist/c-VRXUB2F2.min.js +0 -1
  528. package/dist/c-VUBQNQJH.min.js +0 -1
  529. package/dist/c-VUH4PGZY.min.js +0 -1
  530. package/dist/c-W3CE4A4S.min.js +0 -1
  531. package/dist/c-X5UBGU2V.min.js +0 -1
  532. package/dist/c-XDRV7RKW.min.js +0 -1
  533. package/dist/c-YGZHURXZ.min.js +0 -1
  534. package/dist/c-YZVRZGX2.min.js +0 -1
  535. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  536. /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
  537. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
package/README.md CHANGED
@@ -9,52 +9,52 @@
9
9
 
10
10
  A React data visualization library designed for AI-assisted development.
11
11
 
12
- Simple charts in 5 lines. Network graphs, streaming data, and coordinated
13
- dashboards when you need them. Structured schemas and an MCP server so
14
- AI coding assistants generate correct chart code on the first try.
12
+ Start with a small chart component. Add network graphs, streaming data and
13
+ coordinated views when the task needs them. Structured schemas, diagnostics
14
+ and rendering evidence help coding assistants implement, check and repair
15
+ chart configurations.
16
+
17
+ Work through a complete task: [check category totals](https://semiotic.nteract.io/tasks/compare-category-totals),
18
+ [maintain a live chart](https://semiotic.nteract.io/tasks/update-live-chart), or
19
+ [correct a published chart](https://semiotic.nteract.io/tasks/correct-published-chart).
20
+ The [source task packets](ai/task-packets/index.json) identify their build and
21
+ evidence scope; source availability does not establish installed or deployed parity.
15
22
 
16
23
  <!-- semiotic-readme-dashboard:start -->
17
24
  <img src="./docs/public/assets/img/semiotic-release-dashboard.svg" alt="Semiotic release dashboard showing chart count, bundle sizes, capability coverage, chart families, and documentation growth" width="100%">
18
25
  <!-- semiotic-readme-dashboard:end -->
19
26
 
20
- ## What's New in 3.9.2
21
-
22
- 3.9.2 expands Semiotic's portable chart, accessibility, evidence, and rendering
23
- surfaces while tightening browser/server parity and production entry graphs:
24
-
25
- - `LineChart` gains the dedicated `semiotic/line` entry, and chart HOCs,
26
- network layouts, force workers, and optional overlays load only the runtime
27
- code their chart paths need.
28
- - `ChartAccessContract@1`, `ChartEvidenceEnvelope@1`, and the new
29
- `semiotic/access` and `semiotic/evidence` entries provide schema-backed access
30
- inventories, privacy-aware provenance, deterministic hashing, MCP evidence
31
- fragments, and publication gates.
32
- - `ParallelCoordinatesRecipe` and `CalendarHeatmapRecipe` are now portable,
33
- JSON-safe chart recipes, while Minimap, ScatterplotMatrix, and ChainReaction
34
- gain evidence-backed static rendering through `semiotic/server` and MCP.
35
- - Typed realtime handles preserve authored row types, `styleRules` now spans
36
- ordinal, XY, network, geo, realtime, and physics families, and structured
37
- navigation provides overview-first hierarchy and choropleth semantics.
38
- - Renderer and interaction fixes cover constant-value heatmaps, linked
39
- selection and hover, automatic network legends, Waterfall and Radar geometry,
40
- marginal graphics, custom layouts, tree-shaken network registration, and
41
- instance-local accessible names.
42
- - Release evidence now includes controlled dense-browser measurements,
43
- deterministic linked-hover cohorts, generated bundle guidance, stronger AI
44
- diagnostics, and stricter shipped-product and contributor gates.
27
+ ## What's New in 3.10.1
28
+
29
+ 3.10.1 adds Network Atlas recipes and reduces repeated layout work when charts
30
+ mount or resize.
31
+
32
+ - Network Atlas includes Motif Braid, Dependency X-Ray, and Flow Circuit
33
+ recipes, with interactive examples and an acceptance lab.
34
+ - Network charts reuse custom layouts when inputs are unchanged, avoid
35
+ duplicate worker solves, and treat palette and font changes as paint-only
36
+ updates where possible.
37
+ - Atlas readers integrate with themes and observers; network keyboard
38
+ activation and live hover announcements are corrected.
39
+ - Documentation preview checks and API snapshot parameter extraction are
40
+ more reliable.
41
+
42
+ See [the changelog](CHANGELOG.md#3101) for details.
45
43
 
46
44
  ## Why Semiotic
47
45
 
48
46
  Semiotic is a data visualization library for React that combines broad chart
49
- coverage with first-class AI tooling. It handles the chart types that most
50
- libraries skip — network graphs, streaming data, statistical distributions,
51
- coordinated views — and ships with machine-readable schemas so LLMs can
52
- generate correct code without examples.
47
+ coverage with AI tooling. It supports network graphs, streaming data,
48
+ statistical distributions and coordinated views, with schemas, examples and
49
+ diagnostics for implementing and checking each task. Check the project's
50
+ existing dependencies first: extending its current charting library may be
51
+ the best fit for a small change.
53
52
 
54
53
  ### Built for AI-assisted development
55
54
 
56
- Semiotic ships with everything an AI coding assistant needs to generate
57
- correct visualizations without trial and error:
55
+ Semiotic provides a workflow for generating, checking and repairing chart
56
+ configurations. The [July 27, 2026 evaluation](evals/reports/openai-gpt-5.6-2026-07-27/README.md)
57
+ reports model- and task-specific results; it does not guarantee first-try correctness.
58
58
 
59
59
  - **`semiotic/ai`** — a single import with the schema-backed chart capability catalog (XY, ordinal, network, realtime, geo, value, and portable recipes), optimized for LLM code generation. See `ai/surface-manifest.json` for the generated current inventory. Note: the published entry files are pre-bundled, so importing one chart from `semiotic/ai` still ships most of the bundle — treat it as a codegen/tooling surface and use family subpaths (`semiotic/xy`, `semiotic/geo`, `semiotic/value`, …) in production code, at roughly half the single-chart cost.
60
60
  - **`ai/schema.json`** — machine-readable prop schemas for every component
@@ -392,7 +392,7 @@ loadConversationArc(sink.load(), { enabled: false })
392
392
 
393
393
  ## Bundle Sizes
394
394
 
395
- Semiotic ships 32 stable JavaScript entry points (31 subpaths plus the root). **Don't import from `"semiotic"` unless you need everything** — use the smallest sub-path that matches your charts or tooling.
395
+ Semiotic ships 37 stable JavaScript entry points (36 subpaths plus the root). **Don't import from `"semiotic"` unless you need everything** — use the smallest sub-path that matches your charts or tooling.
396
396
 
397
397
  The numbers below are **first-party artifact cost**: the gzip size of Semiotic's own code for each sub-path. They exclude React and other runtime dependencies, so they are not a prediction of a cold application bundle. Do not add artifact rows to estimate an app: dependency resolution and cross-import deduplication happen in the consumer bundler and are measured separately below.
398
398
 
@@ -401,38 +401,43 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
401
401
 
402
402
  | Entry Point | gzip | What's inside |
403
403
  |---|---|---|
404
- | `semiotic/access` | **35 KB** | Chart Access Contract factory and first-wave baseline contracts |
404
+ | `semiotic/atlas` | **273 KB** | Motif Braid, Dependency Forest, and Flow Circuit readers |
405
+ | `semiotic/atlas/core` | **14 KB** | Network Atlas preparation, projections, and evidence queries |
406
+ | `semiotic/access` | **36 KB** | Chart Access Contract factory and first-wave baseline contracts |
405
407
  | `semiotic/evidence` | **50 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
406
- | `semiotic/line` | **135 KB** | LineChart only — one-chart micro boundary |
407
- | `semiotic/xy` | **166 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
408
- | `semiotic/ordinal` | **130 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
409
- | `semiotic/network` | **157 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
410
- | `semiotic/geo` | **113 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
411
- | `semiotic/realtime` | **162 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
412
- | `semiotic/realtime/core` | **161 KB** | Streaming chart types, HOCs, and buffer helpers |
408
+ | `semiotic/artifact` | **121 KB** | Renderer-independent contracts, claims, time, policy, grounding, and transfer audits |
409
+ | `semiotic/artifact/react` | **4 KB** | Accessible progressive disclosure for artifact contracts and policy evaluations |
410
+ | `semiotic/line` | **132 KB** | LineChart only — one-chart micro boundary |
411
+ | `semiotic/xy` | **163 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
412
+ | `semiotic/ordinal` | **131 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
413
+ | `semiotic/network` | **151 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
414
+ | `semiotic/geo` | **108 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
415
+ | `semiotic/realtime` | **161 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
416
+ | `semiotic/realtime/core` | **160 KB** | Streaming chart types, HOCs, and buffer helpers |
413
417
  | `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
414
- | `semiotic/server` | **216 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
415
- | `semiotic/server/node` | **216 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
416
- | `semiotic/server/edge` | **222 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
417
- | `semiotic/utils` | **103 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
418
- | `semiotic/utils/core` | **95 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
418
+ | `semiotic/server` | **241 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
419
+ | `semiotic/server/node` | **241 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
420
+ | `semiotic/server/edge` | **248 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
421
+ | `semiotic/utils` | **99 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
422
+ | `semiotic/utils/core` | **91 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
419
423
  | `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
420
- | `semiotic/recipes` | **100 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
421
- | `semiotic/recipes/core` | **92 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
424
+ | `semiotic/recipes` | **111 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
425
+ | `semiotic/recipes/core` | **103 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
422
426
  | `semiotic/recipes/react` | **8 KB** | Glyph and React layout-selection helpers |
423
427
  | `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
424
428
  | `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
425
429
  | `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
426
- | `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
430
+ | `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
427
431
  | `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
428
- | `semiotic/physics` | **168 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
432
+ | `semiotic/physics` | **167 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
429
433
  | `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
430
434
  | `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
431
- | `semiotic/ai` | **553 KB** | All schema-backed charts + validation — optimized for LLM code generation |
432
- | `semiotic/ai/core` | **101 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
433
- | `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
435
+ | `semiotic/ai` | **595 KB** | All schema-backed charts + validation — optimized for LLM code generation |
436
+ | `semiotic/ai/core` | **139 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
437
+ | `semiotic/controls` | **10 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
434
438
  | `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
435
- | `semiotic` | **360 KB** | Everything below (full bundle) |
439
+ | `semiotic/text` | **1 KB** | Optional Pretext annotation hook — peer package excluded |
440
+ | `semiotic` | **374 KB** | Full chart API and shared utilities |
436
441
 
437
442
  <!-- semiotic-bundle-sizes:end -->
438
443
 
@@ -453,32 +458,37 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
453
458
 
454
459
  | Public named import | Runtime | gzip cold-consumer bundle |
455
460
  |---|---:|---:|
456
- | `import { LineChart } from "semiotic"` | browser | **140.0 KiB** |
457
- | `import { LineChart } from "semiotic/xy"` | browser | **140.4 KiB** |
458
- | `import { LineChart } from "semiotic/line"` | browser | **140.3 KiB** |
459
- | `import { BarChart } from "semiotic/ordinal"` | browser | **133.1 KiB** |
460
- | `import { SankeyDiagram } from "semiotic/network"` | browser | **157.5 KiB** |
461
- | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **141.0 KiB** |
461
+ | `import { MotifBraidChart } from "semiotic/atlas"` | browser | **161.4 KiB** |
462
+ | `import { prepareNetworkAtlas } from "semiotic/atlas/core"` | browser | **6.4 KiB** |
463
+ | `import { LineChart } from "semiotic"` | browser | **141.4 KiB** |
464
+ | `import { LineChart } from "semiotic/xy"` | browser | **141.8 KiB** |
465
+ | `import { LineChart } from "semiotic/line"` | browser | **141.7 KiB** |
466
+ | `import { BarChart } from "semiotic/ordinal"` | browser | **133.5 KiB** |
467
+ | `import { SankeyDiagram } from "semiotic/network"` | browser | **156.9 KiB** |
468
+ | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **142.5 KiB** |
462
469
  | `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
463
470
  | `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
464
471
  | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **150.3 KiB** |
465
472
  | `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
466
473
  | `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
467
- | `import { renderChart } from "semiotic/server"` | node | **263.4 KiB** |
468
- | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **118.8 KiB** |
469
- | `import { renderToImage } from "semiotic/server/node"` | node | **264.0 KiB** |
470
- | `import { suggestCharts } from "semiotic/ai"` | browser | **253.5 KiB** |
471
- | `import { suggestCharts } from "semiotic/ai/core"` | browser | **44.8 KiB** |
472
- | `import { createChartAccessContract } from "semiotic/access"` | browser | **31.0 KiB** |
473
- | `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **40.1 KiB** |
474
+ | `import { renderChart } from "semiotic/server"` | node | **280.8 KiB** |
475
+ | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **146.7 KiB** |
476
+ | `import { renderToImage } from "semiotic/server/node"` | node | **281.5 KiB** |
477
+ | `import { suggestCharts } from "semiotic/ai"` | browser | **259.1 KiB** |
478
+ | `import { suggestCharts } from "semiotic/ai/core"` | browser | **46.5 KiB** |
479
+ | `import { buildArtifactContract } from "semiotic/artifact"` | browser | **19.7 KiB** |
480
+ | `import { ArtifactInspector } from "semiotic/artifact/react"` | browser | **3.8 KiB** |
481
+ | `import { createChartAccessContract } from "semiotic/access"` | browser | **33.4 KiB** |
482
+ | `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **49.1 KiB** |
474
483
  | `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
475
- | `import { ChoroplethMap } from "semiotic/geo"` | browser | **115.5 KiB** |
476
- | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
484
+ | `import { ChoroplethMap } from "semiotic/geo"` | browser | **116.7 KiB** |
485
+ | `import { usePretextAnnotations } from "semiotic/text"` | browser | **1.5 KiB** |
486
+ | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.2 KiB** |
477
487
  | `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
478
488
  | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
479
489
  | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.2 KiB** |
480
- | `import { validateProps } from "semiotic/utils"` | browser | **9.2 KiB** |
481
- | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **6.9 KiB** |
490
+ | `import { validateProps } from "semiotic/utils"` | browser | **10.4 KiB** |
491
+ | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **8.1 KiB** |
482
492
  | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
483
493
  | `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
484
494
  | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
@@ -486,7 +496,7 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
486
496
  | `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
487
497
  | `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
488
498
 
489
- **Line-boundary interpretation:** the retained named import from `semiotic/line` emits 422.7 KiB raw versus 422.7 KiB from `semiotic/xy`; gzip differs by 0.1 KiB (0.1%). Tree-shaking converges both paths on the same LineChart implementation graph. Treat `semiotic/line` as a narrower API/direct-ESM artifact boundary, not an application-bundle saving. Do not add another per-chart entry until its packed named import beats the family path by both 10 KiB gzip and 7%.
499
+ **Line-boundary interpretation:** the retained named import from `semiotic/line` emits 422.6 KiB raw versus 422.6 KiB from `semiotic/xy`; gzip differs by 0.1 KiB (0.0%). Tree-shaking converges both paths on the same LineChart implementation graph. Treat `semiotic/line` as a narrower API/direct-ESM artifact boundary, not an application-bundle saving. Do not add another per-chart entry until its packed named import beats the family path by both 10 KiB gzip and 7%.
490
500
 
491
501
  <!-- semiotic-cold-consumer:end -->
492
502
 
@@ -495,8 +505,8 @@ and declares them as normal runtime dependencies. Consumers do not need to
495
505
  install d3 packages manually; their bundler resolves, deduplicates, and
496
506
  tree-shakes that dependency graph. A packed webpack comparison favored this
497
507
  model in three of four representative chart families, and a Next 16 webpack
498
- route was 21.8 KiB gzip smaller than the fully bundled alternative. The one
499
- bundled win, Sankey, was only 1.1 KiB gzip. This choice retains a 22-package,
508
+ route was 22.7 KiB gzip smaller than the fully bundled alternative. The one
509
+ bundled win, Sankey, was only 0.4 KiB gzip. This choice retains a 22-package,
500
510
  1.9 MB unpacked d3 install closure in exchange for smaller common application
501
511
  graphs and an ordinary dependency contract. The checked policy is
502
512
  `npm run check:d3-packaging`; the reproducible evidence is in
@@ -625,11 +635,22 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
625
635
  | **`diagnoseConfig`** | Check a chart configuration for common problems — empty data, bad dimensions, missing accessors, wrong data shape, and more. Returns a human-readable diagnostic report with actionable fixes. |
626
636
  | **`reportIssue`** | Generate a pre-filled GitHub issue URL for bug reports or feature requests. Pass `{ title: "...", body: "...", labels: ["bug"] }`. Returns a URL the user can open to submit. |
627
637
  | **`applyTheme`** | List named theme presets or return ThemeProvider/CSS/token usage for a preset such as `{ name: "tufte" }`. |
638
+ | **`auditArtifact`** | Evaluate an explicit artifact contract under a named policy without inferring missing source, review, or timing facts. |
639
+ | **`recommendRepresentation`** | Compare chart and non-chart outcomes against supplied data, claims, evidence, time state, and policy requirements. |
640
+ | **`repairArtifact`** | Propose contract repairs and optionally fill missing identity fields; existing mismatches require a revision and claim reassessment. |
641
+ | **`explainRefusal`** | Explain which explicit policy obligations prevent publication or action and identify safe follow-up work. |
642
+
643
+ Artifact tools are opt-in diagnostics, not publication authorization. A
644
+ `conditional` result (including CLI exit code 0) retains open work. Ordinary
645
+ `renderChart` calls do not enforce artifact policy; governed hosts must enforce
646
+ their own release boundary. Manual-check resolution and revision-bound release
647
+ approval remain separate host workflow work.
628
648
 
629
649
  ### Resources
630
650
 
631
651
  | Resource | Description |
632
652
  |----------|-------------|
653
+ | **`semiotic://artifact-contract-schema`** | Standalone JSON Schema for portable purpose, claim, evidence, timing, review, and transfer metadata. |
633
654
  | **`semiotic://schema`** | Full machine-readable component schema JSON. |
634
655
  | **`semiotic://schema-index`** | Compact discovery index with categories, renderability, import paths, and each component's schema resource URI. |
635
656
  | **`semiotic://schema/{component}`** | One component's schema, metadata, accessibility guidance, and behavior contracts (for example `semiotic://schema/LineChart`). |
@@ -1,18 +1,24 @@
1
1
  ---
2
2
  name: semiotic-charts
3
- description: Generate trustworthy, accessible, agent-legible charts with Semiotic. Use whenever you produce a data visualization in a React/TypeScript app, stream a chart as generative UI, or pick a chart type for a dataset. Emit a validated config and run the trust loop — never hand-write chart JSX that breaks on first paint.
3
+ description: Build, repair, and verify charts in an existing Semiotic project, when Semiotic is explicitly requested, or when evaluating its documented capabilities against a visualization task. Preserve the project's dependency and runtime constraints; routine changes in another charting stack and tasks without a chart do not call for this skill.
4
4
  ---
5
5
 
6
6
  # Generating charts with Semiotic
7
7
 
8
- Semiotic is a React data-visualization library whose differentiator is **trust**:
9
- generation is cheap, but a chart that renders, that a screen-reader user can
10
- receive, and that carries its own provenance is scarce. This skill is the
11
- workflow for producing one.
8
+ Semiotic is a React data-visualization library with configuration validation,
9
+ render evidence, structured access, and artifact revision support. Use this
10
+ workflow to check the parts of a chart that the task requires. A capability
11
+ comparison may conclude that the existing stack, a table, or another tool is
12
+ the better fit; the skill does not authorize adding a dependency or migrating
13
+ working charts.
12
14
 
13
15
  The cardinal rule: **do not hand-write chart JSX and hope it paints.** Emit a
14
16
  `{ component, props }` proposal and run it through the trust loop, which is
15
- validated and diagnosed; when a renderer is available, proven to paint. Otherwise it returns reasons and ranked alternatives to retry with.
17
+ validated and diagnosed; when a renderer is available, checked for a nonempty
18
+ static scene. This does not establish correct data mapping, live browser
19
+ behavior, or usability with assistive technology. Check the expected values
20
+ and run the browser or reception checks relevant to the task. Failed proposals
21
+ return reasons and ranked alternatives to retry with.
16
22
 
17
23
  ## Context discipline
18
24
 
@@ -46,7 +52,7 @@ if (result.ok) {
46
52
 
47
53
  `result` carries `{ ok, config, jsx, validation, diagnostics, repair?, reasons }`.
48
54
  In a server/SSR context you can inject `render: renderChartWithEvidence` (from
49
- `semiotic/server`) so the loop also *proves the scene is non-empty* and reads back
55
+ `semiotic/server`) so the loop also *checks that the static scene is nonempty* and reads back
50
56
  render evidence (mark count, domains, ARIA label) — the first-try oracle.
51
57
 
52
58
  ### As an agent tool