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
@@ -166,6 +166,8 @@ export interface NodeConstraint {
166
166
  }
167
167
  export interface EdgeLayoutHint {
168
168
  readonly edgeId: ID;
169
+ /** Same-owner connections default to none; auto explicitly routes them. */
170
+ readonly route?: "auto" | "none";
169
171
  readonly priority?: number;
170
172
  readonly laneId?: ID;
171
173
  readonly alignment?: "auto" | "prefer" | "none";
@@ -245,7 +247,7 @@ export interface PreparedCompositionalGraph {
245
247
  export interface LayoutOptions {
246
248
  readonly mode: "route-only" | "optimize";
247
249
  readonly topology: "strict-dag" | "feedback";
248
- readonly routing: "orthogonal" | "polyline" | "smooth";
250
+ readonly routing: "orthogonal" | "polyline" | "smooth" | "terminals" | "bump";
249
251
  readonly bundles: "none" | "parallel" | "overview";
250
252
  readonly rankGap: number;
251
253
  readonly nodeGap: number;
@@ -315,6 +317,8 @@ export interface PathSection {
315
317
  readonly bounds: Rect;
316
318
  }
317
319
  export interface RoutedConnection {
320
+ /** Preserved by local scroll projection; absent on legacy engine results. */
321
+ readonly routing?: LayoutOptions["routing"] | "none";
318
322
  readonly edgeId: ID;
319
323
  readonly source: TerminalGeometry;
320
324
  readonly target: TerminalGeometry;
@@ -348,6 +352,8 @@ export interface LayoutMetrics {
348
352
  }
349
353
  export interface SolvedCompositionalLayout {
350
354
  readonly schemaVersion: "semiotic.compositional-layout.v0.1";
355
+ /** Routing and metric axis for local projections; absent on legacy engine results. */
356
+ readonly direction?: CompositionalView["direction"];
351
357
  readonly requestId: ID;
352
358
  readonly semanticHash: string;
353
359
  readonly graphRevision: ID;
@@ -371,6 +377,9 @@ export interface EngineCapabilities {
371
377
  readonly multiedges: boolean;
372
378
  readonly compoundCrossHierarchy: boolean;
373
379
  readonly orthogonalRouting: boolean;
380
+ /** Optional for compatibility with engines authored before terminal routing. */
381
+ readonly terminalRouting?: boolean;
382
+ readonly bumpRouting?: boolean;
374
383
  readonly deterministicSeed: boolean;
375
384
  }
376
385
  export interface AsyncLayoutEngine {
@@ -0,0 +1,20 @@
1
+ import type { KeyboardEvent } from "react";
2
+ import type { EndpointRef, PreparedCompositionalGraph } from "./types";
3
+ /** A semantic interface reference, independent of the caller's DOM controls. */
4
+ export interface CompositionalInterfaceItem {
5
+ ref: EndpointRef;
6
+ label: string;
7
+ kind: "part" | "port";
8
+ }
9
+ /** Focus adapters supplied by the host's own controls. */
10
+ export interface CompositionalInterfaceFocus {
11
+ focusOwner: () => void;
12
+ focusItem: (index: number) => void;
13
+ }
14
+ /** Headless interface inventory and keyboard handlers; callers own markup and focus. */
15
+ export declare function useCompositionalInterfaces(prepared: PreparedCompositionalGraph, ownerId?: string): {
16
+ items: CompositionalInterfaceItem[];
17
+ isRemoved(selected?: EndpointRef): boolean;
18
+ onOwnerKeyDown(event: KeyboardEvent, focus: CompositionalInterfaceFocus): void;
19
+ onItemKeyDown(event: KeyboardEvent, index: number, focus: CompositionalInterfaceFocus): void;
20
+ };
@@ -61,9 +61,10 @@ export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions } fro
61
61
  export { applyAudienceBias, effectiveFamiliarity, stretchFamiliarityCeiling, receivabilityBias } from "./ai/audienceProfile";
62
62
  export type { AudienceProfile, AudienceTarget, AudienceBiasResult, ReceptionModality, ReceivabilitySignal, DashboardLayoutPolicy } from "./ai/audienceProfile";
63
63
  export { suggestStreamCharts, explainStreamCapabilityFit, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities } from "./ai/suggestStreamCharts";
64
- export type { SuggestStreamChartsOptions, SuggestStreamChartsResult, RejectedStreamCapability, StreamStretchSuggestion } from "./ai/suggestStreamCharts";
64
+ export type { SuggestStreamChartsOptions, SuggestStreamChartsResult, RejectedStreamCapability, StreamStretchSuggestion, StreamCapabilityExplanation } from "./ai/suggestStreamCharts";
65
65
  export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamFieldRole, StreamShape, StreamThroughput, StreamThroughputBand, StreamThroughputThresholds, StreamChartCapability, StreamIntentScorer, StreamSuggestion } from "./ai/streamingTypes";
66
- export { resolveStreamShape, streamKeyFields, streamThroughputBand, pickValueField, pickCategoryField, pickTimeField, pickSeriesField } from "./ai/streamSchema";
66
+ export { resolveStreamShape, streamKeyFields, streamThroughputBand, pickValueField, pickCategoryField, pickTimeField, pickSeriesField, pickSplitField, pickMeasureFields, normalizeStreamSchema } from "./ai/streamSchema";
67
+ export type { NormalizedStreamSchema } from "./ai/streamSchema";
67
68
  export { suggestStreamDashboard } from "./ai/suggestStreamDashboard";
68
69
  export type { StreamDashboardPanel, StreamDashboardSuggestion, SuggestStreamDashboardOptions } from "./ai/suggestStreamDashboard";
69
70
  export { suggestStretchCharts } from "./ai/suggestStretchCharts";
@@ -3,8 +3,9 @@
3
3
  * Kept as a satellite so the AI barrel stays under the production line ceiling.
4
4
  */
5
5
  export { suggestStreamCharts, explainStreamCapabilityFit, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities } from "./ai/suggestStreamCharts";
6
- export type { SuggestStreamChartsOptions, SuggestStreamChartsResult, RejectedStreamCapability, StreamStretchSuggestion } from "./ai/suggestStreamCharts";
6
+ export type { SuggestStreamChartsOptions, SuggestStreamChartsResult, RejectedStreamCapability, StreamStretchSuggestion, StreamCapabilityExplanation } from "./ai/suggestStreamCharts";
7
7
  export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamFieldRole, StreamShape, StreamThroughput, StreamThroughputBand, StreamThroughputThresholds, StreamChartCapability, StreamIntentScorer, StreamSuggestion } from "./ai/streamingTypes";
8
- export { resolveStreamShape, streamKeyFields, streamThroughputBand, pickValueField, pickCategoryField, pickTimeField, pickSeriesField } from "./ai/streamSchema";
8
+ export { resolveStreamShape, streamKeyFields, streamThroughputBand, pickValueField, pickCategoryField, pickTimeField, pickSeriesField, pickSplitField, pickMeasureFields, normalizeStreamSchema } from "./ai/streamSchema";
9
+ export type { NormalizedStreamSchema } from "./ai/streamSchema";
9
10
  export { suggestStreamDashboard } from "./ai/suggestStreamDashboard";
10
11
  export type { StreamDashboardPanel, StreamDashboardSuggestion, SuggestStreamDashboardOptions } from "./ai/suggestStreamDashboard";
@@ -5,6 +5,6 @@ export { useNetworkZoom, useNetworkProjectedSize, useNetworkLOD, useNetworkLODLe
5
5
  export type { NetworkLODOptions } from "./stream/networkZoom/NetworkZoomContext";
6
6
  export { getNetworkContentBounds } from "./stream/networkZoom/geometry";
7
7
  export { fitZoom as fitNetworkZoom, centerZoom as centerNetworkZoom, usableViewport as usableNetworkViewport } from "./stream/networkZoom/geometry";
8
- export type { NetworkZoomOptions, NetworkZoomInsets, NetworkZoomFitOptions, NetworkZoomCenterOptions, NetworkZoomState, NetworkZoomSource, NetworkZoomChange, ZoomableNetworkCustomChartHandle } from "./stream/networkZoom/types";
8
+ export type { NetworkLayoutCommitCamera, NetworkZoomOptions, NetworkZoomInsets, NetworkZoomFitOptions, NetworkZoomCenterOptions, NetworkZoomState, NetworkZoomSource, NetworkZoomChange, ZoomableNetworkCustomChartHandle } from "./stream/networkZoom/types";
9
9
  export type { NetworkViewTransform, NetworkViewportRect } from "./stream/networkViewportTypes";
10
10
  export { projectNetworkPoint, invertNetworkRect } from "./stream/networkViewTransform";
@@ -7,3 +7,5 @@ export { Glyph } from "./recipes/recipeGlyph";
7
7
  export type { GlyphProps } from "./recipes/recipeGlyph";
8
8
  export { CompositionalNavigator } from "./recipes/compositional/CompositionalNavigator";
9
9
  export type { CompositionalNavigatorProps } from "./recipes/compositional/CompositionalNavigator";
10
+ export { useCompositionalInterfaces } from "./recipes/compositional/useCompositionalInterfaces";
11
+ export type { CompositionalInterfaceItem, CompositionalInterfaceFocus } from "./recipes/compositional/useCompositionalInterfaces";
@@ -62,6 +62,8 @@ export { fromVegaLite } from "./data/fromVegaLite";
62
62
  export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
63
63
  export { RingBuffer } from "./realtime/RingBuffer";
64
64
  export { IncrementalExtent } from "./realtime/IncrementalExtent";
65
+ export { resolveAxisTickCount } from "./stream/axisTickUtils";
66
+ export type { AxisTickCountOptions } from "./stream/axisTickUtils";
65
67
  export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, normalizeTooltip, resolveTooltipContent, resolveMultiCapableTooltip, isMultiTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome } from "./Tooltip/Tooltip";
66
68
  export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
67
69
  export { sweepToAngles, valueToAngle, computeArcBoundingBox } from "./charts/shared/radialGeometry";
@@ -1,4 +1,17 @@
1
1
  import type { ChartConfig } from "./serverChartConfigShared";
2
+ import type { GradientLegendValue } from "../types/legendTypes";
3
+ /**
4
+ * The HOCs' gradient legend. Its domain sizes the legend margin; the static
5
+ * renderer then takes domain and ramp from the drawn cells, as the frame does.
6
+ */
7
+ export declare function heatmapGradientLegend(options: {
8
+ domain: [number, number];
9
+ label: string;
10
+ format?: (value: number) => string;
11
+ legendDistance?: number;
12
+ colorScheme?: unknown;
13
+ colorScale?: (value: number) => string;
14
+ }): GradientLegendValue;
2
15
  /**
3
16
  * Heatmap keeps cell border props separate from the generic primitive
4
17
  * vocabulary. Convert them to the areaStyle consumed by both SVG paths.
@@ -17,6 +17,11 @@ interface LegendItemLayout {
17
17
  }
18
18
  interface StaticLegendMetrics {
19
19
  items: LegendItemLayout[];
20
+ /** Origin of a horizontal "+N more" slot when rows were capped. */
21
+ more?: {
22
+ x: number;
23
+ y: number;
24
+ };
20
25
  width: number;
21
26
  height: number;
22
27
  swatchSize: number;
@@ -0,0 +1,13 @@
1
+ import * as React from "react";
2
+ import type { SemioticTheme } from "../store/themeCore";
3
+ export declare function legendFontSize(theme: SemioticTheme): number;
4
+ export declare function legendFontFamily(theme: SemioticTheme): string;
5
+ export declare function legendFontWeight(theme: SemioticTheme): string | number | undefined;
6
+ /** Average glyph width static SVG assumes for the theme's legend font. */
7
+ export declare function legendCharWidth(theme: SemioticTheme): number;
8
+ /** Label text plus a hover title carrying the full label when truncated. */
9
+ export declare function staticLegendLabelText(label: string, maxWidth: number, charWidth?: number): React.ReactNode;
10
+ export declare function renderStaticMoreRow(key: string, offset: {
11
+ x: number;
12
+ y: number;
13
+ }, swatchSize: number, hiddenCount: number, title: string, theme: SemioticTheme): React.ReactElement;
@@ -10,7 +10,7 @@ export { reserveLegendConfigMargin, reserveStaticLegendMargin, } from "./staticL
10
10
  import { resolveTheme, type ThemeInput } from "./themeResolver";
11
11
  import type { SemioticTheme } from "../store/themeCore";
12
12
  import * as React from "react";
13
- import { type AxisExtentMode } from "../charts/shared/axisExtent";
13
+ import type { AxisExtentMode } from "../charts/shared/axisExtent";
14
14
  import { type AxisChromeInput } from "../legendLayout";
15
15
  export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
16
16
  export type StaticFrameProps = (StreamXYFrameProps | StreamNetworkFrameProps | StreamOrdinalFrameProps | StreamGeoFrameProps | StaticPhysicsFrameProps) & ThemeAwareProps;
@@ -115,7 +115,7 @@ export declare function renderFrameLegend(options: {
115
115
  export declare function renderOrdinalGridSVG(store: OrdinalPipelineStore, layout: {
116
116
  width: number;
117
117
  height: number;
118
- }, theme: SemioticTheme, idPrefix?: string, axisExtent?: AxisExtentMode, rTickValues?: number[]): React.ReactNode;
118
+ }, theme: SemioticTheme, idPrefix?: string, axisExtent?: AxisExtentMode, rTickValues?: number[], rFormat?: (value: number) => string): React.ReactNode;
119
119
  /** Wrap SVG content with accessibility attributes */
120
120
  export declare function wrapSVG(content: React.ReactNode, opts: {
121
121
  width: number;
@@ -2,6 +2,9 @@ import type { SemioticTheme, ThemeStoreUpdate } from "./themeCore";
2
2
  export * from "./themeCore";
3
3
  export interface ThemeStoreState {
4
4
  theme: SemioticTheme;
5
- setTheme: (theme: ThemeStoreUpdate) => void;
5
+ /** The public provider installs value equality for its prop/imperative updates. */
6
+ equals?: (a: SemioticTheme, b: SemioticTheme) => boolean;
7
+ /** Provider prop synchronization replaces a resolved theme; imperative updates merge. */
8
+ setTheme: (theme: ThemeStoreUpdate, replace?: boolean) => void;
6
9
  }
7
10
  export declare const ThemeProvider: import("react").FC<import("./createStore").StoreProviderProps<ThemeStoreState>>, useThemeSelector: <R>(selector: (state: ThemeStoreState) => R, equalityFn?: ((a: R, b: R) => boolean) | undefined) => R;
@@ -94,4 +94,6 @@ export declare const HIGH_CONTRAST_THEME: SemioticTheme;
94
94
  export declare function resolveThemeSemanticColors(theme: SemioticTheme | null | undefined): ThemeSemanticColors | undefined;
95
95
  /** Apply accessibility flags to a resolved theme. */
96
96
  export declare function applyThemeAccessibility(theme: SemioticTheme): SemioticTheme;
97
+ /** Merge theme records recursively; palettes replace arrays rather than append. */
98
+ export declare function mergeThemeOverrides<T extends object>(base: T, update: object): T;
97
99
  export declare function resolveThemeUpdate(current: SemioticTheme, theme: ThemeStoreUpdate): SemioticTheme;
@@ -1,91 +1,44 @@
1
1
  import type { Changeset } from "./types";
2
2
  import type { Datum } from "../charts/shared/datumTypes";
3
3
  export type ChangesetCallback<T> = (changeset: Changeset<T>) => void;
4
+ /**
5
+ * Normalize bounded snapshots, progressive history, and live pushes into changesets.
6
+ * Replacement is atomic: queued work from the previous dataset is discarded.
7
+ * Live pushes are microtask-batched and follow all chunks of the current history.
8
+ */
4
9
  export declare class DataSourceAdapter<T extends object = Datum> {
5
10
  private callback;
6
11
  private lastBoundedData;
7
12
  private chunkTimer;
8
13
  private chunkThreshold;
9
14
  private chunkSize;
10
- /** Buffer for batching high-frequency push() calls */
15
+ private pendingSnapshot;
11
16
  private pushBuffer;
12
- /** Whether a microtask flush is already scheduled */
13
17
  private flushScheduled;
18
+ private generation;
14
19
  constructor(callback: ChangesetCallback<T>, options?: {
15
20
  chunkThreshold?: number;
16
21
  chunkSize?: number;
17
22
  });
18
- /** Update chunking options without recreating the adapter. */
19
23
  updateChunkOptions(options: {
20
24
  chunkThreshold?: number;
21
25
  chunkSize?: number;
22
26
  }): void;
23
- /** Clear the dedup cache so the next setBoundedData call re-ingests even the same reference.
24
- * Also cancels any in-flight progressive chunking and discards buffered pushes. */
27
+ /** Forget the snapshot and cancel its pending chunks and queued pushes. */
25
28
  clearLastData(): void;
26
- /**
27
- * Ingest a bounded data array (from props).
28
- *
29
- * Small datasets emit a single changeset synchronously.
30
- * Large datasets (> CHUNK_THRESHOLD) are split into chunks that render
31
- * progressively: the first chunk fires immediately (bounded: true to
32
- * reset + seed the buffer), subsequent chunks arrive on successive
33
- * animation frames (bounded: false so they append without clearing).
34
- */
35
29
  setBoundedData(data: T[]): void;
36
- /**
37
- * Replace the buffer contents without clearing category insertion-order
38
- * memory. Intended for aggregator HOCs (e.g. LikertChart) that re-derive
39
- * a full dataset from streaming input on every push — the transport is
40
- * wholesale replacement, but the user perceives it as a live stream
41
- * where categories should stay put across updates.
42
- *
43
- * Small datasets (≤ chunkThreshold) emit a single synchronous
44
- * changeset — the common aggregator case. Larger datasets fall
45
- * through to progressive chunking so an unexpectedly-huge replacement
46
- * doesn't block the main thread. Only the first chunk carries
47
- * `preserveCategoryOrder: true` (it's the one that resets the
48
- * buffer and seeds the category Set); subsequent chunks are plain
49
- * append-only streaming changesets, which preserve order anyway via
50
- * the streaming-mode branch.
51
- */
30
+ /** Replace aggregate rows while preserving the store's category ordering. */
52
31
  setReplacementData(data: T[]): void;
53
- /**
54
- * Flush all buffered push data as a single changeset.
55
- * Called automatically via microtask after push()/pushMany().
56
- */
32
+ private replace;
33
+ private cancelChunk;
34
+ private emitChunk;
35
+ private scheduleChunk;
57
36
  private flushPushBuffer;
58
- /** Schedule a microtask flush if one isn't already pending. */
37
+ private flushSnapshot;
59
38
  private scheduleFlush;
60
- /**
61
- * Push a single datum (streaming mode).
62
- * Data is buffered and flushed as a single changeset via microtask,
63
- * so rapid sequential push() calls within the same task are batched
64
- * into one callback invocation.
65
- *
66
- * Drops `null`/non-object data so a `ref.push(null)` (typically from a
67
- * loader returning a falsy row) doesn't reach extent/accessor reads
68
- * inside the pipeline store. Mirrors the bounded-ingest hardening.
69
- */
70
39
  push(datum: T): void;
71
- /**
72
- * Push multiple data (streaming batch).
73
- * Like push(), data is buffered and flushed via microtask. Multiple
74
- * pushMany() calls within the same task are coalesced.
75
- *
76
- * Sparse entries are dropped during the buffer copy. Mirrors the
77
- * bounded-ingest hardening — `ref.pushMany([null, valid])` lands the
78
- * valid row and silently skips the null instead of crashing the
79
- * pipeline. The early `length === 0` short-circuit still applies.
80
- */
81
40
  pushMany(data: T[]): void;
82
- /**
83
- * Immediately flush any buffered push data without waiting for the microtask.
84
- * Useful when you need the data to be processed synchronously (e.g., in tests).
85
- */
41
+ /** Synchronously expose the complete snapshot and all queued live rows. */
86
42
  flush(): void;
87
- /**
88
- * Reset the adapter state.
89
- */
90
43
  clear(): void;
91
44
  }
@@ -30,6 +30,7 @@ export declare class FrameRuntime {
30
30
  private clock;
31
31
  private lastWallTime;
32
32
  private logicalTime;
33
+ private wallTime;
33
34
  private randomInput;
34
35
  private randomSource;
35
36
  private seedValue;
@@ -38,6 +39,8 @@ export declare class FrameRuntime {
38
39
  private visibleValue;
39
40
  /** Stable callable seam for stores and render loops. */
40
41
  readonly now: () => number;
42
+ /** Freshness time keeps advancing while animation is paused or hidden. */
43
+ readonly wallNow: () => number;
41
44
  /** Stable callable seam for stochastic renderers. */
42
45
  readonly random: () => number;
43
46
  constructor(options?: FrameRuntimeOptions);
@@ -1,3 +1,4 @@
1
+ import { IngestActivity } from "./IngestActivity";
1
2
  import type { ZoomTransform } from "d3-zoom";
2
3
  import { type Quadtree } from "d3-quadtree";
3
4
  import type { GeoPipelineConfig, GeoScales, GeoSceneNode } from "./geoTypes";
@@ -53,6 +54,7 @@ export declare class GeoPipelineStore extends UpdateResultStoreBase {
53
54
  private pointBuffer;
54
55
  private streaming;
55
56
  lastIngestTime: number;
57
+ readonly activity: IngestActivity;
56
58
  private timestampBuffer;
57
59
  activeTransition: ActiveTransition | null;
58
60
  private prevPositions;
@@ -0,0 +1,9 @@
1
+ /** Wall-clock freshness, independent of the frame's paused animation clock. */
2
+ export declare class IngestActivity {
3
+ private readonly now;
4
+ private last;
5
+ constructor(now: () => number);
6
+ touch(): void;
7
+ clear(): void;
8
+ elapsed(): number;
9
+ }
@@ -1,3 +1,4 @@
1
+ import { IngestActivity } from "./IngestActivity";
1
2
  import { ParticlePool } from "./ParticlePool";
2
3
  import type { NetworkLayoutResult, NetworkHtmlMark } from "./networkCustomLayout";
3
4
  import type { CustomLayoutSelection } from "./customLayoutSelection";
@@ -82,7 +83,7 @@ export declare class NetworkPipelineStore extends UpdateResultStoreBase {
82
83
  private config;
83
84
  private tensionConfig;
84
85
  protected updateResults: NetworkPipelineUpdateResults;
85
- /** Keep ingest, live encodings, staleness, and transitions on one clock. */
86
+ /** Keep ingest, live encodings, and transitions on the logical animation clock. */
86
87
  private currentTime;
87
88
  transition: ActiveTransition | null;
88
89
  private _hasRenderedOnce;
@@ -91,6 +92,7 @@ export declare class NetworkPipelineStore extends UpdateResultStoreBase {
91
92
  /** Snapshot of edge positions from before bounded re-ingestion cleared the maps */
92
93
  private _boundedEdgeSnapshot;
93
94
  lastIngestTime: number;
95
+ readonly activity: IngestActivity;
94
96
  private nodeTimestamps;
95
97
  private edgeTimestamps;
96
98
  /** Cached sorted node-timestamp entries for applyDecay(); null = needs rebuild */
@@ -1,3 +1,4 @@
1
+ import { IngestActivity } from "./IngestActivity";
1
2
  import type { Datum } from "../charts/shared/datumTypes";
2
3
  /**
3
4
  * OrdinalPipelineStore — stateful pipeline for ordinal chart data.
@@ -31,7 +32,7 @@ export declare class OrdinalPipelineStore extends UpdateResultStoreBase {
31
32
  /** Per-accessor extents for multiAxis mode */
32
33
  private rExtents;
33
34
  private config;
34
- private windowSizeWarned;
35
+ private liveWindow;
35
36
  protected updateResults: OrdinalPipelineUpdateResults;
36
37
  private getO;
37
38
  private getR;
@@ -54,6 +55,7 @@ export declare class OrdinalPipelineStore extends UpdateResultStoreBase {
54
55
  /** Exit nodes awaiting fade-out removal */
55
56
  exitNodes: import("./ordinalTypes").OrdinalSceneNode[];
56
57
  lastIngestTime: number;
58
+ readonly activity: IngestActivity;
57
59
  scales: OrdinalScales | null;
58
60
  /** Per-accessor scales for multiAxis */
59
61
  multiScales: (ScaleLinear<number, number>)[];
@@ -97,7 +99,7 @@ export declare class OrdinalPipelineStore extends UpdateResultStoreBase {
97
99
  * empty ring would associate later timestamps with the wrong datum index.
98
100
  */
99
101
  private syncPulseTimestampBuffer;
100
- /** Keep ingest, pulse, staleness, and transition timestamps on one clock. */
102
+ /** Keep pulse and transition timestamps on the logical animation clock. */
101
103
  private currentTime;
102
104
  ingest(changeset: Changeset): boolean;
103
105
  ingestWithResult(changeset: Changeset): UpdateResult;
@@ -200,6 +202,7 @@ export declare class OrdinalPipelineStore extends UpdateResultStoreBase {
200
202
  * next scene with an empty/stale domain against the existing buffer.
201
203
  */
202
204
  private rebuildAccessorDerivedState;
205
+ private resizeWindow;
203
206
  updateConfig(config: Partial<OrdinalPipelineConfig>): void;
204
207
  updateConfigWithResult(config: Partial<OrdinalPipelineConfig>): UpdateResult;
205
208
  }
@@ -7,7 +7,7 @@ import type { LegendLayout, LegendValue } from "../types/legendTypes";
7
7
  import type { OnObservationCallback } from "../store/ObservationStore";
8
8
  import { type OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
9
9
  import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
10
- import { type AxisExtentMode } from "../charts/shared/axisExtent";
10
+ import type { AxisExtentMode } from "../charts/shared/axisExtent";
11
11
  interface OrdinalSVGOverlayProps {
12
12
  width: number;
13
13
  height: number;
@@ -1,3 +1,4 @@
1
+ import { IngestActivity } from "./IngestActivity";
1
2
  import type { Datum } from "../charts/shared/datumTypes";
2
3
  import { RingBuffer } from "../realtime/RingBuffer";
3
4
  import type { Changeset, StreamScales, StreamLayout, SceneNode } from "./types";
@@ -18,10 +19,12 @@ export declare class PipelineStore extends UpdateResultStoreBase {
18
19
  private buffer;
19
20
  private xExtent;
20
21
  private yExtent;
22
+ private waterfallCarry;
23
+ private get waterfallBaseline();
24
+ private carryWaterfall;
21
25
  private config;
22
- private growingCap;
26
+ private liveWindow;
23
27
  private growingCapacityWarned;
24
- private windowSizeWarned;
25
28
  private getX;
26
29
  private getY;
27
30
  private getGroup;
@@ -49,7 +52,8 @@ export declare class PipelineStore extends UpdateResultStoreBase {
49
52
  /** Exit nodes awaiting fade-out removal */
50
53
  exitNodes: SceneNode[];
51
54
  lastIngestTime: number;
52
- /** Keep ingest, pulse, staleness, and transition timestamps on one clock. */
55
+ readonly activity: IngestActivity;
56
+ /** Keep pulse and transition timestamps on the logical animation clock. */
53
57
  private currentTime;
54
58
  /** Unified color map cache keyed by sorted category set — shared across point, swarm, etc. */
55
59
  private _colorMapCache;
@@ -258,6 +262,7 @@ export declare class PipelineStore extends UpdateResultStoreBase {
258
262
  * Flags a style-only repaint so the render loop redraws the mutated styles.
259
263
  */
260
264
  restyleScene(selection: CustomLayoutSelection | null): void;
265
+ private resizeWindow;
261
266
  updateConfig(config: Partial<PipelineConfig>): void;
262
267
  /** Additive explicit-result form of {@link updateConfig}. */
263
268
  updateConfigWithResult(config: Partial<PipelineConfig>): UpdateResult;
@@ -1,5 +1,6 @@
1
1
  /** Structural scene node accepted from any frame family. */
2
2
  export type AccessibleSceneNode = {
3
+ navParentId?: string;
3
4
  type?: unknown;
4
5
  datum?: unknown;
5
6
  accessibleDatum?: unknown;
@@ -1,15 +1,35 @@
1
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;
2
+ import type { AxisExtentMode } from "../charts/shared/axisExtent";
3
+ export interface AxisTickCountOptions {
4
+ axis?: {
5
+ ticks?: number;
6
+ tickCount?: number;
7
+ extent?: AxisExtentMode;
8
+ };
9
+ /** Final plot dimension in pixels, before scalePadding insets the range. */
10
+ size: number;
11
+ orientation?: "horizontal" | "vertical";
12
+ axisExtent?: AxisExtentMode;
13
+ }
14
+ /** Requested tick count capped at one per 30px vertically or 70px horizontally.
15
+ * d3 treats this as a hint, so the number of returned ticks can differ.
16
+ * Exact mode uses at least two ticks without a size cap; zero hides nice ticks. */
17
+ export declare function resolveAxisTickCount({ axis, size, orientation, axisExtent }: AxisTickCountOptions): number;
7
18
  /**
8
19
  * Only primitive labels can be meaningfully compared without rendering.
9
20
  * `String(<span />)` is always "[object Object]", so ReactNode ticks cannot
10
21
  * use text-based deduplication.
11
22
  */
12
23
  export declare function hasSameTickLabel(a: string | ReactNode, b: string | ReactNode): boolean;
24
+ /**
25
+ * Drop each tick whose text label repeats the one before it. A coarse
26
+ * formatter (whole seconds over a sub-second domain, rounded currency) would
27
+ * otherwise print the same label at several positions. Shared by XY and
28
+ * ordinal value axes so axis labels, tick marks, and grid lines stay aligned.
29
+ */
30
+ export declare function dropRepeatedTickLabels<T extends {
31
+ label: string | ReactNode;
32
+ }>(ticks: T[]): T[];
13
33
  /** Greedily filter ticks so consecutive labels are at least `minPx` apart. */
14
34
  export declare function filterTicksByPixelDistance<T extends {
15
35
  value: number | Date | string;
@@ -12,11 +12,28 @@ export declare const AXIS_FRAME_DEFAULT_MARGIN: {
12
12
  readonly bottom: 60;
13
13
  readonly left: 70;
14
14
  };
15
+ export declare const AXIS_FREE_FRAME_DEFAULT_MARGIN: {
16
+ readonly top: 10;
17
+ readonly right: 10;
18
+ readonly bottom: 10;
19
+ readonly left: 10;
20
+ };
21
+ export declare function ordinalFrameDefaultMargin(chartType: string): {
22
+ readonly top: 50;
23
+ readonly right: 40;
24
+ readonly bottom: 60;
25
+ readonly left: 70;
26
+ } | {
27
+ readonly top: 10;
28
+ readonly right: 10;
29
+ readonly bottom: 10;
30
+ readonly left: 10;
31
+ };
15
32
  export declare const NETWORK_FRAME_DEFAULT_MARGIN: {
16
33
  readonly top: 20;
17
- readonly right: 80;
34
+ readonly right: 20;
18
35
  readonly bottom: 20;
19
- readonly left: 80;
36
+ readonly left: 20;
20
37
  };
21
38
  export declare const CENTERED_NETWORK_FRAME_DEFAULT_MARGIN: {
22
39
  readonly top: 40;
@@ -25,10 +42,15 @@ export declare const CENTERED_NETWORK_FRAME_DEFAULT_MARGIN: {
25
42
  readonly left: 40;
26
43
  };
27
44
  export declare function networkFrameDefaultMargin(chartType: string): {
45
+ readonly top: 10;
46
+ readonly right: 10;
47
+ readonly bottom: 10;
48
+ readonly left: 10;
49
+ } | {
28
50
  readonly top: 20;
29
- readonly right: 80;
51
+ readonly right: 20;
30
52
  readonly bottom: 20;
31
- readonly left: 80;
53
+ readonly left: 20;
32
54
  } | {
33
55
  readonly top: 40;
34
56
  readonly right: 40;
@@ -16,18 +16,23 @@ export declare function useXYKeyboardNavigation({ decorateHover, ...params }: XY
16
16
  focusedNavPointRef: import("react").RefObject<NavPoint | null>;
17
17
  neighborIndexRef: import("react").RefObject<number>;
18
18
  onKeyDown: (event: import("react").KeyboardEvent) => void;
19
+ onBlur: (event: import("react").FocusEvent<HTMLElement>) => void;
20
+ clearFocus: () => void;
19
21
  refreshKeyboardFocus: () => void;
20
22
  };
21
23
  interface OrdinalKeyboardParams extends KeyboardInteractionParams<OrdinalPipelineStore, OrdinalSceneNode> {
22
24
  chartType: string;
25
+ dataIdAccessor?: string | ((datum: Record<string, unknown>) => string);
23
26
  oAccessor: unknown;
24
27
  rAccessor: unknown;
25
28
  }
26
- export declare function useOrdinalKeyboardNavigation({ chartType, oAccessor, rAccessor, ...params }: OrdinalKeyboardParams): {
29
+ export declare function useOrdinalKeyboardNavigation({ chartType, dataIdAccessor, oAccessor, rAccessor, ...params }: OrdinalKeyboardParams): {
27
30
  kbFocusIndexRef: import("react").RefObject<number>;
28
31
  focusedNavPointRef: import("react").RefObject<NavPoint | null>;
29
32
  neighborIndexRef: import("react").RefObject<number>;
30
33
  onKeyDown: (event: import("react").KeyboardEvent) => void;
34
+ onBlur: (event: import("react").FocusEvent<HTMLElement>) => void;
35
+ clearFocus: () => void;
31
36
  refreshKeyboardFocus: () => void;
32
37
  };
33
38
  export declare function useGeoKeyboardNavigation(params: KeyboardInteractionParams<GeoPipelineStore, GeoSceneNode>): {
@@ -35,6 +40,8 @@ export declare function useGeoKeyboardNavigation(params: KeyboardInteractionPara
35
40
  focusedNavPointRef: import("react").RefObject<NavPoint | null>;
36
41
  neighborIndexRef: import("react").RefObject<number>;
37
42
  onKeyDown: (event: import("react").KeyboardEvent) => void;
43
+ onBlur: (event: import("react").FocusEvent<HTMLElement>) => void;
44
+ clearFocus: () => void;
38
45
  refreshKeyboardFocus: () => void;
39
46
  };
40
47
  export {};
@@ -119,6 +119,8 @@ export interface GeoPipelineConfig {
119
119
  windowSize?: number;
120
120
  /** Logical clock used for Geo pulse and transition work. */
121
121
  clock?: import("./FrameRuntime").FrameClock;
122
+ /** Wall clock for data freshness; animation continues to use `clock`. */
123
+ activityClock?: () => number;
122
124
  decay?: DecayConfig;
123
125
  pulse?: PulseConfig;
124
126
  transition?: TransitionConfig;
@@ -1,4 +1,4 @@
1
- import type { Dispatch, KeyboardEvent, SetStateAction } from "react";
1
+ import type { Dispatch, FocusEvent, KeyboardEvent, SetStateAction } from "react";
2
2
  import type { HoverData } from "../realtime/types";
3
3
  import type { SemanticClickBehavior, SemanticHoverBehavior } from "../charts/shared/semanticInteractions";
4
4
  import { type NavGraph, type NavPoint } from "./navigationGraph";
@@ -25,7 +25,7 @@ interface VersionedSceneStore<Node> {
25
25
  interface GraphKeyboardParams<Node, Store extends VersionedSceneStore<Node>> extends KeyboardInteractionParams<Store, Node> {
26
26
  extractPoints: (scene: Node[]) => NavPoint[];
27
27
  toHover: (point: NavPoint, store: Store) => HoverData;
28
- navigation?: "graph" | "linear";
28
+ navigation?: "graph" | "linear" | "ordered";
29
29
  nextConnected?: (key: string, graph: NavGraph, index: number, neighbor: RefValue<number>) => number | null;
30
30
  }
31
31
  export declare function useGraphKeyboardNavigation<Node, Store extends VersionedSceneStore<Node>>({ storeRef, hoverRef, hoveredNodeRef, setHoverPoint, customHoverBehavior, customClickBehavior, scheduleRender, clearPointerHover, extractPoints, toHover, navigation, nextConnected }: GraphKeyboardParams<Node, Store>): {
@@ -33,6 +33,8 @@ export declare function useGraphKeyboardNavigation<Node, Store extends Versioned
33
33
  focusedNavPointRef: import("react").RefObject<NavPoint | null>;
34
34
  neighborIndexRef: import("react").RefObject<number>;
35
35
  onKeyDown: (event: KeyboardEvent) => void;
36
+ onBlur: (event: FocusEvent<HTMLElement>) => void;
37
+ clearFocus: () => void;
36
38
  refreshKeyboardFocus: () => void;
37
39
  };
38
40
  export {};