@gravitee/graphene-charts 2.31.1 → 2.32.0

package/dist/charts/TraceWaterfall/TraceWaterfall.d.ts

@@ -0,0 +1,21 @@
+import { ChartState } from '../../types';
+import { TraceWaterfallRow } from './types';
+import * as React from 'react';
+export interface TraceWaterfallProps extends Omit<React.ComponentProps<'div'>, 'onSelect'> {
+    spans: TraceWaterfallRow[];
+    /** Lifecycle state. When omitted, inferred from spans length. */
+    state?: ChartState;
+    selectedSpanId?: string;
+    onSpanSelect?: (spanId: string) => void;
+    /** Called when a span row is hovered. */
+    onSpanHover?: (span: TraceWaterfallRow) => void;
+    /** Called when the cursor leaves a span row. */
+    onSpanLeave?: () => void;
+    /** When true, all parent spans start collapsed. */
+    defaultCollapsed?: boolean;
+    /** Custom render for the hover card content. When omitted, the built-in detail card is used. */
+    renderTooltip?: (span: TraceWaterfallRow) => React.ReactNode;
+    ariaLabel?: string;
+}
+export declare function TraceWaterfall({ spans, state, selectedSpanId, onSpanSelect, onSpanHover, onSpanLeave, defaultCollapsed, renderTooltip, ariaLabel, className, ...rest }: TraceWaterfallProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TraceWaterfall.d.ts.map

package/dist/charts/TraceWaterfall/TraceWaterfall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceWaterfall.d.ts","sourceRoot":"","sources":["../../../src/charts/TraceWaterfall/TraceWaterfall.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAUlE,OAAO,KAAK,EAAwB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAwDvE,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACxF,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,yCAAyC;IACzC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gGAAgG;IAChG,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuhBD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,KAAK,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAwB,EACxB,aAAa,EACb,SAAsC,EACtC,SAAS,EACT,GAAG,IAAI,EACR,EAAE,mBAAmB,2CAkHrB"}

package/dist/charts/TraceWaterfall/fixtures.d.ts

@@ -0,0 +1,12 @@
+import { TraceWaterfallRow } from './types';
+/** Sequential parent → child chain across multiple services. */
+export declare const chainSpans: TraceWaterfallRow[];
+/** Parallel sibling spans — microservice fan-out. */
+export declare const parallelSpans: TraceWaterfallRow[];
+/** Trace with cascading error. */
+export declare const errorSpans: TraceWaterfallRow[];
+/** Deep nesting with sub-millisecond spans. */
+export declare const deepTreeSpans: TraceWaterfallRow[];
+/** Realistic API gateway trace with many services. */
+export declare const realisticSpans: TraceWaterfallRow[];
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/charts/TraceWaterfall/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/charts/TraceWaterfall/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD,gEAAgE;AAChE,eAAO,MAAM,UAAU,EAAE,iBAAiB,EAkEzC,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,aAAa,EAAE,iBAAiB,EA6E5C,CAAC;AAEF,kCAAkC;AAClC,eAAO,MAAM,UAAU,EAAE,iBAAiB,EAuDzC,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAmG5C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,iBAAiB,EAyH7C,CAAC"}

package/dist/charts/TraceWaterfall/formatDuration.d.ts

@@ -0,0 +1,24 @@
+/** Minimum rendered bar width in pixels so sub-ms spans remain visible. */
+export declare const MIN_BAR_WIDTH_PX = 3;
+/**
+ * Formats a nanosecond duration for span labels and axis ticks.
+ * Preserves sub-millisecond precision when relevant.
+ */
+export declare function formatDurationNs(ns: number): string;
+/** Returns the trace end offset in nanoseconds (at least 1 to avoid a zero domain). */
+export declare function computeTraceDurationNs(spans: ReadonlyArray<{
+    startOffsetNs: number;
+    durationNs: number;
+}>): number;
+/** Maps span timing to pixel geometry on the shared timeline. */
+export declare function computeBarGeometry(startOffsetNs: number, durationNs: number, traceDurationNs: number, timelineWidth: number): {
+    x: number;
+    width: number;
+};
+/** Formats a span duration as a percentage of the total trace duration. */
+export declare function formatTracePercent(durationNs: number, traceDurationNs: number): string;
+/** Returns the number of ticks the time axis should display for a given pixel width. */
+export declare function getTickCount(usableWidth: number): number;
+/** Builds evenly spaced tick values for the time axis. */
+export declare function buildTimeAxisTicks(traceDurationNs: number, tickCount?: number): number[];
+//# sourceMappingURL=formatDuration.d.ts.map

package/dist/charts/TraceWaterfall/formatDuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDuration.d.ts","sourceRoot":"","sources":["../../../src/charts/TraceWaterfall/formatDuration.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAsBnD;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAOlH;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAa9B;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAMtF;AAKD,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,EAAE,CAMnF"}

package/dist/charts/TraceWaterfall/index.d.ts

@@ -0,0 +1,5 @@
+export { TraceWaterfall } from './TraceWaterfall';
+export type { TraceWaterfallProps } from './TraceWaterfall';
+export { buildTimeAxisTicks, computeBarGeometry, computeTraceDurationNs, formatDurationNs, formatTracePercent, } from './formatDuration';
+export type { SpanKind, SpanStatus, TraceWaterfallRow } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/charts/TraceWaterfall/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/charts/TraceWaterfall/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/charts/TraceWaterfall/types.d.ts

@@ -0,0 +1,20 @@
+export type SpanKind = 'internal' | 'server' | 'client' | 'producer' | 'consumer';
+export type SpanStatus = 'ok' | 'error' | 'unset';
+/** Pre-flattened span row for presentational rendering. */
+export interface TraceWaterfallRow {
+    spanId: string;
+    parentSpanId?: string;
+    /** Operation name (e.g. `GET /api/users`). */
+    name: string;
+    /** Service that emitted this span (e.g. `api-gateway`). */
+    serviceName: string;
+    kind: SpanKind;
+    status: SpanStatus;
+    /** Offset from trace origin in nanoseconds. */
+    startOffsetNs: number;
+    /** Duration in nanoseconds. */
+    durationNs: number;
+    /** Nesting depth (0 = root). */
+    depth: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/charts/TraceWaterfall/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/charts/TraceWaterfall/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAElF,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAElD,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/index.d.ts

@@ -26,4 +26,5 @@ export * from './charts/Metric';
 export * from './charts/MetricGroup';
 export * from './charts/LineChart';
 export * from './charts/AreaChart';
+export * from './charts/TraceWaterfall';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,IAAI,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACvG,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,IAAI,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACvG,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}