semiotic 3.9.2 → 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 (452) hide show
  1. package/README.md +99 -74
  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/dist/mcp-server.js +68 -68
  8. package/ai/examples.md +1 -1
  9. package/ai/reference.md +31 -14
  10. package/ai/schema.json +1868 -438
  11. package/ai/surface-manifest.json +11 -4
  12. package/ai/system-prompt.md +2 -0
  13. package/ai/task-packets/compare-category-totals.json +301 -0
  14. package/ai/task-packets/compare-category-totals.md +188 -0
  15. package/ai/task-packets/correct-published-chart.json +271 -0
  16. package/ai/task-packets/correct-published-chart.md +597 -0
  17. package/ai/task-packets/index.json +40 -0
  18. package/ai/task-packets/update-live-chart.json +289 -0
  19. package/ai/task-packets/update-live-chart.md +424 -0
  20. package/dist/c-2N7IU2NY.min.js +1 -0
  21. package/dist/c-2WK7YJLL.min.js +1 -0
  22. package/dist/c-33QOXEUG.min.js +1 -0
  23. package/dist/c-42PLDTX7.min.js +1 -0
  24. package/dist/c-447VIMRO.min.js +1 -0
  25. package/dist/c-4FN7Q6VQ.min.js +1 -0
  26. package/dist/c-553QUDKA.min.js +1 -0
  27. package/dist/c-55BAJ333.min.js +1 -0
  28. package/dist/c-7242NXSG.min.js +1 -0
  29. package/dist/c-7EGHJU2F.min.js +1 -0
  30. package/dist/c-7HP7MB2I.min.js +1 -0
  31. package/dist/c-7NBU5ZKS.min.js +1 -0
  32. package/dist/c-AFBSWT77.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-AZKPVBOC.min.js +1 -0
  38. package/dist/c-BNFJMDHN.min.js +1 -0
  39. package/dist/c-BNG5ECK5.min.js +1 -0
  40. package/dist/c-BOHCQILI.min.js +1 -0
  41. package/dist/c-CCTGN5CK.min.js +1 -0
  42. package/dist/c-CPSPZH6A.min.js +1 -0
  43. package/dist/c-CPV4N35K.min.js +1 -0
  44. package/dist/c-D6HAAPTX.min.js +1 -0
  45. package/dist/c-DE5Q3U2X.min.js +1 -0
  46. package/dist/c-DK662R77.min.js +1 -0
  47. package/dist/c-DY2676CR.min.js +1 -0
  48. package/dist/c-E32M6XW5.min.js +1 -0
  49. package/dist/c-E4JDJH4I.min.js +1 -0
  50. package/dist/c-E7I2L7CU.min.js +1 -0
  51. package/dist/c-EBOQ7ER7.min.js +1 -0
  52. package/dist/c-ELDWAO2V.min.js +1 -0
  53. package/dist/c-EUBTECGM.min.js +1 -0
  54. package/dist/c-GNTXRXRN.min.js +1 -0
  55. package/dist/c-GSZRZRD6.min.js +1 -0
  56. package/dist/c-GWX7JGMF.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-HPOYKCCG.min.js +1 -0
  61. package/dist/c-HXDKPIKR.min.js +1 -0
  62. package/dist/c-I4QJ6YLM.min.js +1 -0
  63. package/dist/c-IDJV3CZK.min.js +1 -0
  64. package/dist/c-ITKX3RC5.min.js +1 -0
  65. package/dist/c-JG2JCQLP.min.js +1 -0
  66. package/dist/c-JLGRHXGZ.min.js +1 -0
  67. package/dist/c-JO2UGTCP.min.js +1 -0
  68. package/dist/c-JUKIWTBJ.min.js +1 -0
  69. package/dist/c-KCRJGUHP.min.js +1 -0
  70. package/dist/c-LMGSSD2E.min.js +1 -0
  71. package/dist/c-LYQMZMZQ.min.js +1 -0
  72. package/dist/c-LYVKDBQJ.min.js +1 -0
  73. package/dist/c-MVR3RWF3.min.js +1 -0
  74. package/dist/c-MXCP7GNZ.min.js +1 -0
  75. package/dist/c-NG7BLZTR.min.js +1 -0
  76. package/dist/c-NYZ2QNAM.min.js +1 -0
  77. package/dist/c-OO5QLMJC.min.js +1 -0
  78. package/dist/c-OOVX2JPQ.min.js +1 -0
  79. package/dist/c-ORLEBW72.min.js +1 -0
  80. package/dist/c-P65V6HLO.min.js +1 -0
  81. package/dist/c-PP6VY3QU.min.js +1 -0
  82. package/dist/c-PRIKOLTE.min.js +1 -0
  83. package/dist/c-PSNI6KAZ.min.js +1 -0
  84. package/dist/c-PYNW54D2.min.js +1 -0
  85. package/dist/c-QA3HMQJP.min.js +1 -0
  86. package/dist/c-ROEHCIGV.min.js +1 -0
  87. package/dist/c-S3AZX5PP.min.js +1 -0
  88. package/dist/c-T2V7O2LO.min.js +1 -0
  89. package/dist/c-TIXX5CAU.min.js +1 -0
  90. package/dist/c-TKG2NP7G.min.js +1 -0
  91. package/dist/c-VJTDST2R.min.js +1 -0
  92. package/dist/c-VXLOLYTO.min.js +1 -0
  93. package/dist/c-W4ZUKSEQ.min.js +1 -0
  94. package/dist/c-WH2O53VI.min.js +1 -0
  95. package/dist/c-WNGH47HF.min.js +1 -0
  96. package/dist/c-WUWXGQYA.min.js +1 -0
  97. package/dist/c-XDQKXPX4.min.js +1 -0
  98. package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
  99. package/dist/c-YDECTEUW.min.js +1 -0
  100. package/dist/c-YF3YKVQI.min.js +1 -0
  101. package/dist/c-YLZIV3VS.min.js +1 -0
  102. package/dist/c-ZYPXQF7B.min.js +1 -0
  103. package/dist/components/Annotation.d.ts +2 -1
  104. package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
  105. package/dist/components/ai/chartRecipes.d.ts +4 -0
  106. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  107. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  108. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  109. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  110. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  111. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  112. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  113. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  114. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  115. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  116. package/dist/components/artifact/claimGraph.d.ts +5 -0
  117. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  118. package/dist/components/artifact/claims.d.ts +24 -0
  119. package/dist/components/artifact/collection.d.ts +10 -0
  120. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  121. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  122. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  123. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  124. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  125. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  126. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  127. package/dist/components/artifact/contract.d.ts +30 -0
  128. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  129. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  130. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  131. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  132. package/dist/components/artifact/exportPaths.d.ts +8 -0
  133. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  134. package/dist/components/artifact/fingerprint.d.ts +36 -0
  135. package/dist/components/artifact/grounding.d.ts +51 -0
  136. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  137. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  138. package/dist/components/artifact/identity.d.ts +19 -0
  139. package/dist/components/artifact/inheritance.d.ts +48 -0
  140. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  141. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  142. package/dist/components/artifact/obligations.d.ts +3 -0
  143. package/dist/components/artifact/policies.d.ts +45 -0
  144. package/dist/components/artifact/policyRelations.d.ts +3 -0
  145. package/dist/components/artifact/recordProjection.d.ts +7 -0
  146. package/dist/components/artifact/representation.d.ts +50 -0
  147. package/dist/components/artifact/serialization.d.ts +40 -0
  148. package/dist/components/artifact/temporal.d.ts +32 -0
  149. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  150. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  151. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  152. package/dist/components/artifact/types.d.ts +341 -0
  153. package/dist/components/artifact/validation.d.ts +13 -0
  154. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  155. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  156. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  157. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  158. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  159. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  160. package/dist/components/charts/ordinal/DonutChart.d.ts +2 -0
  161. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  162. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  163. package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
  164. package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
  165. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  166. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  167. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  168. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  169. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  170. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  171. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  172. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  173. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  174. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  175. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  176. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  177. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  178. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  179. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  180. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  181. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  182. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  183. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  184. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  185. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +4 -0
  186. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
  187. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
  188. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
  189. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
  190. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  191. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
  192. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  193. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  194. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  195. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  196. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  197. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  198. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  199. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  200. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  201. package/dist/components/charts/shared/useChartLegend.d.ts +4 -0
  202. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  203. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  204. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  205. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  206. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  207. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  208. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  209. package/dist/components/charts/xy/WaterfallChart.d.ts +8 -0
  210. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  211. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  212. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  213. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +16 -8
  214. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  215. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  216. package/dist/components/evidence/evidenceGate.d.ts +3 -1
  217. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  218. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  219. package/dist/components/export/chartConfig.d.ts +40 -5
  220. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  221. package/dist/components/legendLayout.d.ts +18 -0
  222. package/dist/components/legendStyles.d.ts +4 -0
  223. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  224. package/dist/components/recipes/intervals.d.ts +1 -1
  225. package/dist/components/semiotic-ai-core.d.ts +33 -22
  226. package/dist/components/semiotic-ai.d.ts +15 -3
  227. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  228. package/dist/components/semiotic-artifact.d.ts +23 -0
  229. package/dist/components/semiotic-experimental.d.ts +1 -1
  230. package/dist/components/semiotic-physics.d.ts +4 -4
  231. package/dist/components/semiotic-text.d.ts +2 -0
  232. package/dist/components/semiotic-utils-core.d.ts +18 -18
  233. package/dist/components/semiotic.d.ts +3 -3
  234. package/dist/components/server/renderEvidence.d.ts +12 -0
  235. package/dist/components/server/renderToStaticSVG.d.ts +3 -0
  236. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  237. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  238. package/dist/components/server/staticXYGrid.d.ts +1 -1
  239. package/dist/components/server/svgSizing.d.ts +6 -0
  240. package/dist/components/shared/svgRoot.d.ts +17 -0
  241. package/dist/components/store/selectionProvenance.d.ts +6 -0
  242. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  243. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  244. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  245. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  246. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  247. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  248. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  249. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  250. package/dist/components/stream/XYGrid.d.ts +11 -0
  251. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  252. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  253. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  254. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  255. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  256. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  257. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  258. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +3 -0
  259. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  260. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  261. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  262. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  263. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  264. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  265. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  266. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  267. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  268. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  269. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  270. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  271. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  272. package/dist/components/stream/types.d.ts +4 -53
  273. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  274. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  275. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  276. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  277. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  278. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  279. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  280. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  281. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  282. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  283. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  284. package/dist/controls.module.min.js +1 -1
  285. package/dist/geo.min.js +1 -1
  286. package/dist/geo.module.min.js +1 -1
  287. package/dist/network.module.min.js +1 -1
  288. package/dist/ordinal.module.min.js +1 -1
  289. package/dist/physics-matter.min.js +1 -1
  290. package/dist/physics-matter.module.min.js +1 -1
  291. package/dist/physics-rapier.min.js +1 -1
  292. package/dist/physics-rapier.module.min.js +1 -1
  293. package/dist/physics.module.min.js +1 -1
  294. package/dist/physicsWorker.js +1 -1
  295. package/dist/processSankeyLayoutWorker.js +1 -1
  296. package/dist/rough.min.js +1 -1
  297. package/dist/rough.module.min.js +1 -1
  298. package/dist/semiotic-access.module.min.js +1 -1
  299. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  300. package/dist/semiotic-ai-core.d.ts +33 -22
  301. package/dist/semiotic-ai-core.min.js +1 -1
  302. package/dist/semiotic-ai-core.module.min.js +1 -1
  303. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  304. package/dist/semiotic-ai.d.ts +15 -3
  305. package/dist/semiotic-ai.module.min.js +1 -1
  306. package/dist/semiotic-artifact-react.d.ts +10 -0
  307. package/dist/semiotic-artifact-react.min.js +2 -0
  308. package/dist/semiotic-artifact-react.module.min.js +2 -0
  309. package/dist/semiotic-artifact.d.ts +23 -0
  310. package/dist/semiotic-artifact.min.js +1 -0
  311. package/dist/semiotic-artifact.module.min.js +1 -0
  312. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  313. package/dist/semiotic-client-glyph.module.min.js +1 -1
  314. package/dist/semiotic-client-responsive.module.min.js +1 -1
  315. package/dist/semiotic-client-shared.module.min.js +1 -1
  316. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  317. package/dist/semiotic-data.min.js +1 -1
  318. package/dist/semiotic-data.module.min.js +1 -1
  319. package/dist/semiotic-evidence.min.js +1 -1
  320. package/dist/semiotic-evidence.module.min.js +1 -1
  321. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  322. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  323. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  324. package/dist/semiotic-experimental-vacp.min.js +1 -1
  325. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  326. package/dist/semiotic-experimental.d.ts +1 -1
  327. package/dist/semiotic-line.module.min.js +1 -1
  328. package/dist/semiotic-physics.d.ts +4 -4
  329. package/dist/semiotic-realtime-core.module.min.js +1 -1
  330. package/dist/semiotic-realtime-react.module.min.js +1 -1
  331. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  332. package/dist/semiotic-recipes-core.module.min.js +1 -1
  333. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  334. package/dist/semiotic-recipes-react.min.js +1 -1
  335. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  336. package/dist/semiotic-server-edge.min.js +1 -1
  337. package/dist/semiotic-server-edge.module.min.js +1 -1
  338. package/dist/semiotic-server-node.min.js +1 -1
  339. package/dist/semiotic-server-node.module.min.js +1 -1
  340. package/dist/semiotic-text.d.ts +2 -0
  341. package/dist/semiotic-text.min.js +2 -0
  342. package/dist/semiotic-text.module.min.js +2 -0
  343. package/dist/semiotic-themes-core.min.js +1 -1
  344. package/dist/semiotic-themes-core.module.min.js +1 -1
  345. package/dist/semiotic-themes.min.js +1 -1
  346. package/dist/semiotic-themes.module.min.js +1 -1
  347. package/dist/semiotic-utils-core.d.ts +18 -18
  348. package/dist/semiotic-utils-core.min.js +1 -1
  349. package/dist/semiotic-utils-core.module.min.js +1 -1
  350. package/dist/semiotic-value.module.min.js +1 -1
  351. package/dist/semiotic.d.ts +3 -3
  352. package/dist/semiotic.module.min.js +1 -1
  353. package/dist/server.min.js +1 -1
  354. package/dist/server.module.min.js +1 -1
  355. package/dist/xy.module.min.js +1 -1
  356. package/package.json +55 -14
  357. package/spec/README.md +8 -3
  358. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  359. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  360. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  361. package/dist/c-3BLJEQNG.min.js +0 -1
  362. package/dist/c-3SCUN5HI.min.js +0 -1
  363. package/dist/c-3VVKFA4M.min.js +0 -1
  364. package/dist/c-43TJZS3F.min.js +0 -1
  365. package/dist/c-4DTZPSUD.min.js +0 -1
  366. package/dist/c-4ES5367Y.min.js +0 -1
  367. package/dist/c-52TEGIUJ.min.js +0 -1
  368. package/dist/c-54IRWOGM.min.js +0 -1
  369. package/dist/c-5D2S4RMI.min.js +0 -1
  370. package/dist/c-5JWCTX3G.min.js +0 -1
  371. package/dist/c-6CMMSN6N.min.js +0 -1
  372. package/dist/c-6HRB2L7H.min.js +0 -1
  373. package/dist/c-6O5EVOPH.min.js +0 -1
  374. package/dist/c-7W4SV36A.min.js +0 -1
  375. package/dist/c-A4WRGZFX.min.js +0 -1
  376. package/dist/c-AG7WWVIH.min.js +0 -1
  377. package/dist/c-AH6J4MTN.min.js +0 -1
  378. package/dist/c-AKAF6JAD.min.js +0 -1
  379. package/dist/c-ALYR5LKK.min.js +0 -1
  380. package/dist/c-BBKITSXB.min.js +0 -1
  381. package/dist/c-BYDPC44I.min.js +0 -1
  382. package/dist/c-CFFIU2MW.min.js +0 -1
  383. package/dist/c-CGNHBHCE.min.js +0 -1
  384. package/dist/c-CJYSXIFV.min.js +0 -1
  385. package/dist/c-CZF7MV67.min.js +0 -1
  386. package/dist/c-D53OKBSY.min.js +0 -1
  387. package/dist/c-DADXPJXV.min.js +0 -1
  388. package/dist/c-DBQ2V7CH.min.js +0 -1
  389. package/dist/c-DPMVAUAW.min.js +0 -1
  390. package/dist/c-ECJCKLYY.min.js +0 -1
  391. package/dist/c-EGATGOWJ.min.js +0 -1
  392. package/dist/c-EGR6VYBW.min.js +0 -1
  393. package/dist/c-ESNR43AN.min.js +0 -1
  394. package/dist/c-F3LIKINL.min.js +0 -1
  395. package/dist/c-F5ZB5GJ6.min.js +0 -1
  396. package/dist/c-G36WS6LN.min.js +0 -1
  397. package/dist/c-G3VYMHKE.min.js +0 -1
  398. package/dist/c-GGISSW5E.min.js +0 -1
  399. package/dist/c-GR6MOEQC.min.js +0 -1
  400. package/dist/c-GSVCN34B.min.js +0 -1
  401. package/dist/c-GYOQCEFP.min.js +0 -1
  402. package/dist/c-H3DNMTCC.min.js +0 -1
  403. package/dist/c-I6J3FEZE.min.js +0 -1
  404. package/dist/c-IGH6MGJ5.min.js +0 -1
  405. package/dist/c-II2EEAJN.min.js +0 -1
  406. package/dist/c-IUHFPMHD.min.js +0 -1
  407. package/dist/c-J6M4JHRS.min.js +0 -1
  408. package/dist/c-JM3MGLQV.min.js +0 -1
  409. package/dist/c-KM3N7F7R.min.js +0 -1
  410. package/dist/c-LF5BZFNC.min.js +0 -1
  411. package/dist/c-LKBSGFQC.min.js +0 -1
  412. package/dist/c-MNF2S4AA.min.js +0 -1
  413. package/dist/c-MT3WBK7M.min.js +0 -1
  414. package/dist/c-NDJADPIF.min.js +0 -1
  415. package/dist/c-NVPQCIL5.min.js +0 -1
  416. package/dist/c-NY3JWV2K.min.js +0 -1
  417. package/dist/c-OFWJBEE5.min.js +0 -1
  418. package/dist/c-OYFHP5F5.min.js +0 -1
  419. package/dist/c-PGKQGGQ2.min.js +0 -1
  420. package/dist/c-PPWDL5ZI.min.js +0 -1
  421. package/dist/c-Q2IPZ3MU.min.js +0 -1
  422. package/dist/c-QKHMBE2E.min.js +0 -1
  423. package/dist/c-QMVM3AY6.min.js +0 -1
  424. package/dist/c-QSGWX53A.min.js +0 -1
  425. package/dist/c-RJKEKZOO.min.js +0 -1
  426. package/dist/c-RSVIHIQ4.min.js +0 -1
  427. package/dist/c-S6U5CGT5.min.js +0 -1
  428. package/dist/c-SFDIIU5G.min.js +0 -1
  429. package/dist/c-SLGMUBUL.min.js +0 -1
  430. package/dist/c-SRTBCRVE.min.js +0 -1
  431. package/dist/c-T6UAIKBH.min.js +0 -1
  432. package/dist/c-TMCTEVVW.min.js +0 -1
  433. package/dist/c-TMOSJLT3.min.js +0 -1
  434. package/dist/c-TZW3JGJ5.min.js +0 -1
  435. package/dist/c-U6ESPM7V.min.js +0 -1
  436. package/dist/c-UC5PTTFI.min.js +0 -1
  437. package/dist/c-USFMFKIH.min.js +0 -1
  438. package/dist/c-VGKUEZBC.min.js +0 -1
  439. package/dist/c-VGW3VG3I.min.js +0 -1
  440. package/dist/c-VN2HG5BS.min.js +0 -1
  441. package/dist/c-VPZDY5Q4.min.js +0 -1
  442. package/dist/c-VRXUB2F2.min.js +0 -1
  443. package/dist/c-VUBQNQJH.min.js +0 -1
  444. package/dist/c-VUH4PGZY.min.js +0 -1
  445. package/dist/c-W3CE4A4S.min.js +0 -1
  446. package/dist/c-X5UBGU2V.min.js +0 -1
  447. package/dist/c-XDRV7RKW.min.js +0 -1
  448. package/dist/c-YGZHURXZ.min.js +0 -1
  449. package/dist/c-YZVRZGX2.min.js +0 -1
  450. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  451. /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
  452. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
