semiotic 3.8.9 → 3.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/README.md +55 -81
  2. package/agent-skill/semiotic-charts/SKILL.md +11 -2
  3. package/ai/behaviorContracts.cjs +33 -3
  4. package/ai/cli.js +53 -2
  5. package/ai/componentMetadata.cjs +15 -0
  6. package/ai/dist/mcp-server.js +1530 -611
  7. package/ai/examples.md +48 -42
  8. package/{CLAUDE.md → ai/reference.md} +43 -22
  9. package/ai/schema.json +10603 -986
  10. package/ai/surface-manifest.json +643 -2
  11. package/ai/system-prompt.md +83 -130
  12. package/dist/c-3BLJEQNG.min.js +1 -0
  13. package/dist/c-3KZD6AXJ.min.js +1 -0
  14. package/dist/c-4TWEX5HG.min.js +1 -0
  15. package/dist/c-52TEGIUJ.min.js +1 -0
  16. package/dist/c-5YCIX3VZ.min.js +1 -0
  17. package/dist/c-6FEKTA3U.min.js +1 -0
  18. package/dist/c-6O5EVOPH.min.js +1 -0
  19. package/dist/c-74HEEZGK.min.js +1 -0
  20. package/dist/c-AKAF6JAD.min.js +1 -0
  21. package/dist/c-BBKITSXB.min.js +1 -0
  22. package/dist/c-BWNB6USU.min.js +1 -0
  23. package/dist/c-C25ENHIK.min.js +1 -0
  24. package/dist/c-CDR5AO3R.min.js +1 -0
  25. package/dist/c-COHXCW3Q.min.js +1 -0
  26. package/dist/{chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js → c-DADXPJXV.min.js} +0 -1
  27. package/dist/c-E3JFRRMI.min.js +1 -0
  28. package/dist/c-EBFPQHHO.min.js +1 -0
  29. package/dist/c-G36WS6LN.min.js +1 -0
  30. package/dist/c-GIKRQI4X.min.js +1 -0
  31. package/dist/c-GPYOFETM.min.js +1 -0
  32. package/dist/c-IDUHYYSI.min.js +1 -0
  33. package/dist/{chunk-chunk-FQPKOAIH.module.min.js → c-IUHFPMHD.min.js} +0 -1
  34. package/dist/c-J5G56TUH.min.js +1 -0
  35. package/dist/c-JAZ73J32.min.js +1 -0
  36. package/dist/c-KG3NXHAL.min.js +1 -0
  37. package/dist/c-KII3PLZE.min.js +1 -0
  38. package/dist/c-LIXGXMNS.min.js +1 -0
  39. package/dist/c-LVEY6D6B.min.js +1 -0
  40. package/dist/c-M4Y3BHFR.min.js +1 -0
  41. package/dist/c-MAIICR2Z.min.js +1 -0
  42. package/dist/c-MG5DM6VE.min.js +1 -0
  43. package/dist/{chunk-minimapBrushOverlay-JU57U7NM.module.min.js → c-MNF2S4AA.min.js} +0 -1
  44. package/dist/c-MT3WBK7M.min.js +1 -0
  45. package/dist/c-NY3JWV2K.min.js +1 -0
  46. package/dist/c-O6U6K4CW.min.js +1 -0
  47. package/dist/c-OCI56QF2.min.js +1 -0
  48. package/dist/c-OQ7M4AGV.min.js +1 -0
  49. package/dist/c-OXYMVK7Q.min.js +1 -0
  50. package/dist/c-PPWDL5ZI.min.js +1 -0
  51. package/dist/c-QHF5YON3.min.js +1 -0
  52. package/dist/c-RR3GO5SW.min.js +1 -0
  53. package/dist/{chunk-chunk-J5QD4RAM.module.min.js → c-RSVIHIQ4.min.js} +0 -1
  54. package/dist/{chunk-chunk-EMO5NUGE.module.min.js → c-S2BXNNJN.min.js} +0 -1
  55. package/dist/{chunk-chunk-YCQYG6J5.module.min.js → c-SLGMUBUL.min.js} +0 -1
  56. package/dist/c-SUILCHWU.min.js +1 -0
  57. package/dist/c-TZW3JGJ5.min.js +1 -0
  58. package/dist/c-US5ZFT6E.min.js +1 -0
  59. package/dist/{chunk-chunk-RZH7VZYS.module.min.js → c-USFMFKIH.min.js} +0 -1
  60. package/dist/c-UUKVD4WB.min.js +1 -0
  61. package/dist/{chunk-chunk-SV4XAZ3Q.module.min.js → c-VGW3VG3I.min.js} +0 -1
  62. package/dist/c-W3CE4A4S.min.js +1 -0
  63. package/dist/{chunk-chunk-2NVFEB7P.module.min.js → c-WJCD5EUY.min.js} +0 -1
  64. package/dist/{chunk-chunk-2JGJ5GUG.module.min.js → c-X5UBGU2V.min.js} +0 -1
  65. package/dist/c-YDAY2WFR.min.js +1 -0
  66. package/dist/c-ZOWWU34K.min.js +1 -0
  67. package/dist/components/AccessibleNavTree.d.ts +1 -1
  68. package/dist/components/CategoryColors.d.ts +1 -1
  69. package/dist/components/GradientLegend.d.ts +14 -0
  70. package/dist/components/Legend.d.ts +2 -7
  71. package/dist/components/LinkedCharts.d.ts +1 -1
  72. package/dist/components/MobileAnnotationCalloutList.d.ts +1 -1
  73. package/dist/components/ObservationReadout.d.ts +45 -0
  74. package/dist/components/ThemeProvider.d.ts +4 -4
  75. package/dist/components/Tooltip/FlippingTooltip.d.ts +5 -7
  76. package/dist/components/Tooltip/Tooltip.d.ts +30 -5
  77. package/dist/components/Tooltip/tooltipChrome.d.ts +43 -0
  78. package/dist/components/ai/chartCapabilityTypes.d.ts +86 -2
  79. package/dist/components/ai/chartClinic.d.ts +2 -0
  80. package/dist/components/ai/deriveProfileFields.d.ts +40 -0
  81. package/dist/components/ai/evaluateChart.d.ts +85 -0
  82. package/dist/components/ai/fieldPolicy.d.ts +7 -0
  83. package/dist/components/ai/fieldRoles.d.ts +24 -0
  84. package/dist/components/ai/generativeChart.d.ts +18 -2
  85. package/dist/components/ai/inferIntent.d.ts +26 -2
  86. package/dist/components/ai/intents.d.ts +35 -0
  87. package/dist/components/ai/navigationTree.d.ts +2 -2
  88. package/dist/components/ai/observedSceneAudit.d.ts +2 -1
  89. package/dist/components/ai/profileData.d.ts +11 -0
  90. package/dist/components/ai/repairChartConfig.d.ts +2 -3
  91. package/dist/components/ai/semanticEvidence.d.ts +4 -0
  92. package/dist/components/ai/semanticViability.d.ts +11 -0
  93. package/dist/components/ai/semanticViabilityRegistry.d.ts +5 -0
  94. package/dist/components/ai/streamingTypes.d.ts +4 -0
  95. package/dist/components/ai/suggestCharts.d.ts +5 -6
  96. package/dist/components/ai/suggestDashboard.d.ts +2 -3
  97. package/dist/components/ai/suggestStreamCharts.d.ts +1 -1
  98. package/dist/components/ai/suggestStretchCharts.d.ts +2 -3
  99. package/dist/components/ai/suggestionPropContracts.d.ts +20 -0
  100. package/dist/components/ai/variantDiscovery.d.ts +3 -1
  101. package/dist/components/charts/custom/NetworkCustomChart.d.ts +3 -0
  102. package/dist/components/charts/custom/OrdinalCustomChart.d.ts +3 -0
  103. package/dist/components/charts/custom/XYCustomChart.d.ts +1 -1
  104. package/dist/components/charts/geo/ChoroplethMap.d.ts +3 -1
  105. package/dist/components/charts/geo/DistanceCartogram.d.ts +2 -7
  106. package/dist/components/charts/geo/cartogramOverlay.d.ts +28 -0
  107. package/dist/components/charts/index.d.ts +4 -3
  108. package/dist/components/charts/network/ProcessSankey.d.ts +2 -136
  109. package/dist/components/charts/network/ProcessSankeyProps.d.ts +139 -0
  110. package/dist/components/charts/network/Treemap.d.ts +2 -1
  111. package/dist/components/charts/network/processSankey/boundaryHubOrdering.d.ts +23 -0
  112. package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +2 -0
  113. package/dist/components/charts/network/processSankey/ordering.d.ts +3 -41
  114. package/dist/components/charts/network/processSankey/orderingTypes.d.ts +32 -0
  115. package/dist/components/charts/network/processSankey/packing.d.ts +1 -1
  116. package/dist/components/charts/network/processSankey/packingCache.d.ts +1 -1
  117. package/dist/components/charts/network/processSankey/packingOptimization.d.ts +72 -0
  118. package/dist/components/charts/ordinal/BarChart.d.ts +4 -3
  119. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  120. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +3 -2
  121. package/dist/components/charts/ordinal/StackedBarChart.d.ts +4 -3
  122. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +2 -2
  123. package/dist/components/charts/physics/GaltonBoardChart.d.ts +2 -9
  124. package/dist/components/charts/physics/GauntletChart.d.ts +10 -41
  125. package/dist/components/charts/physics/ProcessFlowChart.d.ts +1 -1
  126. package/dist/components/charts/physics/chainReactionAccessibleTable.d.ts +9 -0
  127. package/dist/components/charts/physics/chainReactionRuntime.d.ts +2 -1
  128. package/dist/components/charts/physics/chainReactionTypes.d.ts +5 -1
  129. package/dist/components/charts/physics/crucibleBodyRenderers.d.ts +2 -2
  130. package/dist/components/charts/physics/crucibleClone.d.ts +6 -0
  131. package/dist/components/charts/physics/crucibleEffects.d.ts +1 -2
  132. package/dist/components/charts/physics/crucibleRecord.d.ts +7 -0
  133. package/dist/components/charts/physics/gauntletChrome.d.ts +4 -4
  134. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  135. package/dist/components/charts/physics/gauntletPublic.d.ts +4 -0
  136. package/dist/components/charts/physics/packetFlowOverlay.d.ts +7 -0
  137. package/dist/components/charts/physics/physicsChartLayout.d.ts +8 -0
  138. package/dist/components/charts/physics/physicsChartShared.d.ts +3 -1
  139. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  140. package/dist/components/charts/physics/physicsHocUtils.d.ts +25 -12
  141. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +24 -0
  142. package/dist/components/charts/physics/processFlowOverlays.d.ts +9 -0
  143. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +15 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +10 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +35 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +21 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +20 -13
  148. package/dist/components/charts/realtime/aggregate.d.ts +4 -1
  149. package/dist/components/charts/realtime/eventTime.d.ts +4 -0
  150. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +27 -0
  151. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +30 -0
  152. package/dist/components/charts/realtime/useRealtimeCategoryColors.d.ts +30 -0
  153. package/dist/components/charts/shared/FrameTextAnnotationSVG.d.ts +10 -0
  154. package/dist/components/charts/shared/annotationActivation.d.ts +3 -7
  155. package/dist/components/charts/shared/annotationBandFill.d.ts +6 -0
  156. package/dist/components/charts/shared/annotationDispatch.d.ts +31 -0
  157. package/dist/components/charts/shared/annotationIdentity.d.ts +8 -0
  158. package/dist/components/charts/shared/annotationRules.d.ts +1 -15
  159. package/dist/components/charts/shared/boundedCategoryRegistry.d.ts +8 -0
  160. package/dist/components/charts/shared/chainReactionChartSpec.d.ts +3 -0
  161. package/dist/components/charts/shared/chartMode.d.ts +3 -2
  162. package/dist/components/charts/shared/chartSpecCore.d.ts +1 -0
  163. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  164. package/dist/components/charts/shared/gradient.d.ts +16 -0
  165. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  166. package/dist/components/charts/shared/hooks.d.ts +4 -4
  167. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  168. package/dist/components/charts/shared/streamPropsHelpers.d.ts +2 -1
  169. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  170. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  171. package/dist/components/charts/shared/types.d.ts +18 -9
  172. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  173. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  174. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  175. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  176. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  177. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  178. package/dist/components/charts/value/types.d.ts +1 -1
  179. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  180. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  181. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  182. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  183. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  184. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  185. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  186. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  187. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  188. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  189. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  190. package/dist/components/legendLayout.d.ts +131 -4
  191. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  192. package/dist/components/realtime/types.d.ts +10 -1
  193. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  194. package/dist/components/recipes/directedReachability.d.ts +14 -0
  195. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  196. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  197. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  198. package/dist/components/recipes/physics.d.ts +7 -4
  199. package/dist/components/recipes/processPhysics.d.ts +0 -1
  200. package/dist/components/recipes/waffle.d.ts +7 -4
  201. package/dist/components/semiotic-ai-core.d.ts +13 -4
  202. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  203. package/dist/components/semiotic-ai.d.ts +16 -9
  204. package/dist/components/semiotic-client-shared.d.ts +10 -0
  205. package/dist/components/semiotic-experimental.d.ts +1 -1
  206. package/dist/components/semiotic-geo.d.ts +4 -1
  207. package/dist/components/semiotic-network.d.ts +7 -4
  208. package/dist/components/semiotic-ordinal.d.ts +4 -1
  209. package/dist/components/semiotic-physics.d.ts +11 -4
  210. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  212. package/dist/components/semiotic-realtime.d.ts +3 -1
  213. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  214. package/dist/components/semiotic-server-edge.d.ts +3 -2
  215. package/dist/components/semiotic-server.d.ts +3 -2
  216. package/dist/components/semiotic-themes-core.d.ts +5 -48
  217. package/dist/components/semiotic-utils-core.d.ts +10 -5
  218. package/dist/components/semiotic-utils-react.d.ts +2 -0
  219. package/dist/components/semiotic-utils.d.ts +1 -1
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -26
  222. package/dist/components/server/animatedGif.d.ts +1 -1
  223. package/dist/components/server/renderEvidence.d.ts +25 -2
  224. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  225. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  226. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  227. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  228. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  230. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  231. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  232. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  233. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  234. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  235. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  236. package/dist/components/server/staticAnnotations.d.ts +28 -1
  237. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  238. package/dist/components/server/staticLegend.d.ts +1 -1
  239. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  240. package/dist/components/server/staticOrdinal.d.ts +8 -2
  241. package/dist/components/server/staticPhysics.d.ts +13 -1
  242. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  243. package/dist/components/server/staticRawLegend.d.ts +15 -0
  244. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  245. package/dist/components/server/staticXYAxes.d.ts +27 -0
  246. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  247. package/dist/components/server/staticXYGrid.d.ts +11 -0
  248. package/dist/components/server/themeResolver.d.ts +5 -1
  249. package/dist/components/store/ThemeStore.d.ts +2 -98
  250. package/dist/components/store/designTokens.d.ts +1 -1
  251. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  252. package/dist/components/store/themeCore.d.ts +91 -0
  253. package/dist/components/store/themePresets.d.ts +81 -0
  254. package/dist/components/store/themeSerialization.d.ts +2 -1
  255. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  256. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  257. package/dist/components/stream/GeoTileRenderer.d.ts +2 -0
  258. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  259. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  260. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  261. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  262. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  263. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  264. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  265. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  266. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  268. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  269. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  270. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  271. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  272. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  273. package/dist/components/stream/canvasBackground.d.ts +10 -0
  274. package/dist/components/stream/canvasSetup.d.ts +9 -0
  275. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  276. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  277. package/dist/components/stream/frameGraphics.d.ts +18 -0
  278. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  279. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  280. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  281. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  282. package/dist/components/stream/geoTypes.d.ts +10 -11
  283. package/dist/components/stream/hitTarget.d.ts +61 -2
  284. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  285. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  286. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  287. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  288. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  289. package/dist/components/stream/networkFramePaint.d.ts +7 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +30 -32
  292. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  294. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  295. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  296. package/dist/components/stream/ordinalTypes.d.ts +10 -4
  297. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  298. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  299. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  300. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  301. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  302. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  303. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  304. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  305. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  306. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +23 -4
  307. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  308. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  309. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  310. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  311. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  312. package/dist/components/stream/pipelineConfig.d.ts +6 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
  314. package/dist/components/stream/renderBackend.d.ts +2 -0
  315. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  316. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  317. package/dist/components/stream/responsiveSize.d.ts +17 -0
  318. package/dist/components/stream/sceneCursor.d.ts +41 -0
  319. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  320. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  321. package/dist/components/stream/types.d.ts +25 -12
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +3 -1
  323. package/dist/components/stream/useFrame.d.ts +24 -1
  324. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  325. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  326. package/dist/components/stream/xyFrameAxisTypes.d.ts +15 -4
  327. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  328. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  329. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  330. package/dist/components/types/legendTypes.d.ts +6 -0
  331. package/dist/components/types/marginType.d.ts +7 -8
  332. package/dist/controls.min.js +1 -1
  333. package/dist/controls.module.min.js +1 -1
  334. package/dist/forceLayoutWorker.js +1 -1
  335. package/dist/geo.min.js +1 -1
  336. package/dist/geo.module.min.js +1 -1
  337. package/dist/network.min.js +1 -1
  338. package/dist/network.module.min.js +1 -1
  339. package/dist/ordinal.min.js +1 -1
  340. package/dist/ordinal.module.min.js +1 -1
  341. package/dist/physics-matter.module.min.js +1 -1
  342. package/dist/physics-rapier.module.min.js +1 -1
  343. package/dist/physics.min.js +1 -1
  344. package/dist/physics.module.min.js +1 -1
  345. package/dist/physicsWorker.js +1 -1
  346. package/dist/processSankeyLayoutWorker.js +1 -1
  347. package/dist/realtime.min.js +1 -1
  348. package/dist/realtime.module.min.js +1 -1
  349. package/dist/rough.min.js +1 -1
  350. package/dist/rough.module.min.js +1 -1
  351. package/dist/semiotic-ai-core.d.ts +13 -4
  352. package/dist/semiotic-ai-core.min.js +1 -1
  353. package/dist/semiotic-ai-core.module.min.js +1 -1
  354. package/dist/semiotic-ai.d.ts +16 -9
  355. package/dist/semiotic-ai.min.js +1 -1
  356. package/dist/semiotic-ai.module.min.js +1 -1
  357. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  358. package/dist/semiotic-client-glyph.module.min.js +2 -0
  359. package/dist/semiotic-client-responsive.module.min.js +2 -0
  360. package/dist/semiotic-client-shared.module.min.js +2 -0
  361. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  362. package/dist/semiotic-data.min.js +1 -1
  363. package/dist/semiotic-data.module.min.js +1 -1
  364. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  366. package/dist/semiotic-experimental-node.module.min.js +2 -0
  367. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  368. package/dist/semiotic-experimental-vacp.min.js +1 -1
  369. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  370. package/dist/semiotic-experimental.d.ts +1 -1
  371. package/dist/semiotic-experimental.min.js +1 -1
  372. package/dist/semiotic-experimental.module.min.js +1 -1
  373. package/dist/semiotic-geo.d.ts +4 -1
  374. package/dist/semiotic-network.d.ts +7 -4
  375. package/dist/semiotic-ordinal.d.ts +4 -1
  376. package/dist/semiotic-physics.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.d.ts +11 -4
  378. package/dist/semiotic-realtime-core.min.js +2 -1
  379. package/dist/semiotic-realtime-core.module.min.js +2 -1
  380. package/dist/semiotic-realtime-react.d.ts +4 -3
  381. package/dist/semiotic-realtime-react.min.js +1 -1
  382. package/dist/semiotic-realtime-react.module.min.js +1 -1
  383. package/dist/semiotic-realtime.d.ts +3 -1
  384. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  385. package/dist/semiotic-recipes-core.d.ts +7 -5
  386. package/dist/semiotic-recipes-core.min.js +9 -1
  387. package/dist/semiotic-recipes-core.module.min.js +1 -1
  388. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  389. package/dist/semiotic-recipes-react.min.js +1 -1
  390. package/dist/semiotic-recipes-react.module.min.js +1 -1
  391. package/dist/semiotic-recipes.min.js +7 -1
  392. package/dist/semiotic-recipes.module.min.js +2 -1
  393. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  394. package/dist/semiotic-server-edge.d.ts +3 -2
  395. package/dist/semiotic-server-edge.min.js +1 -1
  396. package/dist/semiotic-server-edge.module.min.js +1 -1
  397. package/dist/semiotic-server-node.min.js +1 -1
  398. package/dist/semiotic-server-node.module.min.js +1 -1
  399. package/dist/semiotic-server.d.ts +3 -2
  400. package/dist/semiotic-themes-core.d.ts +5 -48
  401. package/dist/semiotic-themes-core.min.js +1 -1
  402. package/dist/semiotic-themes-core.module.min.js +1 -1
  403. package/dist/semiotic-themes-react.min.js +1 -1
  404. package/dist/semiotic-themes-react.module.min.js +1 -1
  405. package/dist/semiotic-themes.min.js +1 -1
  406. package/dist/semiotic-themes.module.min.js +1 -1
  407. package/dist/semiotic-utils-core.d.ts +10 -5
  408. package/dist/semiotic-utils-core.min.js +1 -1
  409. package/dist/semiotic-utils-core.module.min.js +1 -1
  410. package/dist/semiotic-utils-react.d.ts +2 -0
  411. package/dist/semiotic-utils-react.min.js +1 -1
  412. package/dist/semiotic-utils-react.module.min.js +1 -1
  413. package/dist/semiotic-utils.d.ts +1 -1
  414. package/dist/semiotic-utils.min.js +2 -1
  415. package/dist/semiotic-utils.module.min.js +2 -1
  416. package/dist/semiotic-value.min.js +1 -1
  417. package/dist/semiotic-value.module.min.js +1 -1
  418. package/dist/semiotic-xy.d.ts +4 -1
  419. package/dist/semiotic.d.ts +68 -26
  420. package/dist/semiotic.min.js +1 -1
  421. package/dist/semiotic.module.min.js +1 -1
  422. package/dist/server.min.js +1 -1
  423. package/dist/server.module.min.js +1 -1
  424. package/dist/xy.min.js +1 -1
  425. package/dist/xy.module.min.js +1 -1
  426. package/package.json +53 -19
  427. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  428. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  429. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  430. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  431. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  432. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  433. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  434. package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
  435. package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  437. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  438. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  439. package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
  442. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  443. package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
  445. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  446. package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
  447. package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
  448. package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
  449. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  450. package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
  451. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  452. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  453. package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
  454. package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  457. package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HIV7AW2V.module.min.js +0 -2
  460. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  461. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  462. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  463. package/dist/chunk-chunk-JZAMMSQQ.module.min.js +0 -2
  464. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  465. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  466. package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
  467. package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
  468. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  469. package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
  470. package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
  471. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  472. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  473. package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
  476. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  477. package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
  478. package/dist/chunk-chunk-SKLYXNYW.module.min.js +0 -2
  479. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  480. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  481. package/dist/chunk-chunk-U4NZCU5T.module.min.js +0 -2
  482. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
  485. package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
  488. package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
  489. package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
  490. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  491. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  492. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  493. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  494. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  495. package/dist/test-utils/canvasMock.d.ts +0 -86
  496. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  497. package/dist/test-utils/frameMock.d.ts +0 -81
  498. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  499. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  500. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  501. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  502. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
