import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import{type LyraSpan}from'../trace-tree/span.js';export type{LyraSpan}from'../trace-tree/span.js';export interface LyraSpanWaterfallEventMap{'lr-span-select':CustomEvent<{spanId:string;}>;}
/**
* `<lr-span-waterfall>` — the horizontal-timeline projection of the same
* `LyraSpan[]` `<lr-trace-tree>` consumes: a time axis, one row per span
* in start order, status-toned bars (Langfuse timeline / Temporal
* event-history style).
*
* Public collection properties take bounded readonly snapshots. `spans` keeps admitted item
* identities only long enough for the shared descriptor-safe projection to copy its closed
* display schema; later rendering never re-reads an admitted source row. Create a new collection
* and reassign it after changes; mutating the assigned array does not update the view.
*
* The time axis always scales to the whole trace, including spans the 500-row ceiling drops, so a
* truncated tail never stretches the surviving bars across the track.
*
* @customElement lr-span-waterfall
* @event lr-span-select - `detail: { spanId }` — a bar/row was activated (click, Enter, Space).
* @csspart base - The root wrapper.
* @csspart axis - The time-ruler row, hidden when `hideAxis`.
* @csspart tick - One axis tick mark.
* @csspart tick-label - An axis tick's formatted duration label.
* @csspart row - One span's row.
* @csspart name - The span's name (the row's name gutter).
* @csspart bar-track - The bar's positioning track.
* @csspart bar - The interactive, focusable status-toned bar (`role` via `<button>`), with the
*   shared `--lr-icon-button-size` minimum target in both axes even when its duration would paint
*   more narrowly.
* @csspart meta - Secondary row info (status/duration), shown inline under 480px.
* @csspart status-text - The visible status label.
* @csspart duration - The formatted duration text.
* @csspart empty - The empty-state message shown when `spans` is empty.
* @csspart limit - Localized notice shown when the shared 500-span projection ceiling is reached.
* @csspart live-region - The internal focus/status-announcement live region.
* @cssprop [--lr-span-waterfall-name-width=8rem] - Width of the name gutter column.
* @cssprop [--lr-span-waterfall-stripe-speed=var(--lr-duration-ambient)] - Animation duration for a
*   `running` span's striped bar. The fallback is the bare-duration `--lr-duration-ambient`, not the
*   `--lr-transition-ambient` duration+easing shorthand, which would be invalid in an
*   `animation-duration` slot.
* @cssprop [--lr-span-waterfall-row-active-bg=var(--lr-color-brand-quiet)] - Background of the active
*   (`activeSpanId`) row. Shadow Parts forbids an attribute selector after `::part()`, so the active
*   row could otherwise only be restyled by hijacking the library-wide `--lr-color-brand-quiet` token.
* @cssprop [--lr-span-waterfall-success-color=var(--lr-color-success)] - Success bar fill.
* @cssprop [--lr-span-waterfall-error-color=var(--lr-color-danger)] - Error bar fill.
* @cssprop [--lr-span-waterfall-denied-color=var(--lr-color-warning)] - Denied bar fill.
* @cssprop [--lr-span-waterfall-running-color=var(--lr-color-brand)] - Running stripe foreground.
* @cssprop [--lr-span-waterfall-running-stripe-color=var(--lr-color-brand-quiet)] - Running stripe background.
* @cssprop [--lr-span-waterfall-pending-border-color=var(--lr-color-border-strong)] - Pending bar border.
* @status stable
* @since 4.0.0
*/
export declare class LyraSpanWaterfall extends LyraElement<LyraSpanWaterfallEventMap>{protected static readonly ownedCollectionProperties:readonly string[];
/** Span sources can carry opaque provider metadata; the shared normalizer copies only its closed
* display schema once, so cloning each whole source record would both lose opaque identity and
* create an unsafe second traversal. */
protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];
/** Identical contract to `<lr-trace-tree>.spans`; rows sort by `startMs` (ties keep array order).
*  The controlled `activeSpanId` reserves a position inside the shared 500-row ceiling. Foreign
*  runtime `kind`/`status` values normalize to `'other'`/`'pending'` before rendering. */
spans:readonly LyraSpan[];activeSpanId:string|null;
/** Visible time window in trace-relative ms (same non-negative, trace-relative vocabulary as
*  `LyraSpan.startMs`/`endMs` -- never a wall-clock timestamp). Both `null` (the default) fits
*  the whole trace; a non-null NaN (e.g. an unparsable attribute) is normalized the same way as
*  `null` by `viewWindow()` rather than poisoning the axis/bar math with NaN. */
viewStartMs:number|null;viewEndMs:number|null;hideAxis:boolean;label:string;private focusedId;private sortedSource?;private sortedActiveSpanId;private sortedCache;private sortedCacheTruncated;
/** Trace extent measured before the projection cap, so a truncated tail cannot shrink the axis. */
private sortedCacheExtentEndMs;private limitAnnouncementSink?;private limitAnnouncementInitialized;private previouslyTruncated;private liveRegion?;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private syncLimitAnnouncementSink;private sortedSpans;private viewWindow;private barGeometry;private formatDuration;private projectionLimitText;private focusRow;private announceFocus;private selectRow;private onKeyDown;protected willUpdate(changed:PropertyValues):void;private renderedBarById;protected updated(changed:PropertyValues):void;private renderAxis;private renderRow;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-span-waterfall':LyraSpanWaterfall;}}