semiotic 3.9.0 → 3.9.2

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 (331) hide show
  1. package/README.md +102 -90
  2. package/agent-skill/semiotic-charts/SKILL.md +14 -10
  3. package/ai/componentMetadata.cjs +13 -3
  4. package/ai/dist/mcp-server.js +140 -36407
  5. package/ai/examples.md +109 -6
  6. package/ai/reference.md +55 -18
  7. package/ai/schema.json +5964 -1190
  8. package/ai/surface-manifest.json +51 -7
  9. package/ai/system-prompt.md +16 -3
  10. package/dist/c-3SCUN5HI.min.js +1 -0
  11. package/dist/c-3VVKFA4M.min.js +1 -0
  12. package/dist/c-43TJZS3F.min.js +1 -0
  13. package/dist/c-4DTZPSUD.min.js +1 -0
  14. package/dist/c-4ES5367Y.min.js +1 -0
  15. package/dist/c-54IRWOGM.min.js +1 -0
  16. package/dist/c-5D2S4RMI.min.js +1 -0
  17. package/dist/c-5JWCTX3G.min.js +1 -0
  18. package/dist/c-6CMMSN6N.min.js +1 -0
  19. package/dist/c-6HRB2L7H.min.js +1 -0
  20. package/dist/c-7W4SV36A.min.js +1 -0
  21. package/dist/c-A4WRGZFX.min.js +1 -0
  22. package/dist/c-AG7WWVIH.min.js +1 -0
  23. package/dist/c-AH6J4MTN.min.js +1 -0
  24. package/dist/c-ALYR5LKK.min.js +1 -0
  25. package/dist/c-BYDPC44I.min.js +1 -0
  26. package/dist/c-CFFIU2MW.min.js +1 -0
  27. package/dist/c-CGNHBHCE.min.js +1 -0
  28. package/dist/c-CJYSXIFV.min.js +1 -0
  29. package/dist/c-CKLIFCGN.min.js +1 -0
  30. package/dist/c-CZF7MV67.min.js +1 -0
  31. package/dist/c-D53OKBSY.min.js +1 -0
  32. package/dist/c-DBQ2V7CH.min.js +1 -0
  33. package/dist/c-DPMVAUAW.min.js +1 -0
  34. package/dist/c-ECJCKLYY.min.js +1 -0
  35. package/dist/c-EGATGOWJ.min.js +1 -0
  36. package/dist/c-EGR6VYBW.min.js +1 -0
  37. package/dist/c-ENF72HU5.min.js +1 -0
  38. package/dist/c-ESNR43AN.min.js +1 -0
  39. package/dist/c-F3LIKINL.min.js +1 -0
  40. package/dist/c-F5ZB5GJ6.min.js +1 -0
  41. package/dist/c-G3VYMHKE.min.js +1 -0
  42. package/dist/c-GR6MOEQC.min.js +1 -0
  43. package/dist/c-GSVCN34B.min.js +1 -0
  44. package/dist/c-GYOQCEFP.min.js +1 -0
  45. package/dist/c-H3DNMTCC.min.js +1 -0
  46. package/dist/c-I6J3FEZE.min.js +1 -0
  47. package/dist/c-IGH6MGJ5.min.js +1 -0
  48. package/dist/c-II2EEAJN.min.js +1 -0
  49. package/dist/c-J6M4JHRS.min.js +1 -0
  50. package/dist/c-JM3MGLQV.min.js +1 -0
  51. package/dist/c-KM3N7F7R.min.js +1 -0
  52. package/dist/c-LF5BZFNC.min.js +1 -0
  53. package/dist/c-LKBSGFQC.min.js +1 -0
  54. package/dist/c-NDJADPIF.min.js +1 -0
  55. package/dist/c-NVPQCIL5.min.js +1 -0
  56. package/dist/c-OFWJBEE5.min.js +1 -0
  57. package/dist/c-OYFHP5F5.min.js +1 -0
  58. package/dist/c-PGKQGGQ2.min.js +1 -0
  59. package/dist/c-Q2IPZ3MU.min.js +1 -0
  60. package/dist/c-QKHMBE2E.min.js +1 -0
  61. package/dist/c-QMVM3AY6.min.js +1 -0
  62. package/dist/c-QSGWX53A.min.js +1 -0
  63. package/dist/c-RJKEKZOO.min.js +1 -0
  64. package/dist/c-SFDIIU5G.min.js +1 -0
  65. package/dist/c-SRTBCRVE.min.js +1 -0
  66. package/dist/c-T6UAIKBH.min.js +1 -0
  67. package/dist/c-TMCTEVVW.min.js +1 -0
  68. package/dist/c-TMOSJLT3.min.js +1 -0
  69. package/dist/c-U6ESPM7V.min.js +1 -0
  70. package/dist/c-UC5PTTFI.min.js +1 -0
  71. package/dist/c-VGKUEZBC.min.js +1 -0
  72. package/dist/c-VN2HG5BS.min.js +1 -0
  73. package/dist/{c-J5G56TUH.min.js → c-VPZDY5Q4.min.js} +1 -1
  74. package/dist/c-VRXUB2F2.min.js +1 -0
  75. package/dist/c-VUBQNQJH.min.js +1 -0
  76. package/dist/c-VUH4PGZY.min.js +1 -0
  77. package/dist/c-XDRV7RKW.min.js +1 -0
  78. package/dist/c-YGZHURXZ.min.js +1 -0
  79. package/dist/components/Annotation.d.ts +1 -1
  80. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  81. package/dist/components/access/chartAccessContract.d.ts +90 -0
  82. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  83. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  84. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  85. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  86. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  87. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  88. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  89. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  90. package/dist/components/ai/chartRecipeRegistry.d.ts +2 -1
  91. package/dist/components/ai/chartRecipes.d.ts +6 -0
  92. package/dist/components/ai/colorEvidence.d.ts +12 -0
  93. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  94. package/dist/components/ai/geoNavigation.d.ts +4 -0
  95. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  96. package/dist/components/ai/navigationTree.d.ts +7 -1
  97. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  98. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  99. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  100. package/dist/components/charts/index.d.ts +4 -0
  101. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  102. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  103. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  104. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  105. package/dist/components/charts/network/Treemap.d.ts +8 -1
  106. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  107. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  108. package/dist/components/charts/ordinal/DonutChart.d.ts +3 -0
  109. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  110. package/dist/components/charts/ordinal/FunnelChart.d.ts +3 -0
  111. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  112. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  113. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  114. package/dist/components/charts/ordinal/PieChart.d.ts +3 -0
  115. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  116. package/dist/components/charts/ordinal/RadarChart.d.ts +75 -0
  117. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  118. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  119. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  120. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  121. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  122. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  123. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  124. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  125. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +10 -1
  126. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +11 -1
  127. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +14 -5
  128. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +7 -1
  129. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
  130. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  131. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +4 -2
  132. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  133. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  134. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  135. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  136. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  137. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  138. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  139. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  140. package/dist/components/charts/shared/types.d.ts +4 -2
  141. package/dist/components/charts/shared/useChartLegend.d.ts +2 -1
  142. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  143. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  144. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  145. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  146. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  147. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  148. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  149. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  150. package/dist/components/charts/xy/WaterfallChart.d.ts +68 -0
  151. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +146 -0
  152. package/dist/components/evidence/evidenceGate.d.ts +28 -0
  153. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  154. package/dist/components/realtime/types.d.ts +16 -7
  155. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  156. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  157. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  158. package/dist/components/recipes/lineageDag.d.ts +17 -0
  159. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  160. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  161. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  162. package/dist/components/semiotic-access.d.ts +9 -0
  163. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  164. package/dist/components/semiotic-ai-core.d.ts +9 -0
  165. package/dist/components/semiotic-ai.d.ts +5 -17
  166. package/dist/components/semiotic-evidence.d.ts +10 -0
  167. package/dist/components/semiotic-line.d.ts +9 -0
  168. package/dist/components/semiotic-network.d.ts +3 -0
  169. package/dist/components/semiotic-ordinal.d.ts +2 -0
  170. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  171. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  172. package/dist/components/semiotic-themes-core.d.ts +3 -0
  173. package/dist/components/semiotic-utils-core.d.ts +5 -0
  174. package/dist/components/semiotic-utils.d.ts +1 -1
  175. package/dist/components/semiotic-xy.d.ts +3 -0
  176. package/dist/components/semiotic.d.ts +9 -3
  177. package/dist/components/server/renderDashboard.d.ts +37 -0
  178. package/dist/components/server/renderEvidence.d.ts +27 -0
  179. package/dist/components/server/renderToStaticSVG.d.ts +2 -30
  180. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  181. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  182. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  183. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  184. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  185. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  186. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  187. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  188. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  189. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  190. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  191. package/dist/components/store/selectionProvenance.d.ts +8 -0
  192. package/dist/components/store/themeCore.d.ts +5 -1
  193. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  194. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  195. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  196. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  197. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  198. package/dist/components/stream/PipelineStore.d.ts +1 -1
  199. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  200. package/dist/components/stream/canvasSetup.d.ts +8 -2
  201. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  202. package/dist/components/stream/geoTypes.d.ts +1 -1
  203. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  204. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  205. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  206. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  207. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  208. package/dist/components/stream/layouts/index.d.ts +6 -12
  209. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  210. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  211. package/dist/components/stream/layouts/registry.d.ts +12 -0
  212. package/dist/components/stream/marginalConfig.d.ts +3 -0
  213. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  214. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  215. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  216. package/dist/components/stream/networkTypes.d.ts +5 -1
  217. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  218. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +1 -1
  219. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  220. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  221. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  222. package/dist/components/stream/types.d.ts +8 -1
  223. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  224. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  225. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  226. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  227. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  228. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  229. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  230. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  231. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  232. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  233. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  234. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  235. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  236. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  237. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  238. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  239. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  240. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  241. package/dist/forceLayoutWorker.js +1 -1
  242. package/dist/geo.min.js +1 -1
  243. package/dist/geo.module.min.js +1 -1
  244. package/dist/network.module.min.js +1 -1
  245. package/dist/ordinal.module.min.js +1 -1
  246. package/dist/physics.module.min.js +1 -1
  247. package/dist/rough.module.min.js +1 -1
  248. package/dist/semiotic-access.d.ts +9 -0
  249. package/dist/semiotic-access.min.js +2 -0
  250. package/dist/semiotic-access.module.min.js +2 -0
  251. package/dist/semiotic-ai-core.d.ts +9 -0
  252. package/dist/semiotic-ai-core.min.js +1 -1
  253. package/dist/semiotic-ai-core.module.min.js +1 -1
  254. package/dist/semiotic-ai.d.ts +5 -17
  255. package/dist/semiotic-ai.module.min.js +1 -1
  256. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  257. package/dist/semiotic-client-shared.module.min.js +1 -1
  258. package/dist/semiotic-evidence.d.ts +10 -0
  259. package/dist/semiotic-evidence.min.js +1 -0
  260. package/dist/semiotic-evidence.module.min.js +1 -0
  261. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  262. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  263. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  264. package/dist/semiotic-experimental-vacp.min.js +1 -1
  265. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  266. package/dist/semiotic-line.d.ts +9 -0
  267. package/dist/semiotic-line.min.js +2 -0
  268. package/dist/semiotic-line.module.min.js +2 -0
  269. package/dist/semiotic-network.d.ts +3 -0
  270. package/dist/semiotic-ordinal.d.ts +2 -0
  271. package/dist/semiotic-realtime-core.d.ts +3 -2
  272. package/dist/semiotic-realtime-core.module.min.js +1 -1
  273. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  274. package/dist/semiotic-recipes-core.d.ts +6 -0
  275. package/dist/semiotic-recipes-core.module.min.js +1 -1
  276. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  277. package/dist/semiotic-server-edge.min.js +1 -1
  278. package/dist/semiotic-server-edge.module.min.js +1 -1
  279. package/dist/semiotic-server-node.min.js +1 -1
  280. package/dist/semiotic-server-node.module.min.js +1 -1
  281. package/dist/semiotic-themes-core.d.ts +3 -0
  282. package/dist/semiotic-themes-core.min.js +1 -1
  283. package/dist/semiotic-themes-core.module.min.js +1 -1
  284. package/dist/semiotic-themes.min.js +1 -1
  285. package/dist/semiotic-themes.module.min.js +1 -1
  286. package/dist/semiotic-utils-core.d.ts +5 -0
  287. package/dist/semiotic-utils-core.min.js +1 -1
  288. package/dist/semiotic-utils-core.module.min.js +1 -1
  289. package/dist/semiotic-utils.d.ts +1 -1
  290. package/dist/semiotic-utils.module.min.js +1 -1
  291. package/dist/semiotic-xy.d.ts +3 -0
  292. package/dist/semiotic.d.ts +9 -3
  293. package/dist/semiotic.module.min.js +1 -1
  294. package/dist/server.min.js +1 -1
  295. package/dist/server.module.min.js +1 -1
  296. package/dist/xy.module.min.js +1 -1
  297. package/package.json +39 -60
  298. package/dist/c-3KZD6AXJ.min.js +0 -1
  299. package/dist/c-4TWEX5HG.min.js +0 -1
  300. package/dist/c-5YCIX3VZ.min.js +0 -1
  301. package/dist/c-6FEKTA3U.min.js +0 -1
  302. package/dist/c-74HEEZGK.min.js +0 -1
  303. package/dist/c-BWNB6USU.min.js +0 -1
  304. package/dist/c-C25ENHIK.min.js +0 -1
  305. package/dist/c-CDR5AO3R.min.js +0 -1
  306. package/dist/c-E3JFRRMI.min.js +0 -1
  307. package/dist/c-EBFPQHHO.min.js +0 -1
  308. package/dist/c-GIKRQI4X.min.js +0 -1
  309. package/dist/c-GPYOFETM.min.js +0 -1
  310. package/dist/c-IDUHYYSI.min.js +0 -1
  311. package/dist/c-JAZ73J32.min.js +0 -1
  312. package/dist/c-KG3NXHAL.min.js +0 -1
  313. package/dist/c-KII3PLZE.min.js +0 -1
  314. package/dist/c-LIXGXMNS.min.js +0 -1
  315. package/dist/c-LVEY6D6B.min.js +0 -1
  316. package/dist/c-M4Y3BHFR.min.js +0 -1
  317. package/dist/c-MAIICR2Z.min.js +0 -1
  318. package/dist/c-MG5DM6VE.min.js +0 -1
  319. package/dist/c-O6U6K4CW.min.js +0 -1
  320. package/dist/c-OQ7M4AGV.min.js +0 -1
  321. package/dist/c-OXYMVK7Q.min.js +0 -1
  322. package/dist/c-QHF5YON3.min.js +0 -1
  323. package/dist/c-RR3GO5SW.min.js +0 -1
  324. package/dist/c-S2BXNNJN.min.js +0 -1
  325. package/dist/c-SUILCHWU.min.js +0 -1
  326. package/dist/c-US5ZFT6E.min.js +0 -1
  327. package/dist/c-UUKVD4WB.min.js +0 -1
  328. package/dist/c-WJCD5EUY.min.js +0 -1
  329. package/dist/c-YDAY2WFR.min.js +0 -1
  330. package/dist/c-ZOWWU34K.min.js +0 -1
  331. /package/dist/{c-COHXCW3Q.min.js → c-YZVRZGX2.min.js} +0 -0
