semiotic 3.8.9 → 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 (500) hide show
  1. package/README.md +83 -67
  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-xy.d.ts +4 -1
  220. package/dist/components/semiotic.d.ts +68 -26
  221. package/dist/components/server/animatedGif.d.ts +1 -1
  222. package/dist/components/server/renderEvidence.d.ts +25 -2
  223. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  224. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  225. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  226. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  227. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  228. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  230. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  231. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  232. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  233. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  234. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  235. package/dist/components/server/staticAnnotations.d.ts +28 -1
  236. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  237. package/dist/components/server/staticLegend.d.ts +1 -1
  238. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  239. package/dist/components/server/staticOrdinal.d.ts +8 -2
  240. package/dist/components/server/staticPhysics.d.ts +13 -1
  241. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  242. package/dist/components/server/staticRawLegend.d.ts +15 -0
  243. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  244. package/dist/components/server/staticXYAxes.d.ts +27 -0
  245. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  246. package/dist/components/server/staticXYGrid.d.ts +11 -0
  247. package/dist/components/server/themeResolver.d.ts +5 -1
  248. package/dist/components/store/ThemeStore.d.ts +2 -98
  249. package/dist/components/store/designTokens.d.ts +1 -1
  250. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  251. package/dist/components/store/themeCore.d.ts +91 -0
  252. package/dist/components/store/themePresets.d.ts +81 -0
  253. package/dist/components/store/themeSerialization.d.ts +2 -1
  254. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  255. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  256. package/dist/components/stream/GeoTileRenderer.d.ts +2 -0
  257. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  258. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  259. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  260. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  261. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  262. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  263. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  264. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  265. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  266. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  268. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  269. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  270. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  271. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  272. package/dist/components/stream/canvasBackground.d.ts +10 -0
  273. package/dist/components/stream/canvasSetup.d.ts +9 -0
  274. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  275. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  276. package/dist/components/stream/frameGraphics.d.ts +18 -0
  277. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  278. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  279. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  280. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  281. package/dist/components/stream/geoTypes.d.ts +10 -11
  282. package/dist/components/stream/hitTarget.d.ts +61 -2
  283. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  284. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  285. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  286. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  287. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  288. package/dist/components/stream/networkFramePaint.d.ts +7 -0
  289. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  290. package/dist/components/stream/networkTypes.d.ts +30 -32
  291. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  292. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  294. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  295. package/dist/components/stream/ordinalTypes.d.ts +10 -4
  296. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  297. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  298. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  299. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  300. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  301. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  302. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  303. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  304. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  305. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +23 -4
  306. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  307. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  308. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  309. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  310. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  311. package/dist/components/stream/pipelineConfig.d.ts +6 -17
  312. package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
  313. package/dist/components/stream/renderBackend.d.ts +2 -0
  314. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  315. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  316. package/dist/components/stream/responsiveSize.d.ts +17 -0
  317. package/dist/components/stream/sceneCursor.d.ts +41 -0
  318. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  319. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  320. package/dist/components/stream/types.d.ts +25 -12
  321. package/dist/components/stream/useCanvasFrameHost.d.ts +3 -1
  322. package/dist/components/stream/useFrame.d.ts +24 -1
  323. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  324. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  325. package/dist/components/stream/xyFrameAxisTypes.d.ts +15 -4
  326. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  327. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  328. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  329. package/dist/components/types/legendTypes.d.ts +6 -0
  330. package/dist/components/types/marginType.d.ts +7 -8
  331. package/dist/controls.min.js +1 -1
  332. package/dist/controls.module.min.js +1 -1
  333. package/dist/forceLayoutWorker.js +1 -1
  334. package/dist/geo.min.js +1 -1
  335. package/dist/geo.module.min.js +1 -1
  336. package/dist/network.min.js +1 -1
  337. package/dist/network.module.min.js +1 -1
  338. package/dist/ordinal.min.js +1 -1
  339. package/dist/ordinal.module.min.js +1 -1
  340. package/dist/physics-matter.module.min.js +1 -1
  341. package/dist/physics-rapier.module.min.js +1 -1
  342. package/dist/physics.min.js +1 -1
  343. package/dist/physics.module.min.js +1 -1
  344. package/dist/physicsWorker.js +1 -1
  345. package/dist/processSankeyLayoutWorker.js +1 -1
  346. package/dist/realtime.min.js +1 -1
  347. package/dist/realtime.module.min.js +1 -1
  348. package/dist/rough.min.js +1 -1
  349. package/dist/rough.module.min.js +1 -1
  350. package/dist/semiotic-ai-core.d.ts +13 -4
  351. package/dist/semiotic-ai-core.min.js +1 -1
  352. package/dist/semiotic-ai-core.module.min.js +1 -1
  353. package/dist/semiotic-ai.d.ts +16 -9
  354. package/dist/semiotic-ai.min.js +1 -1
  355. package/dist/semiotic-ai.module.min.js +1 -1
  356. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  357. package/dist/semiotic-client-glyph.module.min.js +2 -0
  358. package/dist/semiotic-client-responsive.module.min.js +2 -0
  359. package/dist/semiotic-client-shared.module.min.js +2 -0
  360. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  361. package/dist/semiotic-data.min.js +1 -1
  362. package/dist/semiotic-data.module.min.js +1 -1
  363. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  364. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node.module.min.js +2 -0
  366. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  367. package/dist/semiotic-experimental-vacp.min.js +1 -1
  368. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  369. package/dist/semiotic-experimental.d.ts +1 -1
  370. package/dist/semiotic-experimental.min.js +1 -1
  371. package/dist/semiotic-experimental.module.min.js +1 -1
  372. package/dist/semiotic-geo.d.ts +4 -1
  373. package/dist/semiotic-network.d.ts +7 -4
  374. package/dist/semiotic-ordinal.d.ts +4 -1
  375. package/dist/semiotic-physics.d.ts +11 -4
  376. package/dist/semiotic-realtime-core.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.min.js +2 -1
  378. package/dist/semiotic-realtime-core.module.min.js +2 -1
  379. package/dist/semiotic-realtime-react.d.ts +4 -3
  380. package/dist/semiotic-realtime-react.min.js +1 -1
  381. package/dist/semiotic-realtime-react.module.min.js +1 -1
  382. package/dist/semiotic-realtime.d.ts +3 -1
  383. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  384. package/dist/semiotic-recipes-core.d.ts +7 -5
  385. package/dist/semiotic-recipes-core.min.js +9 -1
  386. package/dist/semiotic-recipes-core.module.min.js +1 -1
  387. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  388. package/dist/semiotic-recipes-react.min.js +1 -1
  389. package/dist/semiotic-recipes-react.module.min.js +1 -1
  390. package/dist/semiotic-recipes.min.js +7 -1
  391. package/dist/semiotic-recipes.module.min.js +2 -1
  392. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  393. package/dist/semiotic-server-edge.d.ts +3 -2
  394. package/dist/semiotic-server-edge.min.js +1 -1
  395. package/dist/semiotic-server-edge.module.min.js +1 -1
  396. package/dist/semiotic-server-node.min.js +1 -1
  397. package/dist/semiotic-server-node.module.min.js +1 -1
  398. package/dist/semiotic-server.d.ts +3 -2
  399. package/dist/semiotic-themes-core.d.ts +5 -48
  400. package/dist/semiotic-themes-core.min.js +1 -1
  401. package/dist/semiotic-themes-core.module.min.js +1 -1
  402. package/dist/semiotic-themes-react.min.js +1 -1
  403. package/dist/semiotic-themes-react.module.min.js +1 -1
  404. package/dist/semiotic-themes.min.js +1 -1
  405. package/dist/semiotic-themes.module.min.js +1 -1
  406. package/dist/semiotic-utils-core.d.ts +10 -5
  407. package/dist/semiotic-utils-core.min.js +1 -1
  408. package/dist/semiotic-utils-core.module.min.js +1 -1
  409. package/dist/semiotic-utils-react.d.ts +2 -0
  410. package/dist/semiotic-utils-react.min.js +1 -1
  411. package/dist/semiotic-utils-react.module.min.js +1 -1
  412. package/dist/semiotic-utils.min.js +2 -1
  413. package/dist/semiotic-utils.module.min.js +2 -1
  414. package/dist/semiotic-value.min.js +1 -1
  415. package/dist/semiotic-value.module.min.js +1 -1
  416. package/dist/semiotic-xy.d.ts +4 -1
  417. package/dist/semiotic.d.ts +68 -26
  418. package/dist/semiotic.min.js +1 -1
  419. package/dist/semiotic.module.min.js +1 -1
  420. package/dist/server.min.js +1 -1
  421. package/dist/server.module.min.js +1 -1
  422. package/dist/xy.min.js +1 -1
  423. package/dist/xy.module.min.js +1 -1
  424. package/package.json +53 -19
  425. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  426. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  427. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  428. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  429. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  430. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  431. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  432. package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
  433. package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
  434. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  435. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  436. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  437. package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
  438. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  439. package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
  440. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  441. package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
  442. package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
  443. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  444. package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
  445. package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
  446. package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
  447. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  448. package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
  449. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  450. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  451. package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
  452. package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
  453. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  454. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  455. package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
  456. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  457. package/dist/chunk-chunk-HIV7AW2V.module.min.js +0 -2
  458. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  459. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  460. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  461. package/dist/chunk-chunk-JZAMMSQQ.module.min.js +0 -2
  462. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  463. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  464. package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
  465. package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
  466. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  467. package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
  468. package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
  469. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  470. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  471. package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
  472. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  473. package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
  474. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  475. package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
  476. package/dist/chunk-chunk-SKLYXNYW.module.min.js +0 -2
  477. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  478. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  479. package/dist/chunk-chunk-U4NZCU5T.module.min.js +0 -2
  480. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  481. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  482. package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
  483. package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
  484. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  485. package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
  486. package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
  487. package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
  488. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  489. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  490. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  491. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  492. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  493. package/dist/test-utils/canvasMock.d.ts +0 -86
  494. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  495. package/dist/test-utils/frameMock.d.ts +0 -81
  496. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  497. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  498. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  499. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  500. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -0,0 +1,30 @@
