semiotic 3.8.8 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (501) hide show
  1. package/README.md +82 -66
  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} +46 -24
  9. package/ai/schema.json +10704 -825
  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 +83 -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 +6 -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 +26 -13
  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 +17 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +12 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +37 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +23 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +22 -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/formatUtils.d.ts +40 -9
  164. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  165. package/dist/components/charts/shared/gradient.d.ts +16 -0
  166. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  167. package/dist/components/charts/shared/hooks.d.ts +4 -4
  168. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  169. package/dist/components/charts/shared/streamPropsHelpers.d.ts +3 -1
  170. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  171. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  172. package/dist/components/charts/shared/types.d.ts +26 -10
  173. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  174. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  175. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  176. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  177. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  178. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  179. package/dist/components/charts/value/types.d.ts +1 -1
  180. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  181. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  182. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  183. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  184. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  185. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  186. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  187. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  188. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  189. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  190. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  191. package/dist/components/legendLayout.d.ts +131 -4
  192. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  193. package/dist/components/realtime/types.d.ts +10 -1
  194. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  195. package/dist/components/recipes/directedReachability.d.ts +14 -0
  196. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  197. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  198. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  199. package/dist/components/recipes/physics.d.ts +7 -4
  200. package/dist/components/recipes/processPhysics.d.ts +0 -1
  201. package/dist/components/recipes/waffle.d.ts +7 -4
  202. package/dist/components/semiotic-ai-core.d.ts +13 -4
  203. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  204. package/dist/components/semiotic-ai.d.ts +16 -9
  205. package/dist/components/semiotic-client-shared.d.ts +10 -0
  206. package/dist/components/semiotic-experimental.d.ts +1 -1
  207. package/dist/components/semiotic-geo.d.ts +4 -1
  208. package/dist/components/semiotic-network.d.ts +7 -4
  209. package/dist/components/semiotic-ordinal.d.ts +4 -1
  210. package/dist/components/semiotic-physics.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  212. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  213. package/dist/components/semiotic-realtime.d.ts +3 -1
  214. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  215. package/dist/components/semiotic-server-edge.d.ts +3 -2
  216. package/dist/components/semiotic-server.d.ts +3 -2
  217. package/dist/components/semiotic-themes-core.d.ts +5 -48
  218. package/dist/components/semiotic-utils-core.d.ts +11 -5
  219. package/dist/components/semiotic-utils-react.d.ts +2 -0
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -25
  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 +3 -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 +24 -4
  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 +12 -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 +15 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +32 -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 +12 -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 +25 -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 +8 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +2 -2
  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 +33 -13
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +12 -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 +20 -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 +11 -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.min.js +2 -1
  414. package/dist/semiotic-utils.module.min.js +2 -1
  415. package/dist/semiotic-value.min.js +1 -1
  416. package/dist/semiotic-value.module.min.js +1 -1
  417. package/dist/semiotic-xy.d.ts +4 -1
  418. package/dist/semiotic.d.ts +68 -25
  419. package/dist/semiotic.min.js +1 -1
  420. package/dist/semiotic.module.min.js +1 -1
  421. package/dist/server.min.js +1 -1
  422. package/dist/server.module.min.js +1 -1
  423. package/dist/xy.min.js +1 -1
  424. package/dist/xy.module.min.js +1 -1
  425. package/package.json +53 -19
  426. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  427. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  428. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  429. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  430. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  431. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  432. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  433. package/dist/chunk-chunk-3GCILWPB.module.min.js +0 -2
  434. package/dist/chunk-chunk-46KRGJQP.module.min.js +0 -1
  435. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4MLLQUGW.module.min.js +0 -2
  437. package/dist/chunk-chunk-57RBPDBQ.module.min.js +0 -2
  438. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  439. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  442. package/dist/chunk-chunk-7LE56WAE.module.min.js +0 -2
  443. package/dist/chunk-chunk-7T25U75Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  445. package/dist/chunk-chunk-AF53TBSN.module.min.js +0 -2
  446. package/dist/chunk-chunk-BTZYH2IE.module.min.js +0 -1
  447. package/dist/chunk-chunk-BWV55BZK.module.min.js +0 -2
  448. package/dist/chunk-chunk-BZNOAHJV.module.min.js +0 -2
  449. package/dist/chunk-chunk-CD6PVVS3.module.min.js +0 -2
  450. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  451. package/dist/chunk-chunk-FC3NZWYR.module.min.js +0 -2
  452. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  453. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  454. package/dist/chunk-chunk-FRGBMTZR.module.min.js +0 -1
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-H5IFO6CU.module.min.js +0 -2
  457. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HCNDE26Q.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-JJ4BSUYL.module.min.js +0 -2
  464. package/dist/chunk-chunk-JRHXQGEV.module.min.js +0 -2
  465. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  466. package/dist/chunk-chunk-L6FFYGYS.module.min.js +0 -1
  467. package/dist/chunk-chunk-LJDH3WV3.module.min.js +0 -2
  468. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  469. package/dist/chunk-chunk-N3Q33XCB.module.min.js +0 -2
  470. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  471. package/dist/chunk-chunk-OG3TTJGJ.module.min.js +0 -2
  472. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  473. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-QQJNG23C.module.min.js +0 -2
  476. package/dist/chunk-chunk-RGJ6TKAH.module.min.js +0 -2
  477. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  478. package/dist/chunk-chunk-SFLUSZ73.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-U66USBWU.module.min.js +0 -1
  482. package/dist/chunk-chunk-UEZ6SHW5.module.min.js +0 -2
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VUWYT7DY.module.min.js +0 -2
  485. package/dist/chunk-chunk-W5HWGQMD.module.min.js +0 -2
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-WGROBM3I.module.min.js +0 -2
  488. package/dist/chunk-chunk-WSDJFBKX.module.min.js +0 -2
  489. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  490. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  491. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  492. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  493. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  494. package/dist/test-utils/canvasMock.d.ts +0 -86
  495. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  496. package/dist/test-utils/frameMock.d.ts +0 -81
  497. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  498. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  499. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  500. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  501. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -22,6 +22,7 @@