package/README.md CHANGED
@@ -9,52 +9,60 @@
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.0
28
+
29
+ 3.10.0 finishes style-rule coverage on the remaining sibling charts, fixes geo
30
+ overlay accessible names, and lands the post-3.9.2 example, physics, and
31
+ renderer work:
32
+
33
+ - `styleRules` now reach `WaterfallChart`, `MultiAxisLineChart`, `FlowMap`,
34
+ `ProcessFlowChart`, `MinimapChart`, `CandlestickChart`, `DifferenceChart`,
35
+ and `ScatterplotMatrix` in both React and `renderChart`/MCP output.
36
+ - Geographic overlays use "Geographic chart" fallbacks and honor `description`
37
+ in `<desc>`, matching canvas `aria-label` and static SVG chrome across XY,
38
+ ordinal, network, and geo frames. Live overlay and GIF `<title>`/`<desc>`
39
+ ids are instance-local so two charts on one page do not collide.
40
+ - `BubbleChart` now exposes the same xy brush as Scatterplot; stacked and
41
+ grouped bars share BarChart's value-axis brush. Radar, funnel, pie, and
42
+ donut honor `valueFormat` in default tooltips (and radar/funnel ticks).
43
+ - Physics charts share source updates, replay, and fixed axes; EventDrop and
44
+ process-flow semantics stay aligned between live and settled output.
45
+ - Realtime histograms gain responsive sizing, axis control, Y inversion, and
46
+ linked hover/brush; threshold end caps and Gauge readouts are portable SVG.
47
+ - New long-form examples cover grocery receipts, the jobs report, reservoir
48
+ guide, plane day, and persuasion, each with pinned sources and consumer kits.
49
+ - Renderer hot paths (packing, LOESS, rollup, ordinal scenes, hover hit-test)
50
+ and evidence/artifact contracts are tighter without changing public APIs.
45
51
 
