semiotic 3.8.8 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (501) hide show
  1. package/README.md +82 -66
  2. package/agent-skill/semiotic-charts/SKILL.md +11 -2
  3. package/ai/behaviorContracts.cjs +33 -3
  4. package/ai/cli.js +53 -2
  5. package/ai/componentMetadata.cjs +15 -0
  6. package/ai/dist/mcp-server.js +1530 -611
  7. package/ai/examples.md +48 -42
  8. package/{CLAUDE.md → ai/reference.md} +46 -24
  9. package/ai/schema.json +10704 -825
  10. package/ai/surface-manifest.json +643 -2
  11. package/ai/system-prompt.md +83 -130
  12. package/dist/c-3BLJEQNG.min.js +1 -0
  13. package/dist/c-3KZD6AXJ.min.js +1 -0
  14. package/dist/c-4TWEX5HG.min.js +1 -0
  15. package/dist/c-52TEGIUJ.min.js +1 -0
  16. package/dist/c-5YCIX3VZ.min.js +1 -0
  17. package/dist/c-6FEKTA3U.min.js +1 -0
  18. package/dist/c-6O5EVOPH.min.js +1 -0
  19. package/dist/c-74HEEZGK.min.js +1 -0
  20. package/dist/c-AKAF6JAD.min.js +1 -0
  21. package/dist/c-BBKITSXB.min.js +1 -0
  22. package/dist/c-BWNB6USU.min.js +1 -0
  23. package/dist/c-C25ENHIK.min.js +1 -0
  24. package/dist/c-CDR5AO3R.min.js +1 -0
  25. package/dist/c-COHXCW3Q.min.js +1 -0
  26. package/dist/{chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js → c-DADXPJXV.min.js} +0 -1
  27. package/dist/c-E3JFRRMI.min.js +1 -0
  28. package/dist/c-EBFPQHHO.min.js +1 -0
  29. package/dist/c-G36WS6LN.min.js +1 -0
  30. package/dist/c-GIKRQI4X.min.js +1 -0
  31. package/dist/c-GPYOFETM.min.js +1 -0
  32. package/dist/c-IDUHYYSI.min.js +1 -0
  33. package/dist/{chunk-chunk-FQPKOAIH.module.min.js → c-IUHFPMHD.min.js} +0 -1
  34. package/dist/c-J5G56TUH.min.js +1 -0
  35. package/dist/c-JAZ73J32.min.js +1 -0
  36. package/dist/c-KG3NXHAL.min.js +1 -0
  37. package/dist/c-KII3PLZE.min.js +1 -0
  38. package/dist/c-LIXGXMNS.min.js +1 -0
  39. package/dist/c-LVEY6D6B.min.js +1 -0
  40. package/dist/c-M4Y3BHFR.min.js +1 -0
  41. package/dist/c-MAIICR2Z.min.js +1 -0
  42. package/dist/c-MG5DM6VE.min.js +1 -0
  43. package/dist/{chunk-minimapBrushOverlay-JU57U7NM.module.min.js → c-MNF2S4AA.min.js} +0 -1
  44. package/dist/c-MT3WBK7M.min.js +1 -0
  45. package/dist/c-NY3JWV2K.min.js +1 -0
  46. package/dist/c-O6U6K4CW.min.js +1 -0
  47. package/dist/c-OCI56QF2.min.js +1 -0
  48. package/dist/c-OQ7M4AGV.min.js +1 -0
  49. package/dist/c-OXYMVK7Q.min.js +1 -0
  50. package/dist/c-PPWDL5ZI.min.js +1 -0
  51. package/dist/c-QHF5YON3.min.js +1 -0
  52. package/dist/c-RR3GO5SW.min.js +1 -0
  53. package/dist/{chunk-chunk-J5QD4RAM.module.min.js → c-RSVIHIQ4.min.js} +0 -1
  54. package/dist/{chunk-chunk-EMO5NUGE.module.min.js → c-S2BXNNJN.min.js} +0 -1
  55. package/dist/{chunk-chunk-YCQYG6J5.module.min.js → c-SLGMUBUL.min.js} +0 -1
  56. package/dist/c-SUILCHWU.min.js +1 -0
  57. package/dist/c-TZW3JGJ5.min.js +1 -0
  58. package/dist/c-US5ZFT6E.min.js +1 -0
  59. package/dist/{chunk-chunk-RZH7VZYS.module.min.js → c-USFMFKIH.min.js} +0 -1
  60. package/dist/c-UUKVD4WB.min.js +1 -0
  61. package/dist/{chunk-chunk-SV4XAZ3Q.module.min.js → c-VGW3VG3I.min.js} +0 -1
  62. package/dist/c-W3CE4A4S.min.js +1 -0
  63. package/dist/{chunk-chunk-2NVFEB7P.module.min.js → c-WJCD5EUY.min.js} +0 -1
  64. package/dist/{chunk-chunk-2JGJ5GUG.module.min.js → c-X5UBGU2V.min.js} +0 -1
  65. package/dist/c-YDAY2WFR.min.js +1 -0
  66. package/dist/c-ZOWWU34K.min.js +1 -0
  67. package/dist/components/AccessibleNavTree.d.ts +1 -1
  68. package/dist/components/CategoryColors.d.ts +1 -1
  69. package/dist/components/GradientLegend.d.ts +14 -0
  70. package/dist/components/Legend.d.ts +2 -7
  71. package/dist/components/LinkedCharts.d.ts +1 -1
  72. package/dist/components/MobileAnnotationCalloutList.d.ts +1 -1
  73. package/dist/components/ObservationReadout.d.ts +45 -0
  74. package/dist/components/ThemeProvider.d.ts +4 -4
  75. package/dist/components/Tooltip/FlippingTooltip.d.ts +5 -7
  76. package/dist/components/Tooltip/Tooltip.d.ts +83 -5
  77. package/dist/components/Tooltip/tooltipChrome.d.ts +43 -0
  78. package/dist/components/ai/chartCapabilityTypes.d.ts +86 -2
  79. package/dist/components/ai/chartClinic.d.ts +2 -0
  80. package/dist/components/ai/deriveProfileFields.d.ts +40 -0
  81. package/dist/components/ai/evaluateChart.d.ts +85 -0
  82. package/dist/components/ai/fieldPolicy.d.ts +7 -0
  83. package/dist/components/ai/fieldRoles.d.ts +24 -0
  84. package/dist/components/ai/generativeChart.d.ts +18 -2
  85. package/dist/components/ai/inferIntent.d.ts +26 -2
  86. package/dist/components/ai/intents.d.ts +35 -0
  87. package/dist/components/ai/navigationTree.d.ts +2 -2
  88. package/dist/components/ai/observedSceneAudit.d.ts +2 -1
  89. package/dist/components/ai/profileData.d.ts +11 -0
  90. package/dist/components/ai/repairChartConfig.d.ts +2 -3
  91. package/dist/components/ai/semanticEvidence.d.ts +4 -0
  92. package/dist/components/ai/semanticViability.d.ts +11 -0
  93. package/dist/components/ai/semanticViabilityRegistry.d.ts +5 -0
  94. package/dist/components/ai/streamingTypes.d.ts +4 -0
  95. package/dist/components/ai/suggestCharts.d.ts +5 -6
  96. package/dist/components/ai/suggestDashboard.d.ts +2 -3
  97. package/dist/components/ai/suggestStreamCharts.d.ts +1 -1
  98. package/dist/components/ai/suggestStretchCharts.d.ts +2 -3
  99. package/dist/components/ai/suggestionPropContracts.d.ts +20 -0
  100. package/dist/components/ai/variantDiscovery.d.ts +3 -1
  101. package/dist/components/charts/custom/NetworkCustomChart.d.ts +3 -0
  102. package/dist/components/charts/custom/OrdinalCustomChart.d.ts +3 -0
  103. package/dist/components/charts/custom/XYCustomChart.d.ts +1 -1
  104. package/dist/components/charts/geo/ChoroplethMap.d.ts +3 -1
  105. package/dist/components/charts/geo/DistanceCartogram.d.ts +2 -7
  106. package/dist/components/charts/geo/cartogramOverlay.d.ts +28 -0
  107. package/dist/components/charts/index.d.ts +4 -3
  108. package/dist/components/charts/network/ProcessSankey.d.ts +2 -136
  109. package/dist/components/charts/network/ProcessSankeyProps.d.ts +139 -0
  110. package/dist/components/charts/network/Treemap.d.ts +2 -1
  111. package/dist/components/charts/network/processSankey/boundaryHubOrdering.d.ts +23 -0
  112. package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +2 -0
  113. package/dist/components/charts/network/processSankey/ordering.d.ts +3 -41
  114. package/dist/components/charts/network/processSankey/orderingTypes.d.ts +32 -0
  115. package/dist/components/charts/network/processSankey/packing.d.ts +1 -1
  116. package/dist/components/charts/network/processSankey/packingCache.d.ts +1 -1
  117. package/dist/components/charts/network/processSankey/packingOptimization.d.ts +72 -0
  118. package/dist/components/charts/ordinal/BarChart.d.ts +4 -3
  119. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  120. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +3 -2
  121. package/dist/components/charts/ordinal/StackedBarChart.d.ts +4 -3
  122. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +2 -2
  123. package/dist/components/charts/physics/GaltonBoardChart.d.ts +2 -9
  124. package/dist/components/charts/physics/GauntletChart.d.ts +10 -41
  125. package/dist/components/charts/physics/ProcessFlowChart.d.ts +1 -1
  126. package/dist/components/charts/physics/chainReactionAccessibleTable.d.ts +9 -0
  127. package/dist/components/charts/physics/chainReactionRuntime.d.ts +2 -1
  128. package/dist/components/charts/physics/chainReactionTypes.d.ts +6 -1
  129. package/dist/components/charts/physics/crucibleBodyRenderers.d.ts +2 -2
  130. package/dist/components/charts/physics/crucibleClone.d.ts +6 -0
  131. package/dist/components/charts/physics/crucibleEffects.d.ts +1 -2
  132. package/dist/components/charts/physics/crucibleRecord.d.ts +7 -0
  133. package/dist/components/charts/physics/gauntletChrome.d.ts +4 -4
  134. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  135. package/dist/components/charts/physics/gauntletPublic.d.ts +4 -0
  136. package/dist/components/charts/physics/packetFlowOverlay.d.ts +7 -0
  137. package/dist/components/charts/physics/physicsChartLayout.d.ts +8 -0
  138. package/dist/components/charts/physics/physicsChartShared.d.ts +3 -1
  139. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  140. package/dist/components/charts/physics/physicsHocUtils.d.ts +26 -13
  141. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +24 -0
  142. package/dist/components/charts/physics/processFlowOverlays.d.ts +9 -0
  143. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +17 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +12 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +37 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +23 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +22 -13
  148. package/dist/components/charts/realtime/aggregate.d.ts +4 -1
  149. package/dist/components/charts/realtime/eventTime.d.ts +4 -0
  150. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +27 -0
  151. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +30 -0
  152. package/dist/components/charts/realtime/useRealtimeCategoryColors.d.ts +30 -0
  153. package/dist/components/charts/shared/FrameTextAnnotationSVG.d.ts +10 -0
  154. package/dist/components/charts/shared/annotationActivation.d.ts +3 -7
  155. package/dist/components/charts/shared/annotationBandFill.d.ts +6 -0
  156. package/dist/components/charts/shared/annotationDispatch.d.ts +31 -0
  157. package/dist/components/charts/shared/annotationIdentity.d.ts +8 -0
  158. package/dist/components/charts/shared/annotationRules.d.ts +1 -15
  159. package/dist/components/charts/shared/boundedCategoryRegistry.d.ts +8 -0
  160. package/dist/components/charts/shared/chainReactionChartSpec.d.ts +3 -0
  161. package/dist/components/charts/shared/chartMode.d.ts +3 -2
  162. package/dist/components/charts/shared/chartSpecCore.d.ts +1 -0
  163. package/dist/components/charts/shared/formatUtils.d.ts +40 -9
  164. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  165. package/dist/components/charts/shared/gradient.d.ts +16 -0
  166. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  167. package/dist/components/charts/shared/hooks.d.ts +4 -4
  168. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  169. package/dist/components/charts/shared/streamPropsHelpers.d.ts +3 -1
  170. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  171. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  172. package/dist/components/charts/shared/types.d.ts +26 -10
  173. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  174. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  175. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  176. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  177. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  178. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  179. package/dist/components/charts/value/types.d.ts +1 -1
  180. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  181. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  182. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  183. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  184. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  185. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  186. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  187. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  188. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  189. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  190. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  191. package/dist/components/legendLayout.d.ts +131 -4
  192. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  193. package/dist/components/realtime/types.d.ts +10 -1
  194. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  195. package/dist/components/recipes/directedReachability.d.ts +14 -0
  196. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  197. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  198. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  199. package/dist/components/recipes/physics.d.ts +7 -4
  200. package/dist/components/recipes/processPhysics.d.ts +0 -1
  201. package/dist/components/recipes/waffle.d.ts +7 -4
  202. package/dist/components/semiotic-ai-core.d.ts +13 -4
  203. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  204. package/dist/components/semiotic-ai.d.ts +16 -9
  205. package/dist/components/semiotic-client-shared.d.ts +10 -0
  206. package/dist/components/semiotic-experimental.d.ts +1 -1
  207. package/dist/components/semiotic-geo.d.ts +4 -1
  208. package/dist/components/semiotic-network.d.ts +7 -4
  209. package/dist/components/semiotic-ordinal.d.ts +4 -1
  210. package/dist/components/semiotic-physics.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  212. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  213. package/dist/components/semiotic-realtime.d.ts +3 -1
  214. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  215. package/dist/components/semiotic-server-edge.d.ts +3 -2
  216. package/dist/components/semiotic-server.d.ts +3 -2
  217. package/dist/components/semiotic-themes-core.d.ts +5 -48
  218. package/dist/components/semiotic-utils-core.d.ts +11 -5
  219. package/dist/components/semiotic-utils-react.d.ts +2 -0
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -25
  222. package/dist/components/server/animatedGif.d.ts +1 -1
  223. package/dist/components/server/renderEvidence.d.ts +25 -2
  224. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  225. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  226. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  227. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  228. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  230. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  231. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  232. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  233. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  234. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  235. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  236. package/dist/components/server/staticAnnotations.d.ts +28 -1
  237. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  238. package/dist/components/server/staticLegend.d.ts +1 -1
  239. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  240. package/dist/components/server/staticOrdinal.d.ts +8 -2
  241. package/dist/components/server/staticPhysics.d.ts +13 -1
  242. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  243. package/dist/components/server/staticRawLegend.d.ts +15 -0
  244. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  245. package/dist/components/server/staticXYAxes.d.ts +27 -0
  246. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  247. package/dist/components/server/staticXYGrid.d.ts +11 -0
  248. package/dist/components/server/themeResolver.d.ts +5 -1
  249. package/dist/components/store/ThemeStore.d.ts +2 -98
  250. package/dist/components/store/designTokens.d.ts +1 -1
  251. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  252. package/dist/components/store/themeCore.d.ts +91 -0
  253. package/dist/components/store/themePresets.d.ts +81 -0
  254. package/dist/components/store/themeSerialization.d.ts +2 -1
  255. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  256. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  257. package/dist/components/stream/GeoTileRenderer.d.ts +3 -0
  258. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  259. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  260. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  261. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  262. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  263. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  264. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  265. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  266. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  268. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  269. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  270. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  271. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  272. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  273. package/dist/components/stream/canvasBackground.d.ts +10 -0
  274. package/dist/components/stream/canvasSetup.d.ts +24 -4
  275. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  276. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  277. package/dist/components/stream/frameGraphics.d.ts +18 -0
  278. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  279. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  280. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  281. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  282. package/dist/components/stream/geoTypes.d.ts +12 -11
  283. package/dist/components/stream/hitTarget.d.ts +61 -2
  284. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  285. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  286. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  287. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  288. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  289. package/dist/components/stream/networkFramePaint.d.ts +15 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +32 -32
  292. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  294. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  295. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  296. package/dist/components/stream/ordinalTypes.d.ts +12 -4
  297. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  298. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  299. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  300. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  301. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  302. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  303. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  304. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  305. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  306. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +25 -4
  307. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  308. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  309. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  310. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  311. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  312. package/dist/components/stream/pipelineConfig.d.ts +8 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +2 -2
  314. package/dist/components/stream/renderBackend.d.ts +2 -0
  315. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  316. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  317. package/dist/components/stream/responsiveSize.d.ts +17 -0
  318. package/dist/components/stream/sceneCursor.d.ts +41 -0
  319. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  320. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  321. package/dist/components/stream/types.d.ts +33 -13
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +12 -1
  323. package/dist/components/stream/useFrame.d.ts +24 -1
  324. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  325. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  326. package/dist/components/stream/xyFrameAxisTypes.d.ts +20 -4
  327. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  328. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  329. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  330. package/dist/components/types/legendTypes.d.ts +6 -0
  331. package/dist/components/types/marginType.d.ts +7 -8
  332. package/dist/controls.min.js +1 -1
  333. package/dist/controls.module.min.js +1 -1
  334. package/dist/forceLayoutWorker.js +1 -1
  335. package/dist/geo.min.js +1 -1
  336. package/dist/geo.module.min.js +1 -1
  337. package/dist/network.min.js +1 -1
  338. package/dist/network.module.min.js +1 -1
  339. package/dist/ordinal.min.js +1 -1
  340. package/dist/ordinal.module.min.js +1 -1
  341. package/dist/physics-matter.module.min.js +1 -1
  342. package/dist/physics-rapier.module.min.js +1 -1
  343. package/dist/physics.min.js +1 -1
  344. package/dist/physics.module.min.js +1 -1
  345. package/dist/physicsWorker.js +1 -1
  346. package/dist/processSankeyLayoutWorker.js +1 -1
  347. package/dist/realtime.min.js +1 -1
  348. package/dist/realtime.module.min.js +1 -1
  349. package/dist/rough.min.js +1 -1
  350. package/dist/rough.module.min.js +1 -1
  351. package/dist/semiotic-ai-core.d.ts +13 -4
  352. package/dist/semiotic-ai-core.min.js +1 -1
  353. package/dist/semiotic-ai-core.module.min.js +1 -1
  354. package/dist/semiotic-ai.d.ts +16 -9
  355. package/dist/semiotic-ai.min.js +1 -1
  356. package/dist/semiotic-ai.module.min.js +1 -1
  357. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  358. package/dist/semiotic-client-glyph.module.min.js +2 -0
  359. package/dist/semiotic-client-responsive.module.min.js +2 -0
  360. package/dist/semiotic-client-shared.module.min.js +2 -0
  361. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  362. package/dist/semiotic-data.min.js +1 -1
  363. package/dist/semiotic-data.module.min.js +1 -1
  364. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  366. package/dist/semiotic-experimental-node.module.min.js +2 -0
  367. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  368. package/dist/semiotic-experimental-vacp.min.js +1 -1
  369. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  370. package/dist/semiotic-experimental.d.ts +1 -1
  371. package/dist/semiotic-experimental.min.js +1 -1
  372. package/dist/semiotic-experimental.module.min.js +1 -1
  373. package/dist/semiotic-geo.d.ts +4 -1
  374. package/dist/semiotic-network.d.ts +7 -4
  375. package/dist/semiotic-ordinal.d.ts +4 -1
  376. package/dist/semiotic-physics.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.d.ts +11 -4
  378. package/dist/semiotic-realtime-core.min.js +2 -1
  379. package/dist/semiotic-realtime-core.module.min.js +2 -1
  380. package/dist/semiotic-realtime-react.d.ts +4 -3
  381. package/dist/semiotic-realtime-react.min.js +1 -1
  382. package/dist/semiotic-realtime-react.module.min.js +1 -1
  383. package/dist/semiotic-realtime.d.ts +3 -1
  384. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  385. package/dist/semiotic-recipes-core.d.ts +7 -5
  386. package/dist/semiotic-recipes-core.min.js +9 -1
  387. package/dist/semiotic-recipes-core.module.min.js +1 -1
  388. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  389. package/dist/semiotic-recipes-react.min.js +1 -1
  390. package/dist/semiotic-recipes-react.module.min.js +1 -1
  391. package/dist/semiotic-recipes.min.js +7 -1
  392. package/dist/semiotic-recipes.module.min.js +2 -1
  393. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  394. package/dist/semiotic-server-edge.d.ts +3 -2
  395. package/dist/semiotic-server-edge.min.js +1 -1
  396. package/dist/semiotic-server-edge.module.min.js +1 -1
  397. package/dist/semiotic-server-node.min.js +1 -1
  398. package/dist/semiotic-server-node.module.min.js +1 -1
  399. package/dist/semiotic-server.d.ts +3 -2
  400. package/dist/semiotic-themes-core.d.ts +5 -48
  401. package/dist/semiotic-themes-core.min.js +1 -1
  402. package/dist/semiotic-themes-core.module.min.js +1 -1
  403. package/dist/semiotic-themes-react.min.js +1 -1
  404. package/dist/semiotic-themes-react.module.min.js +1 -1
  405. package/dist/semiotic-themes.min.js +1 -1
  406. package/dist/semiotic-themes.module.min.js +1 -1
  407. package/dist/semiotic-utils-core.d.ts +11 -5
  408. package/dist/semiotic-utils-core.min.js +1 -1
  409. package/dist/semiotic-utils-core.module.min.js +1 -1
  410. package/dist/semiotic-utils-react.d.ts +2 -0
  411. package/dist/semiotic-utils-react.min.js +1 -1
  412. package/dist/semiotic-utils-react.module.min.js +1 -1
  413. package/dist/semiotic-utils.min.js +2 -1
  414. package/dist/semiotic-utils.module.min.js +2 -1
  415. package/dist/semiotic-value.min.js +1 -1
  416. package/dist/semiotic-value.module.min.js +1 -1
  417. package/dist/semiotic-xy.d.ts +4 -1
  418. package/dist/semiotic.d.ts +68 -25
  419. package/dist/semiotic.min.js +1 -1
  420. package/dist/semiotic.module.min.js +1 -1
  421. package/dist/server.min.js +1 -1
  422. package/dist/server.module.min.js +1 -1
  423. package/dist/xy.min.js +1 -1
  424. package/dist/xy.module.min.js +1 -1
  425. package/package.json +53 -19
  426. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  427. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  428. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  429. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  430. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  431. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  432. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  433. package/dist/chunk-chunk-3GCILWPB.module.min.js +0 -2
  434. package/dist/chunk-chunk-46KRGJQP.module.min.js +0 -1
  435. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4MLLQUGW.module.min.js +0 -2
  437. package/dist/chunk-chunk-57RBPDBQ.module.min.js +0 -2
  438. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  439. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  442. package/dist/chunk-chunk-7LE56WAE.module.min.js +0 -2
  443. package/dist/chunk-chunk-7T25U75Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  445. package/dist/chunk-chunk-AF53TBSN.module.min.js +0 -2
  446. package/dist/chunk-chunk-BTZYH2IE.module.min.js +0 -1
  447. package/dist/chunk-chunk-BWV55BZK.module.min.js +0 -2
  448. package/dist/chunk-chunk-BZNOAHJV.module.min.js +0 -2
  449. package/dist/chunk-chunk-CD6PVVS3.module.min.js +0 -2
  450. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  451. package/dist/chunk-chunk-FC3NZWYR.module.min.js +0 -2
  452. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  453. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  454. package/dist/chunk-chunk-FRGBMTZR.module.min.js +0 -1
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-H5IFO6CU.module.min.js +0 -2
  457. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HCNDE26Q.module.min.js +0 -2
  460. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  461. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  462. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  463. package/dist/chunk-chunk-JJ4BSUYL.module.min.js +0 -2
  464. package/dist/chunk-chunk-JRHXQGEV.module.min.js +0 -2
  465. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  466. package/dist/chunk-chunk-L6FFYGYS.module.min.js +0 -1
  467. package/dist/chunk-chunk-LJDH3WV3.module.min.js +0 -2
  468. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  469. package/dist/chunk-chunk-N3Q33XCB.module.min.js +0 -2
  470. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  471. package/dist/chunk-chunk-OG3TTJGJ.module.min.js +0 -2
  472. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  473. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-QQJNG23C.module.min.js +0 -2
  476. package/dist/chunk-chunk-RGJ6TKAH.module.min.js +0 -2
  477. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  478. package/dist/chunk-chunk-SFLUSZ73.module.min.js +0 -2
  479. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  480. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  481. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  482. package/dist/chunk-chunk-UEZ6SHW5.module.min.js +0 -2
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VUWYT7DY.module.min.js +0 -2
  485. package/dist/chunk-chunk-W5HWGQMD.module.min.js +0 -2
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-WGROBM3I.module.min.js +0 -2
  488. package/dist/chunk-chunk-WSDJFBKX.module.min.js +0 -2
  489. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  490. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  491. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  492. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  493. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  494. package/dist/test-utils/canvasMock.d.ts +0 -86
  495. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  496. package/dist/test-utils/frameMock.d.ts +0 -81
  497. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  498. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  499. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  500. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  501. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -1,9 +1,18 @@
