@tangle-network/charts 0.21.16 → 0.21.17

package/dist/react/index.d.ts

@@ -373,6 +373,86 @@ interface DotMapProps {
 export declare const DOT_MAP_CATEGORIES: readonly string[];
 export declare function DotMap({ positions, radii, colors, palette, extent, rects, labels, dimmed, selected, minPixelRadius, onHover, onSelect, describe, height, ariaLabel }: DotMapProps): import("react").JSX.Element;
 //#endregion
+//#region src/react/flow-waterfall-model.d.ts
+/** A minimap mark on a parent row: merged descendant activity of one kind. */
+interface FlowSegment {
+  startMs: number;
+  /** Infinity while running; the presentation clips it at the clock. */
+  endMs: number;
+  kind: 'model' | 'tool' | 'failed';
+  tone: number;
+  /** The first span merged into this mark, and how many were merged. */
+  id: string;
+  count: number;
+  retry: boolean;
+  /** In a family row, every other member's marks take a darker shade of the family's one hue. */
+  alt?: boolean;
+  /** The first merged span's name, e.g. a tool's: shown in the segment's tooltip, and in the bar when one step fits it. */
+  name?: string;
+  /** The tool every merged step shares (the name before " · "); undefined once the merged steps differ. */
+  tool?: string;
+}
+/** A row's direct steps: model and tool calls (failed ones included), the failed and retrying ones, and tool calls by tool. */
+interface StepCounts {
+  model: number;
+  tool: number;
+  failed: number;
+  retried: number;
+  tools: Record<string, number>;
+}
+/** Tokens in, out and cached; a field nobody recorded stays undefined. */
+interface TokenCounts {
+  prompt?: number;
+  completion?: number;
+  cached?: number;
+}
+interface FlowWaterfallRow {
+  id: string;
+  parentId?: string;
+  name: string;
+  kind: FlowSpan['kind'];
+  durationLabel: string;
+  approx: boolean;
+  ok: boolean;
+  depth: number;
+  hasChildren: boolean;
+  span: FlowSpan;
+  /** Agent hue: the index of the nearest pipeline ancestor (or self), in first-start order. */
+  tone: number;
+  /** All descendants, for the collapsed "+N" count. */
+  descendants: number;
+  /** Parent rows only: merged descendant activity, drawn as the row's minimap. */
+  segments: FlowSegment[];
+  /** Direct non-agent children: the row's own thinking and tool work, drawn over its waiting extent. */
+  own: FlowSegment[];
+  /** Direct steps counted from the spans, before marks merge for display (merging depends on zoom). */
+  counts?: StepCounts;
+  /** Durations of its finished direct model calls, ascending: the card's latency. */
+  modelMs?: number[];
+  /** The span's own tokens, else the sum of its children's, as its cost rolls up. */
+  tokens?: TokenCounts;
+  /** Its cost is a floor ("≥"): its own bound, its trace's, or a family with unpriced members. */
+  costFloor?: boolean;
+  /** The span retries a failed one; its bar carries a retry glyph. */
+  retry: boolean;
+  /** The row delegates to child agents, so the gaps in its own work are waiting. */
+  hasAgents: boolean;
+  /** Recorded cost of the row and its descendants, only when every model call below it has a recorded cost. */
+  rollupCostUsd?: number;
+  /** Agent view: the family row this agent belongs to, when agents sharing a role are folded together. */
+  family?: string;
+  /** Agent view: the agent whose steps this row is, shown nested under it. */
+  stepOf?: string;
+  /** Agent view: indent level (members under a family, steps under an agent). */
+  inset?: number;
+}
+/** Hierarchy only; presentation owns geometry.
+ * Orphaned parents become roots; cycles are broken without dropping any span. */
+export declare function flowWaterfallRows(trace: FlowTrace, resolutionMs?: number): FlowWaterfallRow[];
+/** The chain of steps that gates the trace's end: from each root, descend into the latest-ending child until a leaf; the root whose
+ * chain ends last wins. Cutting latency anywhere else leaves the trace's end unchanged. */
+export declare function criticalPathIds(rows: readonly FlowWaterfallRow[]): ReadonlySet<string>;
+//#endregion
 //#region src/react/flow-waterfall-row.d.ts
 type FlowView = 'spans' | 'agents';
 //#endregion
@@ -436,4 +516,4 @@ interface FlowWaterfallProps {
  * Data remains producer-owned; playback, zoom and folding change presentation only. */
 export declare function FlowWaterfall({ trace, live, startedAt, label, defaultCollapsed, defaultView, renderIcon, maxHeight, onSelect, markers, onTimeChange, agentFill: fillProp, selectedId, onDeselect, description, summary: showSummary, criticalPath, query: queryProp, onQueryChange, collapsed: collapsedProp, onCollapsedChange, zoom: zoomProp, onZoomChange, matchSpan }: FlowWaterfallProps): import("react").JSX.Element;
 //#endregion
-export type { BandKind, ChartBand, ChartMark, DotMapLabel, DotMapProps, DotMapRect, Figure, FigureAtWidth, FigureViewProps, FlowWaterfallProps, ViewWindow as FlowWaterfallWindow, GapBand, GapProps, LineSeries, MarkKind, MarkVerdict, MarkerShape, MeterSegment, PointFields, PointGlyph, Refusal, SparklineDirection, SparklineGeometry, SparklineGeometryOptions, SparklineLabelOptions, SparklinePoint, SparklineProps, SparklineValues, StackedBarBucket, StackedBarChartProps, StackedBarSegment, StackedBarSeries, TickOutcome, TimelineLane, TimelineOptions, TimelineSpan, TimelineTick, TimelineViewProps, WaterfallBarProps, WaterfallHeaderProps, WaterfallRowProps, WaterfallSpanGeometry, WaterfallTimeAxisProps, WaterfallWindow, XCategory, YScale, YTarget, YTick };
+export type { BandKind, ChartBand, ChartMark, DotMapLabel, DotMapProps, DotMapRect, Figure, FigureAtWidth, FigureViewProps, FlowWaterfallProps, FlowWaterfallRow, ViewWindow as FlowWaterfallWindow, GapBand, GapProps, LineSeries, MarkKind, MarkVerdict, MarkerShape, MeterSegment, PointFields, PointGlyph, Refusal, SparklineDirection, SparklineGeometry, SparklineGeometryOptions, SparklineLabelOptions, SparklinePoint, SparklineProps, SparklineValues, StackedBarBucket, StackedBarChartProps, StackedBarSegment, StackedBarSeries, TickOutcome, TimelineLane, TimelineOptions, TimelineSpan, TimelineTick, TimelineViewProps, WaterfallBarProps, WaterfallHeaderProps, WaterfallRowProps, WaterfallSpanGeometry, WaterfallTimeAxisProps, WaterfallWindow, XCategory, YScale, YTarget, YTick };

package/dist/react/index.js

@@ -5125,4 +5125,4 @@ function FlowWaterfall({ trace, live, startedAt, label = "Trace waterfall", defa
 	});
 }
 //#endregion
-export { DEFAULT_SPARKLINE_EMPTY_LABEL, DEFAULT_SPARKLINE_HEIGHT, DEFAULT_SPARKLINE_LABEL, DEFAULT_SPARKLINE_UNAVAILABLE_LABEL, DEFAULT_SPARKLINE_WIDTH, DOT_MAP_CATEGORIES, DayBars, DotMap, Events, FigureView, FlowWaterfall, Gantt, Gap, HBars, Histogram, LIVE_SERIES, Lines, Meter, Spark, Sparkline, StackedBarChart, TimelineView, WaterfallBar, WaterfallHeader, WaterfallRow, WaterfallTimeAxis, formatCompact, formatSparklineValue, formatWaterfallDuration, sparklineGeometry, sparklineLabel, sparklinePointsAttribute, sparklineReadings, waterfallSpanGeometry, waterfallTicks };
+export { DEFAULT_SPARKLINE_EMPTY_LABEL, DEFAULT_SPARKLINE_HEIGHT, DEFAULT_SPARKLINE_LABEL, DEFAULT_SPARKLINE_UNAVAILABLE_LABEL, DEFAULT_SPARKLINE_WIDTH, DOT_MAP_CATEGORIES, DayBars, DotMap, Events, FigureView, FlowWaterfall, Gantt, Gap, HBars, Histogram, LIVE_SERIES, Lines, Meter, Spark, Sparkline, StackedBarChart, TimelineView, WaterfallBar, WaterfallHeader, WaterfallRow, WaterfallTimeAxis, criticalPathIds, flowWaterfallRows, formatCompact, formatSparklineValue, formatWaterfallDuration, sparklineGeometry, sparklineLabel, sparklinePointsAttribute, sparklineReadings, waterfallSpanGeometry, waterfallTicks };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/charts",
-  "version": "0.21.16",
+  "version": "0.21.17",
   "description": "Static SVG and HTML figures for benchmarks and operational timing. Draws from producer data and refuses what it cannot draw honestly.",
   "type": "module",
   "license": "MIT",