22
22
  */
23
23
  import type { Datum } from "./datumTypes";
24
24
  import type { HatchFill } from "./hatchFill";
25
+ import type { CSSProperties } from "react";
25
26
  /** The style a rule applies. `fill` may be a solid color or a {@link HatchFill}. */
26
27
  export interface StyleRuleStyle {
27
28
  /** Solid color string, a CSS var, or a declarative hatch descriptor. */
@@ -31,6 +32,11 @@ export interface StyleRuleStyle {
31
32
  strokeWidth?: number;
32
33
  strokeDasharray?: string;
33
34
  opacity?: number;
35
+ /**
36
+ * CSS cursor shown for matching marks. Presentation only; pair with the
37
+ * chart/frame interaction API to provide click and keyboard behavior.
38
+ */
39
+ cursor?: CSSProperties["cursor"];
34
40
  }
35
41
  /**
36
42
  * A declarative numeric / categorical condition. All present operators must
@@ -180,8 +186,9 @@ export declare function composeStyleRules<A = string>(baseStyleFn: ((d: Datum, a
180
186
  * rules read — `value` for bars, `{ value, x, y }` for XY, node value/group
181
187
  * for network, etc. — so all families share one rule-resolution core.
182
188
  *
183
- * @param arg the second style-fn argument (ordinal category / stack key). It is
184
- * passed through to `buildContext` and the user style fn unchanged.
189
+ * The returned style function's second argument is the ordinal category or
190
+ * stack key. It is passed through to `buildContext` and the user style
191
+ * function unchanged.
185
192
  */
186
193
  export declare function makeStyleRuleStyleFn(rules: ReadonlyArray<StyleRule> | undefined, buildContext: (d: Datum, arg?: string) => StyleRuleContext, userStyleFn?: MarkStyleFn): MarkStyleFn | undefined;
187
194
  /**
@@ -0,0 +1,353 @@
1
+ /** JSON-safe subset of `HatchFill` accepted by declarative style rules. */
2
+ export declare const HATCH_FILL_WIRE_SCHEMA: {
3
+ readonly type: "object";
4
+ readonly properties: {
5
+ readonly type: {
6
+ readonly const: "hatch";
7
+ };
8
+ readonly background: {
9
+ readonly type: "string";
10
+ };
11
+ readonly stroke: {
12
+ readonly type: "string";
13
+ };
14
+ readonly lineWidth: {
15
+ readonly type: "number";
16
+ };
17
+ readonly spacing: {
18
+ readonly type: "number";
19
+ };
20
+ readonly angle: {
21
+ readonly type: "number";
22
+ };
23
+ readonly lineOpacity: {
24
+ readonly type: "number";
25
+ };
26
+ };
27
+ readonly required: readonly ["type"];
28
+ readonly additionalProperties: false;
29
+ };
30
+ /** JSON-safe declarative threshold; predicate functions remain React-only. */
31
+ export declare const STYLE_RULE_WHEN_WIRE_SCHEMA: {
32
+ readonly oneOf: readonly [{
33
+ readonly type: "boolean";
34
+ }, {
35
+ readonly type: "object";
36
+ readonly properties: {
37
+ readonly axis: {
38
+ readonly type: "string";
39
+ readonly enum: readonly ["x", "y", "value"];
40
+ };
41
+ readonly field: {
42
+ readonly type: "string";
43
+ };
44
+ readonly gt: {
45
+ readonly type: "number";
46
+ };
47
+ readonly gte: {
48
+ readonly type: "number";
49
+ };
50
+ readonly lt: {
51
+ readonly type: "number";
52
+ };
53
+ readonly lte: {
54
+ readonly type: "number";
55
+ };
56
+ readonly eq: {
57
+ readonly type: readonly ["number", "string"];
58
+ };
59
+ readonly ne: {
60
+ readonly type: readonly ["number", "string"];
61
+ };
62
+ readonly within: {
63
+ readonly type: "array";
64
+ readonly items: {
65
+ readonly type: "number";
66
+ };
67
+ readonly minItems: 2;
68
+ readonly maxItems: 2;
69
+ };
70
+ readonly outside: {
71
+ readonly type: "array";
72
+ readonly items: {
73
+ readonly type: "number";
74
+ };
75
+ readonly minItems: 2;
76
+ readonly maxItems: 2;
77
+ };
78
+ readonly in: {
79
+ readonly type: "array";
80
+ readonly items: {
81
+ readonly type: readonly ["number", "string"];
82
+ };
83
+ };
84
+ };
85
+ readonly additionalProperties: false;
86
+ }];
87
+ };
88
+ /** Nested authoring contract shared by every chart with wired `styleRules`. */
89
+ export declare const STYLE_RULES_WIRE_SCHEMA: {
90
+ readonly items: {
91
+ readonly type: "object";
92
+ readonly properties: {
93
+ readonly id: {
94
+ readonly type: "string";
95
+ };
96
+ readonly label: {
97
+ readonly type: "string";
98
+ };
99
+ readonly when: {
100
+ readonly oneOf: readonly [{
101
+ readonly type: "boolean";
102
+ }, {
103
+ readonly type: "object";
104
+ readonly properties: {
105
+ readonly axis: {
106
+ readonly type: "string";
107
+ readonly enum: readonly ["x", "y", "value"];
108
+ };
109
+ readonly field: {
110
+ readonly type: "string";
111
+ };
112
+ readonly gt: {
113
+ readonly type: "number";
114
+ };
115
+ readonly gte: {
116
+ readonly type: "number";
117
+ };
118
+ readonly lt: {
119
+ readonly type: "number";
120
+ };
121
+ readonly lte: {
122
+ readonly type: "number";
123
+ };
124
+ readonly eq: {
125
+ readonly type: readonly ["number", "string"];
126
+ };
127
+ readonly ne: {
128
+ readonly type: readonly ["number", "string"];
129
+ };
130
+ readonly within: {
131
+ readonly type: "array";
132
+ readonly items: {
133
+ readonly type: "number";
134
+ };
135
+ readonly minItems: 2;
136
+ readonly maxItems: 2;
137
+ };
138
+ readonly outside: {
139
+ readonly type: "array";
140
+ readonly items: {
141
+ readonly type: "number";
142
+ };
143
+ readonly minItems: 2;
144
+ readonly maxItems: 2;
145
+ };
146
+ readonly in: {
147
+ readonly type: "array";
148
+ readonly items: {
149
+ readonly type: readonly ["number", "string"];
150
+ };
151
+ };
152
+ };
153
+ readonly additionalProperties: false;
154
+ }];
155
+ };
156
+ readonly style: {
157
+ readonly type: "object";
158
+ readonly properties: {
159
+ readonly fill: {
160
+ readonly oneOf: readonly [{
161
+ readonly type: "string";
162
+ }, {
163
+ readonly type: "object";
164
+ readonly properties: {
165
+ readonly type: {
166
+ readonly const: "hatch";
167
+ };
168
+ readonly background: {
169
+ readonly type: "string";
170
+ };
171
+ readonly stroke: {
172
+ readonly type: "string";
173
+ };
174
+ readonly lineWidth: {
175
+ readonly type: "number";
176
+ };
177
+ readonly spacing: {
178
+ readonly type: "number";
179
+ };
180
+ readonly angle: {
181
+ readonly type: "number";
182
+ };
183
+ readonly lineOpacity: {
184
+ readonly type: "number";
185
+ };
186
+ };
187
+ readonly required: readonly ["type"];
188
+ readonly additionalProperties: false;
189
+ }];
190
+ };
191
+ readonly fillOpacity: {
192
+ readonly type: "number";
193
+ };
194
+ readonly stroke: {
195
+ readonly type: "string";
196
+ };
197
+ readonly strokeWidth: {
198
+ readonly type: "number";
199
+ };
200
+ readonly strokeDasharray: {
201
+ readonly type: "string";
202
+ };
203
+ readonly opacity: {
204
+ readonly type: "number";
205
+ };
206
+ readonly cursor: {
207
+ readonly type: "string";
208
+ };
209
+ };
210
+ readonly additionalProperties: false;
211
+ };
212
+ };
213
+ readonly required: readonly ["style"];
214
+ readonly additionalProperties: false;
215
+ };
216
+ };
217
+ /**
218
+ * Shared chart-registry prop for the serializable `StyleRule` contract.
219
+ * React callers may additionally use predicate `when` and functional `style`
220
+ * values; those function variants are intentionally absent from JSON Schema.
221
+ */
222
+ export declare const STYLE_RULES_PROP_SPEC: {
223
+ readonly type: "array";
224
+ readonly description: "Ordered declarative style rules; matching styles merge in order and the last value wins per property. Wire configs accept boolean/declarative-threshold `when` values and object styles (including cursor and solid or HatchFill fill). Predicate and style functions are React-only.";
225
+ readonly schema: {
226
+ readonly items: {
227
+ readonly type: "object";
228
+ readonly properties: {
229
+ readonly id: {
230
+ readonly type: "string";
231
+ };
232
+ readonly label: {
233
+ readonly type: "string";
234
+ };
235
+ readonly when: {
236
+ readonly oneOf: readonly [{
237
+ readonly type: "boolean";
238
+ }, {
239
+ readonly type: "object";
240
+ readonly properties: {
241
+ readonly axis: {
242
+ readonly type: "string";
243
+ readonly enum: readonly ["x", "y", "value"];
244
+ };
245
+ readonly field: {
246
+ readonly type: "string";
247
+ };
248
+ readonly gt: {
249
+ readonly type: "number";
250
+ };
251
+ readonly gte: {
252
+ readonly type: "number";
253
+ };
254
+ readonly lt: {
255
+ readonly type: "number";
256
+ };
257
+ readonly lte: {
258
+ readonly type: "number";
259
+ };
260
+ readonly eq: {
261
+ readonly type: readonly ["number", "string"];
262
+ };
263
+ readonly ne: {
264
+ readonly type: readonly ["number", "string"];
265
+ };
266
+ readonly within: {
267
+ readonly type: "array";
268
+ readonly items: {
269
+ readonly type: "number";
270
+ };
271
+ readonly minItems: 2;
272
+ readonly maxItems: 2;
273
+ };
274
+ readonly outside: {
275
+ readonly type: "array";
276
+ readonly items: {
277
+ readonly type: "number";
278
+ };
279
+ readonly minItems: 2;
280
+ readonly maxItems: 2;
281
+ };
282
+ readonly in: {
283
+ readonly type: "array";
284
+ readonly items: {
285
+ readonly type: readonly ["number", "string"];
286
+ };
287
+ };
288
+ };
289
+ readonly additionalProperties: false;
290
+ }];
291
+ };
292
+ readonly style: {
293
+ readonly type: "object";
294
+ readonly properties: {
295
+ readonly fill: {
296
+ readonly oneOf: readonly [{
297
+ readonly type: "string";
298
+ }, {
299
+ readonly type: "object";
300
+ readonly properties: {
301
+ readonly type: {
302
+ readonly const: "hatch";
303
+ };
304
+ readonly background: {
305
+ readonly type: "string";
306
+ };
307
+ readonly stroke: {
308
+ readonly type: "string";
309
+ };
310
+ readonly lineWidth: {
311
+ readonly type: "number";
312
+ };
313
+ readonly spacing: {
314
+ readonly type: "number";
315
+ };
316
+ readonly angle: {
317
+ readonly type: "number";
318
+ };
319
+ readonly lineOpacity: {
320
+ readonly type: "number";
321
+ };
322
+ };
323
+ readonly required: readonly ["type"];
324
+ readonly additionalProperties: false;
325
+ }];
326
+ };
327
+ readonly fillOpacity: {
328
+ readonly type: "number";
329
+ };
330
+ readonly stroke: {
331
+ readonly type: "string";
332
+ };
333
+ readonly strokeWidth: {
334
+ readonly type: "number";
335
+ };
336
+ readonly strokeDasharray: {
337
+ readonly type: "string";
338
+ };
339
+ readonly opacity: {
340
+ readonly type: "number";
341
+ };
342
+ readonly cursor: {
343
+ readonly type: "string";
344
+ };
345
+ };
346
+ readonly additionalProperties: false;
347
+ };
348
+ };
349
+ readonly required: readonly ["style"];
350
+ readonly additionalProperties: false;
351
+ };
352
+ };
353
+ };
@@ -6,6 +6,7 @@ import type { Datum, DatumValue } from "./datumTypes";
6
6
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
7
7
  import type { ResponsiveRule } from "./responsiveRules";
8
8
  import type { MobileVisualizationContract } from "./auditMobileVisualization";
9
+ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
9
10
  /**
10
11
  * Selection consumption config — makes this chart react to a named selection
11
12
  */
@@ -106,14 +107,20 @@ export interface BaseChartProps {
106
107
  height?: number;
107
108
  /** Margin around the chart. Accepts a number (same on all sides) or an object
108
109
  * with any subset of `top`/`bottom`/`left`/`right`. Missing sides fall back
109
- * to the chart-mode defaults. Use `"auto"` or `null` for a side to explicitly
110
- * allow chart auto-reservation, e.g. `margin={{ right: "auto" }}` with a
111
- * right-side legend. */
110
+ * to the chart-mode defaults. Numeric sides are minima when chart-owned
111
+ * chrome such as a legend needs more room; `"auto"` and `null` start from
112
+ * the chart-mode default. */
112
113
  margin?: PartialMargin;
113
114
  /** Auto-match width to parent container. Default: false */
114
115
  responsiveWidth?: boolean;
115
116
  /** Auto-match height to parent container (requires parent with explicit height). Default: false */
116
117
  responsiveHeight?: boolean;
118
+ /**
119
+ * Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
120
+ * on coarse-pointer/small-screen devices. Canvas chart families repaint
121
+ * automatically when browser zoom or display density changes.
122
+ */
123
+ maxDevicePixelRatio?: number;
117
124
  /** Semantic responsive transformations keyed by measured chart slot, not CSS alone. */
118
125
  responsiveRules?: ResponsiveRule[];
119
126
  /** Phone/mobile contract consumed by audits, recipes, adapters, and agents. */
@@ -160,14 +167,15 @@ export interface BaseChartProps {
160
167
  /** Accessible summary rendered as a screen-reader-only note.
161
168
  * Use for trend descriptions or key takeaways that supplement the visual. */
162
169
  summary?: string;
163
- /** Enable accessible data table below the chart canvas. Default: true (via frame). */
164
- accessibleTable?: boolean;
170
+ /** Enable the accessible data table. Use `{ portalTarget }` to relocate its
171
+ * interactive UI outside a consumer-owned `role="img"`. Default: true. */
172
+ accessibleTable?: AccessibleTableProp;
165
173
  /** Callback when a data element is clicked. Receives the original datum and pixel coordinates.
166
174
  * For lines, receives the line data; for bars, the bar datum; for pie slices, the slice datum. */
167
175
  onClick?: DatumClickHandler;
168
176
  /** Dim non-hovered series when hovering a data mark. Requires `colorBy`. */
169
177
  hoverHighlight?: HoverHighlightMode;
170
- /** Max pixel distance for hover/click hit testing. Default 30. Increase for sparse charts, decrease for dense ones. */
178
+ /** Requested minimum hit radius in pixels. The effective radius also honors the visible mark radius plus tolerance and a 12px floor. Default 30. */
171
179
  hoverRadius?: number;
172
180
  /** ID accessor for remove()/update() on XY charts. Extracts a unique identifier from each datum. */
173
181
  pointIdAccessor?: string | ((d: Datum) => string);
@@ -188,7 +196,8 @@ export interface BaseChartProps {
188
196
  * Useful when a fixed scale (gauge, score band, KPI dial) needs
189
197
  * endpoints to read as the actual boundaries.
190
198
  *
191
- * Applies to:
199
+ * `frameProps.axes[i].extent` can override this independently for an XY
200
+ * axis. Applies to:
192
201
  * - XY charts: both x and y axes (linear, time, log).
193
202
  * - Ordinal charts: the value (r) axis only — the categorical
194
203
  * axis is a band scale and doesn't have a numeric tick set.
@@ -226,10 +235,16 @@ export type CategoryFormatFn = (label: string, index?: number) => string | React
226
235
  export type Accessor<T = DatumValue> = string | ((d: Datum, i?: number) => T);
227
236
  /**
228
237
  * Generic accessor type that provides autocomplete when TDatum is specified.
229
- * Uses Datum in the function param so HOC charts can pass
230
- * accessors to Stream Frames without contravariance errors under strict mode.
238
+ * Function accessors receive the caller's datum type, preserving inference and
239
+ * catching misspelled fields. The bivariant callback form keeps the accessor
240
+ * assignable at the internal Stream Frame boundary, where datum types are
241
+ * intentionally erased to the shared `Datum` shape.
231
242
  */
232
- export type ChartAccessor<TDatum, T> = (keyof TDatum & string) | ((d: Datum, i?: number) => T);
243
+ type DatumBoundaryAccessor<T> = {
244
+ bivarianceHack(d: Datum, i?: number): T;
245
+ }["bivarianceHack"];
246
+ type ChartAccessorFunction<TDatum, T> = ((d: TDatum, i?: number) => T) & DatumBoundaryAccessor<T>;
247
+ export type ChartAccessor<TDatum, T> = (keyof TDatum & string) | ChartAccessorFunction<TDatum, T>;
233
248
  /**
234
249
  * Color configuration
235
250
  */
@@ -250,3 +265,4 @@ export interface SizeConfig<TDatum = Datum> {
250
265
  /** Min and max size range */
251
266
  sizeRange?: [number, number];
252
267
  }
268
+ export {};
@@ -1,6 +1,6 @@
1
1
  import type { Accessor } from "./types";
2
2
  import type { MarginType, PartialMargin } from "../../types/marginType";
3
- import type { LegendLayout, LegendValue } from "../../types/legendTypes";
3
+ import type { LegendItem, LegendLayout, LegendValue } from "../../types/legendTypes";
4
4
  import { type AxisChromeInput } from "../../legendLayout";
5
5
  import type { Datum } from "./datumTypes";
6
6
  /**
@@ -15,7 +15,29 @@ export declare function distinctCategories(data: readonly Datum[], colorBy: Acce
15
15
  * expansion pattern that every chart with color encoding repeats.
16
16
  */
17
17
  export type LegendPosition = "right" | "left" | "top" | "bottom";
18
- export declare function useChartLegendAndMargin({ data, colorBy, colorScale, showLegend, legendPosition, userMargin, defaults, categories, additionalLegend, chartWidth, legendLayout, hasTitle, axisChrome, }: {
18
+ /**
19
+ * Legend-related frame overrides. High-level chart wrappers spread
20
+ * `frameProps` last, so legend measurement must resolve these fields with the
21
+ * same precedence as the rendered Stream frame.
22
+ */
23
+ export interface FrameLegendOverrides {
24
+ legend?: LegendValue;
25
+ legendPosition?: LegendPosition;
26
+ legendLayout?: LegendLayout;
27
+ /** Any explicit frame margin replaces the HOC-measured margin. */
28
+ margin?: unknown;
29
+ }
30
+ /**
31
+ * Resolve the legend values consumed by layout before a wrapper forwards its
32
+ * `frameProps`. Keeping this at the shared margin boundary prevents a
33
+ * frame-level position/layout override from moving the legend after the plot
34
+ * margin has already been measured for a different side.
35
+ */
36
+ export declare function resolveFrameLegendOverrides(legendPosition: LegendPosition | undefined, legendLayout: LegendLayout | undefined, frameLegend: FrameLegendOverrides | undefined): {
37
+ legendPosition: LegendPosition;
38
+ legendLayout: LegendLayout | undefined;
39
+ };
40
+ export declare function useChartLegendAndMargin({ data, colorBy, colorScale, showLegend, legendPosition: legendPositionProp, userMargin, defaults, categories, additionalLegend, chartWidth, chartHeight, legendLayout, frameLegend, hasTitle, axisChrome }: {
19
41
  data: Array<Datum>;
20
42
  colorBy: Accessor<string> | undefined;
21
43
  colorScale: ((v: string) => string) | undefined;
@@ -28,8 +50,14 @@ export declare function useChartLegendAndMargin({ data, colorBy, colorScale, sho
28
50
  additionalLegend?: LegendValue;
29
51
  /** Total chart width, used to estimate wrapping for top/bottom legends. */
30
52
  chartWidth?: number;
53
+ /** Total chart height, used to keep legend reservation from consuming a
54
+ * compact frame's whole plot. */
55
+ chartHeight?: number;
31
56
  /** Legend metrics shared with the renderer. */
32
57
  legendLayout?: LegendLayout;
58
+ /** Frame-level legend fields, which take precedence just as `frameProps`
59
+ * does when the wrapper renders the Stream frame. */
60
+ frameLegend?: FrameLegendOverrides;
33
61
  /** Reserve the chart-title band above a top legend. */
34
62
  hasTitle?: boolean;
35
63
  /**
@@ -42,17 +70,17 @@ export declare function useChartLegendAndMargin({ data, colorBy, colorScale, sho
42
70
  legend: LegendValue | undefined;
43
71
  margin: MarginType;
44
72
  legendPosition: LegendPosition;
73
+ legendLayout: LegendLayout | undefined;
74
+ /** Whether this hook's margin still reaches the rendered Stream frame. */
75
+ legendMarginReserved: boolean;
76
+ hasAutomaticLegend: boolean;
45
77
  };
46
78
  export type LegendInteractionMode = "highlight" | "isolate" | "none";
47
79
  export interface LegendInteractionState {
48
80
  highlightedCategory: string | null;
49
81
  isolatedCategories: Set<string>;
50
- onLegendHover: (item: {
51
- label: string;
52
- } | null) => void;
53
- onLegendClick: (item: {
54
- label: string;
55
- }) => void;
82
+ onLegendHover: (item: LegendItem | null) => void;
83
+ onLegendClick: (item: LegendItem) => void;
56
84
  /** Selection predicate that dims non-matching data — use with wrapStyleWithSelection */
57
85
  legendSelectionHook: {
58
86
  isActive: boolean;
@@ -68,4 +96,10 @@ export interface LegendInteractionState {
68
96
  * `DEFAULT_SELECTION_OPACITY` fallback.
69
97
  * - "isolate": click toggles category visibility; click all to reset
70
98
  */
71
- export declare function useLegendInteraction(mode: LegendInteractionMode | undefined, colorBy: string | ((d: Datum) => string) | undefined, allCategories: string[]): LegendInteractionState;
99
+ export declare function useLegendInteraction(mode: LegendInteractionMode | undefined, colorBy: string | ((d: Datum) => string) | undefined, allCategories: string[], enabled?: boolean, requireInferredItem?: boolean): LegendInteractionState;
100
+ /**
101
+ * Continuous counterpart to `useLegendInteraction`. Gradient legends expose a
102
+ * small set of keyboard/pointer-addressable ranges; highlight and isolate then
103
+ * apply those ranges to the chart's numeric value accessor.
104
+ */
105
+ export declare function useGradientLegendInteraction(mode: LegendInteractionMode | undefined, valueAccessor: (d: Datum) => number, domain: [number, number], binCount?: number): LegendInteractionState;
@@ -1,7 +1,7 @@
1
1
  import type { Datum } from "./datumTypes";
2
2
  import type { AxisChromeInput } from "../../legendLayout";
3
3
  import { useChartLegendAndMargin, useLegendInteraction, DEFAULT_COLOR } from "./hooks";
4
- import type { LegendInteractionMode, LegendPosition } from "./hooks";
4
+ import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition } from "./hooks";
5
5
  import type { Accessor, SelectionConfig, LinkedHoverProp, HoverHighlightMode, MobileInteractionProp, ResolvedMobileInteractionConfig } from "./types";
6
6
  import type { MobileVisualizationContract } from "./auditMobileVisualization";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
@@ -50,6 +50,8 @@ export interface ChartSetupInput {
50
50
  legend?: LegendValue;
51
51
  /** Shared legend metrics, including any side-axis gutter. */
52
52
  legendLayout?: LegendLayout;
53
+ /** Frame-level legend fields which take precedence in the rendered frame. */
54
+ frameLegend?: FrameLegendOverrides;
53
55
  /** User-provided margin */
54
56
  userMargin: PartialMargin | undefined;
55
57
  /** Mode-resolved margin defaults */
@@ -9,7 +9,8 @@ import { type PartialMargin, type MarginType } from "../../types/marginType";
9
9
  import type { Datum } from "./datumTypes";
10
10
  import type { RealtimeFrameHandle } from "../../realtime/types";
11
11
  import type { LegendValue } from "../../types/legendTypes";
12
- import type { LegendInteractionMode, LegendPosition } from "./useChartLegend";
12
+ import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition } from "./useChartLegend";
13
+ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
13
14
  /**
14
15
  * Margin shorthand → sided form. The Stream*Frame margin props only
15
16
  * accept the sided object form, so HOCs that expose the user-friendly
@@ -32,7 +33,7 @@ interface ScaffoldOptions {
32
33
  title?: string;
33
34
  description?: string;
34
35
  summary?: string;
35
- accessibleTable?: boolean;
36
+ accessibleTable?: AccessibleTableProp;
36
37
  mobileInteraction?: MobileInteractionProp;
37
38
  mobileSemantics?: MobileVisualizationContract;
38
39
  responsiveRules?: ResponsiveRule[];
@@ -70,6 +71,8 @@ interface DataSetupOptions extends ScaffoldOptions {
70
71
  legend?: LegendValue;
71
72
  legendInteraction?: LegendInteractionMode;
72
73
  legendPosition?: LegendPosition;
74
+ /** Frame-level legend fields which take precedence in the rendered frame. */
75
+ frameLegend?: FrameLegendOverrides;
73
76
  /** Pass-through chart-setup inputs. */
74
77
  selection?: SelectionConfig;
75
78
  linkedHover?: LinkedHoverProp;
@@ -5,7 +5,7 @@ import type { MobileVisualizationContract } from "./auditMobileVisualization";
5
5
  import type { OnObservationCallback } from "../../store/ObservationStore";
6
6
  import type { PartialMargin, MarginType } from "../../types/marginType";
7
7
  import { useChartSelection, useChartLegendAndMargin } from "./hooks";
8
- import type { LegendInteractionMode, LegendPosition, LegendInteractionState } from "./hooks";
8
+ import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition, LegendInteractionState } from "./hooks";
9
9
  export interface NetworkChartSetupInput<TNode extends Datum = Datum, TEdge extends Datum = Datum> {
10
10
  /** Raw `nodes` prop (may be undefined). */
11
11
  nodes: TNode[] | undefined;
@@ -29,6 +29,8 @@ export interface NetworkChartSetupInput<TNode extends Datum = Datum, TEdge exten
29
29
  showLegend?: boolean;
30
30
  legendPosition?: LegendPosition;
31
31
  legendInteraction?: LegendInteractionMode;
32
+ /** Frame-level legend fields which take precedence in the rendered frame. */
33
+ frameLegend?: FrameLegendOverrides;
32
34
  selection?: SelectionConfig;
33
35
  linkedHover?: LinkedHoverProp;
34
36
  onObservation?: OnObservationCallback;
@@ -98,6 +100,8 @@ export interface NetworkChartSetupResult {
98
100
  legend: ReturnType<typeof useChartLegendAndMargin>["legend"];
99
101
  margin: MarginType;
100
102
  legendPosition: LegendPosition;
103
+ /** Internal hand-off which prevents duplicate Stream-frame reservation. */
104
+ legendBehaviorProps: Record<string, unknown>;
101
105
  mobileInteraction: ResolvedMobileInteractionConfig;
102
106
  customHoverBehavior: ReturnType<typeof useChartSelection>["customHoverBehavior"];
103
107
  customClickBehavior: ReturnType<typeof useChartSelection>["customClickBehavior"];
@@ -1,6 +1,6 @@
1
1
  import type { ChartAccessor } from "./types";
2
2
  import type { Datum } from "./datumTypes";
3
- export interface OrdinalBrushInput {
3
+ export interface OrdinalBrushInput<TDatum extends Datum = Datum> {
4
4
  brushProp: boolean | undefined;
5
5
  onBrushProp: ((extent: {
6
6
  r: [number, number];
@@ -9,7 +9,7 @@ export interface OrdinalBrushInput {
9
9
  name: string;
10
10
  rField?: string;
11
11
  } | undefined;
12
- valueAccessor: ChartAccessor<Datum, number>;
12
+ valueAccessor: ChartAccessor<TDatum, number>;
13
13
  }
14
14
  export interface OrdinalBrushResult {
15
15
  hasBrush: boolean;
@@ -26,4 +26,4 @@ export interface OrdinalBrushResult {
26
26
  } | null) => void;
27
27
  } | Record<string, never>;
28
28
  }
29
- export declare function useOrdinalBrush({ brushProp, onBrushProp, linkedBrush, valueAccessor, }: OrdinalBrushInput): OrdinalBrushResult;
29
+ export declare function useOrdinalBrush<TDatum extends Datum = Datum>({ brushProp, onBrushProp, linkedBrush, valueAccessor, }: OrdinalBrushInput<TDatum>): OrdinalBrushResult;