1
1
  import * as React from "react";
2
- import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { AccessibleTableProp } from "./accessibleTableTypes";
3
3
  import { type AccessibleSceneNode as AnySceneNode } from "./accessibleDataRows";
4
+ import { type NetworkTableElement } from "./accessibleDataTableModel";
5
+ export type { AccessibleTableOptions, AccessibleTablePortalTarget, AccessibleTableProp } from "./accessibleTableTypes";
4
6
  export { extractAllRows } from "./accessibleDataRows";
5
7
  export type { DataRow } from "./accessibleDataRows";
6
8
  export { AriaLiveTooltip, SR_ONLY_STYLE } from "./AriaLiveTooltip";
9
+ /** Relocate the complete interactive accessible-table UI when a chart lives
10
+ * inside a consumer-owned `role="img"`. The historical inline DOM remains
11
+ * unchanged for `accessibleTable={true}`. */
12
+ export declare function AccessibleTablePortal({ accessibleTable, children }: {
13
+ accessibleTable: AccessibleTableProp;
14
+ children: React.ReactNode;
15
+ }): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
7
16
  /**
8
17
  * Compute an aria-label describing the chart type and data shape from the scene graph.
9
18
  */
@@ -28,19 +37,8 @@ interface AccessibleDataTableProps {
28
37
  */
29
38
  export declare function AccessibleDataTable({ scene, chartType, tableId, chartTitle }: AccessibleDataTableProps): React.JSX.Element | null;
30
39
  interface NetworkAccessibleDataTableProps {
31
- nodes: Array<{
32
- datum?: Datum | null;
33
- id?: string;
34
- cx?: number;
35
- cy?: number;
36
- x?: number;
37
- y?: number;
38
- }>;
39
- edges: Array<{
40
- datum?: Datum | null;
41
- source?: string;
42
- target?: string;
43
- }>;
40
+ nodes: NetworkTableElement[];
41
+ edges: NetworkTableElement[];
44
42
  chartType: string;
45
43
  tableId?: string;
46
44
  chartTitle?: string;
@@ -0,0 +1,6 @@
1
+ import * as React from "react";
2
+ import type { AccessibleTablePortalTarget } from "./accessibleTableTypes";
3
+ export default function AccessibleTablePortalImpl({ target: requestedTarget, children }: {
4
+ target: AccessibleTablePortalTarget;
5
+ children: React.ReactNode;
6
+ }): React.JSX.Element | null;
@@ -17,6 +17,7 @@ export type TileURLTemplate = string | ((z: number, x: number, y: number, dpr: n
17
17
  interface CachedTile {
18
18
  img: HTMLImageElement;
19
19
  loaded: boolean;
20
+ failed: boolean;
20
21
  key: string;
21
22
  lastUsed: number;
22
23
  }
@@ -24,6 +25,7 @@ export declare class TileCache {
24
25
  private cache;
25
26
  private limit;
26
27
  constructor(limit?: number);
28
+ setLimit(limit: number): void;
27
29
  get(key: string): CachedTile | undefined;
28
30
  set(key: string, entry: CachedTile): void;
29
31
  private evict;
@@ -36,6 +38,7 @@ export interface TileRenderOptions {
36
38
  height: number;
37
39
  tileCache: TileCache;
38
40
  onTileLoad?: () => void;
41
+ maxDevicePixelRatio?: number;
39
42
  }
40
43
  /**
41
44
  * Render visible tiles onto a canvas context.
@@ -2,6 +2,8 @@ import type { NetworkSceneNode, NetworkSceneEdge, NetworkCircleNode } from "./ne
2
2
  import type { Quadtree } from "d3-quadtree";
3
3
  import type { SceneDatum } from "./types";
4
4
  export interface NetworkHitResult {
5
+ /** Scene node/edge that supplied this hit (used for presentation metadata). */
6
+ mark?: NetworkSceneNode | NetworkSceneEdge;
5
7
  type: "node" | "edge";
6
8
  datum: SceneDatum;
7
9
  x: number;
@@ -13,4 +15,4 @@ export interface NetworkHitResult {
13
15
  *
14
16
  * Checks nodes first (they're on top), then edges.
15
17
  */
16
- export declare function findNearestNetworkNode(sceneNodes: NetworkSceneNode[], sceneEdges: NetworkSceneEdge[], px: number, py: number, maxDistance?: number, nodeQuadtree?: Quadtree<NetworkCircleNode> | null, maxNodeRadius?: number): NetworkHitResult | null;
18
+ export declare function findNearestNetworkNode(sceneNodes: NetworkSceneNode[], sceneEdges: NetworkSceneEdge[], px: number, py: number, maxDistance?: number, nodeQuadtree?: Quadtree<NetworkCircleNode> | null, maxNodeRadius?: number, includeEdges?: boolean): NetworkHitResult | null;
@@ -10,8 +10,9 @@ interface NetworkSSRFrameProps {
10
10
  margin: React.ComponentProps<typeof NetworkSVGOverlay>["margin"];
11
11
  adjustedWidth: number;
12
12
  adjustedHeight: number;
13
+ surfaceBackground: string | null;
13
14
  resolvedBackground: React.ReactNode;
14
15
  resolvedForeground: React.ReactNode;
15
16
  }
16
- export declare function NetworkSSRFrame({ props, store, responsiveRef, size, margin, adjustedWidth, adjustedHeight, resolvedBackground, resolvedForeground }: NetworkSSRFrameProps): React.JSX.Element;
17
+ export declare function NetworkSSRFrame({ props, store, responsiveRef, size, margin, adjustedWidth, adjustedHeight, surfaceBackground, resolvedBackground, resolvedForeground }: NetworkSSRFrameProps): React.JSX.Element;
17
18
  export {};
@@ -5,41 +5,14 @@ import type { NetworkLabel } from "./networkTypes";
5
5
  import type { LegendLayout, LegendValue } from "../types/legendTypes";
6
6
  import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
7
7
  import type { AnnotationContext } from "../realtime/types";
8
- import { type GlyphDef } from "./glyphDef";
8
+ import { type NetworkAnnotationAnchorNode } from "./networkAnnotationAnchors";
9
9
  import type { OnObservationCallback } from "../store/ObservationStore";
10
10
  import { type OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
11
- type AnnotationAnchorNode = {
12
- type: string;
13
- datum: Datum | null;
14
- id?: string;
15
- x?: number;
16
- y?: number;
17
- cx?: number;
18
- cy?: number;
19
- w?: number;
20
- h?: number;
21
- /** Circle nodes (NetworkCircleNode, force/tree/orbit marks) carry an explicit radius. */
22
- r?: number;
23
- /** Arc nodes (chord, radial) carry an outer radius. */
24
- outerR?: number;
25
- /** Symbol nodes carry a d3-symbol area; glyph nodes reuse `size` as rendered height. */
26
- size?: number;
27
- /** Glyph nodes (the composite-pictogram channel) carry a definition. */
28
- glyph?: GlyphDef;
29
- };
11
+ type AnnotationAnchorNode = NetworkAnnotationAnchorNode;
30
12
  type NetworkAnnotationContext = AnnotationContext & {
31
13
  sceneNodes?: AnnotationAnchorNode[];
32
14
  };
33
- /** Anchor id for a scene node — used to resolve `pointId`-anchored annotations
34
- * to a mark a layout emitted (incl. custom-layout marks). Exported for tests. */
35
- export declare function nodeAnchorId(node: AnnotationAnchorNode): string | undefined;
36
- /** Center + effective radius of a scene node for annotation anchoring. Exported
37
- * for tests. */
38
- export declare function nodeCenter(node: AnnotationAnchorNode): {
39
- x: number;
40
- y: number;
41
- r: number;
42
- } | null;
15
+ export { nodeAnchorId, nodeCenter } from "./networkAnnotationAnchors";
43
16
  export interface NetworkSVGOverlayProps {
44
17
  width: number;
45
18
  height: number;
@@ -91,4 +64,3 @@ export declare function NetworkSVGOverlay(props: NetworkSVGOverlayProps): React.
91
64
  export declare namespace NetworkSVGOverlay {
92
65
  var displayName: string;
93
66
  }
94
- export {};
@@ -2,6 +2,8 @@ import type { OrdinalSceneNode } from "./ordinalTypes";
2
2
  import type { SceneDatum, PointSceneNode } from "./types";
3
3
  import type { Quadtree } from "d3-quadtree";
4
4
  export interface OrdinalHitResult {
5
+ /** Scene mark that supplied this hit (used for presentation metadata). */
6
+ node?: OrdinalSceneNode;
5
7
  datum: SceneDatum;
6
8
  x: number;
7
9
  y: number;
@@ -0,0 +1,9 @@
1
+ import type { ReactNode } from "react";
2
+ interface SVGChartTitleProps {
3
+ title?: string | ReactNode;
4
+ totalWidth: number;
5
+ marginTop: number;
6
+ }
7
+ /** Shared SVG title chrome, kept separate from the axis/annotation overlay. */
8
+ export declare function SVGChartTitle({ title, totalWidth, marginTop }: SVGChartTitleProps): import("react").JSX.Element | null;
9
+ export {};
@@ -7,6 +7,7 @@ import type { LegendLayout, LegendValue } from "../types/legendTypes";
7
7
  import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
8
8
  import type { OnObservationCallback } from "../store/ObservationStore";
9
9
  import { type OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
10
+ export { SVGUnderlay } from "./SVGUnderlay";
10
11
  export type AxisConfig = XYFrameAxisConfig;
11
12
  interface SVGOverlayProps {
12
13
  width: number;
@@ -95,25 +96,4 @@ interface SVGOverlayProps {
95
96
  linkedCrosshairSourceId?: string;
96
97
  children?: ReactNode;
97
98
  }
98
- interface SVGUnderlayProps {
99
- width: number;
100
- height: number;
101
- totalWidth: number;
102
- totalHeight: number;
103
- margin: {
104
- top: number;
105
- right: number;
106
- bottom: number;
107
- left: number;
108
- };
109
- scales: StreamScales | null;
110
- showAxes?: boolean;
111
- axes?: AxisConfig[];
112
- showGrid?: boolean;
113
- xFormat?: (d: number | Date | string, index?: number, allTicks?: number[]) => string | ReactNode;
114
- yFormat?: (d: number | Date | string) => string | ReactNode;
115
- axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
116
- }
117
- export declare function SVGUnderlay(props: SVGUnderlayProps): React.JSX.Element | null;
118
99
  export declare function SVGOverlay(props: SVGOverlayProps): React.JSX.Element | null;
119
- export {};
@@ -0,0 +1,24 @@
1
+ import type { ReactNode } from "react";
2
+ import type { StreamScales, XYFrameAxisConfig } from "./types";
3
+ /** Props for the canvas-behind grid and axis-baseline SVG layer. */
4
+ export interface SVGUnderlayProps {
5
+ width: number;
6
+ height: number;
7
+ totalWidth: number;
8
+ totalHeight: number;
9
+ margin: {
10
+ top: number;
11
+ right: number;
12
+ bottom: number;
13
+ left: number;
14
+ };
15
+ scales: StreamScales | null;
16
+ showAxes?: boolean;
17
+ axes?: XYFrameAxisConfig[];
18
+ showGrid?: boolean;
19
+ xFormat?: (d: number | Date | string, index?: number, allTicks?: number[]) => string | ReactNode;
20
+ yFormat?: (d: number | Date | string) => string | ReactNode;
21
+ axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
22
+ }
23
+ /** Renders only grid lines and axis baselines behind the canvas. */
24
+ export declare function SVGUnderlay(props: SVGUnderlayProps): import("react").JSX.Element | null;
@@ -16,7 +16,7 @@ import type { SceneNode } from "./types";
16
16
  export { networkSceneNodeToSVG, networkSceneEdgeToSVG, networkLabelToSVG } from "./SceneToSVGNetwork";
17
17
  export { geoSceneNodeToSVG } from "./SceneToSVGGeo";
18
18
  export { ordinalSceneNodeToSVG } from "./SceneToSVGOrdinal";
19
- export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?: string): React.ReactNode;
19
+ export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?: string, cursorHitRadius?: number): React.ReactNode;
20
20
  /**
21
21
  * Returns true when running in a true server/Node.js context where
22
22
  * window and document are not available.
@@ -1,5 +1,5 @@
1
1
  import type { Datum } from "../charts/shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamGeoFrameProps, StreamGeoFrameHandle } from "./geoTypes";
3
+ import type { StreamGeoFrameHandle, StreamGeoFrameProps } from "./geoTypes";
4
4
  declare const StreamGeoFrame: React.NamedExoticComponent<StreamGeoFrameProps<Datum> & React.RefAttributes<StreamGeoFrameHandle>>;
5
5
  export default StreamGeoFrame;
@@ -1,5 +1,5 @@
1
1
  import type { Datum } from "../charts/shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle } from "./ordinalTypes";
3
+ import type { StreamOrdinalFrameHandle, StreamOrdinalFrameProps } from "./ordinalTypes";
4
4
  declare const StreamOrdinalFrame: React.NamedExoticComponent<StreamOrdinalFrameProps<Datum> & React.RefAttributes<StreamOrdinalFrameHandle<Datum>>>;
5
5
  export default StreamOrdinalFrame;
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../charts/shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamXYFrameProps, StreamXYFrameHandle } from "./types";
3
+ import type { StreamXYFrameHandle, StreamXYFrameProps } from "./types";
4
4
  export { withAlpha } from "./frameThemeColors";
5
5
  declare const StreamXYFrame: React.NamedExoticComponent<StreamXYFrameProps<Datum> & React.RefAttributes<StreamXYFrameHandle<Datum>>>;
6
6
  export default StreamXYFrame;
@@ -26,6 +26,17 @@ export interface DataRow {
26
26
  label: string;
27
27
  values: Record<string, string | number>;
28
28
  }
29
+ /**
30
+ * Extract one semantic row from a network node or edge.
31
+ *
32
+ * Network geometry has several shapes (circle/rect nodes and
33
+ * line/bezier/ribbon/curved edges), but its accessible row contract is the
34
+ * same for all of them: an explicit `accessibility.tableFields` projection
35
+ * wins, then `accessibleDatum`, then the render datum. Keeping this separate
36
+ * from `extractAllRows` avoids treating a network line edge like an XY line
37
+ * series (whose datum is an array of vertices).
38
+ */
39
+ export declare function extractNetworkDataRow(element: AccessibleSceneNode, fallbackLabel: string): DataRow;
29
40
  /**
30
41
  * Extract user-facing table rows from scene nodes. Geometry is ignored; rich
31
42
  * accessibleDatum/tableFields metadata takes precedence over the render datum.
@@ -0,0 +1,40 @@
1
+ import { type AccessibleSceneNode, type DataRow } from "./accessibleDataRows";
2
+ export declare const fmt: (value: number | undefined | null) => string;
3
+ export declare function fmtCell(value: unknown): string;
4
+ interface FieldStats {
5
+ name: string;
6
+ count: number;
7
+ numeric: boolean;
8
+ min?: number;
9
+ max?: number;
10
+ mean?: number;
11
+ uniqueValues?: string[];
12
+ }
13
+ /** Compute per-field statistics from extracted rows. Defensive against weird values. */
14
+ export declare function computeFieldStats(rows: DataRow[]): FieldStats[];
15
+ /** Format a summary string from field stats. */
16
+ export declare function formatSummary(totalRows: number, fieldStats: FieldStats[]): string;
17
+ export type NetworkTableElement = AccessibleSceneNode & {
18
+ id?: string | number;
19
+ source?: unknown;
20
+ target?: unknown;
21
+ };
22
+ export interface NetworkNodeTableRow {
23
+ id: string;
24
+ degree: number;
25
+ inDeg: number;
26
+ outDeg: number;
27
+ wDegree: number;
28
+ wInDeg: number;
29
+ wOutDeg: number;
30
+ semantic: DataRow;
31
+ }
32
+ export interface NetworkTableModel {
33
+ nodeRows: NetworkNodeTableRow[];
34
+ edgeRows: DataRow[];
35
+ hasWeights: boolean;
36
+ summary: string;
37
+ }
38
+ /** Derive authored rows and topology metrics without coupling them to React. */
39
+ export declare function buildNetworkTableModel(nodes: NetworkTableElement[], edges: NetworkTableElement[]): NetworkTableModel;
40
+ export {};
@@ -0,0 +1,11 @@
1
+ /** A DOM destination outside an atomic `role="img"` wrapper. String targets
2
+ * are resolved as element IDs after mount; callback targets support refs. */
3
+ export type AccessibleTablePortalTarget = string | Element | (() => Element | null);
4
+ /** Options for the screen-reader data summary. The object form keeps the
5
+ * existing table enabled while relocating its interactive UI with a portal. */
6
+ export interface AccessibleTableOptions {
7
+ portalTarget: AccessibleTablePortalTarget;
8
+ }
9
+ /** `true` keeps the historical in-chart placement, `false` disables the
10
+ * fallback, and the object form enables it at an explicit portal target. */
11
+ export type AccessibleTableProp = boolean | AccessibleTableOptions;
@@ -0,0 +1,19 @@
1
+ import type { ReactNode } from "react";
2
+ /** Resolve the canonical `ticks` count while retaining `tickCount` compatibility. */
3
+ export declare function axisTickCount(axis: {
4
+ ticks?: number;
5
+ tickCount?: number;
6
+ } | undefined, fallback: number): number;
7
+ export declare function defaultTickFormat(v: string | number | Date, _index?: number, _allTicks?: number[]): string;
8
+ /**
9
+ * Only primitive labels can be meaningfully compared without rendering.
10
+ * `String(<span />)` is always "[object Object]", which used to erase every
11
+ * subsequent ReactNode tick when collision filtering also de-duplicated text.
12
+ */
13
+ export declare function hasSameTickLabel(a: string | ReactNode, b: string | ReactNode): boolean;
14
+ /** Greedily filter ticks so consecutive labels are at least `minPx` apart. */
15
+ export declare function filterTicksByPixelDistance<T extends {
16
+ value: number | Date;
17
+ pixel: number;
18
+ label: string | ReactNode;
19
+ }>(ticks: T[], minPx: number): T[];
@@ -18,6 +18,16 @@ export interface PaintCanvasBackgroundOptions {
18
18
  height: number;
19
19
  }
20
20
  export type CanvasBackgroundOptions = Pick<PaintCanvasBackgroundOptions, "background" | "hasBackgroundGraphics" | "themeBackground">;
21
+ /**
22
+ * Resolve the full-frame surface that sits below a canvas and any custom
23
+ * background graphics.
24
+ *
25
+ * Unlike the canvas painter, this surface keeps an explicit `background`
26
+ * when `backgroundGraphics` are present so the requested solid is composed
27
+ * beneath the custom SVG. The implicit theme surface remains suppressed in
28
+ * that mode, preserving transparent custom-background composition.
29
+ */
30
+ export declare function resolveFrameSurfaceBackground(options: CanvasBackgroundOptions): string | null;
21
31
  /**
22
32
  * Select the background token a canvas will attempt to paint. This is kept
23
33
  * separate from the drawing operation so SVG layer composition can use the
@@ -10,6 +10,15 @@ export interface CanvasMargin {
10
10
  bottom: number;
11
11
  left: number;
12
12
  }
13
+ /**
14
+ * Keep a canvas's backing store and CSS box aligned with the frame size.
15
+ * This is separate from context preparation so an idle interaction layer can
16
+ * be sized on mount/resize without forcing it through a paint path.
17
+ */
18
+ export declare function syncCanvasSize(canvas: HTMLCanvasElement, size: [number, number], dpr: number): {
19
+ effectiveDprX: number;
20
+ effectiveDprY: number;
21
+ };
13
22
  /**
14
23
  * Set a canvas element's physical (pixel) and CSS (logical) dimensions,
15
24
  * accounting for devicePixelRatio. Returns the 2D context ready for drawing
@@ -22,8 +31,19 @@ export interface CanvasMargin {
22
31
  export declare function prepareCanvas(canvas: HTMLCanvasElement, size: [number, number], margin: CanvasMargin, dpr: number): CanvasRenderingContext2D | null;
23
32
  /**
24
33
  * Get the effective canvas devicePixelRatio, defaulting to 1 in non-browser
25
- * environments. Mobile/coarse-pointer screens are capped at 2x to avoid
26
- * allocating very large backing stores on high-density phones; desktop stays
27
- * crisper but still caps pathological DPR values at 3x.
34
+ * environments. By default, mobile/coarse-pointer screens are capped at 2x to
35
+ * avoid allocating very large backing stores on high-density phones and
36
+ * desktop is capped at 3x. `maxDevicePixelRatio` overrides that ceiling.
37
+ */
38
+ export declare function getDevicePixelRatio(maxDevicePixelRatio?: number): number;
39
+ /**
40
+ * Subscribe to browser pixel-density changes (page zoom, display migration,
41
+ * or OS display-scale changes). A normal ResizeObserver is insufficient:
42
+ * browsers can update `devicePixelRatio` without changing an element's CSS
43
+ * dimensions.
44
+ *
45
+ * The media query is re-created after every change because it watches the
46
+ * *current* resolution. Once that query stops matching, the next query must
47
+ * be armed for the browser's new DPR.
28
48
  */
29
- export declare function getDevicePixelRatio(): number;
49
+ export declare function subscribeToDevicePixelRatioChange(listener: () => void): () => void;
@@ -0,0 +1,25 @@
1
+ import { type CanvasMarkPointerState } from "./sceneCursor";
2
+ type PointerRef = {
3
+ current: CanvasMarkPointerState;
4
+ };
5
+ type CanvasPointerEvent = {
6
+ clientX: number;
7
+ clientY: number;
8
+ pointerType?: string;
9
+ };
10
+ export declare function captureFramePointer(pointerRef: PointerRef, event: CanvasPointerEvent, fallbackType?: string): void;
11
+ /** Capture a pointer without allocation, then preserve the no-work and
12
+ * cursor-only touch fast paths shared by the canvas frames. */
13
+ export declare function shouldHandleFramePointer(pointerRef: PointerRef, event: CanvasPointerEvent, hoverEnabled: boolean, hasAuthoredCursor: boolean, canvas?: HTMLCanvasElement | null, fallbackType?: string): boolean;
14
+ export interface CursorFrameGeometry {
15
+ canvas: HTMLCanvasElement;
16
+ pointer: CanvasMarkPointerState;
17
+ margin: {
18
+ left: number;
19
+ top: number;
20
+ };
21
+ width: number;
22
+ height: number;
23
+ geometryMoved: boolean;
24
+ }
25
+ export {};
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Canonical chrome-safe defaults for direct Stream Frame consumers.
3
+ *
4
+ * High-level chart components supply their own mode-aware margins, but the
5
+ * public Stream frame APIs also render axes and labels by default. Keep their
6
+ * live and static defaults in one place so a standalone SVG cannot crop the
7
+ * same chrome that a browser frame contains.
8
+ */
9
+ export declare const AXIS_FRAME_DEFAULT_MARGIN: {
10
+ readonly top: 50;
11
+ readonly right: 40;
12
+ readonly bottom: 60;
13
+ readonly left: 70;
14
+ };
15
+ export declare const NETWORK_FRAME_DEFAULT_MARGIN: {
16
+ readonly top: 20;
17
+ readonly right: 80;
18
+ readonly bottom: 20;
19
+ readonly left: 80;
20
+ };
21
+ export declare const CENTERED_NETWORK_FRAME_DEFAULT_MARGIN: {
22
+ readonly top: 40;
23
+ readonly right: 40;
24
+ readonly bottom: 40;
25
+ readonly left: 40;
26
+ };
27
+ export declare function networkFrameDefaultMargin(chartType: string): {
28
+ readonly top: 20;
29
+ readonly right: 80;
30
+ readonly bottom: 20;
31
+ readonly left: 80;
32
+ } | {
33
+ readonly top: 40;
34
+ readonly right: 40;
35
+ readonly bottom: 40;
36
+ readonly left: 40;
37
+ };
@@ -2,3 +2,21 @@ import type { ReactNode } from "react";
2
2
  import type { FrameGraphicsContext, FrameGraphicsProp } from "./types";
3
3
  /** Resolve a static or scale-aware SVG graphics layer for a frame family. */
4
4
  export declare function resolveFrameGraphics<S>(graphics: FrameGraphicsProp<S> | undefined, size: number[], margin: FrameGraphicsContext<S>["margin"], scales: S | null): ReactNode;
5
+ export interface ResolveFrameLayersOptions<S> {
6
+ foregroundGraphics?: FrameGraphicsProp<S>;
7
+ backgroundGraphics?: FrameGraphicsProp<S>;
8
+ size: number[];
9
+ margin: FrameGraphicsContext<S>["margin"];
10
+ scales: S | null;
11
+ background?: string;
12
+ themeBackgroundColor: string;
13
+ /** A subscribed wrapper owns function-form resolution when false. */
14
+ resolveScaleAwareGraphics?: boolean;
15
+ }
16
+ /** Resolve both authored SVG layers and the full-frame themed surface once. */
17
+ export declare function resolveFrameLayers<S>({ foregroundGraphics, backgroundGraphics, size, margin, scales, background, themeBackgroundColor, resolveScaleAwareGraphics }: ResolveFrameLayersOptions<S>): {
18
+ resolvedForeground: ReactNode;
19
+ resolvedBackground: ReactNode;
20
+ themeBackground: string;
21
+ surfaceBackground: string | null;
22
+ };
@@ -0,0 +1,26 @@
1
+ import type { ReactNode } from "react";
2
+ import { type ResolveFrameLayersOptions } from "./frameGraphics";
3
+ export interface FrameGraphicsScaleTracker {
4
+ subscribe(listener: () => void): () => void;
5
+ getSnapshot(): number;
6
+ sync(scales: unknown): void;
7
+ }
8
+ /**
9
+ * Small external-store signal for imperative scale mutations. The frame calls
10
+ * `sync` from its already-coalesced paint callback, so React only reconciles
11
+ * authored graphics once per displayed zoom/rotation frame—and only while a
12
+ * function-form layer is mounted.
13
+ */
14
+ export declare function createFrameGraphicsScaleTracker(initialScales?: unknown): FrameGraphicsScaleTracker;
15
+ type SubscribedFrameLayerOptions<S> = ResolveFrameLayersOptions<S> & {
16
+ tracker: FrameGraphicsScaleTracker;
17
+ readScales: () => S | null;
18
+ };
19
+ /** Resolve static layers normally and subscribe only function-form layers. */
20
+ export declare function resolveSubscribedFrameLayers<S>({ tracker, readScales, ...options }: SubscribedFrameLayerOptions<S>): {
21
+ resolvedForeground: ReactNode;
22
+ resolvedBackground: ReactNode;
23
+ themeBackground: string;
24
+ surfaceBackground: string | null;
25
+ };
26
+ export {};
@@ -0,0 +1,18 @@
1
+ import type { StreamOrdinalFrameProps } from "./ordinalTypes";
2
+ import type { StreamXYFrameProps } from "./types";
3
+ type ChartLegendHost = {
4
+ __legendMarginReservedFor?: unknown;
5
+ };
6
+ /** Shared HOC-to-frame legend hand-off for direct XY frames. */
7
+ export declare function xyFrameLegendOptions(props: StreamXYFrameProps & ChartLegendHost, legend: unknown): {
8
+ legendLayout: import("../semiotic-geo").LegendLayout | undefined;
9
+ axisChrome: import("../legendLayout").AxisChromeInput;
10
+ legendMarginReserved: boolean;
11
+ };
12
+ /** Shared HOC-to-frame legend hand-off for direct ordinal frames. */
13
+ export declare function ordinalFrameLegendOptions(props: StreamOrdinalFrameProps & ChartLegendHost, legend: unknown): {
14
+ legendLayout: import("../semiotic-geo").LegendLayout | undefined;
15
+ axisChrome: import("../legendLayout").AxisChromeInput;
16
+ legendMarginReserved: boolean;
17
+ };
18
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { GeoPipelineStore } from "./GeoPipelineStore";
2
+ import type { CursorFrameGeometry } from "./frameCursorInteraction";
3
+ import { type HitCanvas } from "./geoFrameHelpers";
4
+ export declare function rehitGeoFrameCursor(options: CursorFrameGeometry & {
5
+ store: GeoPipelineStore;
6
+ hitCanvasRef: {
7
+ current: HitCanvas | null;
8
+ };
9
+ }): void;
@@ -3,10 +3,14 @@
3
3
  * projection name resolution, and hit-canvas context acquisition.
4
4
  */
5
5
  import type * as React from "react";
6
+ import type { Quadtree } from "d3-quadtree";
6
7
  import type { Selection } from "d3-selection";
7
8
  import type { ZoomTransform } from "d3-zoom";
8
9
  import type { Datum } from "../charts/shared/datumTypes";
9
- import type { ProjectionName, ProjectionProp } from "./geoTypes";
10
+ import type { HoverData } from "../realtime/types";
11
+ import type { GeoSceneNode, ProjectionName, ProjectionProp } from "./geoTypes";
12
+ import { type HoverPointerCoords } from "./hoverUtils";
13
+ import type { PointSceneNode } from "./types";
10
14
  export declare const DEFAULT_GEO_MARGIN: {
11
15
  top: number;
12
16
  right: number;
@@ -32,3 +36,27 @@ export interface GeoZoomControlBehavior {
32
36
  }
33
37
  export declare function resolveProjectionName(projection: ProjectionProp): ProjectionName | null;
34
38
  export declare function ensureHitCanvasContext(canvas: HitCanvas | null): HitCanvasContext | null;
39
+ export type GeoPointerResolution = {
40
+ kind: "outside" | "unavailable" | "miss";
41
+ } | {
42
+ kind: "hit";
43
+ node: GeoSceneNode;
44
+ hover: HoverData;
45
+ };
46
+ /** Resolve Geo pointer geometry and its flattened public hover datum. */
47
+ export declare function resolveGeoPointerHit(options: {
48
+ pointer: HoverPointerCoords;
49
+ canvasRect: Pick<DOMRect, "left" | "top">;
50
+ margin: {
51
+ left: number;
52
+ top: number;
53
+ };
54
+ width: number;
55
+ height: number;
56
+ scene: GeoSceneNode[];
57
+ pointQuadtree: Quadtree<PointSceneNode> | null;
58
+ maxPointRadius: number;
59
+ hitCanvasRef: {
60
+ current: HitCanvas | null;
61
+ };
62
+ }): GeoPointerResolution;