package/README.md CHANGED
@@ -17,54 +17,31 @@ AI coding assistants generate correct chart code on the first try.
17
17
  <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
18
  <!-- semiotic-readme-dashboard:end -->
19
19
 
20
- ## What's New in 3.9.0
21
-
22
- 3.9.0 closes renderer and API gaps while making chart interaction easier to express:
23
-
24
- - Retained mark styles accept datum-specific CSS cursors across canvas, SVG, and static rendering;
25
- realtime chart HOCs also accept a top-level cursor default, including `TemporalHistogram`.
26
- Cursor presentation stays separate from click and keyboard behavior so applications keep control
27
- of interaction semantics.
28
- - Realtime charts now share the generic typing, accessibility metadata, loading/empty states,
29
- legends, selection, linked-hover, and observation contracts of the high-level chart families;
30
- RealtimeLineChart also supports bounded event-time reordering, window aggregation, and explicit
31
- end-of-stream flushing.
32
- - Static rendering gains OrbitDiagram plus broad client-parity fixes for grouped XY data, custom
33
- layouts, geo flows, gradients, background layers, empty scenes, and zero-valued network edges.
34
- - New observation, tooltip, snapshot-flow, network hit-target, responsive, and theme-CSS helpers
35
- are public, while stricter package, API, performance, docs, npm, Cloud Run, and MCP Registry
36
- gates protect the release artifact end to end.
37
- - `evaluateChart` now combines data-contract, representation, accessibility, and optional
38
- render-evidence findings for the AI API, CLI, and MCP server. AI descriptions also distinguish
39
- value components such as `BigNumber` from chart HOCs, and CommonJS recipe imports keep their
40
- geographic dependencies lazy.
41
- - Side legends reserve their focus-ring clearance consistently in browser and static output; use
42
- the typed `frameProps.legendLayout.edgeGutter` to tune that clearance when necessary.
43
-
44
- ```jsx
45
- import { ForceDirectedGraph } from "semiotic/network"
46
-
47
- <ForceDirectedGraph
48
- nodes={nodes}
49
- edges={edges}
50
- styleRules={[
51
- { when: node => Boolean(node.url), style: { cursor: "pointer" } }
52
- ]}
53
- onClick={node => node?.url && openNode(node.url)}
54
- />
55
- ```
56
-
57
- Simple charts stay five lines:
58
-
59
- ```jsx
60
- import { LineChart } from "semiotic/xy"
61
-
62
- <LineChart
63
- data={salesData}
64
- xAccessor="month"
65
- yAccessor="revenue"
66
- />
67
- ```
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.
68
45
 
