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.
- package/README.md +48 -48
- package/ai/artifact-surface-inventory.json +1 -1
- package/ai/dist/mcp-server.js +4 -4
- package/ai/reference.md +23 -12
- package/ai/schema.json +258 -96
- package/ai/surface-manifest.json +1 -1
- package/ai/task-packets/compare-category-totals.json +5 -5
- package/ai/task-packets/compare-category-totals.md +2 -2
- package/ai/task-packets/correct-published-chart.json +5 -5
- package/ai/task-packets/correct-published-chart.md +2 -2
- package/ai/task-packets/index.json +6 -6
- package/ai/task-packets/update-live-chart.json +5 -5
- package/ai/task-packets/update-live-chart.md +2 -2
- package/dist/c-2YFVDRU4.min.js +1 -0
- package/dist/c-4OVDIXAR.min.js +1 -0
- package/dist/c-57IIWW46.min.js +1 -0
- package/dist/c-5HTUQRJT.min.js +1 -0
- package/dist/c-5NAU4JAY.min.js +1 -0
- package/dist/c-62UTMRQE.min.js +1 -0
- package/dist/c-6QV6F3U7.min.js +1 -0
- package/dist/c-73ORHEHO.min.js +1 -0
- package/dist/c-7S46KBYD.min.js +2 -0
- package/dist/c-AJSS332Z.min.js +2 -0
- package/dist/{c-ZWJDTDEV.min.js → c-AMQAAW7G.min.js} +1 -1
- package/dist/c-B3X2IJRQ.min.js +1 -0
- package/dist/c-BLLDBVFK.min.js +38 -0
- package/dist/c-BQWX6NBX.min.js +1 -0
- package/dist/c-C7TT4J7K.min.js +1 -0
- package/dist/c-CJ5GA7DM.min.js +1 -0
- package/dist/c-D7YDFHLY.min.js +1 -0
- package/dist/c-DHNROAXY.min.js +1 -0
- package/dist/c-DMDFJQU4.min.js +1 -0
- package/dist/{c-RAIBDXDV.min.js → c-FRVHZIGR.min.js} +1 -1
- package/dist/{c-I54V24WG.min.js → c-HAZCVHI7.min.js} +1 -1
- package/dist/c-HN5U72U7.min.js +1 -0
- package/dist/c-JA5F7ITS.min.js +1 -0
- package/dist/{c-VZNIIKL6.min.js → c-JDI7HKEM.min.js} +1 -1
- package/dist/{c-ISHYKYII.min.js → c-JVZRD4GL.min.js} +1 -1
- package/dist/{c-HGWITEJI.min.js → c-KJGJEOSV.min.js} +1 -1
- package/dist/c-LDGV6TDQ.min.js +1 -0
- package/dist/c-LW3GP7RY.min.js +1 -0
- package/dist/c-M2TPZE7P.min.js +1 -0
- package/dist/{c-XOGN3524.min.js → c-NBBYSAQY.min.js} +2 -2
- package/dist/c-OA6RJZ7S.min.js +1 -0
- package/dist/c-OBBSIOYU.min.js +1 -0
- package/dist/c-OMTJIC3P.min.js +1 -0
- package/dist/{c-SQQZPFVY.min.js → c-QPHM7AWW.min.js} +1 -1
- package/dist/{c-XZJWL7UL.min.js → c-QSEAAHEU.min.js} +1 -1
- package/dist/c-RQWI623R.min.js +1 -0
- package/dist/{c-62JIVHK5.min.js → c-RWFADOKS.min.js} +1 -1
- package/dist/c-TFESQSWE.min.js +1 -0
- package/dist/{c-SDGGMIYI.min.js → c-TJGC5JEM.min.js} +1 -1
- package/dist/{c-4P2EM44G.min.js → c-TOXWQRXS.min.js} +3 -3
- package/dist/c-TX53234M.min.js +1 -0
- package/dist/c-TZBEQ5UY.min.js +1 -0
- package/dist/c-UALVQIIJ.min.js +1 -0
- package/dist/c-VBDWHTC7.min.js +1 -0
- package/dist/c-VBIPDCE7.min.js +1 -0
- package/dist/c-WTNRBWZZ.min.js +51 -0
- package/dist/{c-3GIPT46Z.min.js → c-XG4LL2VI.min.js} +1 -1
- package/dist/c-XPNBS3W2.min.js +1 -0
- package/dist/c-XT3G3YWU.min.js +1 -0
- package/dist/c-YCBCZFOC.min.js +1 -0
- package/dist/c-ZBSL4Y32.min.js +1 -0
- package/dist/c-ZP6O6UHV.min.js +1 -0
- package/dist/c-ZVL7ULNH.min.js +1 -0
- package/dist/components/ChartErrorBoundary.d.ts +5 -1
- package/dist/components/ai/intentWeights.d.ts +22 -0
- package/dist/components/ai/streamSchema.d.ts +98 -0
- package/dist/components/ai/streamingTypes.d.ts +27 -4
- package/dist/components/ai/suggestCharts.d.ts +10 -2
- package/dist/components/ai/suggestStreamCharts.d.ts +60 -13
- package/dist/components/ai/suggestStreamDashboard.d.ts +9 -1
- package/dist/components/charts/network/processSankey/frameMargins.d.ts +1 -1
- package/dist/components/charts/network/processSankey/labelPlacement.d.ts +1 -1
- package/dist/components/charts/physics/physicsHocUtils.d.ts +1 -1
- package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +7 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +9 -2
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +13 -1
- package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +5 -1
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +5 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
- package/dist/components/charts/realtime/TemporalHistogram.capability.d.ts +5 -3
- package/dist/components/charts/realtime/aggregate.d.ts +11 -12
- package/dist/components/charts/realtime/defaultRealtimeTooltip.d.ts +9 -0
- package/dist/components/charts/realtime/eventTime.d.ts +7 -1
- package/dist/components/charts/realtime/useRealtimeLineIngestion.d.ts +13 -0
- package/dist/components/charts/shared/ChartError.d.ts +4 -6
- package/dist/components/charts/shared/GaugeReadout.d.ts +39 -4
- package/dist/components/charts/shared/axisExtent.d.ts +2 -1
- package/dist/components/charts/shared/chartMode.d.ts +2 -2
- package/dist/components/charts/shared/gaugeLayout.d.ts +69 -0
- package/dist/components/charts/shared/types.d.ts +4 -1
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +3 -0
- package/dist/components/charts/shared/useStreamStatus.d.ts +2 -2
- package/dist/components/charts/shared/withChartErrorBoundary.d.ts +14 -0
- package/dist/components/charts/xy/Scatterplot.streamCapability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallIndex.d.ts +12 -0
- package/dist/components/charts/xy/lineGapStrategy.d.ts +15 -3
- package/dist/components/legendGeometry.d.ts +148 -0
- package/dist/components/legendLayout.d.ts +20 -38
- package/dist/components/realtime/ReorderBuffer.d.ts +14 -0
- package/dist/components/realtime/SlidingExtent.d.ts +18 -0
- package/dist/components/realtime/WindowAccumulator.d.ts +5 -1
- package/dist/components/realtime/renderers/types.d.ts +1 -0
- package/dist/components/realtime/renderers/waterfallRenderer.d.ts +1 -1
- package/dist/components/recipes/atlas/resolution/appearance.d.ts +1 -1
- package/dist/components/recipes/atlas/resolution/scene.d.ts +1 -1
- package/dist/components/recipes/compositional/edgeRouting.d.ts +9 -0
- package/dist/components/recipes/compositional/metrics.d.ts +2 -2
- package/dist/components/recipes/compositional/projection.d.ts +3 -1
- package/dist/components/recipes/compositional/routing.d.ts +3 -1
- package/dist/components/recipes/compositional/testFixtures.d.ts +4 -0
- package/dist/components/recipes/compositional/topology.d.ts +2 -0
- package/dist/components/recipes/compositional/types.d.ts +10 -1
- package/dist/components/recipes/compositional/useCompositionalInterfaces.d.ts +20 -0
- package/dist/components/semiotic-ai-core.d.ts +3 -2
- package/dist/components/semiotic-ai-stream.d.ts +3 -2
- package/dist/components/semiotic-network-zoom.d.ts +1 -1
- package/dist/components/semiotic-recipes-react.d.ts +2 -0
- package/dist/components/semiotic-utils-core.d.ts +2 -0
- package/dist/components/server/serverChartConfigHeatmap.d.ts +13 -0
- package/dist/components/server/staticLegend.d.ts +5 -0
- package/dist/components/server/staticLegendText.d.ts +13 -0
- package/dist/components/server/staticSVGChrome.d.ts +2 -2
- package/dist/components/store/ThemeStore.d.ts +4 -1
- package/dist/components/store/themeCore.d.ts +2 -0
- package/dist/components/stream/DataSourceAdapter.d.ts +15 -62
- package/dist/components/stream/FrameRuntime.d.ts +3 -0
- package/dist/components/stream/GeoPipelineStore.d.ts +2 -0
- package/dist/components/stream/IngestActivity.d.ts +9 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +3 -1
- package/dist/components/stream/OrdinalPipelineStore.d.ts +5 -2
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +1 -1
- package/dist/components/stream/PipelineStore.d.ts +8 -3
- package/dist/components/stream/accessibleDataRows.d.ts +1 -0
- package/dist/components/stream/axisTickUtils.d.ts +25 -5
- package/dist/components/stream/frameDefaultMargins.d.ts +26 -4
- package/dist/components/stream/frameKeyboardNavigation.d.ts +8 -1
- package/dist/components/stream/geoTypes.d.ts +2 -0
- package/dist/components/stream/graphKeyboardNavigation.d.ts +4 -2
- package/dist/components/stream/hitTestUtils.d.ts +7 -0
- package/dist/components/stream/keyboardNav.d.ts +3 -1
- package/dist/components/stream/mediaQuery.d.ts +2 -0
- package/dist/components/stream/navigationGraph.d.ts +10 -3
- package/dist/components/stream/networkEdgeHitIndex.d.ts +6 -2
- package/dist/components/stream/networkFrameKeyboardNavigation.d.ts +2 -0
- package/dist/components/stream/networkNavGroups.d.ts +3 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +1 -0
- package/dist/components/stream/networkSceneTypes.d.ts +10 -0
- package/dist/components/stream/networkSpatialNavigation.d.ts +3 -0
- package/dist/components/stream/networkTypes.d.ts +2 -0
- package/dist/components/stream/networkZoom/ZoomableNetworkCustomChart.d.ts +6 -4
- package/dist/components/stream/networkZoom/gestures.d.ts +5 -0
- package/dist/components/stream/networkZoom/types.d.ts +10 -0
- package/dist/components/stream/ordinalAxisTicks.d.ts +27 -0
- package/dist/components/stream/ordinalSceneBuilders/pieScene.d.ts +10 -0
- package/dist/components/stream/ordinalSceneBuilders/types.d.ts +2 -0
- package/dist/components/stream/ordinalTypes.d.ts +11 -2
- package/dist/components/stream/pipelineBufferUtils.d.ts +9 -0
- package/dist/components/stream/pipelineConfig.d.ts +7 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +3 -2
- package/dist/components/stream/pipelineTransitionTypes.d.ts +3 -5
- package/dist/components/stream/pipelineTransitionUtils.d.ts +4 -0
- package/dist/components/stream/pipelineTransitions.d.ts +1 -13
- package/dist/components/stream/renderers/networkArcRenderer.d.ts +1 -3
- package/dist/components/stream/renderers/networkCircleRenderer.d.ts +1 -3
- package/dist/components/stream/renderers/networkPrimitiveRenderer.d.ts +5 -0
- package/dist/components/stream/renderers/networkRectRenderer.d.ts +1 -3
- package/dist/components/stream/renderers/renderPulse.d.ts +8 -14
- package/dist/components/stream/roundScaleDomain.d.ts +9 -0
- package/dist/components/stream/sceneToSVGShared.d.ts +9 -0
- package/dist/components/stream/shallowEqual.d.ts +2 -0
- package/dist/components/stream/stalenessBands.d.ts +1 -1
- package/dist/components/stream/svgOverlayUtils.d.ts +12 -0
- package/dist/components/stream/types.d.ts +10 -2
- package/dist/components/stream/useFrame.d.ts +7 -4
- package/dist/components/stream/useMediaPreferences.d.ts +1 -4
- package/dist/components/stream/useOrdinalFrameHandle.d.ts +4 -14
- package/dist/components/stream/useStalenessCheck.d.ts +5 -3
- package/dist/components/stream/useStreamingDataHandle.d.ts +24 -0
- package/dist/components/stream/useXYFrameHandle.d.ts +4 -14
- package/dist/components/stream/xyDateTicks.d.ts +33 -4
- package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
- package/dist/components/stream/xyPlugins/registry.d.ts +7 -0
- package/dist/components/stream/xySceneBuilders/heatmapScene.d.ts +11 -2
- package/dist/components/stream/xySceneBuilders/types.d.ts +4 -0
- package/dist/components/types/legendTypes.d.ts +12 -1
- package/dist/geo.min.js +155 -152
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/semiotic-ai-core.d.ts +3 -2
- package/dist/semiotic-ai-core.min.js +5 -5
- package/dist/semiotic-ai-core.module.min.js +4 -4
- package/dist/semiotic-ai.module.min.js +2 -2
- package/dist/semiotic-artifact.min.js +6 -6
- package/dist/semiotic-artifact.module.min.js +5 -5
- package/dist/semiotic-atlas-selection.module.min.js +1 -1
- package/dist/semiotic-atlas.module.min.js +1 -1
- package/dist/semiotic-client-cjs-shared.min.js +1021 -1024
- package/dist/semiotic-client-compositional.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +2 -2
- package/dist/semiotic-experimental-network-resolution-react.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +3 -3
- package/dist/semiotic-line.module.min.js +1 -1
- package/dist/semiotic-network-zoom.d.ts +1 -1
- package/dist/semiotic-network-zoom.min.js +7 -7
- package/dist/semiotic-network-zoom.module.min.js +1 -1
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +101 -101
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-react.d.ts +2 -0
- package/dist/semiotic-recipes-react.min.js +8 -8
- package/dist/semiotic-server-edge-node.module.min.js +3 -3
- package/dist/semiotic-server-edge.min.js +399 -397
- package/dist/semiotic-server-edge.module.min.js +3 -3
- package/dist/semiotic-server-node.min.js +399 -397
- package/dist/semiotic-themes-core.min.js +2 -2
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes.min.js +2 -2
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.d.ts +2 -0
- package/dist/semiotic-utils-core.min.js +11 -11
- package/dist/semiotic-utils-core.module.min.js +3 -3
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +399 -397
- package/dist/server.module.min.js +3 -3
- package/dist/xy.module.min.js +1 -1
- package/package.json +11 -11
- package/dist/c-2M2OPWVA.min.js +0 -37
- package/dist/c-2N7IU2NY.min.js +0 -1
- package/dist/c-3UXQGCQT.min.js +0 -1
- package/dist/c-4RVDKSMQ.min.js +0 -1
- package/dist/c-4YPPVFZH.min.js +0 -1
- package/dist/c-6WJKNYIG.min.js +0 -1
- package/dist/c-7UN2WUMI.min.js +0 -1
- package/dist/c-AQUX6L2O.min.js +0 -1
- package/dist/c-BR5QDUCR.min.js +0 -1
- package/dist/c-C3YQVUB6.min.js +0 -1
- package/dist/c-COP4OISO.min.js +0 -1
- package/dist/c-ENRZPF5E.min.js +0 -1
- package/dist/c-FAOZZE77.min.js +0 -1
- package/dist/c-HBLICBM6.min.js +0 -1
- package/dist/c-I4BEWAKT.min.js +0 -1
- package/dist/c-IDCFMBA4.min.js +0 -2
- package/dist/c-KLJDKRD5.min.js +0 -1
- package/dist/c-LEICSI5V.min.js +0 -1
- package/dist/c-MOK4RWNO.min.js +0 -1
- package/dist/c-N2TVSOYL.min.js +0 -2
- package/dist/c-NHZ2E3CI.min.js +0 -1
- package/dist/c-OIJL2WZH.min.js +0 -1
- package/dist/c-OSLNYZ3Q.min.js +0 -51
- package/dist/c-OWRVBUSL.min.js +0 -1
- package/dist/c-QIVKWHDL.min.js +0 -1
- package/dist/c-QUAEYF34.min.js +0 -1
- package/dist/c-RDFFLRKC.min.js +0 -1
- package/dist/c-RTU5425Z.min.js +0 -1
- package/dist/c-SIQVOV6A.min.js +0 -1
- package/dist/c-SU6Z75M2.min.js +0 -1
- package/dist/c-SWVXFUDL.min.js +0 -1
- package/dist/c-TC47SNSI.min.js +0 -1
- package/dist/c-VLWWXOM5.min.js +0 -1
- package/dist/c-VNFIRKU5.min.js +0 -1
- package/dist/c-W5ATXREF.min.js +0 -1
- package/dist/c-WFX456JK.min.js +0 -5
- package/dist/c-WSWMQDFZ.min.js +0 -1
- package/dist/c-XORVM6C5.min.js +0 -1
- package/dist/c-YGTMWEEF.min.js +0 -1
- 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
|
|
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
|
-
*
|
|
56
|
-
*
|
|
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
|
-
/**
|
|
10
|
-
|
|
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
|
};
|
|
@@ -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
|
|
18
|
-
*
|
|
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,
|
|
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.
|
|
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
|
-
*
|
|
24
|
-
*
|
|
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
|
|
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
|
-
},
|
|
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
|
-
},
|
|
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
|
|
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;
|