46
52
  ## Why Semiotic
47
53
 
48
54
  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.
55
+ coverage with AI tooling. It supports network graphs, streaming data,
56
+ statistical distributions and coordinated views, with schemas, examples and
57
+ diagnostics for implementing and checking each task. Check the project's
58
+ existing dependencies first: extending its current charting library may be
59
+ the best fit for a small change.
53
60
 
54
61
  ### Built for AI-assisted development
55
62
 
56
- Semiotic ships with everything an AI coding assistant needs to generate
57
- correct visualizations without trial and error:
63
+ Semiotic provides a workflow for generating, checking and repairing chart
64
+ configurations. The [July 27, 2026 evaluation](evals/reports/openai-gpt-5.6-2026-07-27/README.md)
65
+ reports model- and task-specific results; it does not guarantee first-try correctness.
58
66
 
59
67
  - **`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
68
  - **`ai/schema.json`** — machine-readable prop schemas for every component
@@ -392,7 +400,7 @@ loadConversationArc(sink.load(), { enabled: false })
392
400
 
393
401
  ## Bundle Sizes
394
402
 
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.
403
+ Semiotic ships 35 stable JavaScript entry points (34 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
404
 
397
405
  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
406
 
@@ -401,21 +409,23 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
401
409
 
402
410
  | Entry Point | gzip | What's inside |
403
411
  |---|---|---|
404
- | `semiotic/access` | **35 KB** | Chart Access Contract factory and first-wave baseline contracts |
412
+ | `semiotic/access` | **36 KB** | Chart Access Contract factory and first-wave baseline contracts |
405
413
  | `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 |