69
46
  ## Why Semiotic
70
47
 
@@ -79,7 +56,7 @@ generate correct code without examples.
79
56
  Semiotic ships with everything an AI coding assistant needs to generate
80
57
  correct visualizations without trial and error:
81
58
 
82
- - **`semiotic/ai`** — a single import with the schema-backed chart capability catalog (XY, ordinal, network, realtime, geo, value), 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.
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.
83
60
  - **`ai/schema.json`** — machine-readable prop schemas for every component
84
61
  - **`npx semiotic-mcp`** — an MCP server for tool-based chart rendering in any MCP client
85
62
  - **`npx semiotic-ai --doctor`** — validate component + props JSON from the command line with typo suggestions and anti-pattern detection
@@ -147,6 +124,11 @@ needs to communicate more than its encoding alone.
147
124
  | **Charts** | Common chart forms with chart-level props | `<LineChart data={d} xAccessor="x" yAccessor="y" />` |
148
125
  | **Frames** | Full control over rendering, interaction, and layout | `<StreamXYFrame chartType="line" lineStyle={...} />` |
149
126
 
127
+ Chart HOCs register only the mark plugins they need. Direct `StreamXYFrame`
128
+ loads the remaining built-ins on first client paint. Call
129
+ `registerBuiltInXYPlugins()` from `semiotic/xy` or `semiotic/realtime/core`
130
+ before the first render when SSR or the first frame must include marks.
131
+
150
132
  Every Chart component accepts a `frameProps` prop to access the underlying
