semiotic 3.13.1 → 3.13.3

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 (276) hide show
  1. package/README.md +48 -48
  2. package/ai/artifact-surface-inventory.json +1 -1
  3. package/ai/dist/mcp-server.js +4 -4
  4. package/ai/reference.md +23 -12
  5. package/ai/schema.json +258 -96
  6. package/ai/surface-manifest.json +1 -1
  7. package/ai/task-packets/compare-category-totals.json +5 -5
  8. package/ai/task-packets/compare-category-totals.md +2 -2
  9. package/ai/task-packets/correct-published-chart.json +5 -5
  10. package/ai/task-packets/correct-published-chart.md +2 -2
  11. package/ai/task-packets/index.json +6 -6
  12. package/ai/task-packets/update-live-chart.json +5 -5
  13. package/ai/task-packets/update-live-chart.md +2 -2
  14. package/dist/c-2YFVDRU4.min.js +1 -0
  15. package/dist/c-4OVDIXAR.min.js +1 -0
  16. package/dist/c-57IIWW46.min.js +1 -0
  17. package/dist/c-5HTUQRJT.min.js +1 -0
  18. package/dist/c-5NAU4JAY.min.js +1 -0
  19. package/dist/c-62UTMRQE.min.js +1 -0
  20. package/dist/c-6QV6F3U7.min.js +1 -0
  21. package/dist/c-73ORHEHO.min.js +1 -0
  22. package/dist/c-7S46KBYD.min.js +2 -0
  23. package/dist/c-AJSS332Z.min.js +2 -0
  24. package/dist/{c-ZWJDTDEV.min.js → c-AMQAAW7G.min.js} +1 -1
  25. package/dist/c-B3X2IJRQ.min.js +1 -0
  26. package/dist/c-BLLDBVFK.min.js +38 -0
  27. package/dist/c-BQWX6NBX.min.js +1 -0
  28. package/dist/c-C7TT4J7K.min.js +1 -0
  29. package/dist/c-CJ5GA7DM.min.js +1 -0
  30. package/dist/c-D7YDFHLY.min.js +1 -0
  31. package/dist/c-DHNROAXY.min.js +1 -0
  32. package/dist/c-DMDFJQU4.min.js +1 -0
  33. package/dist/{c-RAIBDXDV.min.js → c-FRVHZIGR.min.js} +1 -1
  34. package/dist/{c-I54V24WG.min.js → c-HAZCVHI7.min.js} +1 -1
  35. package/dist/c-HN5U72U7.min.js +1 -0
  36. package/dist/c-JA5F7ITS.min.js +1 -0
  37. package/dist/{c-VZNIIKL6.min.js → c-JDI7HKEM.min.js} +1 -1
  38. package/dist/{c-ISHYKYII.min.js → c-JVZRD4GL.min.js} +1 -1
  39. package/dist/{c-HGWITEJI.min.js → c-KJGJEOSV.min.js} +1 -1
  40. package/dist/c-LDGV6TDQ.min.js +1 -0
  41. package/dist/c-LW3GP7RY.min.js +1 -0
  42. package/dist/c-M2TPZE7P.min.js +1 -0
  43. package/dist/{c-XOGN3524.min.js → c-NBBYSAQY.min.js} +2 -2
  44. package/dist/c-OA6RJZ7S.min.js +1 -0
  45. package/dist/c-OBBSIOYU.min.js +1 -0
  46. package/dist/c-OMTJIC3P.min.js +1 -0
  47. package/dist/{c-SQQZPFVY.min.js → c-QPHM7AWW.min.js} +1 -1
  48. package/dist/{c-XZJWL7UL.min.js → c-QSEAAHEU.min.js} +1 -1
  49. package/dist/c-RQWI623R.min.js +1 -0
  50. package/dist/{c-62JIVHK5.min.js → c-RWFADOKS.min.js} +1 -1
  51. package/dist/c-TFESQSWE.min.js +1 -0
  52. package/dist/{c-SDGGMIYI.min.js → c-TJGC5JEM.min.js} +1 -1
  53. package/dist/{c-4P2EM44G.min.js → c-TOXWQRXS.min.js} +3 -3
  54. package/dist/c-TX53234M.min.js +1 -0
  55. package/dist/c-TZBEQ5UY.min.js +1 -0
  56. package/dist/c-UALVQIIJ.min.js +1 -0
  57. package/dist/c-VBDWHTC7.min.js +1 -0
  58. package/dist/c-VBIPDCE7.min.js +1 -0
  59. package/dist/c-WTNRBWZZ.min.js +51 -0
  60. package/dist/{c-3GIPT46Z.min.js → c-XG4LL2VI.min.js} +1 -1
  61. package/dist/c-XPNBS3W2.min.js +1 -0
  62. package/dist/c-XT3G3YWU.min.js +1 -0
  63. package/dist/c-YCBCZFOC.min.js +1 -0
  64. package/dist/c-ZBSL4Y32.min.js +1 -0
  65. package/dist/c-ZP6O6UHV.min.js +1 -0
  66. package/dist/c-ZVL7ULNH.min.js +1 -0
  67. package/dist/components/ChartErrorBoundary.d.ts +5 -1
  68. package/dist/components/ai/intentWeights.d.ts +22 -0
  69. package/dist/components/ai/streamSchema.d.ts +98 -0
  70. package/dist/components/ai/streamingTypes.d.ts +27 -4
  71. package/dist/components/ai/suggestCharts.d.ts +10 -2
  72. package/dist/components/ai/suggestStreamCharts.d.ts +60 -13
  73. package/dist/components/ai/suggestStreamDashboard.d.ts +9 -1
  74. package/dist/components/charts/network/processSankey/frameMargins.d.ts +1 -1
  75. package/dist/components/charts/network/processSankey/labelPlacement.d.ts +1 -1
  76. package/dist/components/charts/physics/physicsHocUtils.d.ts +1 -1
  77. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +7 -0
  78. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +9 -2
  79. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +13 -1
  80. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +5 -1
  81. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +5 -1
  82. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
  83. package/dist/components/charts/realtime/TemporalHistogram.capability.d.ts +5 -3
  84. package/dist/components/charts/realtime/aggregate.d.ts +11 -12
  85. package/dist/components/charts/realtime/defaultRealtimeTooltip.d.ts +9 -0
  86. package/dist/components/charts/realtime/eventTime.d.ts +7 -1
  87. package/dist/components/charts/realtime/useRealtimeLineIngestion.d.ts +13 -0
  88. package/dist/components/charts/shared/ChartError.d.ts +4 -6
  89. package/dist/components/charts/shared/GaugeReadout.d.ts +39 -4
  90. package/dist/components/charts/shared/axisExtent.d.ts +2 -1
  91. package/dist/components/charts/shared/chartMode.d.ts +2 -2
  92. package/dist/components/charts/shared/gaugeLayout.d.ts +69 -0
  93. package/dist/components/charts/shared/types.d.ts +4 -1
  94. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +3 -0
  95. package/dist/components/charts/shared/useStreamStatus.d.ts +2 -2
  96. package/dist/components/charts/shared/withChartErrorBoundary.d.ts +14 -0
  97. package/dist/components/charts/xy/Scatterplot.streamCapability.d.ts +2 -0
  98. package/dist/components/charts/xy/WaterfallChart.d.ts +2 -0
  99. package/dist/components/charts/xy/WaterfallIndex.d.ts +12 -0
  100. package/dist/components/charts/xy/lineGapStrategy.d.ts +15 -3
  101. package/dist/components/legendGeometry.d.ts +148 -0
  102. package/dist/components/legendLayout.d.ts +20 -38
  103. package/dist/components/realtime/ReorderBuffer.d.ts +14 -0
  104. package/dist/components/realtime/SlidingExtent.d.ts +18 -0
  105. package/dist/components/realtime/WindowAccumulator.d.ts +5 -1
  106. package/dist/components/realtime/renderers/types.d.ts +1 -0
  107. package/dist/components/realtime/renderers/waterfallRenderer.d.ts +1 -1
  108. package/dist/components/recipes/atlas/resolution/appearance.d.ts +1 -1
  109. package/dist/components/recipes/atlas/resolution/scene.d.ts +1 -1
  110. package/dist/components/recipes/compositional/edgeRouting.d.ts +9 -0
  111. package/dist/components/recipes/compositional/metrics.d.ts +2 -2
  112. package/dist/components/recipes/compositional/projection.d.ts +3 -1
  113. package/dist/components/recipes/compositional/routing.d.ts +3 -1
  114. package/dist/components/recipes/compositional/testFixtures.d.ts +4 -0
  115. package/dist/components/recipes/compositional/topology.d.ts +2 -0
  116. package/dist/components/recipes/compositional/types.d.ts +10 -1
  117. package/dist/components/recipes/compositional/useCompositionalInterfaces.d.ts +20 -0
  118. package/dist/components/semiotic-ai-core.d.ts +3 -2
  119. package/dist/components/semiotic-ai-stream.d.ts +3 -2
  120. package/dist/components/semiotic-network-zoom.d.ts +1 -1
  121. package/dist/components/semiotic-recipes-react.d.ts +2 -0
  122. package/dist/components/semiotic-utils-core.d.ts +2 -0
  123. package/dist/components/server/serverChartConfigHeatmap.d.ts +13 -0
  124. package/dist/components/server/staticLegend.d.ts +5 -0
  125. package/dist/components/server/staticLegendText.d.ts +13 -0
  126. package/dist/components/server/staticSVGChrome.d.ts +2 -2
  127. package/dist/components/store/ThemeStore.d.ts +4 -1
  128. package/dist/components/store/themeCore.d.ts +2 -0
  129. package/dist/components/stream/DataSourceAdapter.d.ts +15 -62
  130. package/dist/components/stream/FrameRuntime.d.ts +3 -0
  131. package/dist/components/stream/GeoPipelineStore.d.ts +2 -0
  132. package/dist/components/stream/IngestActivity.d.ts +9 -0
  133. package/dist/components/stream/NetworkPipelineStore.d.ts +3 -1
  134. package/dist/components/stream/OrdinalPipelineStore.d.ts +5 -2
  135. package/dist/components/stream/OrdinalSVGOverlay.d.ts +1 -1
  136. package/dist/components/stream/PipelineStore.d.ts +8 -3
  137. package/dist/components/stream/accessibleDataRows.d.ts +1 -0
  138. package/dist/components/stream/axisTickUtils.d.ts +25 -5
  139. package/dist/components/stream/frameDefaultMargins.d.ts +26 -4
  140. package/dist/components/stream/frameKeyboardNavigation.d.ts +8 -1
  141. package/dist/components/stream/geoTypes.d.ts +2 -0
  142. package/dist/components/stream/graphKeyboardNavigation.d.ts +4 -2
  143. package/dist/components/stream/hitTestUtils.d.ts +7 -0
  144. package/dist/components/stream/keyboardNav.d.ts +3 -1
  145. package/dist/components/stream/mediaQuery.d.ts +2 -0
  146. package/dist/components/stream/navigationGraph.d.ts +10 -3
  147. package/dist/components/stream/networkEdgeHitIndex.d.ts +6 -2
  148. package/dist/components/stream/networkFrameKeyboardNavigation.d.ts +2 -0
  149. package/dist/components/stream/networkNavGroups.d.ts +3 -0
  150. package/dist/components/stream/networkPipelineConfig.d.ts +1 -0
  151. package/dist/components/stream/networkSceneTypes.d.ts +10 -0
  152. package/dist/components/stream/networkSpatialNavigation.d.ts +3 -0
  153. package/dist/components/stream/networkTypes.d.ts +2 -0
  154. package/dist/components/stream/networkZoom/ZoomableNetworkCustomChart.d.ts +6 -4
  155. package/dist/components/stream/networkZoom/gestures.d.ts +5 -0
  156. package/dist/components/stream/networkZoom/types.d.ts +10 -0
  157. package/dist/components/stream/ordinalAxisTicks.d.ts +27 -0
  158. package/dist/components/stream/ordinalSceneBuilders/pieScene.d.ts +10 -0
  159. package/dist/components/stream/ordinalSceneBuilders/types.d.ts +2 -0
  160. package/dist/components/stream/ordinalTypes.d.ts +11 -2
  161. package/dist/components/stream/pipelineBufferUtils.d.ts +9 -0
  162. package/dist/components/stream/pipelineConfig.d.ts +7 -0
  163. package/dist/components/stream/pipelineDomainResolution.d.ts +3 -2
  164. package/dist/components/stream/pipelineTransitionTypes.d.ts +3 -5
  165. package/dist/components/stream/pipelineTransitionUtils.d.ts +4 -0
  166. package/dist/components/stream/pipelineTransitions.d.ts +1 -13
  167. package/dist/components/stream/renderers/networkArcRenderer.d.ts +1 -3
  168. package/dist/components/stream/renderers/networkCircleRenderer.d.ts +1 -3
  169. package/dist/components/stream/renderers/networkPrimitiveRenderer.d.ts +5 -0
  170. package/dist/components/stream/renderers/networkRectRenderer.d.ts +1 -3
  171. package/dist/components/stream/renderers/renderPulse.d.ts +8 -14
  172. package/dist/components/stream/roundScaleDomain.d.ts +9 -0
  173. package/dist/components/stream/sceneToSVGShared.d.ts +9 -0
  174. package/dist/components/stream/shallowEqual.d.ts +2 -0
  175. package/dist/components/stream/stalenessBands.d.ts +1 -1
  176. package/dist/components/stream/svgOverlayUtils.d.ts +12 -0
  177. package/dist/components/stream/types.d.ts +10 -2
  178. package/dist/components/stream/useFrame.d.ts +7 -4
  179. package/dist/components/stream/useMediaPreferences.d.ts +1 -4
  180. package/dist/components/stream/useOrdinalFrameHandle.d.ts +4 -14
  181. package/dist/components/stream/useStalenessCheck.d.ts +5 -3
  182. package/dist/components/stream/useStreamingDataHandle.d.ts +24 -0
  183. package/dist/components/stream/useXYFrameHandle.d.ts +4 -14
  184. package/dist/components/stream/xyDateTicks.d.ts +33 -4
  185. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  186. package/dist/components/stream/xyPlugins/registry.d.ts +7 -0
  187. package/dist/components/stream/xySceneBuilders/heatmapScene.d.ts +11 -2
  188. package/dist/components/stream/xySceneBuilders/types.d.ts +4 -0
  189. package/dist/components/types/legendTypes.d.ts +12 -1
  190. package/dist/geo.min.js +155 -152
  191. package/dist/geo.module.min.js +1 -1
  192. package/dist/network.module.min.js +1 -1
  193. package/dist/ordinal.module.min.js +1 -1
  194. package/dist/physics.module.min.js +1 -1
  195. package/dist/processSankeyLayoutWorker.js +1 -1
  196. package/dist/semiotic-ai-core.d.ts +3 -2
  197. package/dist/semiotic-ai-core.min.js +5 -5
  198. package/dist/semiotic-ai-core.module.min.js +4 -4
  199. package/dist/semiotic-ai.module.min.js +2 -2
  200. package/dist/semiotic-artifact.min.js +6 -6
  201. package/dist/semiotic-artifact.module.min.js +5 -5
  202. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  203. package/dist/semiotic-atlas.module.min.js +1 -1
  204. package/dist/semiotic-client-cjs-shared.min.js +1021 -1024
  205. package/dist/semiotic-client-compositional.module.min.js +1 -1
  206. package/dist/semiotic-client-shared.module.min.js +1 -1
  207. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -2
  208. package/dist/semiotic-experimental-network-resolution-react.module.min.js +1 -1
  209. package/dist/semiotic-experimental-node-auxiliary.module.min.js +3 -3
  210. package/dist/semiotic-line.module.min.js +1 -1
  211. package/dist/semiotic-network-zoom.d.ts +1 -1
  212. package/dist/semiotic-network-zoom.min.js +7 -7
  213. package/dist/semiotic-network-zoom.module.min.js +1 -1
  214. package/dist/semiotic-realtime-core.module.min.js +1 -1
  215. package/dist/semiotic-realtime-react.module.min.js +1 -1
  216. package/dist/semiotic-recipes-core-cjs-base.min.js +101 -101
  217. package/dist/semiotic-recipes-core.module.min.js +1 -1
  218. package/dist/semiotic-recipes-react.d.ts +2 -0
  219. package/dist/semiotic-recipes-react.min.js +8 -8
  220. package/dist/semiotic-server-edge-node.module.min.js +3 -3
  221. package/dist/semiotic-server-edge.min.js +399 -397
  222. package/dist/semiotic-server-edge.module.min.js +3 -3
  223. package/dist/semiotic-server-node.min.js +399 -397
  224. package/dist/semiotic-themes-core.min.js +2 -2
  225. package/dist/semiotic-themes-core.module.min.js +1 -1
  226. package/dist/semiotic-themes.min.js +2 -2
  227. package/dist/semiotic-themes.module.min.js +1 -1
  228. package/dist/semiotic-utils-core.d.ts +2 -0
  229. package/dist/semiotic-utils-core.min.js +11 -11
  230. package/dist/semiotic-utils-core.module.min.js +3 -3
  231. package/dist/semiotic-value.module.min.js +1 -1
  232. package/dist/semiotic.module.min.js +1 -1
  233. package/dist/server.min.js +399 -397
  234. package/dist/server.module.min.js +3 -3
  235. package/dist/xy.module.min.js +1 -1
  236. package/package.json +11 -11
  237. package/dist/c-2M2OPWVA.min.js +0 -37
  238. package/dist/c-2N7IU2NY.min.js +0 -1
  239. package/dist/c-3UXQGCQT.min.js +0 -1
  240. package/dist/c-4RVDKSMQ.min.js +0 -1
  241. package/dist/c-4YPPVFZH.min.js +0 -1
  242. package/dist/c-6WJKNYIG.min.js +0 -1
  243. package/dist/c-7UN2WUMI.min.js +0 -1
  244. package/dist/c-AQUX6L2O.min.js +0 -1
  245. package/dist/c-BR5QDUCR.min.js +0 -1
  246. package/dist/c-C3YQVUB6.min.js +0 -1
  247. package/dist/c-COP4OISO.min.js +0 -1
  248. package/dist/c-ENRZPF5E.min.js +0 -1
  249. package/dist/c-FAOZZE77.min.js +0 -1
  250. package/dist/c-HBLICBM6.min.js +0 -1
  251. package/dist/c-I4BEWAKT.min.js +0 -1
  252. package/dist/c-IDCFMBA4.min.js +0 -2
  253. package/dist/c-KLJDKRD5.min.js +0 -1
  254. package/dist/c-LEICSI5V.min.js +0 -1
  255. package/dist/c-MOK4RWNO.min.js +0 -1
  256. package/dist/c-N2TVSOYL.min.js +0 -2
  257. package/dist/c-NHZ2E3CI.min.js +0 -1
  258. package/dist/c-OIJL2WZH.min.js +0 -1
  259. package/dist/c-OSLNYZ3Q.min.js +0 -51
  260. package/dist/c-OWRVBUSL.min.js +0 -1
  261. package/dist/c-QIVKWHDL.min.js +0 -1
  262. package/dist/c-QUAEYF34.min.js +0 -1
  263. package/dist/c-RDFFLRKC.min.js +0 -1
  264. package/dist/c-RTU5425Z.min.js +0 -1
  265. package/dist/c-SIQVOV6A.min.js +0 -1
  266. package/dist/c-SU6Z75M2.min.js +0 -1
  267. package/dist/c-SWVXFUDL.min.js +0 -1
  268. package/dist/c-TC47SNSI.min.js +0 -1
  269. package/dist/c-VLWWXOM5.min.js +0 -1
  270. package/dist/c-VNFIRKU5.min.js +0 -1
  271. package/dist/c-W5ATXREF.min.js +0 -1
  272. package/dist/c-WFX456JK.min.js +0 -5
  273. package/dist/c-WSWMQDFZ.min.js +0 -1
  274. package/dist/c-XORVM6C5.min.js +0 -1
  275. package/dist/c-YGTMWEEF.min.js +0 -1
  276. package/dist/c-ZDCTFRA6.min.js +0 -1
