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,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,9 +107,9 @@ 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;
@@ -166,14 +167,15 @@ export interface BaseChartProps {
166
167
  /** Accessible summary rendered as a screen-reader-only note.
167
168
  * Use for trend descriptions or key takeaways that supplement the visual. */
168
169
  summary?: string;
169
- /** Enable accessible data table below the chart canvas. Default: true (via frame). */
170
- 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;
171
173
  /** Callback when a data element is clicked. Receives the original datum and pixel coordinates.
172
174
  * For lines, receives the line data; for bars, the bar datum; for pie slices, the slice datum. */
173
175
  onClick?: DatumClickHandler;
174
176
  /** Dim non-hovered series when hovering a data mark. Requires `colorBy`. */
175
177
  hoverHighlight?: HoverHighlightMode;
176
- /** 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. */
177
179
  hoverRadius?: number;
178
180
  /** ID accessor for remove()/update() on XY charts. Extracts a unique identifier from each datum. */
179
181
  pointIdAccessor?: string | ((d: Datum) => string);
@@ -233,10 +235,16 @@ export type CategoryFormatFn = (label: string, index?: number) => string | React
233
235
  export type Accessor<T = DatumValue> = string | ((d: Datum, i?: number) => T);
234
236
  /**
235
237
  * Generic accessor type that provides autocomplete when TDatum is specified.
236
- * Uses Datum in the function param so HOC charts can pass
237
- * 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.
238
242
  */
239
- 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>;
240
248
  /**
241
249
  * Color configuration
242
250
  */
@@ -257,3 +265,4 @@ export interface SizeConfig<TDatum = Datum> {
257
265
  /** Min and max size range */
258
266
  sizeRange?: [number, number];
259
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;
@@ -24,7 +24,7 @@ import { type LegendPosition } from "./hooks";
24
24
  * but new code should rely on `setup.legend` / `setup.margin` from
25
25
  * `useChartSetup` instead.
26
26
  */
27
- export declare function useStreamingLegend({ isPushMode, colorBy, colorScheme, showLegend, legendPosition, }: {
27
+ export declare function useStreamingLegend({ isPushMode, colorBy, colorScheme, showLegend, legendPosition, trackCategoryDomain, registerLinkedCategories }: {
28
28
  /** True when data prop is undefined (push API mode) */
29
29
  isPushMode: boolean;
30
30
  /** The color-by accessor (may be derived from stackBy/groupBy/categoryAccessor) */
@@ -35,6 +35,10 @@ export declare function useStreamingLegend({ isPushMode, colorBy, colorScheme, s
35
35
  showLegend: boolean | undefined;
36
36
  /** Legend position */
37
37
  legendPosition?: LegendPosition;
38
+ /** Install frame-domain discovery; disable when no legend/linked consumer needs it. */
39
+ trackCategoryDomain?: boolean;
40
+ /** Disable when the caller already registers the same domain through chart setup. */
41
+ registerLinkedCategories?: boolean;
38
42
  }): {
39
43
  wrapPush: (originalPush: (d: Datum) => void) => (datum: Datum) => void;
40
44
  wrapPushMany: (originalPushMany: (data: Datum[]) => void) => (data: Datum[]) => void;
@@ -54,6 +58,7 @@ export declare function useStreamingLegend({ isPushMode, colorBy, colorScheme, s
54
58
  items: {
55
59
  label: string;
56
60
  color: string;
61
+ __semioticCategory: boolean;
57
62
  }[];
58
63
  label: string;
59
64
  }[];
@@ -163,7 +163,7 @@ export interface BigNumberProps<_TDatum extends Datum = Datum> {
163
163
  * routes the card into its empty state (see `emptyContent`); this lets
164
164
  * consumers pass `data?.revenue` style optional values without a
165
165
  * conditional. */
166
- value: number | null | undefined;
166
+ value?: number | null;
167
167
  /** Top-line descriptor — e.g. `"Q3 Revenue"`. Rendered above the value. */
168
168
  label?: string;
169
169
  /** Secondary descriptor, smaller, below the label. */
@@ -182,7 +182,7 @@ export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChar
182
182
  * data={data}
183
183
  * sizeBy="value"
184
184
  * frameProps={{
185
- * customPointMark: ({ d }) => <circle r={d.r} fill="gold" />
185
+ * pointStyle: () => ({ fill: "gold", stroke: "#333" })
186
186
  * }}
187
187
  * />
188
188
  * ```