151
133
  Frame API without leaving the simpler interface.
152
134
 
@@ -410,7 +392,7 @@ loadConversationArc(sink.load(), { enabled: false })
410
392
 
411
393
  ## Bundle Sizes
412
394
 
413
- Semiotic ships 17 stable module entry points. **Don't import from `"semiotic"` unless you need everything** — use the sub-path that matches your chart type.
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.
414
396
 
415
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.
416
398
 
@@ -419,35 +401,38 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
419
401
 
420
402
  | Entry Point | gzip | What's inside |
421
403
  |---|---|---|
422
- | `semiotic/xy` | **152 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
423
- | `semiotic/ordinal` | **128 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
424
- | `semiotic/network` | **149 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
425
- | `semiotic/geo` | **109 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
426
- | `semiotic/realtime` | **163 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
427
- | `semiotic/realtime/core` | **162 KB** | Streaming chart types, HOCs, and buffer helpers |
404
+ | `semiotic/access` | **35 KB** | Chart Access Contract factory and first-wave baseline contracts |
405
+ | `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 |
428
413
  | `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
429
- | `semiotic/server` | **195 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
430
- | `semiotic/server/node` | **195 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
431
- | `semiotic/server/edge` | **200 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
432
- | `semiotic/utils` | **93 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
433
- | `semiotic/utils/core` | **86 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
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 |
434
419
  | `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
435
- | `semiotic/recipes` | **94 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
436
- | `semiotic/recipes/core` | **86 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
437
- | `semiotic/recipes/react` | **7 KB** | Glyph and React layout-selection helpers |
438
- | `semiotic/themes` | **6 KB** | Theme presets only (tufte, carbon, etc.) |
439
- | `semiotic/themes/core` | **6 KB** | Theme presets and token helpers |
440
- | `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
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, …) |
422
+ | `semiotic/recipes/react` | **8 KB** | Glyph and React layout-selection helpers |
423
+ | `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
424
+ | `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
425
+ | `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
441
426
  | `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
