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
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/** Threshold scale labels sit this far outside the arc, at this font size. */
|
|
2
|
+
export declare const GAUGE_LABEL_OFFSET = 10;
|
|
3
|
+
export declare const GAUGE_LABEL_FONT_SIZE = 10;
|
|
4
|
+
/** Threshold label on the scale: its position along the sweep (0–1) and text. */
|
|
5
|
+
export interface GaugeScaleLabelFit {
|
|
6
|
+
fraction: number;
|
|
7
|
+
text: string;
|
|
8
|
+
}
|
|
9
|
+
type GaugeLabelAnchor = "start" | "middle" | "end";
|
|
10
|
+
type GaugeLabelBaseline = "auto" | "middle" | "hanging";
|
|
11
|
+
/**
|
|
12
|
+
* Text alignment for a scale label at `angle` (radians, 0 = 3 o'clock),
|
|
13
|
+
* following the clock position of its mark: top sector (11–1) centered above,
|
|
14
|
+
* right sector (1–5) left-aligned, bottom sector (5–7) centered below, left
|
|
15
|
+
* sector (7–11) right-aligned. Shared by React and static rendering.
|
|
16
|
+
*/
|
|
17
|
+
export declare function gaugeScaleLabelAlignment(angle: number): {
|
|
18
|
+
textAnchor: GaugeLabelAnchor;
|
|
19
|
+
dominantBaseline: GaugeLabelBaseline;
|
|
20
|
+
};
|
|
21
|
+
/** Text readout drawn at the arc center, sized before the arc is placed. */
|
|
22
|
+
export interface GaugeReadoutFit {
|
|
23
|
+
/** Value text; its estimated width sets the fitted font size. */
|
|
24
|
+
value: string;
|
|
25
|
+
/** Caption lines beneath the value (scale range, `centerLabel`). */
|
|
26
|
+
captionLines: number;
|
|
27
|
+
}
|
|
28
|
+
export interface GaugeLayout {
|
|
29
|
+
/** Outer arc radius. */
|
|
30
|
+
radius: number;
|
|
31
|
+
innerRadius: number;
|
|
32
|
+
/** Arc center in chart coordinates. */
|
|
33
|
+
centerX: number;
|
|
34
|
+
centerY: number;
|
|
35
|
+
/** Value center line relative to the arc center (negative = up). */
|
|
36
|
+
readoutOffset: number;
|
|
37
|
+
/** Frame margins whose square layout reproduces `radius` at the center. */
|
|
38
|
+
margin: {
|
|
39
|
+
top: number;
|
|
40
|
+
right: number;
|
|
41
|
+
bottom: number;
|
|
42
|
+
left: number;
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Shared GaugeChart geometry for React and static rendering: the largest arc
|
|
47
|
+
* whose visible bounding box, plus the center readout and threshold labels
|
|
48
|
+
* when there are any, fits inside `width` x `height` with a small inset,
|
|
49
|
+
* centered in the chart. The readout can hang below the arc (always on a
|
|
50
|
+
* half-circle gauge) and labels sit outside it, so both count toward the fit
|
|
51
|
+
* instead of being drawn past the chart's edges.
|
|
52
|
+
*/
|
|
53
|
+
export declare function computeGaugeLayout({ width, height, sweep, arcWidth, readout, needle, scaleLabels, topInset }: {
|
|
54
|
+
width: number;
|
|
55
|
+
height: number;
|
|
56
|
+
sweep: number;
|
|
57
|
+
arcWidth: number;
|
|
58
|
+
readout?: GaugeReadoutFit | null;
|
|
59
|
+
/** Whether a needle is drawn; the readout then keeps out of its sweep. */
|
|
60
|
+
needle?: boolean;
|
|
61
|
+
/** Threshold labels drawn outside the arc, which must fit too. */
|
|
62
|
+
scaleLabels?: GaugeScaleLabelFit[];
|
|
63
|
+
/**
|
|
64
|
+
* Height reserved above the gauge, such as the frame's title strip. The
|
|
65
|
+
* frame enforces it as a minimum top margin, so the fit must leave it free.
|
|
66
|
+
*/
|
|
67
|
+
topInset?: number;
|
|
68
|
+
}): GaugeLayout;
|
|
69
|
+
export {};
|
|
@@ -13,7 +13,7 @@ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
|
|
|
13
13
|
export interface SelectionConfig {
|
|
14
14
|
/** Name of the selection to consume */
|
|
15
15
|
name: string;
|
|
16
|
-
/** Opacity for unselected elements
|
|
16
|
+
/** Opacity multiplier for unselected elements. Defaults to the theme's selectionOpacity, then 0.5. */
|
|
17
17
|
unselectedOpacity?: number;
|
|
18
18
|
/** Style overrides for unselected elements */
|
|
19
19
|
unselectedStyle?: Datum;
|
|
@@ -194,6 +194,9 @@ export interface BaseChartProps {
|
|
|
194
194
|
* tick generator — labels stay round but ticks may sit inside the
|
|
195
195
|
* data domain. `"exact"` pins the first and last tick to the
|
|
196
196
|
* actual data min and max with equidistant intermediate ticks.
|
|
197
|
+
* `"rounded"` widens open value-axis ends to round ticks after padding
|
|
198
|
+
* and final plot layout; pinned bounds and explicit tick values stay fixed.
|
|
199
|
+
* Rounding applies to XY y and ordinal value axes; x retains nice ticks.
|
|
197
200
|
* Useful when a fixed scale (gauge, score band, KPI dial) needs
|
|
198
201
|
* endpoints to read as the actual boundaries.
|
|
199
202
|
*
|
|
@@ -4,6 +4,7 @@ import type { Accessor, ChartAccessor, SelectionConfig, LinkedHoverProp, MobileI
|
|
|
4
4
|
import type { MobileVisualizationContract } from "./auditMobileVisualization";
|
|
5
5
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
6
6
|
import type { PartialMargin, MarginType } from "../../types/marginType";
|
|
7
|
+
import type { AxisChromeInput } from "../../legendLayout";
|
|
7
8
|
import { useChartSelection, useChartLegendAndMargin } from "./hooks";
|
|
8
9
|
import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition, LegendInteractionState } from "./hooks";
|
|
9
10
|
import type { SelectionHookResult } from "./selectionUtils";
|
|
@@ -53,6 +54,8 @@ export interface NetworkChartSetupInput<TNode extends Datum = Datum, TEdge exten
|
|
|
53
54
|
height: number;
|
|
54
55
|
responsive?: PlaceholderLayout;
|
|
55
56
|
hasTitle?: boolean;
|
|
57
|
+
/** Only layouts with chart-owned axes need extra legend clearance. */
|
|
58
|
+
axisChrome?: AxisChromeInput;
|
|
56
59
|
loading?: boolean;
|
|
57
60
|
/** Custom content rendered in place of the default skeleton while `loading` is true. */
|
|
58
61
|
loadingContent?: ReactNode | false;
|
|
@@ -23,8 +23,8 @@ export interface StreamStatusResult<THandle extends RealtimeFrameHandle = Realti
|
|
|
23
23
|
ref: React.MutableRefObject<THandle | null>;
|
|
24
24
|
/** Current status. Re-renders the consumer on transition. */
|
|
25
25
|
status: StreamStatus;
|
|
26
|
-
/** Timestamp (from `performance.now()`) of the most recent push,
|
|
27
|
-
*
|
|
26
|
+
/** Timestamp (from `performance.now()`) of the most recent push, published
|
|
27
|
+
* on status transitions and at poll cadence; null before the first push. */
|
|
28
28
|
lastPushTime: number | null;
|
|
29
29
|
}
|
|
30
30
|
/**
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
interface ErrorSize {
|
|
3
|
+
width?: number | string;
|
|
4
|
+
height?: number | string;
|
|
5
|
+
}
|
|
6
|
+
type ChartProps<T> = T extends React.ComponentType<infer P> ? P : never;
|
|
7
|
+
/** Protect charts using the same mode and family defaults as their setup. */
|
|
8
|
+
export declare function withChartErrorBoundary<T extends React.ComponentType<never>>(component: T, componentName: string, primarySize?: {
|
|
9
|
+
width?: number;
|
|
10
|
+
height?: number;
|
|
11
|
+
}): T;
|
|
12
|
+
/** Protect chart setup and frames, retaining custom composition sizes and refs. */
|
|
13
|
+
export declare function withSizedChartErrorBoundary<T extends React.ComponentType<never>>(component: T, componentName: string, resolveSize: (props: ChartProps<T>) => ErrorSize): T;
|
|
14
|
+
export {};
|
|
@@ -13,6 +13,8 @@ export interface WaterfallChartProps<TDatum extends Datum = Datum> extends BaseC
|
|
|
13
13
|
/** Stable ID for push-mode remove() and update(). */
|
|
14
14
|
pointIdAccessor?: ChartAccessor<TDatum, string>;
|
|
15
15
|
xScaleType?: "linear" | "log" | "time";
|
|
16
|
+
/** Initial cumulative balance. Evicted deltas carry forward until clear or data replacement. */
|
|
17
|
+
initialValue?: number;
|
|
16
18
|
positiveColor?: string;
|
|
17
19
|
negativeColor?: string;
|
|
18
20
|
connectorStroke?: string;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Datum } from "../shared/datumTypes";
|
|
2
|
+
/** Bounded categorical labels and IDs; caller-owned rows are never stamped. */
|
|
3
|
+
export declare class WaterfallIndex {
|
|
4
|
+
private next;
|
|
5
|
+
private indices;
|
|
6
|
+
private ids;
|
|
7
|
+
private entries;
|
|
8
|
+
index(row: Datum, id: string, label: unknown, capacity: number): number;
|
|
9
|
+
label(index: number): unknown;
|
|
10
|
+
forget(row: Datum): void;
|
|
11
|
+
private forgetIndex;
|
|
12
|
+
}
|
|
@@ -4,7 +4,9 @@
|
|
|
4
4
|
* - "break" splits a line at each gap into separate segment lines.
|
|
5
5
|
* - "interpolate" drops gap points so the line connects across them.
|
|
6
6
|
* This must happen before the frame, whose accessors coerce null to 0.
|
|
7
|
-
* - "zero"
|
|
7
|
+
* - "zero" drops a gap point to the baseline. A string y field is written on a
|
|
8
|
+
* copy. A function y accessor cannot be written through, so those points stay
|
|
9
|
+
* the caller's objects; a wrapped accessor re-evaluates gaps on copied rows.
|
|
8
10
|
*
|
|
9
11
|
* Segment lines are keyed by index and held off the data (no marker field),
|
|
10
12
|
* so frame grouping never merges two series and datums reach tooltips,
|
|
@@ -26,13 +28,23 @@ export interface LineGapResult {
|
|
|
26
28
|
/** Present when "break" split the data at one or more gaps. */
|
|
27
29
|
segments?: LineGapSegments;
|
|
28
30
|
}
|
|
31
|
+
/** Group rows safely in first-seen order, retaining authored series metadata. */
|
|
32
|
+
export declare function groupLineChartRows(rows: readonly Datum[], { lineDataAccessor, groupAccessor, lineBy, segmentField }: {
|
|
33
|
+
lineDataAccessor: string;
|
|
34
|
+
groupAccessor: string | ((row: Datum) => unknown);
|
|
35
|
+
lineBy?: string | ((row: Datum) => unknown);
|
|
36
|
+
segmentField?: string;
|
|
37
|
+
}): Datum[];
|
|
29
38
|
export declare function applyLineGapStrategy({ lineData, strategy, lineDataAccessor, isGap, yField, seriesOfLine, }: {
|
|
30
39
|
lineData: Datum[];
|
|
31
40
|
strategy: LineGapStrategy;
|
|
32
41
|
lineDataAccessor: string;
|
|
33
42
|
isGap: (d: Datum) => boolean;
|
|
34
|
-
/**
|
|
35
|
-
|
|
43
|
+
/**
|
|
44
|
+
* Field "zero" writes 0 into. Omit it when y is read by a function;
|
|
45
|
+
* the wrapped accessor resolves gaps instead of writing a synthetic field.
|
|
46
|
+
*/
|
|
47
|
+
yField?: string;
|
|
36
48
|
/** Authored series label of a line object before it is split. */
|
|
37
49
|
seriesOfLine: (line: Datum) => string;
|
|
38
50
|
}): LineGapResult;
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import type { LegendLayout } from "./types/legendTypes";
|
|
2
|
+
export declare const DEFAULT_LEGEND_SWATCH_SIZE = 16;
|
|
3
|
+
export declare const DEFAULT_LEGEND_LABEL_GAP = 6;
|
|
4
|
+
export declare const DEFAULT_LEGEND_ITEM_GAP = 10;
|
|
5
|
+
export declare const DEFAULT_LEGEND_ROW_HEIGHT = 22;
|
|
6
|
+
export declare const DEFAULT_SIDE_LEGEND_WIDTH = 100;
|
|
7
|
+
export interface LegendMetrics {
|
|
8
|
+
swatchSize: number;
|
|
9
|
+
labelGap: number;
|
|
10
|
+
itemGap: number;
|
|
11
|
+
rowHeight: number;
|
|
12
|
+
align: "start" | "center" | "end";
|
|
13
|
+
maxWidth?: number;
|
|
14
|
+
}
|
|
15
|
+
export interface VerticalLegendGroupInput {
|
|
16
|
+
hasLabel: boolean;
|
|
17
|
+
itemCount: number;
|
|
18
|
+
}
|
|
19
|
+
export interface VerticalLegendGroupLayout {
|
|
20
|
+
lineY: number;
|
|
21
|
+
labelY?: number;
|
|
22
|
+
itemsY: number;
|
|
23
|
+
endY: number;
|
|
24
|
+
}
|
|
25
|
+
/** Resolve the dimensions used by both the interactive and static legends. */
|
|
26
|
+
export declare function resolveLegendMetrics(layout?: LegendLayout): LegendMetrics;
|
|
27
|
+
/**
|
|
28
|
+
* Lay out vertical legend groups using the long-standing Legend.tsx geometry.
|
|
29
|
+
* Keeping this calculation renderer-neutral prevents SSR and CSR from drifting
|
|
30
|
+
* when labels, multiple groups, or custom row heights are used.
|
|
31
|
+
*/
|
|
32
|
+
export declare function layoutVerticalLegendGroups(groups: VerticalLegendGroupInput[], rowHeight: number): VerticalLegendGroupLayout[];
|
|
33
|
+
/**
|
|
34
|
+
* SVG text has no useful intrinsic width until after it is mounted. Keep the
|
|
35
|
+
* estimate shared by margin calculation and rendering so side legends never
|
|
36
|
+
* reserve one width and draw into another.
|
|
37
|
+
*/
|
|
38
|
+
export declare function estimateLegendTextWidth(label: string): number;
|
|
39
|
+
/**
|
|
40
|
+
* When a left/right legend's margin is measured, it may claim at most this
|
|
41
|
+
* share of the chart width (never less than the 100px minimum box), so long
|
|
42
|
+
* labels truncate instead of squeezing the plot. `legendLayout.maxWidth`
|
|
43
|
+
* replaces this cap for side legends.
|
|
44
|
+
*/
|
|
45
|
+
export declare const MAX_SIDE_LEGEND_WIDTH_RATIO = 0.3;
|
|
46
|
+
/**
|
|
47
|
+
* A top/bottom legend's measured rows may claim at most this share of the
|
|
48
|
+
* chart height (never less than one row); further rows collapse into
|
|
49
|
+
* "+N more". Looser than the side cap because rows hide whole categories
|
|
50
|
+
* where a narrower side legend only truncates labels.
|
|
51
|
+
*/
|
|
52
|
+
export declare const MAX_HORIZONTAL_LEGEND_HEIGHT_RATIO = 0.4;
|
|
53
|
+
/** Shortest label (in characters) a wrapped side-legend column keeps before
|
|
54
|
+
* the layout stops adding columns and summarizes the rest as "+N more". */
|
|
55
|
+
export declare const MIN_SIDE_LEGEND_LABEL_CHARS = 6;
|
|
56
|
+
/** Visible text for a category whose label is empty or whitespace. */
|
|
57
|
+
export declare const EMPTY_LEGEND_LABEL = "(empty)";
|
|
58
|
+
/** The text a legend draws for a category label. */
|
|
59
|
+
export declare function legendDisplayLabel(label: unknown): string;
|
|
60
|
+
/** Shorten a label with an ellipsis so its estimated width fits `maxWidth`. */
|
|
61
|
+
export declare function truncateLegendLabel(label: string, maxWidth: number, charWidth?: number): string;
|
|
62
|
+
/** Text of the row that stands in for categories a side legend cannot fit. */
|
|
63
|
+
export declare function legendMoreLabel(hiddenCount: number): string;
|
|
64
|
+
/** Hover text naming the categories summarized by the "+N more" row. */
|
|
65
|
+
export declare function legendMoreTitle(items: ReadonlyArray<{
|
|
66
|
+
label: string;
|
|
67
|
+
} | undefined>, visibleCount: number): string;
|
|
68
|
+
/** Rows a top/bottom legend can draw in `height`, never fewer than one.
|
|
69
|
+
* Multi-group legends lose 16px to their separator overshoot. */
|
|
70
|
+
export declare function legendRowsFor(height: number, rowHeight: number, groupCount: number): number;
|
|
71
|
+
export interface LegendRow {
|
|
72
|
+
start: number;
|
|
73
|
+
end: number;
|
|
74
|
+
width: number;
|
|
75
|
+
}
|
|
76
|
+
export interface LegendRowsFit {
|
|
77
|
+
rows: LegendRow[];
|
|
78
|
+
/** Item widths, capped at the row width so over-wide labels truncate. */
|
|
79
|
+
widths: number[];
|
|
80
|
+
visibleCount: number;
|
|
81
|
+
hiddenCount: number;
|
|
82
|
+
/** Offset of the "+N more" slot on the last row; -1 when nothing is hidden. */
|
|
83
|
+
moreX: number;
|
|
84
|
+
width: number;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Wrap a horizontal legend group into rows no wider than `maxWidth`. An item
|
|
88
|
+
* wider than a row is capped to it (its label truncates, keeping at least one
|
|
89
|
+
* character and the ellipsis), and rows past `maxRows` collapse into a
|
|
90
|
+
* "+N more" slot at the end of the last kept row. Shared by margin
|
|
91
|
+
* reservation and the live and static renderers; static SVG passes its
|
|
92
|
+
* theme-derived `charWidth`.
|
|
93
|
+
*/
|
|
94
|
+
export declare function fitLegendRows(widths: readonly number[], options: {
|
|
95
|
+
itemGap: number;
|
|
96
|
+
labelOffset: number;
|
|
97
|
+
maxWidth?: number;
|
|
98
|
+
maxRows?: number;
|
|
99
|
+
charWidth?: number;
|
|
100
|
+
}): LegendRowsFit;
|
|
101
|
+
/** Space a legend may occupy, measured from its origin. */
|
|
102
|
+
export interface LegendBounds {
|
|
103
|
+
maxWidth?: number;
|
|
104
|
+
maxHeight?: number;
|
|
105
|
+
}
|
|
106
|
+
export interface SideLegendGroupFit extends VerticalLegendGroupLayout {
|
|
107
|
+
/** Rows in each column of this group. */
|
|
108
|
+
rows: number;
|
|
109
|
+
/** Leading items that are drawn. */
|
|
110
|
+
visibleCount: number;
|
|
111
|
+
/** Trailing items summarized by a "+N more" row in the last slot. */
|
|
112
|
+
hiddenCount: number;
|
|
113
|
+
}
|
|
114
|
+
export interface SideLegendFit {
|
|
115
|
+
width: number;
|
|
116
|
+
height: number;
|
|
117
|
+
columns: number;
|
|
118
|
+
/** Width of one column (swatch plus label). */
|
|
119
|
+
columnWidth: number;
|
|
120
|
+
/** Distance between adjacent column origins. */
|
|
121
|
+
columnStep: number;
|
|
122
|
+
/** Widest label text a column draws before truncating. */
|
|
123
|
+
labelWidth: number;
|
|
124
|
+
rowHeight: number;
|
|
125
|
+
groups: SideLegendGroupFit[];
|
|
126
|
+
}
|
|
127
|
+
type SideLegendGroupInput = {
|
|
128
|
+
label?: string;
|
|
129
|
+
items: ReadonlyArray<{
|
|
130
|
+
label: string;
|
|
131
|
+
} | undefined>;
|
|
132
|
+
};
|
|
133
|
+
/**
|
|
134
|
+
* Fit categorical groups into a left/right legend box. Unbounded, this is the
|
|
135
|
+
* long-standing single column. With bounds, items flow into columns (top to
|
|
136
|
+
* bottom, then left to right) when the column would run past `maxHeight`;
|
|
137
|
+
* labels truncate to the column width; and when even the narrowest readable
|
|
138
|
+
* columns cannot hold every item, the last slot of a group becomes "+N more".
|
|
139
|
+
* Shared by margin reservation and the live and static renderers so their
|
|
140
|
+
* geometry cannot drift.
|
|
141
|
+
*/
|
|
142
|
+
export declare function fitSideLegend(groups: ReadonlyArray<SideLegendGroupInput>, layout?: LegendLayout, bounds?: LegendBounds): SideLegendFit;
|
|
143
|
+
/** Origin of a slot (item or "+N more" row) inside its group's item box. */
|
|
144
|
+
export declare function sideLegendSlotOffset(fit: SideLegendFit, group: SideLegendGroupFit, slot: number): {
|
|
145
|
+
x: number;
|
|
146
|
+
y: number;
|
|
147
|
+
};
|
|
148
|
+
export {};
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
import type { LegendLayout, LegendValue } from "./types/legendTypes";
|
|
2
|
-
|
|
3
|
-
export
|
|
4
|
-
export
|
|
5
|
-
export declare const DEFAULT_LEGEND_ROW_HEIGHT = 22;
|
|
6
|
-
export declare const DEFAULT_SIDE_LEGEND_WIDTH = 100;
|
|
2
|
+
import { type LegendBounds } from "./legendGeometry";
|
|
3
|
+
export { DEFAULT_LEGEND_ITEM_GAP, DEFAULT_LEGEND_LABEL_GAP, DEFAULT_LEGEND_ROW_HEIGHT, DEFAULT_LEGEND_SWATCH_SIZE, DEFAULT_SIDE_LEGEND_WIDTH, EMPTY_LEGEND_LABEL, MAX_HORIZONTAL_LEGEND_HEIGHT_RATIO, MAX_SIDE_LEGEND_WIDTH_RATIO, MIN_SIDE_LEGEND_LABEL_CHARS, estimateLegendTextWidth, fitLegendRows, fitSideLegend, layoutVerticalLegendGroups, legendDisplayLabel, legendMoreLabel, legendMoreTitle, legendRowsFor, resolveLegendMetrics, sideLegendSlotOffset, truncateLegendLabel, } from "./legendGeometry";
|
|
4
|
+
export type { LegendMetrics, LegendRow, LegendRowsFit, LegendBounds, SideLegendFit, SideLegendGroupFit, VerticalLegendGroupInput, VerticalLegendGroupLayout, } from "./legendGeometry";
|
|
7
5
|
export declare const DEFAULT_LEGEND_DISTANCE = 10;
|
|
8
6
|
export declare const DEFAULT_LEGEND_EDGE_GUTTER = 3;
|
|
9
7
|
/** Keep a chart's data area meaningful when chart-owned chrome (currently a
|
|
@@ -32,14 +30,22 @@ export declare const GRADIENT_LEGEND_LABEL_BASELINE = 12;
|
|
|
32
30
|
export declare const GRADIENT_LEGEND_LABELED_BAR_Y = 18;
|
|
33
31
|
export declare const GRADIENT_LEGEND_HORIZONTAL_HEIGHT = 46;
|
|
34
32
|
export declare const GRADIENT_LEGEND_HORIZONTAL_HEIGHT_UNLABELED = 26;
|
|
33
|
+
/** Widest box a measured left/right legend may reserve in a chart. */
|
|
34
|
+
export declare function resolveSideLegendMaxWidth(chartWidth: number, layout?: LegendLayout): number;
|
|
35
35
|
/**
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
36
|
+
* Space a legend may draw into once margins are known, shared by the live and
|
|
37
|
+
* static renderers. A left/right legend gets the side margin left after its
|
|
38
|
+
* gutters (never below the 100px minimum box, which compact frames already
|
|
39
|
+
* let overlap the plot) and the height from the plot top to the chart bottom.
|
|
40
|
+
* A top/bottom legend (which wraps to the plot width) gets the height of the
|
|
41
|
+
* band left in its margin after axis chrome, the plot gap and (above a top
|
|
42
|
+
* legend) the title.
|
|
39
43
|
*/
|
|
40
|
-
export declare function
|
|
44
|
+
export declare function resolveLegendRenderBounds(legend: LegendValue | null | undefined, input: LegendPlacementInput): LegendBounds;
|
|
45
|
+
/** Rows a top/bottom legend may draw in the band reserved for it. */
|
|
46
|
+
export declare function resolveHorizontalLegendMaxRows(legend: LegendValue | null | undefined, input: LegendPlacementInput): number;
|
|
41
47
|
/** Resolve the layout box needed by a left/right legend. */
|
|
42
|
-
export declare function resolveSideLegendWidth(legend: LegendValue | null | undefined, layout?: LegendLayout): number;
|
|
48
|
+
export declare function resolveSideLegendWidth(legend: LegendValue | null | undefined, layout?: LegendLayout, bounds?: LegendBounds): number;
|
|
43
49
|
/** Resolve the requested gap between the legend edge and plot edge. */
|
|
44
50
|
export declare function resolveLegendDistance(legend: LegendValue | null | undefined): number;
|
|
45
51
|
/** Resolve plot-adjacent chrome reserved before a left/right legend. */
|
|
@@ -158,9 +164,9 @@ export declare function resolveOrdinalAxisChrome(input: {
|
|
|
158
164
|
hasValueLabel: boolean;
|
|
159
165
|
}): AxisChromeInput;
|
|
160
166
|
/** Estimate the layout-box height used to place a top/bottom legend. */
|
|
161
|
-
export declare function resolveHorizontalLegendHeight(legend: LegendValue | null | undefined, availableWidth: number, layout?: LegendLayout): number;
|
|
167
|
+
export declare function resolveHorizontalLegendHeight(legend: LegendValue | null | undefined, availableWidth: number, layout?: LegendLayout, maxRows?: number): number;
|
|
162
168
|
/** Margin required to fit a side legend and its plot-edge gap. */
|
|
163
|
-
export declare function resolveSideLegendMargin(legend: LegendValue | null | undefined, layout?: LegendLayout, axisChrome?: Omit<AxisChromeInput, "topAxis" | "leftAxis" | "rightAxis"
|
|
169
|
+
export declare function resolveSideLegendMargin(legend: LegendValue | null | undefined, layout?: LegendLayout, axisChrome?: Omit<AxisChromeInput, "topAxis" | "leftAxis" | "rightAxis">, bounds?: LegendBounds): number;
|
|
164
170
|
/**
|
|
165
171
|
* Apply the shared legend reservation used by HOC layout, direct stream
|
|
166
172
|
* frames, and static rendering. Keeping this here prevents direct SSR from
|
|
@@ -195,6 +201,8 @@ export interface LegendPlacementInput {
|
|
|
195
201
|
axisChrome?: AxisChromeInput;
|
|
196
202
|
/** Static renderers may reserve a measured side box wider than the default. */
|
|
197
203
|
reservedWidth?: number;
|
|
204
|
+
/** A chart title sits above a top legend's band. */
|
|
205
|
+
hasTitle?: boolean;
|
|
198
206
|
}
|
|
199
207
|
/**
|
|
200
208
|
* Resolve the origin and box used by both live and static legend renderers.
|
|
@@ -207,32 +215,6 @@ export declare function resolveLegendPlacement(legend: LegendValue | null | unde
|
|
|
207
215
|
width: number;
|
|
208
216
|
height: number;
|
|
209
217
|
};
|
|
210
|
-
export interface LegendMetrics {
|
|
211
|
-
swatchSize: number;
|
|
212
|
-
labelGap: number;
|
|
213
|
-
itemGap: number;
|
|
214
|
-
rowHeight: number;
|
|
215
|
-
align: "start" | "center" | "end";
|
|
216
|
-
maxWidth?: number;
|
|
217
|
-
}
|
|
218
|
-
export interface VerticalLegendGroupInput {
|
|
219
|
-
hasLabel: boolean;
|
|
220
|
-
itemCount: number;
|
|
221
|
-
}
|
|
222
|
-
export interface VerticalLegendGroupLayout {
|
|
223
|
-
lineY: number;
|
|
224
|
-
labelY?: number;
|
|
225
|
-
itemsY: number;
|
|
226
|
-
endY: number;
|
|
227
|
-
}
|
|
228
|
-
/** Resolve the dimensions used by both the interactive and static legends. */
|
|
229
|
-
export declare function resolveLegendMetrics(layout?: LegendLayout): LegendMetrics;
|
|
230
|
-
/**
|
|
231
|
-
* Lay out vertical legend groups using the long-standing Legend.tsx geometry.
|
|
232
|
-
* Keeping this calculation renderer-neutral prevents SSR and CSR from drifting
|
|
233
|
-
* when labels, multiple groups, or custom row heights are used.
|
|
234
|
-
*/
|
|
235
|
-
export declare function layoutVerticalLegendGroups(groups: VerticalLegendGroupInput[], rowHeight: number): VerticalLegendGroupLayout[];
|
|
236
218
|
/** Drop only default margins belonging to explicitly hidden XY axes. */
|
|
237
219
|
export declare function resolveHiddenAxisMargins(defaults: {
|
|
238
220
|
top: number;
|
|
@@ -10,6 +10,10 @@ export interface ReorderBufferConfig<T> {
|
|
|
10
10
|
* - `"keep"`: release it immediately, out of order (still counted).
|
|
11
11
|
*/
|
|
12
12
|
latePolicy?: LatePolicy;
|
|
13
|
+
/** Reject timestamps beyond the wall clock plus this many ms. Opt-in. */
|
|
14
|
+
maxFutureSkew?: number;
|
|
15
|
+
/** Epoch-millisecond clock for future-skew checks. @default Date.now */
|
|
16
|
+
now?: () => number;
|
|
13
17
|
}
|
|
14
18
|
export interface ReorderResult<T> {
|
|
15
19
|
/**
|
|
@@ -19,6 +23,8 @@ export interface ReorderResult<T> {
|
|
|
19
23
|
released: T[];
|
|
20
24
|
/** The events that were late this push (informational; for diagnostics). */
|
|
21
25
|
late: T[];
|
|
26
|
+
/** Future-dated events rejected without advancing the watermark. */
|
|
27
|
+
future?: T[];
|
|
22
28
|
}
|
|
23
29
|
/**
|
|
24
30
|
* Buffers pushed events and releases them in event-time order once they
|
|
@@ -28,6 +34,9 @@ export declare class ReorderBuffer<T> {
|
|
|
28
34
|
private readonly lateness;
|
|
29
35
|
private readonly getTime;
|
|
30
36
|
private readonly latePolicy;
|
|
37
|
+
private readonly maxFutureSkew;
|
|
38
|
+
private readonly now;
|
|
39
|
+
private _futureCount;
|
|
31
40
|
private held;
|
|
32
41
|
private nextOrder;
|
|
33
42
|
private _watermark;
|
|
@@ -46,6 +55,11 @@ export declare class ReorderBuffer<T> {
|
|
|
46
55
|
* stream ends and the remaining grace-window events should be shown.
|
|
47
56
|
*/
|
|
48
57
|
flush(): T[];
|
|
58
|
+
/** Opt-in idle progression, using elapsed wall time rather than assuming an event epoch. */
|
|
59
|
+
advanceIdle(elapsed: number): T[];
|
|
60
|
+
/** Event-time frontier behind the configured grace window. */
|
|
61
|
+
get releaseWatermark(): number;
|
|
62
|
+
get futureCount(): number;
|
|
49
63
|
clear(): void;
|
|
50
64
|
/** Largest event-time seen, or `-Infinity` if empty. */
|
|
51
65
|
get watermark(): number;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/** Monotonic queues make FIFO extrema eviction amortized O(1), including ties. */
|
|
2
|
+
export declare class SlidingExtent {
|
|
3
|
+
private needsRebuild;
|
|
4
|
+
private minima;
|
|
5
|
+
private maxima;
|
|
6
|
+
private minHead;
|
|
7
|
+
private maxHead;
|
|
8
|
+
push(value: number): void;
|
|
9
|
+
/** Only for evicting values in the same order they were pushed. */
|
|
10
|
+
evictOldest(value: number): void;
|
|
11
|
+
/** Arbitrary removals/edits require rebuilding queues from retained data. */
|
|
12
|
+
evict(value: number): void;
|
|
13
|
+
recalculate<T>(values: Iterable<T>, accessor?: (value: T) => number): void;
|
|
14
|
+
clear(): void;
|
|
15
|
+
get min(): number;
|
|
16
|
+
get extent(): [number, number];
|
|
17
|
+
get dirty(): boolean;
|
|
18
|
+
}
|
|
@@ -75,11 +75,12 @@ export declare class WindowAccumulator {
|
|
|
75
75
|
private readonly size;
|
|
76
76
|
private readonly hop;
|
|
77
77
|
private readonly gap;
|
|
78
|
-
private
|
|
78
|
+
private retain;
|
|
79
79
|
private readonly percentiles;
|
|
80
80
|
private readonly wantDistinct;
|
|
81
81
|
private windows;
|
|
82
82
|
private starts;
|
|
83
|
+
private sortedStarts;
|
|
83
84
|
private sessions;
|
|
84
85
|
private latest;
|
|
85
86
|
constructor(config: WindowAccumulatorConfig);
|
|
@@ -93,6 +94,7 @@ export declare class WindowAccumulator {
|
|
|
93
94
|
private pushFixed;
|
|
94
95
|
private bump;
|
|
95
96
|
private pushSession;
|
|
97
|
+
setRetention(retain: number): void;
|
|
96
98
|
private prune;
|
|
97
99
|
/**
|
|
98
100
|
* Snapshot the current windows as aggregated rows, sorted by start.
|
|
@@ -102,6 +104,8 @@ export declare class WindowAccumulator {
|
|
|
102
104
|
*/
|
|
103
105
|
emit(): AggregatedWindow[];
|
|
104
106
|
private row;
|
|
107
|
+
/** Advance event time without fabricating an observation (opt-in idle release). */
|
|
108
|
+
advanceWatermark(time: number): void;
|
|
105
109
|
/** Number of live windows (or sessions). */
|
|
106
110
|
get windowCount(): number;
|
|
107
111
|
/** The watermark — largest event-time seen, or `-Infinity` if empty. */
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
import type { RendererFn } from "./types";
|
|
2
2
|
import type { Datum } from "../../charts/shared/datumTypes";
|
|
3
|
-
export declare function computeWaterfallExtent(data: Iterable<Datum>, getValue: (d: Datum) => number): [number, number];
|
|
3
|
+
export declare function computeWaterfallExtent(data: Iterable<Datum>, getValue: (d: Datum) => number, initialValue?: number): [number, number];
|
|
4
4
|
export declare const waterfallRenderer: RendererFn;
|
|
@@ -51,7 +51,7 @@ export declare function resolutionAppearance(theme: NetworkLayoutContext["theme"
|
|
|
51
51
|
};
|
|
52
52
|
generationColor: (generation: number) => string;
|
|
53
53
|
style: (context: Omit<ResolutionStyleContext, "theme">, base: Style) => Style;
|
|
54
|
-
labelStyle: Partial<Pick<NetworkLabel, "fill" | "stroke" | "
|
|
54
|
+
labelStyle: Partial<Pick<NetworkLabel, "fill" | "stroke" | "strokeWidth" | "fontSize" | "fontWeight" | "paintOrder">> | undefined;
|
|
55
55
|
dimmedOpacity: number;
|
|
56
56
|
};
|
|
57
57
|
/** Match only the hovered component's original members, without expanding through later unions. */
|
|
@@ -46,7 +46,7 @@ export declare function sceneBuilder(theme: NetworkLayoutContext["theme"], appea
|
|
|
46
46
|
};
|
|
47
47
|
generationColor: (generation: number) => string;
|
|
48
48
|
style: (context: Omit<import("./appearance").ResolutionStyleContext, "theme">, base: Style) => Style;
|
|
49
|
-
labelStyle: Partial<Pick<NetworkLabel, "fill" | "stroke" | "
|
|
49
|
+
labelStyle: Partial<Pick<NetworkLabel, "fill" | "stroke" | "strokeWidth" | "fontSize" | "fontWeight" | "paintOrder">> | undefined;
|
|
50
50
|
dimmedOpacity: number;
|
|
51
51
|
};
|
|
52
52
|
export declare function shortLabel(text: string, max?: number): string;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { LayoutRequest, RoutedConnection } from "./types";
|
|
2
|
+
import type { Projection } from "./projection";
|
|
3
|
+
/** Request-local indexes and direct-route cache shared by optimization candidates. */
|
|
4
|
+
export declare function createEdgeRouter(request: LayoutRequest): (projection: Projection, rankMap: Map<string, number>) => {
|
|
5
|
+
edges: RoutedConnection[];
|
|
6
|
+
hints: Map<string, import("./types").EdgeLayoutHint>;
|
|
7
|
+
sorted: import("./types").Connection[];
|
|
8
|
+
excluded: Set<string>;
|
|
9
|
+
};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import type { LayoutMetrics, RoutedConnection } from "./types";
|
|
2
|
-
export declare function measureRoutes(
|
|
1
|
+
import type { LayoutMetrics, LayoutOptions, RoutedConnection } from "./types";
|
|
2
|
+
export declare function measureRoutes(allEdges: readonly RoutedConnection[], horizontal: boolean, alignmentIds: Set<string>, routing?: LayoutOptions["routing"], excluded?: ReadonlySet<string>): {
|
|
3
3
|
metrics: LayoutMetrics;
|
|
4
4
|
partial: boolean;
|
|
5
5
|
};
|
|
@@ -11,6 +11,8 @@ export interface Projection {
|
|
|
11
11
|
exposures: Map<string, BoundaryExposure>;
|
|
12
12
|
portOrders: Map<string, PortOrderConstraint>;
|
|
13
13
|
byId: Map<string, PlacedNode>;
|
|
14
|
+
positions: Map<string, Point>;
|
|
15
|
+
orders: Map<string, string[]>;
|
|
14
16
|
}
|
|
15
17
|
/** Shared visibility rules for projection and external-engine acceptance. */
|
|
16
18
|
export declare function projectionOwners(request: LayoutRequest): {
|
|
@@ -18,6 +20,6 @@ export declare function projectionOwners(request: LayoutRequest): {
|
|
|
18
20
|
views: Map<string, NodePresentation>;
|
|
19
21
|
hidden: Map<string, string>;
|
|
20
22
|
};
|
|
21
|
-
export declare function project(request: LayoutRequest, measurements: Map<string, NodeMeasure>, positions: Map<string, Point>, orders: Map<string, string[]
|
|
23
|
+
export declare function project(request: LayoutRequest, measurements: Map<string, NodeMeasure>, positions: Map<string, Point>, orders: Map<string, string[]>, previous?: Projection): Projection;
|
|
22
24
|
export declare function terminal(request: LayoutRequest, projection: Projection, edgeId: string, ref: EndpointRef, use: "source" | "target"): TerminalGeometry;
|
|
23
25
|
export declare function validateView(request: LayoutRequest): void;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { PathSection, Point, Rect } from "./types";
|
|
1
|
+
import type { PathSection, Point, Rect, TerminalGeometry } from "./types";
|
|
2
2
|
export declare const distance: (a: Point, b: Point) => number;
|
|
3
3
|
export declare function segmentBlocked(a: Point, b: Point, rectangles: readonly Rect[]): boolean;
|
|
4
4
|
export declare function compact(points: readonly Point[]): Point[];
|
|
@@ -8,3 +8,5 @@ export declare function orthogonalRoute(start: Point, end: Point, obstacles: rea
|
|
|
8
8
|
export declare function routeSection(id: string, points: readonly Point[], smooth: boolean, obstacles: readonly Rect[]): PathSection;
|
|
9
9
|
export declare function compositionalPath(section: PathSection): string;
|
|
10
10
|
export declare function flattened(section: PathSection): Point[];
|
|
11
|
+
/** Direct chord or bump geometry. Terminal anchors are shared with obstacle routing. */
|
|
12
|
+
export declare function terminalSection(id: string, source: TerminalGeometry, target: TerminalGeometry, start?: Point, end?: Point, bump?: boolean, horizontal?: boolean): PathSection;
|
|
@@ -5,3 +5,5 @@ export declare function validateSemanticTopology(request: LayoutRequest): void;
|
|
|
5
5
|
export declare function projectedRanks(request: LayoutRequest, projection: Projection): Map<string, number>;
|
|
6
6
|
export declare function initialPositions(request: LayoutRequest): Map<string, Point>;
|
|
7
7
|
export declare function placeRanks(request: LayoutRequest, rankMap: Map<string, number>, positions: Map<string, Point>): void;
|
|
8
|
+
/** Pins constrain owner placement, not the semantic dependency graph. */
|
|
9
|
+
export declare function allOwnersPinned(request: LayoutRequest): boolean;
|