414
+ | `semiotic/artifact` | **121 KB** | Renderer-independent contracts, claims, time, policy, grounding, and transfer audits |
415
+ | `semiotic/artifact/react` | **4 KB** | Accessible progressive disclosure for artifact contracts and policy evaluations |
416
+ | `semiotic/line` | **131 KB** | LineChart only — one-chart micro boundary |
417
+ | `semiotic/xy` | **161 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
408
418
  | `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 |
419
+ | `semiotic/network` | **150 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
420
+ | `semiotic/geo` | **107 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
421
+ | `semiotic/realtime` | **159 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
422
+ | `semiotic/realtime/core` | **158 KB** | Streaming chart types, HOCs, and buffer helpers |
413
423
  | `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 |
424
+ | `semiotic/server` | **228 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
425
+ | `semiotic/server/node` | **228 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
426
+ | `semiotic/server/edge` | **230 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
427
+ | `semiotic/utils` | **98 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
428
+ | `semiotic/utils/core` | **91 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
419
429
  | `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
420
430
  | `semiotic/recipes` | **100 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
421
431
  | `semiotic/recipes/core` | **92 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
@@ -423,16 +433,17 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
423
433
  | `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
424
434
  | `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
425
435
  | `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
426
- | `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
436
+ | `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
427
437
  | `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
428
- | `semiotic/physics` | **168 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
438
+ | `semiotic/physics` | **165 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
429
439
  | `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