442
427
  | `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
443
- | `semiotic/physics` | **164 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
428
+ | `semiotic/physics` | **168 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
444
429
  | `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
445
430
  | `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
446
- | `semiotic/ai` | **520 KB** | All schema-backed charts + validation — optimized for LLM code generation |
447
- | `semiotic/ai/core` | **87 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — 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 |
448
433
  | `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
449
434
  | `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
450
- | `semiotic` | **334 KB** | Everything below (full bundle) |
435
+ | `semiotic` | **360 KB** | Everything below (full bundle) |
451
436
 
452
437
  <!-- semiotic-bundle-sizes:end -->
453
438
 
@@ -468,38 +453,57 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
468
453
 
469
454
  | Public named import | Runtime | gzip cold-consumer bundle |
470
455
  |---|---:|---:|
471
- | `import { LineChart } from "semiotic"` | browser | **162.5 KiB** |
472
- | `import { LineChart } from "semiotic/xy"` | browser | **162.2 KiB** |
473
- | `import { BarChart } from "semiotic/ordinal"` | browser | **130.5 KiB** |
474
- | `import { SankeyDiagram } from "semiotic/network"` | browser | **152.7 KiB** |
475
- | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **135.4 KiB** |
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** |
476
462
  | `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
477
463
  | `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
478
- | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.2 KiB** |
464
+ | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **150.3 KiB** |
479
465
  | `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