1
+ import type { ReactNode } from "react";
2
+ import type { TooltipPropWithHoverCallback } from "../../Tooltip/Tooltip";
3
+ import type { HoverData } from "../../stream/types";
4
+ import type { Datum } from "../shared/datumTypes";
5
+ import type { ChartAccessor } from "../shared/types";
6
+ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
7
+ /** Accessibility metadata shared by the streaming chart wrappers. */
8
+ export interface RealtimeAccessibilityProps {
9
+ /** Visible chart title and accessible name. */
10
+ title?: string;
11
+ /** Concise accessible description overriding the generated frame label. */
12
+ description?: string;
13
+ /** Screen-reader-only takeaway or interaction guidance. */
14
+ summary?: string;
15
+ /** Expose the current streaming window as an accessible data table. @default true */
16
+ accessibleTable?: AccessibleTableProp;
17
+ }
18
+ /**
19
+ * Realtime charts historically passed the full HoverData wrapper to a custom
20
+ * tooltip callback. Keep that published callback contract while also accepting
21
+ * the shared declarative and multi-series tooltip forms.
22
+ */
23
+ export type RealtimeTooltipProp = TooltipPropWithHoverCallback | ((data: HoverData) => ReactNode);
24
+ /** Typed data inference plus the broader array accepted by the 3.x API. */
25
+ export type RealtimeData<TDatum extends Datum> = TDatum[] | Datum[];
26
+ /**
27
+ * Typed accessor authoring plus the loose string/Datum callback forms shipped
28
+ * by the 3.x realtime wrappers.
29
+ */
30
+ export type RealtimePointIdAccessor<TDatum extends Datum> = string | ChartAccessor<TDatum, string>;
@@ -0,0 +1,30 @@
1
+ type CategoryOrder = "discovery" | "explicit-then-alpha";
2
+ interface RealtimeCategoryColorOptions {
3
+ /** Whether the chart has an active category encoding. */
4
+ enabled: boolean;
5
+ /** Current controlled or frame-discovered category domain. */
6
+ categories: string[];
7
+ /** Consumer-authored exact category colors. */
8
+ colors?: Record<string, string>;
9
+ /** Consumer-authored fallback fill for categories absent from the map. */
10
+ fallbackColor?: string;
11
+ /** Preserve histogram stack ordering without changing swarm discovery order. */
12
+ order?: CategoryOrder;
13
+ /** Reset palette assignments when the category encoding itself changes. */
14
+ domainKey?: unknown;
15
+ }
16
+ /**
17
+ * Resolve realtime category colors once for both retained marks and legends.
18
+ *
19
+ * Precedence matches the existing streaming-legend contract:
20
+ * CategoryColorProvider → explicit category map → explicit fallback fill →
21
+ * categorical theme → the streaming fallback palette. Partial
22
+ * explicit/provider maps intentionally fall through instead of collapsing
23
+ * every unmapped category unless the consumer deliberately supplied a
24
+ * uniform fallback fill.
25
+ */
26
+ export declare function useRealtimeCategoryColors({ enabled, categories, colors, fallbackColor, order, domainKey }: RealtimeCategoryColorOptions): {
27
+ colorScale: ((category: string) => string) | undefined;
28
+ colorMap: Record<string, string> | undefined;
29
+ };
30
+ export {};
@@ -0,0 +1,10 @@
1
+ import * as React from "react";
2
+ import type { Datum } from "./datumTypes";
3
+ import { type FrameTextStyleDefaults } from "./frameTextAnnotation";
4
+ /** SVG-only renderer shared by live annotation rules and static rendering. */
5
+ export declare function FrameTextAnnotationSVG({ annotation, width, height, defaults }: {
6
+ annotation: Datum;
7
+ width: number;
8
+ height: number;
9
+ defaults?: FrameTextStyleDefaults;
10
+ }): React.JSX.Element | null;
@@ -1,7 +1,8 @@
1
1
  import * as React from "react";