430
440
  | `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 |
441
+ | `semiotic/ai` | **591 KB** | All schema-backed charts + validation — optimized for LLM code generation |
442
+ | `semiotic/ai/core` | **138 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
443
+ | `semiotic/controls` | **10 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
434
444
  | `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
435
- | `semiotic` | **360 KB** | Everything below (full bundle) |
445
+ | `semiotic/text` | **1 KB** | Optional Pretext annotation hook — peer package excluded |
446
+ | `semiotic` | **371 KB** | Full chart API and shared utilities |
436
447
 
437
448
  <!-- semiotic-bundle-sizes:end -->
438
449
 
@@ -453,32 +464,35 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
453
464
 
454
465
  | Public named import | Runtime | gzip cold-consumer bundle |
455
466
  |---|---:|---:|
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** |
467
+ | `import { LineChart } from "semiotic"` | browser | **141.2 KiB** |
468
+ | `import { LineChart } from "semiotic/xy"` | browser | **141.6 KiB** |
469
+ | `import { LineChart } from "semiotic/line"` | browser | **141.6 KiB** |
470
+ | `import { BarChart } from "semiotic/ordinal"` | browser | **133.5 KiB** |
471
+ | `import { SankeyDiagram } from "semiotic/network"` | browser | **156.9 KiB** |
472
+ | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **142.4 KiB** |
462
473
  | `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
463
474
  | `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