480
466
  | `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
481
- | `import { renderChart } from "semiotic/server"` | node | **243.2 KiB** |
482
- | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.5 KiB** |
483
- | `import { renderToImage } from "semiotic/server/node"` | node | **243.6 KiB** |
484
- | `import { suggestCharts } from "semiotic/ai"` | browser | **239.2 KiB** |
485
- | `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.1 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** |
486
474
  | `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
487
- | `import { ChoroplethMap } from "semiotic/geo"` | browser | **114.6 KiB** |
475
+ | `import { ChoroplethMap } from "semiotic/geo"` | browser | **115.5 KiB** |
488
476
  | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
489
477
  | `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
490
478
  | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
491
- | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.1 KiB** |
492
- | `import { validateProps } from "semiotic/utils"` | browser | **9.1 KiB** |
493
- | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **6.8 KiB** |
494
- | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.3 KiB** |
495
- | `import { waffleLayout } from "semiotic/recipes"` | browser | **2.9 KiB** |
496
- | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.9 KiB** |
479
+ | `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** |
482
+ | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
483
+ | `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
484
+ | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
497
485
  | `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** |
498
486
  | `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
499
487
  | `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
500
488
 
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%.
490
+
501
491
  <!-- semiotic-cold-consumer:end -->
502
492
 
493
+ **d3 packaging model:** Semiotic externalizes the twelve d3 modules it imports
494
+ and declares them as normal runtime dependencies. Consumers do not need to
495
+ install d3 packages manually; their bundler resolves, deduplicates, and
496
+ tree-shakes that dependency graph. A packed webpack comparison favored this
497
+ 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,
500
+ 1.9 MB unpacked d3 install closure in exchange for smaller common application
501
+ graphs and an ordinary dependency contract. The checked policy is
502
+ `npm run check:d3-packaging`; the reproducible evidence is in
503
+ `benchmarks/setup/d3-packaging.json` and can be regenerated with
504
+ `npm run measure:d3-packaging -- --toolchain-root <dir>` after installing
505
+ webpack and Next in that isolated toolchain directory.
506
+
503
507
  ```jsx