package/README.md CHANGED
@@ -17,42 +17,12 @@ 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.8.9
20
+ ## What's New in 3.9.1
21
21
 
22
- 3.8.9 sharpens Stream Frame reliability and the chart chrome shared by browser and server rendering:
23
-
24
- - Zoom- and display-aware canvas resolution keeps Stream Frames crisp when browser zoom, display
25
- scale, or monitor changes alter `devicePixelRatio`, without rebuilding retained scene geometry.
26
- - XY axes now support per-axis `"nice"` / `"exact"` extent modes consistently across domain
27
- padding, ticks, grids, client SVG, and static SSR — including top- and right-only axis configs.
28
- - Adaptive time ticks accept IANA time zones, and multi-series tooltips have a first-class
29
- configuration object with optional custom content.
30
-
31
- ```jsx
32
- import { LineChart } from "semiotic/xy"
33
-
34
- <LineChart
35
- data={salesData}
36
- xAccessor="month"
37
- yAccessor="revenue"
38
- axisExtent="exact"
39
- frameProps={{
40
- axes: [{ orient: "left", extent: "nice" }]
41
- }}
42
- />
43
- ```
44
-
45
- Simple charts stay five lines:
46
-
47
- ```jsx
48
- import { LineChart } from "semiotic/xy"
49
-
50
- <LineChart
51
- data={salesData}
52
- xAccessor="month"
53
- yAccessor="revenue"
54
- />
55
- ```
22
+ 3.9.1 is a focused patch release. It removes the webpack “conflicting star
23
+ exports” warning emitted by `semiotic/utils`, while keeping every existing
24
+ utility—including `resolveResponsiveDimension` and `useResponsiveSize`—available
25
+ from the same public entry point.
56
26
 