464
- | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **150.3 KiB** |
475
+ | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.8 KiB** |
465
476
  | `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
466
477
  | `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** |
478
+ | `import { renderChart } from "semiotic/server"` | node | **268.6 KiB** |
479
+ | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **119.7 KiB** |
480
+ | `import { renderToImage } from "semiotic/server/node"` | node | **269.4 KiB** |
481
+ | `import { suggestCharts } from "semiotic/ai"` | browser | **258.7 KiB** |
482
+ | `import { suggestCharts } from "semiotic/ai/core"` | browser | **46.3 KiB** |
483
+ | `import { buildArtifactContract } from "semiotic/artifact"` | browser | **19.5 KiB** |
484
+ | `import { ArtifactInspector } from "semiotic/artifact/react"` | browser | **3.8 KiB** |
485
+ | `import { createChartAccessContract } from "semiotic/access"` | browser | **33.2 KiB** |
486
+ | `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **48.9 KiB** |
474
487
  | `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** |
488
+ | `import { ChoroplethMap } from "semiotic/geo"` | browser | **116.6 KiB** |
489
+ | `import { usePretextAnnotations } from "semiotic/text"` | browser | **1.5 KiB** |
490
+ | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.2 KiB** |
477
491
  | `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
478
492
  | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
479
493
  | `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** |