2
- import type { Datum } from "./datumTypes";
3
2
  import type { OnObservationCallback, ObservationInputType } from "../../store/ObservationStore";
4
- export type ChartAnnotation = Datum;
3
+ import { type ChartAnnotation } from "./annotationIdentity";
4
+ export { annotationStableId } from "./annotationIdentity";
5
+ export type { ChartAnnotation } from "./annotationIdentity";
5
6
  export interface AnnotationActivationEvent {
6
7
  annotation: ChartAnnotation;
7
8
  annotationId?: string;
@@ -17,11 +18,6 @@ export interface AnnotationActivationOptions {
17
18
  }
18
19
  /** Route annotation activation to both a direct callback and the observation store. */
19
20
  export declare function useAnnotationActivationOptions(options: AnnotationActivationOptions): AnnotationActivationOptions;
20
- /**
21
- * Resolve a durable annotation identity without ever falling back to array
22
- * position. Provenance stable IDs are accepted for agent-authored notes.
23
- */
24
- export declare function annotationStableId(annotation: ChartAnnotation): string | undefined;
25
21
  /**
26
22
  * Event props for a widget's existing HTML boundary. Capture phase observes
27
23
  * arbitrary descendant controls without replacing their behavior or adding a
@@ -0,0 +1,6 @@
1
+ import type { Datum } from "./datumTypes";
2
+ /** Resolve the solid/gradient paint contract shared by browser and static bands. */
3
+ export declare function resolveAnnotationBandFill(annotation: Datum, idBase: string, direction: "horizontal" | "vertical", fallback: string): {
4
+ fill: string;
5
+ def?: React.ReactElement;
6
+ };
@@ -0,0 +1,31 @@
1
+ import * as React from "react";
2
+ import type { AnnotationContext } from "../../realtime/types";
3
+ import type { Datum } from "./datumTypes";
4
+ export type AnnotationRule = (annotation: Datum, index: number, context: AnnotationContext) => React.ReactNode | null;
5
+ /**
6
+ * Run the SVG-overlay annotation pass: dispatch each annotation through the
7
+ * user's `svgAnnotationRules` (falling back to the default rules), drop the
8
+ * ones that render nothing, then apply emphasis hierarchy. Shared verbatim by
9
+ * the XY and ordinal overlays so the dispatch/filter/hierarchy logic lives in
10
+ * one place.
11
+ *
12
+ * Falsy-node semantics match the pre-emphasis `.filter(Boolean)` exactly: a
13
+ * rule returning `null`/`undefined` ("skip", e.g. the default rules' out-of-
14
+ * bounds path) — or any other falsy node (`0`/`""`/`false`) — produces no
15
+ * annotation and is dropped. A user rule that returns `null`/`undefined` falls
16
+ * through to the default rule, preserving the existing override contract.
17
+ */
18
+ export declare function renderAnnotationPass(annotations: ReadonlyArray<Datum>, defaultRule: AnnotationRule, userRule: AnnotationRule | undefined, context: AnnotationContext): React.ReactNode[];
19
+ /**
20
+ * The same annotation pass as {@link renderAnnotationPass}, with the source
21
+ * annotations that actually produced SVG nodes retained alongside the nodes.
22
+ *
23
+ * Server rendering uses this to report annotation evidence from the rendered
24
+ * scene rather than from the input prop bag. Keeping this at the shared
25
+ * dispatch boundary ensures custom rules, fallback semantics, and hierarchy
26
+ * treatment stay identical in live and static renderers.
27
+ */
28
+ export declare function renderAnnotationPassWithResult(annotations: ReadonlyArray<Datum>, defaultRule: AnnotationRule, userRule: AnnotationRule | undefined, context: AnnotationContext): {
29
+ nodes: React.ReactNode[];
30
+ renderedAnnotations: Datum[];
31
+ };
@@ -0,0 +1,8 @@
1
+ import type { Datum } from "./datumTypes";
2
+ /** Annotation shape shared by React interaction and headless diagnostics. */
3
+ export type ChartAnnotation = Datum;
4
+ /**
5
+ * Resolve a durable annotation identity without ever falling back to array
6
+ * position. Provenance stable IDs are accepted for agent-authored notes.
7
+ */
8
+ export declare function annotationStableId(annotation: ChartAnnotation): string | undefined;
@@ -3,19 +3,5 @@ import type { AnnotationContext } from "../../realtime/types";
3
3
  import type { Datum } from "./datumTypes";
4
4
  import { type AnnotationActivationOptions } from "./annotationActivation";
5
5
  export { applyAnnotationEmphasis, type AnnotationRenderPair } from "./annotationHierarchy";
6
- type AnnotationRule = (annotation: Datum, index: number, context: AnnotationContext) => React.ReactNode | null;
7
- /**
8
- * Run the SVG-overlay annotation pass: dispatch each annotation through the
9
- * user's `svgAnnotationRules` (falling back to the default rules), drop the
10
- * ones that render nothing, then apply emphasis hierarchy. Shared verbatim by
11
- * the XY and ordinal overlays so the dispatch/filter/hierarchy logic lives in
12
- * one place.
13
- *
14
- * Falsy-node semantics match the pre-emphasis `.filter(Boolean)` exactly: a
15
- * rule returning `null`/`undefined` ("skip", e.g. the default rules' out-of-
16
- * bounds path) — or any other falsy node (`0`/`""`/`false`) — produces no
17
- * annotation and is dropped. A user rule that returns `null`/`undefined` falls
18
- * through to the default rule, preserving the existing override contract.
19
- */
20
- export declare function renderAnnotationPass(annotations: ReadonlyArray<Datum>, defaultRule: AnnotationRule, userRule: AnnotationRule | undefined, context: AnnotationContext): React.ReactNode[];
6
+ export { renderAnnotationPass, renderAnnotationPassWithResult, type AnnotationRule, } from "./annotationDispatch";
21
7
  export declare function createDefaultAnnotationRules(_frameType: "xy" | "ordinal" | "network", activation?: AnnotationActivationOptions): (annotation: Datum, index: number, context: AnnotationContext) => React.ReactNode | null;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Bound retained category strings for long-running charts. Categories below
3
+ * this limit keep first-seen sequential palette assignment. Higher-cardinality
4
+ * categories use a deterministic hash and are not retained.
5
+ */
6
+ export declare const MAX_RETAINED_CATEGORY_ASSIGNMENTS = 4096;
7
+ /** Resolve a stable palette index while keeping the discovery registry bounded. */
8
+ export declare function resolveBoundedCategoryIndex(registry: Map<string, number>, category: string): number;
@@ -0,0 +1,3 @@
1
+ import type { ChartPropSpec } from "./chartSpecCore";
2
+ /** Accessor grammar kept separate from the physics registry's chart metadata. */
3
+ export declare const CHAIN_REACTION_ACCESSOR_PROPS: Record<string, ChartPropSpec>;
@@ -1,6 +1,7 @@
1
1
  import type { ChartMode, LinkedHoverProp, MobileInteractionProp, ResolvedMobileInteractionConfig } from "./types";
2
2
  import type { MobileVisualizationContract } from "./auditMobileVisualization";
3
3
  import type { ResponsiveRule } from "./responsiveRules";
4
+ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
4
5
  export declare const MOBILE_INTERACTION_TARGET_SIZE = 44;
5
6
  export declare const MOBILE_INTERACTION_MIN_HIT_RADIUS = 24;
6
7
  export declare const MOBILE_INTERACTION_DEFAULTS: ResolvedMobileInteractionConfig;
@@ -25,7 +26,7 @@ export interface ChartModeInput {
25
26
  title?: string;
26
27
  description?: string;
27
28
  summary?: string;
28
- accessibleTable?: boolean;
29
+ accessibleTable?: AccessibleTableProp;
29
30
  xLabel?: string;
30
31
  yLabel?: string;
31
32
  categoryLabel?: string;
@@ -48,7 +49,7 @@ export interface ChartModeResult {
48
49
  title: string | undefined;
49
50
  description: string | undefined;
50
51
  summary: string | undefined;
51
- accessibleTable: boolean | undefined;
52
+ accessibleTable: AccessibleTableProp | undefined;
52
53
  xLabel: string | undefined;
53
54
  yLabel: string | undefined;
54
55
  categoryLabel: string | undefined;
@@ -157,6 +157,7 @@ export declare const PROP_BAGS: {
157
157
  readonly xyAxis: Record<string, ChartPropSpec>;
158
158
  readonly ordinalAxis: Record<string, ChartPropSpec>;
159
159
  readonly realtime: Record<string, ChartPropSpec>;
160
+ readonly realtimeStatic: Record<string, ChartPropSpec>;
160
161
  readonly physics: Record<string, ChartPropSpec>;
161
162
  };
162
163
  export declare const ORIENTATION_ENUM: readonly ["vertical", "horizontal"];
@@ -0,0 +1,63 @@
1
+ import type { Datum } from "./datumTypes";
2
+ /**
3
+ * Plot-relative anchors for serializable chart-adjacent text. Coordinates are
4
+ * resolved against the final plot rectangle, so the same annotation survives
5
+ * responsive layout and SSR without parsing SVG transforms.
6
+ */
7
+ export declare const FRAME_TEXT_POSITIONS: readonly ["top-left", "top-center", "top-right", "middle-left", "center", "middle-right", "bottom-left", "bottom-center", "bottom-right"];
8
+ export type FrameTextPosition = (typeof FRAME_TEXT_POSITIONS)[number];
9
+ export interface FrameTextAnnotationBase {
10
+ type: "frame-text";
11
+ position?: FrameTextPosition;
12
+ dx?: number;
13
+ dy?: number;
14
+ textAnchor?: "start" | "middle" | "end";
15
+ dominantBaseline?: "auto" | "middle" | "hanging";
16
+ fill?: string;
17
+ color?: string;
18
+ fontSize?: number;
19
+ fontFamily?: string;
20
+ fontWeight?: string | number;
21
+ fontStyle?: string;
22
+ letterSpacing?: string | number;
23
+ opacity?: number;
24
+ className?: string;
25
+ }
26
+ export type FrameTextAnnotation = FrameTextAnnotationBase & ({
27
+ label: string | number;
28
+ text?: string | number;
29
+ } | {
30
+ text: string | number;
31
+ label?: string | number;
32
+ });
33
+ export interface ResolvedFrameTextPosition {
34
+ x: number;
35
+ y: number;
36
+ textAnchor: "start" | "middle" | "end";
37
+ dominantBaseline: "auto" | "middle" | "hanging";
38
+ }
39
+ export interface FrameTextStyleDefaults {
40
+ fill: string;
41
+ fontSize: number;
42
+ fontFamily: string;
43
+ }
44
+ /** Resolve a `frame-text` annotation without consulting data scales. */
45
+ export declare function resolveFrameTextPosition(annotation: Datum, width: number, height: number): ResolvedFrameTextPosition;
46
+ /** Shared SVG attributes keep live and static frame-text output in lockstep. */
47
+ export declare function resolveFrameTextAttributes(annotation: Datum, width: number, height: number, defaults: FrameTextStyleDefaults): {
48
+ fill: any;
49
+ fontSize: any;
50
+ fontFamily: any;
51
+ fontWeight: any;
52
+ fontStyle: any;
53
+ letterSpacing: any;
54
+ opacity: any;
55
+ className: any;
56
+ style: {
57
+ pointerEvents: "none";
58
+ };
59
+ x: number;
60
+ y: number;
61
+ textAnchor: "start" | "middle" | "end";
62
+ dominantBaseline: "auto" | "middle" | "hanging";
63
+ };
@@ -27,9 +27,25 @@ export interface SemanticGradientStopInput {
27
27
  export type GradientInput = GradientConfig | boolean | ColorStopsConfig | OpacityEndpointsConfig;
28
28
  export type ColorGradientInput = GradientConfig | ColorStopsConfig;
29
29
  export type SemanticGradientInput = GradientConfig | SemanticGradientStopInput[];
30
+ /** A semantic stop after it has been made safe for an area's top stroke. */
31
+ export interface SemanticLineStop {
32
+ offset: number;
33
+ color: string;
34
+ opacity?: number;
35
+ }
30
36
  export declare const DEFAULT_GRADIENT: GradientConfig;
31
37
  export declare function normalizeGradient(input: GradientInput | null | undefined, defaultGradient?: GradientConfig): GradientConfig | undefined;
32
38
  export declare function normalizeColorGradient(input: ColorGradientInput | null | undefined): GradientConfig | undefined;
33
39
  export declare function normalizeSemanticGradient(input: SemanticGradientInput | null | undefined): GradientConfig | undefined;
40
+ /**
41
+ * Build the top-stroke counterpart of a semantic fill gradient.
42
+ *
43
+ * SVG gradients naturally extend their first stop down to zero. The segmented
44
+ * area stroke used to leave that range uncoloured, exposing the chart's normal
45
+ * brand stroke below the first semantic threshold. Carry the first coloured
46
+ * stop to zero so canvas, SVG, and static rendering have matching coverage;
47
+ * opacity is part of the same contract.
48
+ */
49
+ export declare function semanticLineStopsForGradient(gradient: GradientConfig | undefined): SemanticLineStop[] | undefined;
34
50
  export declare function reverseGradient(gradient: GradientConfig): GradientConfig;
35
51
  export {};
@@ -20,6 +20,7 @@
20
20
  * ```
21
21
  */
22
22
  import * as React from "react";
23
+ type AnnotationGradientDirection = "horizontal" | "vertical";
23
24
  /**
24
25
  * A declarative diagonal-hatch fill. Assign it anywhere a `style.fill`
25
26
  * is accepted (`pieceStyle`, `styleRules`, annotation region `fill`).
@@ -80,3 +81,17 @@ export declare function resolveSvgFill(fill: string | HatchFill | CanvasPattern
80
81
  fill: string;
81
82
  def?: React.ReactElement;
82
83
  };
84
+ /**
85
+ * Resolve the serializable `gradient` option accepted by band annotations.
86
+ *
87
+ * Gradient stops deliberately share the familiar `{ offset: 0..1, color?,
88
+ * opacity? }` contract used by area and legend gradients. The annotation owns
89
+ * its direction: horizontal for an x-band and vertical for a y-band, unless
90
+ * callers explicitly select the other direction. Invalid JSON input simply
91
+ * falls through to the annotation's solid fill instead of breaking rendering.
92
+ */
93
+ export declare function resolveAnnotationGradient(gradient: unknown, idBase: string, defaultDirection: AnnotationGradientDirection, fallback: string): {
94
+ fill: string;
95
+ def: React.ReactElement;
96
+ } | undefined;
97
+ export {};
@@ -5,7 +5,7 @@ import type { Accessor, SelectionConfig, LinkedHoverProp, ChartMode, HoverHighli
5
5
  import type { TransitionConfig } from "../../stream/types";
6
6
  import type { Datum } from "./datumTypes";
7
7
  import type { ChartModeInput, ChartModeResult } from "./chartMode";
8
- export { DISABLED_MOBILE_INTERACTION, MOBILE_INTERACTION_DEFAULTS, MOBILE_INTERACTION_MIN_HIT_RADIUS, MOBILE_INTERACTION_TARGET_SIZE, isChartMode, resolveChartMode, resolveMobileInteraction, } from "./chartMode";
8
+ export { DISABLED_MOBILE_INTERACTION, MOBILE_INTERACTION_DEFAULTS, MOBILE_INTERACTION_MIN_HIT_RADIUS, MOBILE_INTERACTION_TARGET_SIZE, isChartMode, resolveChartMode, resolveMobileInteraction } from "./chartMode";
9
9
  export type { ChartModeInput, ChartModeResult } from "./chartMode";
10
10
  import type { SemanticClickBehavior, SemanticHoverBehavior } from "./semanticInteractions";
11
11
  /**
@@ -63,7 +63,7 @@ export declare function useSortedData(data: Array<Datum>, sort: boolean | "asc"
63
63
  * @param unwrapData - Deprecated / no-op. Hover data is always unwrapped
64
64
  * (stream frames wrap the raw datum in { data, time, value, x, y }).
65
65
  */
66
- export declare function useChartSelection({ selection, linkedHover, fallbackFields, unwrapData: _unwrapData, onObservation, chartType, chartId, onClick, hoverHighlight, colorByField, mobileInteraction, }: {
66
+ export declare function useChartSelection({ selection, linkedHover, fallbackFields, unwrapData: _unwrapData, onObservation, chartType, chartId, onClick, hoverHighlight, colorByField, mobileInteraction }: {
67
67
  selection?: SelectionConfig;
68
68
  linkedHover?: LinkedHoverProp;
69
69
  fallbackFields?: string[];
@@ -94,8 +94,8 @@ export declare function getCrosshairProps(linkedHover: unknown, crosshairSourceI
94
94
  linkedCrosshairName: string;
95
95
  linkedCrosshairSourceId: string;
96
96
  } | undefined;
97
- export { useChartLegendAndMargin, useLegendInteraction, distinctCategories, } from "./useChartLegend";
98
- export type { LegendPosition, LegendInteractionMode, LegendInteractionState, } from "./useChartLegend";
97
+ export { useChartLegendAndMargin, useGradientLegendInteraction, useLegendInteraction, distinctCategories } from "./useChartLegend";
98
+ export type { FrameLegendOverrides, LegendPosition, LegendInteractionMode, LegendInteractionState } from "./useChartLegend";
99
99
  /**
100
100
  * React-facing alias for {@link resolveChartMode}. Mode resolution is kept
101
101
  * pure so non-React renderers (notably semiotic/server) consume the exact same
@@ -27,6 +27,7 @@ export declare function createLegend({ data, colorBy, colorScale, getColor, stro
27
27
  items: {
28
28
  label: string;
29
29
  color: string;
30
+ __semioticCategory: boolean;
30
31
  }[];
31
32
  label: string;
32
33
  }[];
@@ -7,6 +7,7 @@ import type { HoverHighlightMode, LinkedHoverProp, SelectionConfig, ResolvedMobi
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
8
8
  import type { AnimateProp } from "../../stream/pipelineTransitionUtils";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
+ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
10
11
  /**
11
12
  * The frames accept `tooltipContent: (d: HoverData) => ReactNode`,
12
13
  * which is a slightly wider parameter than the `TooltipContentFn`
@@ -41,7 +42,7 @@ export interface BaseMetadataProps {
41
42
  title?: string | ReactNode;
42
43
  description?: string;
43
44
  summary?: string;
44
- accessibleTable?: boolean;
45
+ accessibleTable?: AccessibleTableProp;
45
46
  className?: string;
46
47
  animate?: AnimateProp;
47
48
  maxDevicePixelRatio?: number;
@@ -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
  /**