57
27
  ## Why Semiotic
58
28
 
@@ -73,7 +43,10 @@ correct visualizations without trial and error:
73
43
  - **`npx semiotic-ai --doctor`** — validate component + props JSON from the command line with typo suggestions and anti-pattern detection
74
44
  - **`diagnoseConfig(component, props)`** — programmatic anti-pattern detector with actionable fixes, spanning validation, encoding, accessibility, and misleading-design (deception) checks
75
45
  - **`auditData(component, props, data?)`** — chart-aware numeric preflight for inputs that pass schema validation but break the math: non-finite values, zero-span domains, invalid log inputs, negative size geometry, unsafe normalized totals, and scale-dominating outliers. Returns bounded row evidence and flows into `diagnoseConfig`, Chart Clinic, CLI doctor, and opt-in `ChartContainer` notifications
76
- - **`CLAUDE.md`** — instruction files auto-synced for Claude, Cursor, Copilot, Windsurf, and Cline
46
+ - **`AGENTS.md`** — concise repository workflow shared by modern coding agents;
47
+ `CLAUDE.md` imports it and Copilot receives a short compatibility bridge
48
+ - **`ai/reference.md`** — complete on-demand product reference, kept out of
49
+ always-loaded coding-agent context
77
50
  - **`llms.txt`** — machine-readable documentation following the emerging standard