494
+ | `import { validateProps } from "semiotic/utils"` | browser | **10.2 KiB** |
495
+ | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **7.9 KiB** |
482
496
  | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
483
497
  | `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
484
498
  | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
@@ -486,7 +500,7 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
486
500
  | `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
487
501
  | `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
488
502
 
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%.
503
+ **Line-boundary interpretation:** the retained named import from `semiotic/line` emits 421.9 KiB raw versus 421.9 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%.
490
504
 
491
505
  <!-- semiotic-cold-consumer:end -->
492
506
 
@@ -495,8 +509,8 @@ and declares them as normal runtime dependencies. Consumers do not need to
495
509
  install d3 packages manually; their bundler resolves, deduplicates, and
496
510
  tree-shakes that dependency graph. A packed webpack comparison favored this
497
511
  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,
512
+ route was 22.7 KiB gzip smaller than the fully bundled alternative. The one
513
+ bundled win, Sankey, was only 0.4 KiB gzip. This choice retains a 22-package,
500
514
  1.9 MB unpacked d3 install closure in exchange for smaller common application
501
515
  graphs and an ordinary dependency contract. The checked policy is
502
516
  `npm run check:d3-packaging`; the reproducible evidence is in
@@ -625,11 +639,22 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
625
639
  | **`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