504
508
  // Import from the sub-path, not from "semiotic"
505
509
  import { LineChart } from "semiotic/xy"
@@ -512,6 +516,12 @@ import { ChoroplethMap } from "semiotic/geo"
512
516
 
513
517
  **When to use `"semiotic"`**: Fine when you want one import for mixed families. Shared chunks prevent duplicated runtime code across family subpaths; the cold-consumer table above is the better guide for a single named import.
514
518
 
519
+ **CommonJS compatibility note:** `require("semiotic/xy")` loads the shared
520
+ CommonJS client bundle (about 2.1 MB before compression) so React contexts stay
521
+ singletons across family imports. Prefer ESM imports in browser builds when
522
+ bundle size matters; splitting that CJS client without a context-identity
523
+ contract would be unsafe.
524
+
515
525
  ## TypeScript
516
526
 
517
527
  Built with `strict: true`. Full type definitions ship with the package.
@@ -621,7 +631,9 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
621
631
  | Resource | Description |
622
632
  |----------|-------------|
623
633
  | **`semiotic://schema`** | Full machine-readable component schema JSON. |
624
- | **`semiotic://components`** | Component index showing renderable/browser-only status and MCP categories. |
634
+ | **`semiotic://schema-index`** | Compact discovery index with categories, renderability, import paths, and each component's schema resource URI. |
635
+ | **`semiotic://schema/{component}`** | One component's schema, metadata, accessibility guidance, and behavior contracts (for example `semiotic://schema/LineChart`). |
636
+ | **`semiotic://components`** | Backward-compatible component index showing renderable/browser-only status and MCP categories. |
625
637
  | **`semiotic://surface-manifest`** | Generated inventory of the current AI schema, exports, renderability, tools, resources, and prompts. |
626
638
  | **`semiotic://behavior-contracts`** | Agent-visible semantic rules for color precedence, required prop combinations, push refs, and renderability. |
627
639
  | **`semiotic://system-prompt`** | Compact AI instructions with import rules, chart props, SSR guidance, and pitfalls. |
@@ -16,11 +16,12 @@ validated and diagnosed; when a renderer is available, proven to paint. Otherwis
16
16
 
17
17
  ## Context discipline
18
18
 
19
- Start with the task and the exact component schema. Use the MCP `getSchema` tool
20
- or `npx semiotic-ai --schema <Component>`, then read one nearby example if
21
- needed. Do not load the full reference, schema, or example catalog by default;
22
- retrieve broader context only when validation or diagnosis shows that it is
23
- necessary.
19
+ Start with the task and the exact component schema. Use the MCP `getSchema` tool,
20
+ read `semiotic://schema/{component}`, or run
21
+ `npx semiotic-ai --schema <Component>`, then read one nearby example if needed.
22
+ Use `semiotic://schema-index` when the component is not known. Do not load the
23
+ full reference, schema, or example catalog by default; retrieve broader context
24
+ only when validation or diagnosis shows that it is necessary.
24
25
 
25
26
  ## The trust loop — generate → validate → diagnose → repair → prove
26
27
 
@@ -76,10 +77,13 @@ const ranked = suggestCharts(data, { intent: "trend", maxResults: 3, audience })
76
77
  These are enforced by validation and the `npx semiotic-ai --doctor` gate. Honor
77
78
  them in every proposal:
78
79
 