78
51
 
79
52
  Every chart includes a built-in error boundary, dev-mode validation
@@ -404,35 +377,35 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
404
377
 
405
378
  | Entry Point | gzip | What's inside |
406
379
  |---|---|---|
407
- | `semiotic/xy` | **146 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
408
- | `semiotic/ordinal` | **122 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
409
- | `semiotic/network` | **146 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
410
- | `semiotic/geo` | **104 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
411
- | `semiotic/realtime` | **155 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
412
- | `semiotic/realtime/core` | **146 KB** | Streaming chart types, HOCs, and buffer helpers |
380
+ | `semiotic/xy` | **154 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
381
+ | `semiotic/ordinal` | **129 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
382
+ | `semiotic/network` | **150 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
383
+ | `semiotic/geo` | **110 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
384
+ | `semiotic/realtime` | **165 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
385
+ | `semiotic/realtime/core` | **164 KB** | Streaming chart types, HOCs, and buffer helpers |
413
386
  | `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
414
- | `semiotic/server` | **226 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
415
- | `semiotic/server/node` | **226 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
416
- | `semiotic/server/edge` | **241 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
417
- | `semiotic/utils` | **86 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
418
- | `semiotic/utils/core` | **84 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
419
- | `semiotic/utils/react` | **6 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
420
- | `semiotic/recipes` | **90 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
421
- | `semiotic/recipes/core` | **89 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
422
- | `semiotic/recipes/react` | **2 KB** | Glyph and React layout-selection helpers |
387
+ | `semiotic/server` | **197 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
388
+ | `semiotic/server/node` | **197 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
389
+ | `semiotic/server/edge` | **202 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
390
+ | `semiotic/utils` | **93 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
391
+ | `semiotic/utils/core` | **86 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
392
+ | `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
393
+ | `semiotic/recipes` | **94 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
394
+ | `semiotic/recipes/core` | **86 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
395
+ | `semiotic/recipes/react` | **7 KB** | Glyph and React layout-selection helpers |
423
396
  | `semiotic/themes` | **7 KB** | Theme presets only (tufte, carbon, etc.) |