640
  | **`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
641
  | **`applyTheme`** | List named theme presets or return ThemeProvider/CSS/token usage for a preset such as `{ name: "tufte" }`. |
642
+ | **`auditArtifact`** | Evaluate an explicit artifact contract under a named policy without inferring missing source, review, or timing facts. |
643
+ | **`recommendRepresentation`** | Compare chart and non-chart outcomes against supplied data, claims, evidence, time state, and policy requirements. |
644
+ | **`repairArtifact`** | Propose contract repairs and optionally fill missing identity fields; existing mismatches require a revision and claim reassessment. |
645
+ | **`explainRefusal`** | Explain which explicit policy obligations prevent publication or action and identify safe follow-up work. |
646
+
647
+ Artifact tools are opt-in diagnostics, not publication authorization. A
648
+ `conditional` result (including CLI exit code 0) retains open work. Ordinary
649
+ `renderChart` calls do not enforce artifact policy; governed hosts must enforce
650
+ their own release boundary. Manual-check resolution and revision-bound release
651
+ approval remain separate host workflow work.
628
652
 
629
653
  ### Resources
630
654
 
631
655
  | Resource | Description |
632
656
  |----------|-------------|
657
+ | **`semiotic://artifact-contract-schema`** | Standalone JSON Schema for portable purpose, claim, evidence, timing, review, and transfer metadata. |
633
658
  | **`semiotic://schema`** | Full machine-readable component schema JSON. |
634
659
  | **`semiotic://schema-index`** | Compact discovery index with categories, renderability, import paths, and each component's schema resource URI. |
635
660
  | **`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