79
- 1. **Sub-path imports.** Import from the family entry point, not the barrel:
80
- `semiotic/xy`, `semiotic/ordinal`, `semiotic/network`, `semiotic/geo`,
81
- `semiotic/realtime`, `semiotic/ai`. The full `semiotic` is large; a family
82
- entry point is a fraction of it.
80
+ 1. **Sub-path imports.** Import from the smallest stable entry that covers every
81
+ chart in the route, never the barrel: use `semiotic/line` when `LineChart`
82
+ is the only XY chart; otherwise use family entries such as `semiotic/xy`,
83
+ `semiotic/ordinal`, `semiotic/network`, `semiotic/geo`, `semiotic/realtime`,
84
+ or `semiotic/ai`. Family entries avoid loading other families and the
85
+ AI/server surfaces; they do not necessarily exclude unused marks within their
86
+ own family.
83
87
  2. **Static usage requires data in props.** `renderChart`, SSR snapshots, and any
84
88
  copy-paste example need `data` (or `nodes`/`edges`) present.
85
89
  3. **Push (live) mode omits `data` entirely.** Create a ref, do NOT pass
@@ -102,7 +106,7 @@ them in every proposal:
102
106
  ## What good output looks like
103
107
 
104
108
  ```tsx
105
- import { LineChart } from "semiotic/xy"
109
+ import { LineChart } from "semiotic/line"
106
110
 
107
111
  <LineChart
108
112
  data={series}
@@ -1,17 +1,17 @@
1
1
  "use strict"
2
2
 
3
- const CATEGORY_ORDER = ["xy", "ordinal", "network", "geo", "realtime", "physics", "value"]
3
+ const CATEGORY_ORDER = ["xy", "ordinal", "network", "geo", "realtime", "physics", "value", "recipe"]
4
4
 
5
5
  const COMPONENTS_BY_CATEGORY = {
6
6
  xy: [
7
7
  "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "QuadrantChart",
8
8
  "MultiAxisLineChart", "CandlestickChart", "BubbleChart", "Heatmap",
9
- "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart",
9
+ "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "WaterfallChart",
10
10
  ],
11
11
  ordinal: [
12
12
  "BarChart", "StackedBarChart", "LikertChart", "GroupedBarChart", "SwarmPlot",
13
13
  "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart",
14
- "DonutChart", "GaugeChart", "FunnelChart", "SwimlaneChart",
14
+ "DonutChart", "GaugeChart", "FunnelChart", "RadarChart", "SwimlaneChart",
15
15
  ],
16
16
  network: [
17
17
  "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram",
@@ -32,6 +32,9 @@ const COMPONENTS_BY_CATEGORY = {
32
32
  value: [
33
33
  "BigNumber",
34
34
  ],
35
+ recipe: [
36
+ "ParallelCoordinatesRecipe", "CalendarHeatmapRecipe",
37
+ ],
35
38
  }
36
39
 
37
40
  const COMPONENT_TO_CATEGORY = new Map()
@@ -67,9 +70,14 @@ function categoryForAIExport(name) {
67
70
 
68
71
  function importPathForCategory(category) {
69
72
  if (category === "physics") return "semiotic/physics"
73
+ if (category === "recipe") return "semiotic/ai"
70
74
  return category === "geo" ? "semiotic/geo" : `semiotic/${category}`
71
75
  }
72
76
 
77
+ function schemaResourceUriForComponent(name) {
78
+ return `semiotic://schema/${encodeURIComponent(name)}`
79
+ }
80
+
73
81
  function metadataForComponent(entryOrName) {
74
82
  const name = typeof entryOrName === "string" ? entryOrName : entryOrName.name
75
83
  const category = categoryForComponent(name)
@@ -84,6 +92,7 @@ function metadataForComponent(entryOrName) {
84
92
  name,
85
93
  category,
86
94
  importPath: importPathForCategory(category),
95
+ schemaResourceUri: schemaResourceUriForComponent(name),
87
96
  renderable: !isPushOnly,
88
97
  requiresLiveData: isPushOnly,
89
98
  description: typeof entryOrName === "string" ? undefined : entryOrName.description,
@@ -134,5 +143,6 @@ module.exports = {
134
143
  findComponent,
135
144
  importPathForCategory,
136
145
  metadataForComponent,
146
+ schemaResourceUriForComponent,
137
147
  schemaEntries,
138
148
  }