424
397
  | `semiotic/themes/core` | **7 KB** | Theme presets and token helpers |
425
398
  | `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
426
399
  | `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
427
- | `semiotic/value` | **8 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
428
- | `semiotic/physics` | **161 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
400
+ | `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
401
+ | `semiotic/physics` | **165 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
429
402
  | `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
430
403
  | `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
431
- | `semiotic/ai` | **507 KB** | All schema-backed charts + validation — optimized for LLM code generation |
432
- | `semiotic/ai/core` | **81 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
433
- | `semiotic/controls` | **12 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
434
- | `semiotic/rough` | **4 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
435
- | `semiotic` | **410 KB** | Everything below (full bundle) |
404
+ | `semiotic/ai` | **522 KB** | All schema-backed charts + validation — optimized for LLM code generation |
405
+ | `semiotic/ai/core` | **88 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
406
+ | `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
407
+ | `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
408
+ | `semiotic` | **335 KB** | Everything below (full bundle) |
436
409
 
437
410
  <!-- semiotic-bundle-sizes:end -->
438
411
 
@@ -453,32 +426,32 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
453
426
 
454
427
  | Public named import | Runtime | gzip cold-consumer bundle |
455
428
  |---|---:|---:|
456
- | `import { LineChart } from "semiotic"` | browser | **154.2 KiB** |
457
- | `import { LineChart } from "semiotic/xy"` | browser | **154.4 KiB** |
458
- | `import { BarChart } from "semiotic/ordinal"` | browser | **124.5 KiB** |
459
- | `import { SankeyDiagram } from "semiotic/network"` | browser | **147.0 KiB** |
460
- | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **123.9 KiB** |
461
- | `import { RingBuffer } from "semiotic/realtime/core"` | browser | **171.5 KiB** |
429
+ | `import { LineChart } from "semiotic"` | browser | **162.5 KiB** |
430
+ | `import { LineChart } from "semiotic/xy"` | browser | **162.2 KiB** |
431
+ | `import { BarChart } from "semiotic/ordinal"` | browser | **130.6 KiB** |
432
+ | `import { SankeyDiagram } from "semiotic/network"` | browser | **152.7 KiB** |
433
+ | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **135.4 KiB** |
434
+ | `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
462
435
  | `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
463
- | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **134.9 KiB** |
436
+ | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.3 KiB** |
464
437
  | `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