@@ -47,3 +47,10 @@ export declare function isTimeLandmark(value: Date | number | string | null | un
47
47
  * Normalize an angle to the [0, 2π) range.
48
48
  */
49
49
  export declare function normalizeAngle(angle: number): number;
50
+ /**
51
+ * True when `angle` lies on the arc from `startAngle` to `endAngle`.
52
+ * Canvas convention: 0 is east, positive is clockwise. A sweep of a full
53
+ * turn or more matches every direction, including a pie or donut whose
54
+ * single category runs from -π/2 to 3π/2 (both normalize to the same ray).
55
+ */
56
+ export declare function angleWithinArc(angle: number, startAngle: number, endAngle: number): boolean;
@@ -26,7 +26,9 @@ export declare function extractXYNavPoints(scene: SceneNode[]): NavPoint[];
26
26
  /**
27
27
  * Extract navigable points from ordinal scene nodes.
28
28
  * Bars use `node.group` (stack/group key) falling back to `datum.category`.
29
- * ArrowRight/Left = across categories, ArrowUp/Down = within stacked segments.
29
+ * ArrowRight/Left walks that group in scene order; ArrowUp/Down switches groups.
30
+ * Wedges keep angular order via start angle, including a start angle of 0.
31
+ * Funnel and bar-funnel steps that were one group per step share `_funnel`.
30
32
  */
31
33
  export declare function extractOrdinalNavPoints(scene: OrdinalSceneNode[]): NavPoint[];
32
34
  /**
@@ -1,2 +1,4 @@
1
+ /** Read a media query without requiring a browser or matchMedia polyfill. */
2
+ export declare function getMediaQuery(query: string): MediaQueryList | undefined;
1
3
  /** Subscribe with the legacy Safari fallback; tolerate unavailable media queries. */
2
4
  export declare function addMqlListener(mql: MediaQueryList | undefined, handler: (event: MediaQueryListEvent) => void): () => void;
@@ -6,6 +6,9 @@ export interface NavPoint {
6
6
  datum: Datum | null;
7
7
  /** Logical identity for aggregates whose datum is rebuilt during layout. */
8
8
  semanticKey?: string;
9
+ /** Network scene identity and optional authored navigation parent. */
10
+ navId?: string;
11
+ navParentId?: string;
9
12
  /** Shape hint for focus ring rendering */
10
13
  shape?: "circle" | "rect" | "wedge" | "geoarea" | "path";
11
14
  /** Width of rect-shaped elements (bars, sankey nodes) */
@@ -20,6 +23,10 @@ export interface NavPoint {
20
23
  category?: string;
21
24
  /** Group identifier for graph navigation (series name, category, node id) */
22
25
  group?: string;
26
+ /**
27
+ * Rank used while extracting ordinal marks in authored reading order.
28
+ */
29
+ readingOrder?: number;
23
30
  /** Index in NavGraph.flat — set by buildNavGraph for O(1) lookup */
24
31
  _flatIndex?: number;
25
32
  /** Index within its group — set by buildNavGraph for O(1) resolvePosition */
@@ -52,10 +59,10 @@ export interface NavPosition {
52
59
  }
53
60
  /**
54
61
  * Build a navigation graph from grouped NavPoints.
55
- * Points within each group are sorted by x then y.
56
- * Groups are sorted by their first-point y position (top to bottom).
62
+ * With ordered input, points and groups retain their supplied reading order.
63
+ * Otherwise points sort by x then y and groups stay in top-to-bottom order.
57
64
  */
58
- export declare function buildNavGraph(points: NavPoint[]): NavGraph;
65
+ export declare function buildNavGraph(points: NavPoint[], ordered?: boolean): NavGraph;
59
66
  /**
60
67
  * Resolve the current NavPosition from a flat index.
61
68
  * Clamps to valid range if the index is stale (e.g. scene changed between key presses).
@@ -6,5 +6,9 @@ export interface NetworkEdgeHitIndex {
6
6
  root: NetworkHitBranch;
7
7
  }
8
8
  export declare function buildNetworkEdgeHitIndex(edges: NetworkSceneEdge[]): NetworkEdgeHitIndex;
9
- /** Prune by bounds and paint order; Canvas remains the final authority. */
10
- export declare function queryNetworkEdgeHitIndex<T>(index: NetworkEdgeHitIndex, x: number, y: number, tolerance: number, hit: (edge: NetworkSceneEdge) => T | null): T | null;
9
+ /**
10
+ * Prune by bounds; Canvas remains the final authority. `hit` sees each candidate
11
+ * once with its paint order. Returning a hit prunes earlier paint orders;
12
+ * return null for candidates that still need to compete on distance.
13
+ */
14
+ export declare function queryNetworkEdgeHitIndex<T>(index: NetworkEdgeHitIndex, x: number, y: number, tolerance: number, hit: (edge: NetworkSceneEdge, order: number) => T | null): T | null;
@@ -8,5 +8,7 @@ export declare function useNetworkKeyboardNavigation(params: KeyboardInteraction
8
8
  focusedNavPointRef: import("react").RefObject<NavPoint | null>;
9
9
  neighborIndexRef: import("react").RefObject<number>;
10
10
  onKeyDown: (event: import("react").KeyboardEvent) => void;
11
+ onBlur: (event: import("react").FocusEvent<HTMLElement>) => void;
12
+ clearFocus: () => void;
11
13
  refreshKeyboardFocus: () => void;
12
14
  };
@@ -0,0 +1,3 @@
1
+ import type { NavGraph } from "./navigationGraph";
2
+ /** Authored owner/part navigation, leaving ungrouped network behavior intact. */
3
+ export declare function groupedNetworkIndex(key: string, index: number, graph: NavGraph): number | null | undefined;
@@ -6,6 +6,7 @@ import type { SemioticTheme } from "../store/themeCore";
6
6
  import type { NetworkPipelineConfig } from "./networkTypes";
7
7
  import type { StreamNetworkFrameProps } from "./networkTypes";
8
8
  export type NetworkPipelineConfigSources = Pick<StreamNetworkFrameProps, "chartType" | "nodeIDAccessor" | "sourceAccessor" | "targetAccessor" | "valueAccessor" | "edgeIdAccessor" | "edgeIdentity" | "childrenAccessor" | "hierarchySum" | "orientation" | "nodeAlign" | "nodePaddingRatio" | "nodeWidth" | "iterations" | "forceStrength" | "padAngle" | "groupWidth" | "sortGroups" | "edgeSort" | "treeOrientation" | "edgeType" | "padding" | "paddingTop" | "nodeStyle" | "edgeStyle" | "nodeLabel" | "showLabels" | "labelMode" | "colorBy" | "colorScheme" | "edgeColorBy" | "edgeOpacity" | "colorByDepth" | "nodeSize" | "nodeSizeRange" | "decay" | "pulse" | "transition" | "staleness" | "thresholds" | "orbitMode" | "orbitSize" | "orbitSpeed" | "orbitRevolution" | "orbitRevolutionStyle" | "orbitEccentricity" | "orbitShowRings" | "orbitAnimated" | "clock" | "random" | "seed" | "customNetworkLayout" | "onLayoutError" | "layoutConfig" | "perspective"> & {
9
+ activityClock?: () => number;
9
10
  tensionConfig: NetworkPipelineConfig["tensionConfig"];
10
11
  showParticles: boolean;
11
12
  particleStyle: NetworkPipelineConfig["particleStyle"];
@@ -18,6 +18,8 @@ export interface NetworkCircleNode {
18
18
  datum: SceneDatum;
19
19
  accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
20
20
  accessibility?: SceneAccessibilityMetadata["accessibility"];
21
+ /** Scene node ID of the containing keyboard navigation group. */
22
+ navParentId?: string;
21
23
  id?: string;
22
24
  label?: string;
23
25
  depth?: number;
@@ -51,6 +53,8 @@ export interface NetworkRectNode {
51
53
  datum: SceneDatum;
52
54
  accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
53
55
  accessibility?: SceneAccessibilityMetadata["accessibility"];
56
+ /** Scene node ID of the containing keyboard navigation group. */
57
+ navParentId?: string;
54
58
  id?: string;
55
59
  label?: string;
56
60
  depth?: number;
@@ -83,6 +87,8 @@ export interface NetworkArcNode {
83
87
  datum: SceneDatum;
84
88
  accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
85
89
  accessibility?: SceneAccessibilityMetadata["accessibility"];
90
+ /** Scene node ID of the containing keyboard navigation group. */
91
+ navParentId?: string;
86
92
  id?: string;
87
93
  label?: string;
88
94
  _pulseIntensity?: number;
@@ -118,6 +124,8 @@ export interface NetworkSymbolNode {
118
124
  datum: SceneDatum;
119
125
  accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
120
126
  accessibility?: SceneAccessibilityMetadata["accessibility"];
127
+ /** Scene node ID of the containing keyboard navigation group. */
128
+ navParentId?: string;
121
129
  id?: string;
122
130
  label?: string;
123
131
  depth?: number;
@@ -161,6 +169,8 @@ export interface NetworkGlyphNode {
161
169
  datum: SceneDatum;
162
170
  accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
163
171
  accessibility?: SceneAccessibilityMetadata["accessibility"];
172
+ /** Scene node ID of the containing keyboard navigation group. */
173
+ navParentId?: string;
164
174
  id?: string;
165
175
  label?: string;
166
176
  depth?: number;
@@ -0,0 +1,3 @@
1
+ import type { NavGraph, NavPoint } from "./navigationGraph";
2
+ /** Shared spatial arrow movement for flat networks and authored sibling groups. */
3
+ export declare function findNearestSpatial(graph: NavGraph, from: NavPoint, direction: "right" | "left" | "up" | "down", candidates?: readonly number[]): number | null;
@@ -241,6 +241,8 @@ export interface NetworkPipelineConfig {
241
241
  chartType: NetworkChartType;
242
242
  /** Frame-owned logical clock for ingest, live encodings, and transitions. */
243
243
  clock?: import("./FrameRuntime").FrameClock;
244
+ /** Wall clock for data freshness; animation continues to use `clock`. */
245
+ activityClock?: () => number;
244
246
  /** Frame-local random source used by synchronous force layout. */
245
247
  random?: import("./FrameRuntime").FrameRandom;
246
248
  /** Serializable deterministic seed, including the force-worker protocol. */
@@ -3,7 +3,7 @@ import type { NetworkCustomChartProps } from "../../charts/custom/NetworkCustomC
3
3
  import type { Datum } from "../../charts/shared/datumTypes";
4
4
  import type { NetworkLayoutResult } from "../networkCustomLayout";
5
5
  import type { NetworkViewTransform } from "../networkViewportTypes";
6
- import type { NetworkZoomChange, NetworkZoomOptions, ZoomableNetworkCustomChartHandle } from "./types";
6
+ import type { NetworkLayoutCommitCamera, NetworkZoomChange, NetworkZoomOptions, ZoomableNetworkCustomChartHandle } from "./types";
7
7
  /** An opt-in camera around NetworkCustomChart. Layout remains in authored
8
8
  * coordinates; only presentation, hit testing and the visible window change. */
9
9
  export interface ZoomableNetworkCustomChartProps<TNode extends Datum = Datum, TEdge extends Datum = Datum, TConfig extends object = Record<string, unknown>> extends NetworkCustomChartProps<TNode, TEdge, TConfig> {
@@ -14,10 +14,12 @@ export interface ZoomableNetworkCustomChartProps<TNode extends Datum = Datum, TE
14
14
  onZoomChange?: (zoom: NetworkViewTransform, event: NetworkZoomChange) => void;
15
15
  /**
16
16
  * Called from the commit that renders each new custom layout run's HTML marks
17
- * and overlays, before that frame paints, with the run it replaces. A
18
- * zero-duration camera move made here paints with those marks.
17
+ * and overlays, before that frame paints, with the run it replaces and the
18
+ * commit's camera. A move made through that camera applies in this commit,
19
+ * so the run's marks paint under it, and its `getZoom` reads it back at
20
+ * once. A zero-duration move through the handle lands with those marks too.
19
21
  */
20
- onLayoutCommit?: (result: NetworkLayoutResult | null, previous: NetworkLayoutResult | null) => void;
22
+ onLayoutCommit?: (result: NetworkLayoutResult | null, previous: NetworkLayoutResult | null, camera: NetworkLayoutCommitCamera) => void;
21
23
  zoomOptions?: NetworkZoomOptions;
22
24
  /** Accessible zoom, fit and reset buttons. @default true */
23
25
  zoomControls?: boolean;
@@ -7,11 +7,16 @@ interface Host {
7
7
  /** Moving changes arrive from an animation frame or a microtask, never from
8
8
  * inside a caller's React commit. */
9
9
  change(zoom: NetworkViewTransform, event: NetworkZoomChange): void;
10
+ /** A move made from inside the host's own commit (`jumpTo`): the host
11
+ * applies it in place, with no flush of its own. */
12
+ commit(zoom: NetworkViewTransform, event: NetworkZoomChange): void;
10
13
  }
11
14
  /** A frame-scoped Pointer Events driver. No document gesture listeners or
12
15
  * global registrations; every timer, capture and listener belongs to this host. */
13
16
  export declare function bindNetworkZoom(element: HTMLElement, host: Host): {
14
17
  moveTo: (requested: NetworkViewTransform, nextSource: NetworkZoomSource, duration?: number) => void;
18
+ jumpTo: (requested: NetworkViewTransform, nextSource: NetworkZoomSource) => void;
19
+ rebound: () => void;
15
20
  zoomBy: (factor: number, nextSource?: NetworkZoomSource, point?: {
16
21
  x: number;
17
22
  y: number;
@@ -80,6 +80,16 @@ export interface NetworkZoomCenterOptions {
80
80
  duration?: number;
81
81
  insets?: NetworkZoomInsets;
82
82
  }
83
+ /**
84
+ * The camera during a layout commit (`onLayoutCommit`). A move made through it
85
+ * applies inside that commit, before the committed marks paint, within the
86
+ * bounds as any move is; with a controlled `zoom` it is proposed through
87
+ * `onZoomChange` as any move is. `getZoom` reads the camera as applied.
88
+ */
89
+ export interface NetworkLayoutCommitCamera {
90
+ getZoom(): NetworkViewTransform;
91
+ zoomTo(zoom: NetworkViewTransform): void;
92
+ }
83
93
  /** Change notification. An idle event also fires when a gesture settles. */
84
94
  export interface NetworkZoomChange {
85
95
  source: NetworkZoomSource;
@@ -0,0 +1,27 @@
1
+ import { type AxisExtentMode } from "../charts/shared/axisExtent";
2
+ import type { OrdinalScales } from "./ordinalTypes";
3
+ /** Existing ordinal modes retain their fixed count; rounded domains and their
4
+ * ticks share the XY pixel budget along the value axis. */
5
+ export declare function ordinalAxisTickCount(layout: {
6
+ width: number;
7
+ height: number;
8
+ }, projection: string, mode?: AxisExtentMode): number;
9
+ export declare function ordinalAxisTicks(scales: OrdinalScales, layout: {
10
+ width: number;
11
+ height: number;
12
+ }, mode?: AxisExtentMode, values?: number[]): number[];
13
+ export interface OrdinalValueTick {
14
+ value: number;
15
+ pixel: number;
16
+ label: string;
17
+ }
18
+ /**
19
+ * Positioned, labelled value-axis ticks for ordinal frames. Live axes,
20
+ * underlay grids, and static exports all read this one list, so a tick whose
21
+ * label repeats its neighbour is dropped from labels and grid alike — the
22
+ * same rule XY axes apply.
23
+ */
24
+ export declare function ordinalValueTicks(scales: OrdinalScales, layout: {
25
+ width: number;
26
+ height: number;
27
+ }, mode?: AxisExtentMode, values?: number[], format?: (value: number) => string): OrdinalValueTick[];
@@ -1,3 +1,13 @@
1
1
  import type { WedgeSceneNode, OrdinalLayout } from "../ordinalTypes";
2
2
  import type { OrdinalSceneContext } from "./types";
3
+ /**
4
+ * `innerRadius` is a pixel request, but the outer radius follows the plot
5
+ * area. On a short plot the requested hole can be wider than the pie; drawing
6
+ * that inverted ring paints it outside the plot, where the clip cuts it flat.
7
+ * A hole that leaves at least a 1px ring is kept as requested (thin rings are
8
+ * a legitimate style, and gauges size their hole against the radius they
9
+ * reserve); one that does not falls back to a readable ring of
10
+ * `FALLBACK_DONUT_RING` px, or a quarter of the radius on very small donuts.
11
+ */
12
+ export declare function fitDonutInnerRadius(requested: number, outerRadius: number): number;
3
13
  export declare function buildPieScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): WedgeSceneNode[];
@@ -4,6 +4,8 @@ import type { Style } from "../types";
4
4
  import type { Datum } from "../../charts/shared/datumTypes";
5
5
  export interface OrdinalSceneContext {
6
6
  scales: OrdinalScales;
7
+ /** Columns in resolved scale-domain order, including integer-like names. */
8
+ orderedColumns: OrdinalColumn[];
7
9
  columns: Record<string, OrdinalColumn>;
8
10
  config: OrdinalPipelineConfig;
9
11
  getR: (d: Datum) => number;
@@ -193,6 +193,7 @@ export interface OrdinalPipelineConfig {
193
193
  chartType: OrdinalChartType;
194
194
  runtimeMode?: "bounded" | "streaming";
195
195
  windowSize: number;
196
+ maxCapacity?: number;
196
197
  windowMode: WindowMode;
197
198
  extentPadding: number;
198
199
  /** When `"exact"`, the value-axis domain is pinned to the literal data
@@ -200,6 +201,8 @@ export interface OrdinalPipelineConfig {
200
201
  * land on the actual data bounds. Default `"nice"` keeps the existing
201
202
  * padded domain so symbols at the extremes don't clip the plot edge. */
202
203
  axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
204
+ /** Explicit ticks disable automatic value-domain rounding. */
205
+ rTickValues?: number[];
203
206
  projection: "vertical" | "horizontal" | "radial";
204
207
  categoryAccessor?: string | ((d: Datum) => string);
205
208
  valueAccessor?: string | ((d: Datum) => number) | Array<string | ((d: Datum) => number)>;
@@ -276,8 +279,10 @@ export interface OrdinalPipelineConfig {
276
279
  /** Whether to animate elements on first render (bars grow from baseline, wedges sweep in) */
277
280
  introAnimation?: boolean;
278
281
  staleness?: StalenessConfig;
279
- /** Frame-owned logical clock for ingest, pulse, staleness, and transitions. */
282
+ /** Frame-owned logical clock for ingest, pulse, and transitions. */
280
283
  clock?: import("./FrameRuntime").FrameClock;
284
+ /** Wall clock for data freshness; animation continues to use `clock`. */
285
+ activityClock?: () => number;
281
286
  /** When provided, replaces chart-type dispatch in scene building.
282
287
  * Receives an OrdinalLayoutContext (scales, dimensions, theme,
283
288
  * resolveColor) and returns scene nodes plus optional overlays. */
@@ -360,6 +365,8 @@ export interface StreamOrdinalFrameProps<T = Datum> {
360
365
  oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc" | "auto";
361
366
  windowMode?: WindowMode;
362
367
  windowSize?: number;
368
+ /** Maximum retained live rows in growing mode (default 100,000). */
369
+ maxCapacity?: number;
363
370
  connectorAccessor?: string | ((d: T) => string);
364
371
  connectorStyle?: Style | ((d: Datum) => Style);
365
372
  /** ID accessor for remove()/update() — extracts a unique identifier from each datum */
@@ -371,7 +378,9 @@ export interface StreamOrdinalFrameProps<T = Datum> {
371
378
  /** Axis extent mode for the value (r) axis. `"nice"` (default) uses
372
379
  * d3-scale's rounded tick generator. `"exact"` pins the first and
373
380
  * last tick to the actual data min and max with equidistant
374
- * intermediate ticks. The categorical (o) axis is unaffected since
381
+ * intermediate ticks. `"rounded"` widens open ends to round ticks after
382
+ * padding and final layout, retaining explicit rExtent bounds.
383
+ * The categorical (o) axis is unaffected since
375
384
  * it's a band scale, not a continuous one. Ignored when explicit
376
385
  * `rTickValues` are provided — caller has hand-picked positions. */
377
386
  axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
@@ -24,3 +24,12 @@ export declare function pushWithTimestamp<T>(buffer: RingBuffer<T>, datum: T, ti
24
24
  * ring buffer. The predicate must be the same one passed to `buffer.remove()`.
25
25
  */
26
26
  export declare function compactTimestampBufferForRemoval<T>(buffer: RingBuffer<T>, timestampBuffer: RingBuffer<number> | null | undefined, predicate: (item: T) => boolean): void;
27
+ /** The retention policy applies to live appends, not bounded snapshots. */
28
+ export interface StreamingWindowConfig {
29
+ windowSize: number;
30
+ windowMode: "sliding" | "growing";
31
+ maxCapacity?: number;
32
+ }
33
+ export declare function validateStreamingWindow(config: StreamingWindowConfig): void;
34
+ /** Resize both rings together, preserving the newest rows and their timestamps. */
35
+ export declare function resizeStreamingBuffer<T>(buffer: RingBuffer<T>, timestamps: RingBuffer<number> | null | undefined, config: StreamingWindowConfig, grow?: boolean): T[];
@@ -14,6 +14,8 @@ export interface PipelineConfig {
14
14
  runtimeMode?: "streaming" | "bounded";
15
15
  /** Optional monotonic clock owned by a frame runtime or embedding host. */
16
16
  clock?: () => number;
17
+ /** Wall clock for data freshness; animation continues to use `clock`. */
18
+ activityClock?: () => number;
17
19
  windowSize: number;
18
20
  windowMode: WindowMode;
19
21
  arrowOfTime: ArrowOfTime;
@@ -27,6 +29,9 @@ export interface PipelineConfig {
27
29
  axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
28
30
  /** Resolved y-axis mode. Falls back to `axisExtent` when omitted. */
29
31
  yAxisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
32
+ /** Value-axis tick selection, shared with the overlay when rounding domains. */
33
+ yAxisTicks?: number;
34
+ yAxisTickValues?: import("./xyFrameAxisTypes").XYFrameAxisConfig["tickValues"];
30
35
  /**
31
36
  * Hard cap for `windowMode: "growing"`. Defaults to
32
37
  * {@link DEFAULT_GROWING_MAX_CAPACITY} (100_000). Canvas scene graphs
@@ -99,6 +104,8 @@ export interface PipelineConfig {
99
104
  };
100
105
  areaStyle?: (d: Datum) => Style;
101
106
  swarmStyle?: SwarmStyle;
107
+ /** Starting cumulative balance for waterfall charts. @default 0 */
108
+ initialValue?: number;
102
109
  waterfallStyle?: WaterfallStyle;
103
110
  colorScheme?: string | string[] | Record<string, string>;
104
111
  /** Theme categorical palette — used as fallback when colorScheme is not an explicit array */
@@ -44,8 +44,8 @@ export declare function resolveCenteredBinXDomain(dataDomain: [number, number],
44
44
  * Cumulative ends of the bars `buildWaterfallScene` draws. A missing or
45
45
  * non-finite x is not a bar, so that row must not move the cursor.
46
46
  */
47
- export declare function waterfallCumulativeEnds(data: Iterable<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number): number[];
48
- export declare function resolveWaterfallYDomain(buffer: RingBuffer<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, extentPadding: number, exactMode: boolean): [number, number];
47
+ export declare function waterfallCumulativeEnds(data: Iterable<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, initialValue?: number): number[];
48
+ export declare function resolveWaterfallYDomain(buffer: RingBuffer<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, extentPadding: number, exactMode: boolean, initialValue?: number): [number, number];
49
49
  /**
50
50
  * Waterfall x values identify bar centers, so the automatic domain needs half
51
51
  * of the neighboring interval beyond each edge datum. User-specified bounds
@@ -55,6 +55,7 @@ export declare function resolveWaterfallXDomain(data: Datum[], getX: (d: Datum)
55
55
  export declare function expandYDomainWithRibbons(yDomain: [number, number], bufferArray: Datum[], ribbons: ResolvedRibbon[]): [number, number];
56
56
  export declare function padYDomain(yDomain: [number, number], options: {
57
57
  exactMode: boolean;
58
+ roundedMode?: boolean;
58
59
  extentPadding: number;
59
60
  userMin?: number;
60
61
  userMax?: number;
@@ -7,26 +7,24 @@
7
7
  import type { GlyphDef } from "./glyphDef";
8
8
  import type { SceneNode } from "./types";
9
9
  import type { Datum } from "../charts/shared/datumTypes";
10
- import type { ActiveTransition } from "./pipelineTransitionUtils";
11
- export type PrevPosition = {
10
+ import type { ActiveTransition, TransitionOpacity } from "./pipelineTransitionUtils";
11
+ export type PrevPosition = TransitionOpacity & {
12
12
  x: number;
13
13
  y: number;
14
14
  w?: number;
15
15
  h?: number;
16
16
  r?: number;
17
- opacity?: number;
18
17
  openY?: number;
19
18
  closeY?: number;
20
19
  highY?: number;
21
20
  lowY?: number;
22
21
  glyph?: GlyphDef;
23
22
  };
24
- export type PrevPath = {
23
+ export type PrevPath = TransitionOpacity & {
25
24
  topPath?: [number, number][];
26
25
  bottomPath?: [number, number][];
27
26
  path?: [number, number][];
28
27
  pathIds?: string[];
29
- opacity?: number;
30
28
  };
31
29
  /** Context needed from PipelineStore for identity resolution */
32
30
  export interface TransitionContext {
@@ -4,6 +4,10 @@
4
4
  * Extracts common easing logic and types used by PipelineStore,
5
5
  * OrdinalPipelineStore, NetworkPipelineStore, and GeoPipelineStore.
6
6
  */
7
+ import type { Style } from "./types";
8
+ export type TransitionOpacity = Pick<Style, "opacity" | "fillOpacity" | "strokeOpacity">;
9
+ /** Copy channels independently of the animated multiplier, including for exits. */
10
+ export declare function snapshotOpacity(style?: TransitionOpacity | null): TransitionOpacity;
7
11
  /** Active transition state tracked by each PipelineStore */
8
12
  export interface ActiveTransition {
9
13
  startTime: number;
@@ -26,19 +26,7 @@ export { joinPathByIdentity };
26
26
  * `_transitionKey` keeps exits stable across overlapping transitions.
27
27
  */
28
28
  export declare function getNodeIdentity(ctx: TransitionContext, node: SceneNode, index: number): string | null;
29
- /**
30
- * Effective paint alpha for fill-based marks.
31
- *
32
- * Matches the canvas renderer convention (`style.opacity ?? style.fillOpacity ?? 1`)
33
- * used by points, glyphs, rects, heatcells, and candlesticks. Intro/update
34
- * transitions must target this same value — otherwise a mark authored with
35
- * only `fillOpacity: 0.7` animates toward 1, bakes `style.opacity = 1` on
36
- * completion, and then "fades" back to 0.7 on the next dirty rebuild
37
- * (e.g. tab-away → tab-back via FrameRuntime visibility resume).
38
- *
39
- * Line/area marks keep stroke alpha on `style.opacity` alone; their under-
40
- * path fill uses `fillOpacity` independently and is not covered here.
41
- */
29
+ /** Transition opacity is independent of the authored fill/stroke channels. */
42
30
  export declare function resolveMarkOpacity(style?: Style | null): number;
43
31
  /**
44
32
  * Snapshot current scene node positions before rebuild.
@@ -1,5 +1,3 @@
1
1
  import type { NetworkSceneNode } from "../networkTypes";
2
- /**
3
- * Canvas painter for NetworkArcNode (chord diagram arc segments).
4
- */
2
+ /** Canvas painter for NetworkArcNode. */
5
3
  export declare function networkArcRenderer(ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[]): void;
@@ -1,5 +1,3 @@
1
1
  import type { NetworkSceneNode } from "../networkTypes";
2
- /**
3
- * Canvas painter for NetworkCircleNode (force nodes, tree nodes, circlepack).
4
- */
2
+ /** Canvas painter for NetworkCircleNode. */
5
3
  export declare function networkCircleRenderer(ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[]): void;
@@ -0,0 +1,5 @@
1
+ import type { NetworkSceneNode, NetworkCircleNode, NetworkRectNode, NetworkArcNode } from "../networkTypes";
2
+ type Primitive = NetworkCircleNode | NetworkRectNode | NetworkArcNode;
3
+ /** Shared paint ordering and alpha ownership for flat and projected network marks. */
4
+ export declare function paintNetworkPrimitives(ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[], type: Primitive["type"]): void;
5
+ export {};
@@ -1,5 +1,3 @@
1
1
  import type { NetworkSceneNode } from "../networkTypes";
2
- /**
3
- * Canvas painter for NetworkRectNode (sankey nodes, treemap cells, partition blocks).
4
- */
2
+ /** Canvas painter for NetworkRectNode. */
5
3
  export declare function networkRectRenderer(ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[]): void;
@@ -5,6 +5,9 @@
5
5
  * their aggregated value changes. Each node carries `_pulseIntensity` (0–1),
6
6
  * `_pulseColor`, and optionally `_pulseGlowRadius`.
7
7
  *
8
+ * Pulses are independent of mark opacity, but inherit the frame alpha.
9
+ * Callers pass the original frame alpha and restore their own paint state.
10
+ *
8
11
  * Three visual variants:
9
12
  * - **Rect overlay**: semi-transparent fillRect on top of the bar/cell
10
13
  * - **Circle glow ring**: expanding stroke ring around a point
@@ -20,17 +23,15 @@ interface PulseFields {
20
23
  */
21
24
  export declare function hasPulse(node: PulseFields): boolean;
22
25
  /**
23
- * Render a rectangular pulse overlay (used by bar, heatmap, and network rect renderers).
24
- * Call this after drawing the main fill/stroke for the rectangle.
26
+ * Flash a rectangle, traced path, or supplied projected outline. The caller
27
+ * owns state restoration; rectangular overlays retain their lighter flash.
25
28
  */
26
- export declare function renderRectPulse(ctx: CanvasRenderingContext2D, node: PulseFields & {
29
+ export declare function renderFillPulse(ctx: CanvasRenderingContext2D, node: PulseFields | (PulseFields & {
27
30
  x: number;
28
31
  y: number;
29
32
  w: number;
30
33
  h: number;
31
- }, alphaMultiplier?: number,
32
- /** Projected outline to flash instead of the bounding rectangle. */
33
- path?: Path2D | null): void;
34
+ }), baseAlpha: number, path?: Path2D | null): void;
34
35
  /**
35
36
  * Render a circular glow ring pulse (used by point and network circle renderers).
36
37
  * Call this after drawing the main circle fill/stroke.
@@ -41,12 +42,5 @@ export declare function renderCirclePulse(ctx: CanvasRenderingContext2D, node: P
41
42
  cx?: number;
42
43
  cy?: number;
43
44
  r: number;
44
- }, alphaMultiplier?: number): void;
45
- /**
46
- * Render a path-based fill pulse (used by area, wedge, and geo renderers).
47
- * The caller must trace the path onto ctx BEFORE calling this function,
48
- * or pass a Path2D object as the third argument (for geo renderers).
49
- * This function sets alpha/fillStyle and calls ctx.fill().
50
- */
51
- export declare function renderPathPulse(ctx: CanvasRenderingContext2D, node: PulseFields, path?: Path2D, alphaMultiplier?: number): void;
45
+ }, baseAlpha: number): void;
52
46
  export {};
@@ -0,0 +1,9 @@
1
+ /** Widen a continuous value scale using d3's stable nice step, retaining pinned
2
+ * ends from the already-resolved domain (including log-domain validation). */
3
+ export declare function roundScaleDomain(scale: {
4
+ domain(): number[];
5
+ domain(values: number[]): unknown;
6
+ nice(count?: number): {
7
+ domain(): number[];
8
+ };
9
+ }, count: number, pinned: readonly boolean[]): void;
@@ -18,6 +18,14 @@ import type { GradientStop } from "../charts/shared/gradient";
18
18
  * the arc-emit sites in the network/ordinal serializers.
19
19
  */
20
20
  export declare const ARC_NOOP: DefaultArcObject;
21
+ /** Independent SVG paint channels; opacity applies once to both. */
22
+ export declare function svgPaintStyle(style: Style): {
23
+ opacity: number | undefined;
24
+ fillOpacity: number | undefined;
25
+ strokeOpacity: number | undefined;
26
+ stroke: string | undefined;
27
+ strokeWidth: number | undefined;
28
+ };
21
29
  export declare function svgFill(fill: string | HatchFill | CanvasPattern | undefined, fallback?: string): string;
22
30
  /**
23
31
  * Coerce a candidate SVG `id` value to the strict `[A-Za-z0-9_-]` charset.
@@ -76,4 +84,5 @@ export declare function perCornerSvgPath(n: RectSceneNode): string;
76
84
  * unfilled in SSR too).
77
85
  */
78
86
  export declare function symbolSceneNodeToSVG(n: SymbolSceneNode, i: number, idPrefix?: string): React.ReactNode;
87
+ export declare function pointSceneNodeToSVG(n: PointSceneNode, i: number, idPrefix?: string, hatchPrefix?: string): React.ReactNode;
79
88
  export declare function pointOrRectSceneNodeToSVG(n: PointSceneNode | RectSceneNode, i: number, idPrefix?: string): React.ReactNode;
@@ -1,2 +1,4 @@
1
1
  /** Shared pure equality for frame configs and retained custom-layout inputs. */
2
2
  export declare function shallowEqualTwoLevel(a: unknown, b: unknown): boolean;
3
+ /** Compare plain records to the requested depth; arrays retain per-index Object.is. */
4
+ export declare function equalConfig(a: unknown, b: unknown, depth: number): boolean;
@@ -19,7 +19,7 @@ export interface ResolvedStaleness {
19
19
  }
20
20
  /**
21
21
  * Resolve the dimming + band for a given idle duration. Pure — the
22
- * render path computes idle from `now - lastIngestTime` each paint and
22
+ * render path reads wall-clock idle time from the activity tracker each paint and
23
23
  * the staleness poll uses the same function to decide when to repaint.
24
24
  *
25
25
  * `idleMs` of 0 (no data yet) is treated as fresh.
@@ -1,4 +1,16 @@
1
1
  export declare function resolveHorizontalTickAnchor(mode: "middle" | "edges" | undefined, isLeftmost: boolean, isRightmost: boolean): "start" | "middle" | "end";
2
+ /**
3
+ * Horizontal offset that keeps a text tick label inside `[min, max]` (the
4
+ * frame's full width, in plot coordinates). Centred end labels — long time
5
+ * stamps especially — otherwise run past the side margin and are clipped by
6
+ * the host container. Returns 0 for any label that already fits, so interior
7
+ * ticks are untouched. Width is the shared 0.6em estimate; a slight
8
+ * overestimate only nudges the label further inside.
9
+ */
10
+ export declare function resolveHorizontalTickLabelShift(anchor: "start" | "middle" | "end", pixel: number, label: string | number, fontSize: number, bounds: {
11
+ min: number;
12
+ max: number;
13
+ }): number;
2
14
  export declare function resolveVerticalTickBaseline(mode: "middle" | "edges" | undefined, isTopmost: boolean, isBottommost: boolean): "hanging" | "middle" | "auto";
3
15
  export declare function tickPixelExtent(ticks: Array<{
4
16
  pixel: number;