465
438
  | `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
466
- | `import { renderChart } from "semiotic/server"` | node | **287.0 KiB** |
467
- | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **166.1 KiB** |
468
- | `import { renderToImage } from "semiotic/server/node"` | node | **287.4 KiB** |
469
- | `import { suggestCharts } from "semiotic/ai"` | browser | **194.2 KiB** |
470
- | `import { suggestCharts } from "semiotic/ai/core"` | browser | **36.5 KiB** |
439
+ | `import { renderChart } from "semiotic/server"` | node | **243.4 KiB** |
440
+ | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.6 KiB** |
441
+ | `import { renderToImage } from "semiotic/server/node"` | node | **243.9 KiB** |
442
+ | `import { suggestCharts } from "semiotic/ai"` | browser | **239.3 KiB** |
443
+ | `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.2 KiB** |
471
444
  | `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
472
- | `import { ChoroplethMap } from "semiotic/geo"` | browser | **109.3 KiB** |
473
- | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.4 KiB** |
474
- | `import { resolveThemePreset } from "semiotic/themes"` | browser | **3.4 KiB** |
475
- | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **3.4 KiB** |
476
- | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **4.4 KiB** |
477
- | `import { validateProps } from "semiotic/utils"` | browser | **8.6 KiB** |
478
- | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **0.9 KiB** |
479
- | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **0.3 KiB** |
480
- | `import { waffleLayout } from "semiotic/recipes"` | browser | **2.5 KiB** |
481
- | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.5 KiB** |
445
+ | `import { ChoroplethMap } from "semiotic/geo"` | browser | **114.6 KiB** |
446
+ | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
447
+ | `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
448
+ | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
449
+ | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.1 KiB** |
450
+ | `import { validateProps } from "semiotic/utils"` | browser | **9.1 KiB** |
451
+ | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **6.8 KiB** |
452
+ | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.3 KiB** |
453
+ | `import { waffleLayout } from "semiotic/recipes"` | browser | **2.9 KiB** |
454
+ | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.9 KiB** |
482
455
  | `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** |
483
456
  | `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
484
457
  | `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
@@ -734,7 +707,8 @@ Secondary-directory freshness and release ownership are tracked in
734
707
 
735
708
  Agent-facing API surface:
736
709
 
737
- - **`CLAUDE.md`**, **`ai/schema.json`**, **`ai/surface-manifest.json`**, **`ai/behaviorContracts.cjs`** — bundled in the npm tarball (see `package.json#files`); agents that install Semiotic locally read these directly. `CLAUDE.md` is the quick-start cheat sheet (HOC props, push API, theming, usage notes); `ai/schema.json` is the JSON Schema for every chart's prop surface; `ai/surface-manifest.json` is the generated inventory; `ai/behaviorContracts.cjs` carries the agent-visible semantic rules (color precedence, push-mode requirements, ID-accessor contracts).
710
+ - **`AGENTS.md`** is the concise repository development contract and **`CLAUDE.md`** imports it for Claude Code. These stay repository-local rather than shipping irrelevant contributor instructions to package consumers.
711
+ - **`ai/reference.md`**, **`ai/schema.json`**, **`ai/surface-manifest.json`**, **`ai/behaviorContracts.cjs`**, and **`agent-skill/semiotic-charts/SKILL.md`** are bundled in the npm tarball (see `package.json#files`). The reference is the on-demand product guide printed by `npx semiotic-ai`; the schema, manifest, contracts, and portable skill provide structured generation and validation guidance.
738
712
  - [**`semiotic.nteract.io/llms.txt`**](https://semiotic.nteract.io/llms.txt) + [**`/llms-full.txt`**](https://semiotic.nteract.io/llms-full.txt) — deployed at the docs site per the [llms.txt standard](https://llmstxt.org). Agents fetch the navigation map (`llms.txt`) or the full inlined docs (`llms-full.txt`) over HTTP; they're not part of the npm package itself.
739
713
 
740
714
  ## Documentation
@@ -14,6 +14,14 @@ The cardinal rule: **do not hand-write chart JSX and hope it paints.** Emit a
14
14
  `{ component, props }` proposal and run it through the trust loop, which is
15
15
  validated and diagnosed; when a renderer is available, proven to paint. Otherwise it returns reasons and ranked alternatives to retry with.
16
16
 
17
+ ## Context discipline
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.
24
+
17
25
  ## The trust loop — generate → validate → diagnose → repair → prove
18
26
 
19
27
  `prepareChart` (from `semiotic/ai`) composes the whole loop. Call it on every
@@ -120,14 +128,15 @@ const note = withProvenance(
120
128
  ## Tooling
121
129
 
122
130
  - **MCP server:** `npx semiotic-mcp` — tools for `renderChart` (SVG + render
123
- evidence), `suggestCharts`, `groundChart`, `diagnoseConfig`, `repairChartConfig`,
131
+ evidence), `suggestCharts`, `groundChart`, `diagnoseConfig`, `evaluateChart`, `repairChartConfig`,
124
132
  `proposeChartVariants`, and more. Prefer these over guessing.
125
133
  - **Public app profile:** `npx semiotic-mcp --profile public` exposes the five
126
134
  task-oriented tools `createChart`, `improveChart`, `explainChart`,
127
135
  `auditChart`, and `getChartSchema`; use it when tool discovery matters more
128
136
  than expert-level control.
129
137
  - **CLI gate:** `npx semiotic-ai --doctor` validates a `{ component, props }` JSON
130
- (`--audit-a11y` for an accessibility audit). Run it before shipping generated code.
138
+ (`--audit-a11y` for an accessibility audit, `--evaluate` for the unified
139
+ data/deception/accessibility pass). Run it before shipping generated code.
131
140
  - **Machine-readable docs:** the published `llms.txt` is the chart catalog with
132
141
  per-chart communicative-act labels; read it for the full surface rather than
133
142
  guessing component names.
@@ -163,7 +163,19 @@ const BEHAVIOR_CONTRACTS = [
163
163
  severity: "warning",
164
164
  appliesTo: {},
165
165
  summary: "High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.",
166
- agentAction: "Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields.",
166
+ agentAction: 'Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. If a consumer-owned role=img wraps the chart, use accessibleTable: { portalTarget: "element-id" } and render that target outside the image. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields.',
167
+ },
168
+ {
169
+ id: "interaction.cursor-is-presentation-only",
170
+ category: "interaction",
171
+ title: "Cursor styling does not create behavior",
172
+ severity: "warning",
173
+ appliesTo: {
174
+ propsAny: ["cursor"],
175
+ propPathsAny: [["styleRules", "*", "style", "cursor"]],
176
+ },
177
+ summary: "Cursor values in realtime props, retained mark styles, styleRules, and custom hit targets change pointer presentation only. They do not install click handlers, keyboard activation, observations, or accessibility semantics.",
178
+ agentAction: "Use an actionable cursor only when the application separately supplies documented click or observation behavior and an accessible activation path. Treat cursor in serialized/static output as visual metadata, never as proof that a mark is interactive.",
167
179
  },
168
180
  {
169
181
  id: "props.data-required-by-usage-mode",
@@ -320,8 +332,26 @@ function appliesToComponent(contract, component) {
320
332
 
321
333
  function appliesToProps(contract, props) {
322
334
  const propsAny = contract.appliesTo?.propsAny
323
- if (!propsAny || propsAny.length === 0) return true
324
- return propsAny.some((prop) => hasOwn(props, prop) && props[prop] !== undefined)
335
+ const propPathsAny = contract.appliesTo?.propPathsAny
336
+ if (
337
+ (!propsAny || propsAny.length === 0) &&
338
+ (!propPathsAny || propPathsAny.length === 0)
339
+ )
340
+ return true
341
+
342
+ if (propsAny?.some((prop) => hasOwn(props, prop) && props[prop] !== undefined)) return true
343
+ return propPathsAny?.some((path) => hasDefinedPath(props, path)) ?? false
344
+ }
345
+
346
+ function hasDefinedPath(value, path) {
347
+ if (path.length === 0) return value !== undefined
348
+ if (value === null || typeof value !== "object") return false
349
+
350
+ const [segment, ...rest] = path
351
+ if (segment === "*") {
352
+ return Array.isArray(value) && value.some((item) => hasDefinedPath(item, rest))
353
+ }
354
+ return hasOwn(value, segment) && hasDefinedPath(value[segment], rest)
325
355
  }
326
356
 
327
357
  function behaviorContractsFor({ component, props } = {}) {
package/ai/cli.js CHANGED
@@ -24,7 +24,7 @@ const {
24
24
  } = require("./behaviorContracts.cjs")
25
25
 
26
26
  const FILES = {
27
- default: path.join(pkgRoot, "CLAUDE.md"),
27
+ default: path.join(pkgRoot, "ai", "reference.md"),
28
28
  "--schema": path.join(__dirname, "schema.json"),
29
29
  "--compact": path.join(__dirname, "system-prompt.md"),
30
30
  "--examples": path.join(__dirname, "examples.md"),
@@ -39,7 +39,7 @@ const HELP = `
39
39
  semiotic-ai — Dump Semiotic AI context to stdout
40
40
 
41
41
  Usage:
42
- npx semiotic-ai Print CLAUDE.md (full reference)
42
+ npx semiotic-ai Print ai/reference.md (full reference)
43
43
  npx semiotic-ai --list List components, categories, imports, and renderability
44
44
  npx semiotic-ai --list --json Print component index as JSON
45
45
  npx semiotic-ai --schema Print ai/schema.json (all tool definitions)
@@ -54,6 +54,8 @@ Usage:
54
54
  npx semiotic-ai --audit-a11y Audit { component, props, inChartContainer?, describe?, navigable? }
55
55
  npx semiotic-ai --audit-mobile Audit { component, props, viewportWidth?, targetSize?, inChartContainer? }
56
56
  JSON against Chartability (POUR-CAF) accessibility heuristics
57
+ npx semiotic-ai --evaluate Evaluate { component, props, data?, inChartContainer?, describe?, navigable? }
58
+ with data, deception, and accessibility checks (add --json for a machine-readable report)
57
59
  npx semiotic-ai --help Show this help message
58
60
  `.trim()
59
61
 
@@ -485,6 +487,55 @@ if (flag === "--audit-mobile") {
485
487
  }
486
488
  }
487
489
 
490
+ // --evaluate: run the unified data/deception/accessibility evaluator
491
+ if (flag === "--evaluate") {
492
+ const input = readJSONInput("Usage: npx semiotic-ai --evaluate '{\"component\":\"LineChart\",\"props\":{\"xAccessor\":\"x\",\"yAccessor\":\"y\"},\"data\":[...]}'")
493
+ const asJson = process.argv.includes("--json")
494
+
495
+ try {
496
+ const { component, props, data, inChartContainer, describe, navigable } = JSON.parse(input)
497
+ if (!component || !props) {
498
+ const msg = "Input must be JSON with { component, props } fields."
499
+ if (asJson) console.log(JSON.stringify({ ok: false, error: msg }, null, 2))
500
+ else console.error(msg)
501
+ process.exit(1)
502
+ }
503
+
504
+ const distPath = path.join(pkgRoot, "dist", "semiotic-ai.min.js")
505
+ let evaluateChart, formatEvaluateChart
506
+ try {
507
+ if (!process.env.SEMIOTIC_AI_SCHEMA_ONLY) {
508
+ const mod = require(distPath)
509
+ evaluateChart = mod.evaluateChart
510
+ formatEvaluateChart = mod.formatEvaluateChart
511
+ }
512
+ } catch (e) {
513
+ // Dist unavailable.
514
+ }
515
+
516
+ if (!evaluateChart || !formatEvaluateChart) {
517
+ const msg = "Chart evaluation requires the built library. Run `npm run dist` first, or use the MCP `evaluateChart` tool."
518
+ if (asJson) console.log(JSON.stringify({ ok: false, error: msg }, null, 2))
519
+ else console.error(msg)
520
+ process.exit(2)
521
+ }
522
+
523
+ const result = evaluateChart(component, props, Array.isArray(data) ? data : undefined, {
524
+ inChartContainer: inChartContainer === true,
525
+ describe: describe === true,
526
+ navigable: navigable === true,
527
+ })
528
+ if (asJson) console.log(JSON.stringify(result, null, 2))
529
+ else console.log(formatEvaluateChart(result))
530
+ process.exit(result.ok ? 0 : 1)
531
+ } catch (err) {
532
+ const msg = `Failed to parse input: ${errorMessage(err)}`
533
+ if (asJson) console.log(JSON.stringify({ ok: false, error: msg }, null, 2))
534
+ else console.error(msg)
535
+ process.exit(1)
536
+ }
537
+ }
538
+
488
539
  const filePath = flag ? FILES[flag] : FILES.default
489
540
 
490
541
  if (!filePath) {
@@ -41,6 +41,14 @@ for (const [category, names] of Object.entries(COMPONENTS_BY_CATEGORY)) {
41
41
  }
42
42
  }
43
43
 
44
+ // AI's component catalog can expose imperative/custom-layout charts that
45
+ // deliberately have no JSON schema. Keep that small extension separate from
46
+ // the schema-backed metadata above so chart-spec drift checks retain their
47
+ // exact one-to-one inventory contract.
48
+ const AI_EXPORT_ONLY_CATEGORIES = {
49
+ PhysicsCustomChart: "physics",
50
+ }
51
+
44
52
  function schemaEntries(schema) {
45
53
  return schema.tools.map((tool) => tool.function)
46
54
  }
@@ -53,6 +61,10 @@ function categoryForComponent(name) {
53
61
  return category
54
62
  }
55
63
 
64
+ function categoryForAIExport(name) {
65
+ return COMPONENT_TO_CATEGORY.get(name) ?? AI_EXPORT_ONLY_CATEGORIES[name]
66
+ }
67
+
56
68
  function importPathForCategory(category) {
57
69
  if (category === "physics") return "semiotic/physics"
58
70
  return category === "geo" ? "semiotic/geo" : `semiotic/${category}`
@@ -73,6 +85,7 @@ function metadataForComponent(entryOrName) {
73
85
  category,
74
86
  importPath: importPathForCategory(category),
75
87
  renderable: !isPushOnly,
88
+ requiresLiveData: isPushOnly,
76
89
  description: typeof entryOrName === "string" ? undefined : entryOrName.description,
77
90
  }
78
91
  }
@@ -106,6 +119,7 @@ function componentIndexFromSchema(schema) {
106
119
  totalComponents: components.length,
107
120
  renderableComponents: components.filter((component) => component.renderable).length,
108
121
  browserOnlyComponents: components.filter((component) => !component.renderable).length,
122
+ requiresLiveDataComponents: components.filter((component) => component.requiresLiveData).length,
109
123
  categories,
110
124
  components,
111
125
  }
@@ -115,6 +129,7 @@ module.exports = {
115
129
  CATEGORY_ORDER,
116
130
  COMPONENTS_BY_CATEGORY,
117
131
  categoryForComponent,
132
+ categoryForAIExport,
118
133
  componentIndexFromSchema,
119
134
  findComponent,
120
135
  importPathForCategory,