import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraAnchor,LyraAnchorKind,HighlightActivateDetail,AnchorResultDetail}from'../../viewers/document-viewer/anchors.js';import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import{type LyraAvCue,type LyraAvTrack}from'./av-metadata.js';export type{LyraAvCue,LyraAvTrack}from'./av-metadata.js';export type LyraAvKind='audio'|'video';export type LyraAvPreload='none'|'metadata'|'auto';export interface LyraAvCueChangeDetail{readonly cueId:string|null;readonly index:number;}export interface LyraAvPlayerEventMap{ended:Event;error:Event;loadedmetadata:Event;pause:Event;play:Event;timeupdate:Event;volumechange:Event;'lr-play':CustomEvent<null>;'lr-pause':CustomEvent<null>;'lr-load':CustomEvent<{duration:number;kind:LyraAvKind;}>;'lr-time-change':CustomEvent<{currentTime:number;}>;'lr-rate-change':CustomEvent<{rate:number;}>;'lr-cue-change':CustomEvent<LyraAvCueChangeDetail>;'lr-highlight-activate':CustomEvent<HighlightActivateDetail>;'lr-anchor-result':CustomEvent<AnchorResultDetail>;'lr-search-change':CustomEvent<LyraSearchChangeDetail>;'lr-render-error':CustomEvent<{error:unknown;}>;blur:FocusEvent;focus:FocusEvent;}declare class LyraAvPlayerBase extends LyraElement<LyraAvPlayerEventMap>{}declare const LyraAvPlayer_base:Omit<typeof LyraAvPlayerBase,'prototype'> &(new(...args:ConstructorParameters<typeof LyraAvPlayerBase>)=>InstanceType<typeof LyraAvPlayerBase> &import("../../../lyra.js").LyraAnchorTarget&{renderAnchorLiveRegion():unknown;});
/**
* `<lr-av-player>` — audio/video player built on a native `<audio>`/`<video>` element, plus a cue
* transcript synced to `currentTime`, `time-range` anchor/highlight support, an optional
* dependency-free waveform (peaks in, no in-component decoding), and playback-rate control. Owns
* recorded-media transcript sync; distinct from `<lr-transcript-feed>` (live captions for an
* in-progress voice session) and `<lr-sequence-playback>` (an index stepper over
* `[0, itemCount)` for
* time-series dashboards — no media involved in either).
*
* Adopts `DocumentAnchorTarget` with `anchorKinds: ['time-range']` only. No text selection is bound:
* transcript rows render inside `<lr-virtual-list>`'s own nested shadow root, one boundary deeper
* than the mixin's default selection lookup resolves.
*
* The transcript virtualizes through `<lr-virtual-list>` the same way `pdf-viewer.class.ts`
* virtualizes pages: `items`/`renderItem`/`keyFunction`/`activeItemId` props. Playback follows its
* active cue through `activeItemId`; search navigation reveals its active match through the list's
* `scrollToIndex()` API without seeking the media.
* An authored host `aria-label` remains the aggregate name on the host. Otherwise a nonempty
* `name` labels `[part="base"]` as a region. The native media element keeps the distinct localized
* player-purpose label, avoiding duplicate semantic owners; a bare loaded player uses the native
* media element as its sole named owner.
*
* **RTL behavior:** surrounding controls stay logical, but `[part="timeline"]` is a physical
* elapsed-time axis and remains left-to-right under `dir="rtl"`. ArrowLeft rewinds and ArrowRight
* advances in both text directions.
*
* Waveform canvas painting is visibility-gated: peak, theme, and resize changes while the player
* is off-screen stay dirty and coalesce into one paint on re-entry. Environments without
* `IntersectionObserver` retain eager painting.
*
* @customElement lr-av-player
* @event ended - Relayed native media event; non-bubbling and non-composed.
* @event error - Relayed native media event; non-bubbling and non-composed. The localized
*   `lr-render-error` notification additionally carries the underlying failure detail.
* @event loadedmetadata - Relayed native media event; non-bubbling and non-composed.
* @event pause - Relayed native media event; non-bubbling and non-composed.
* @event play - Relayed native media event; non-bubbling and non-composed.
* @event timeupdate - Relayed native media event; non-bubbling and non-composed.
* @event volumechange - Relayed native media event; non-bubbling and non-composed.
* @event lr-play - Playback started.
* @event lr-pause - Playback paused.
* @event lr-load - Media metadata finished loading. `detail: { duration, kind }`.
* @event lr-time-change - `detail: { currentTime }`, throttled to at most 4/s while playing, plus
*   one extra emission per `seek()` regardless of the throttle window.
* @event lr-rate-change - `detail: { rate }`.
* @event lr-cue-change - The active transcript cue changed. `detail: { cueId, index }`
*   (`cueId:null,index:-1` when none is active).
* @event lr-highlight-activate - A `time-range` highlight marker was activated.
*   `detail: { highlightId }`.
* @event lr-anchor-result - Fired after `anchor` (or a `scrollToAnchor()` call) is applied.
*   `detail: { found }`.
* @event lr-search-change - Fired from `search()`/`searchNext()`/`searchPrevious()`/
*   `clearSearch()`. `detail: { query, matchCount, matchCountExact, activeIndex }`.
*   `matchCountExact` is always `true`: `search()` matches over the already-loaded `cues` array
*   with no additional ceiling.
* @event lr-render-error - Native media failure, unsafe-source rejection, or an internal playback
*   rejection. `detail: { error }`; native `MediaError` identity is preserved.
* @event {FocusEvent} focus - Relayed once from the native media element as a bubbling, composed
*   native event.
* @event {FocusEvent} blur - Relayed once from the native media element as a bubbling, composed
*   native event.
* @csspart base - The root wrapper.
* @csspart media - The native `<audio>`/`<video>` element.
* @csspart toolbar - The playback-rate control row.
* @csspart rate-select - The playback-rate `<select>`.
* @csspart timeline - The waveform canvas or plain seek rail; click-to-seek and arrow-key seeking.
*   It is disabled and removed from sequential focus until duration is positive.
* @csspart timeline-marker - One clickable marker per `time-range` highlight (`data-tone`,
*   `data-active`).
* @csspart transcript - The virtualized cue list (`<lr-virtual-list>` itself).
* @csspart cue - One transcript row (`aria-current`, `data-match`, `data-active-match`).
* @csspart cue-current - Added alongside `cue` on the row the playhead is inside. A second part
*   name rather than an attribute selector, because Shadow Parts forbids an attribute selector
*   after `::part()`.
* @csspart cue-match - Added alongside `cue` on every row matching the current search query.
* @csspart cue-active-match - Added alongside `cue`/`cue-match` on the row holding the current
*   search match.
* @csspart cue-time - A cue's timestamp label.
* @csspart cue-speaker - A cue's speaker label.
* @csspart cue-text - A cue's text.
* @csspart error - Ordinary visible failure text. Fresh post-mount media/source failures append
*   the localized message to the shared light-DOM assertive announcement sink; an already-unsafe
*   initial `src` renders visibly without interrupting on mount.
* @cssprop [--lr-av-player-transcript-height=var(--lr-size-16rem)] - Block size of the
*   virtualized transcript list.
* @cssprop [--lr-av-player-marker-active-color=var(--lr-color-brand)] - Outline color of the
*   `[part="timeline-marker"]` matching `activeHighlightId`.
* @cssprop [--lr-av-player-marker-bg=color-mix(in srgb, var(--lr-color-brand) 35%, transparent)] -
*   Background of a `[part="timeline-marker"]` with no (or an unrecognized) `data-tone`.
* @cssprop [--lr-av-player-marker-success-bg=color-mix(in srgb, var(--lr-color-success) 35%, transparent)] -
*   Background of a `[part="timeline-marker"][data-tone="success"]`.
* @cssprop [--lr-av-player-marker-warning-bg=color-mix(in srgb, var(--lr-color-warning) 35%, transparent)] -
*   Background of a `[part="timeline-marker"][data-tone="warning"]`.
* @cssprop [--lr-av-player-marker-danger-bg=color-mix(in srgb, var(--lr-color-danger) 35%, transparent)] -
*   Background of a `[part="timeline-marker"][data-tone="danger"]`.
* @cssprop [--lr-av-player-marker-neutral-bg=color-mix(in srgb, var(--lr-color-text) 25%, transparent)] -
*   Background of a `[part="timeline-marker"][data-tone="neutral"]`.
* @cssprop --lr-av-player-marker-fill - The resting fill a `[part="timeline-marker"]` actually
*   renders, resolved per tone from the `--lr-av-player-marker-*-bg` knobs above. Its hover and
*   pressed states are colour mixes taken from this value, so setting it directly retints all
*   three at once for one marker; retint a whole tone through the `-bg` knob instead.
* @cssprop [--lr-av-player-cue-hover-bg=var(--lr-color-brand-quiet)] - Background of a hovered
*   `[part="cue"]`. The pressed state mixes further from this same value rather than a separate
*   knob, so retuning it keeps its pressed step too.
* @cssprop [--lr-av-player-cue-current-bg=var(--lr-color-brand-quiet)] - Background of the
*   `[part="cue"]` the playhead is currently inside.
* @cssprop [--lr-av-player-cue-active-match-color=var(--lr-color-warning)] - Outline color of the
*   `[part="cue"]` holding the current search match, leaving the other matches' dashed outline on
*   the shared warning token.
* @status stable
* @since 4.0.0
*/
export declare class LyraAvPlayer extends LyraAvPlayer_base{static styles:import("lit").CSSResultGroup[];static properties:{playbackRate:{type:NumberConstructor;attribute:string;reflect:boolean;noAccessor:boolean;};volume:{type:NumberConstructor;reflect:boolean;noAccessor:boolean;};};
/** Media URL; validated with `safeMediaSrc` before it ever reaches the `<audio>`/`<video>` `src`. */
src:string;
/** Accessible name of the stable `[part="base"]` region and of the native `[part="media"]`
*  element (the actual keyboard tab stop, which would otherwise be nameless); a host
*  `aria-label` wins, then the localized `avPlayerLabel` fallback. */
name:string;
/** Forces exact `audio`/`video` rendering, overriding the `mime-type`-based auto-detection.
*  Unrecognized runtime or attribute values continue MIME auto-detection. */
kind?:LyraAvKind;
/** Drives auto-detection: an `audio/*` mime type renders `<audio>`; anything else renders
*  `<video>`. Ignored once `kind` is set explicitly. Attribute removal is consumed as an absent hint. */
mimeType:string;
/** Poster image for `<video>`; validated with `safeMediaSrc` and omitted when unsafe. Ignored for
*  `<audio>`. */
poster:string;loop:boolean;muted:boolean;preload:LyraAvPreload;private _playbackRate;private _volume;
/** Playback-rate multiplier, reflected to the native media element. Clamped to
*  `[MIN_PLAYBACK_RATE, MAX_PLAYBACK_RATE]` -- a non-finite or wildly out-of-range assignment
*  (e.g. a bad computed value) self-heals rather than reaching `HTMLMediaElement.playbackRate`
*  unsanitized. */
get playbackRate():number;set playbackRate(next:number);
/** Native volume on the canonical `0..1` scale. Native `volumechange` updates this property, and
* direct property writes update the current media generation without feedback duplicates. */
get volume():number;set volume(next:number);private _rates;
/** Selectable rates offered by `[part="rate-select"]`; snapshotted, deduplicated, bounded to 32. */
get rates():readonly number[];set rates(value:readonly number[]);private _cues;private nextCueStarts;
/** Transcript entries, rendered as a virtualized, `currentTime`-synced list. Valid nonempty
* `cueId` values are unique; the first occurrence wins. Inputs are bounded, cloned, and frozen.
* Omitted ends use indexed next chronological starts; seeks reconcile in linear work. */
get cues():readonly LyraAvCue[];set cues(value:readonly LyraAvCue[]);private _peaks;
/** Normalized `0..1` waveform amplitude samples. Empty renders a plain seek rail instead of a
*  canvas -- this component never decodes audio itself. */
get peaks():readonly number[];set peaks(value:readonly number[]);private _tracks;
/** Native `<track>` sources (subtitles/captions/descriptions), bounded and snapshotted. */
get tracks():readonly LyraAvTrack[];set tracks(value:readonly LyraAvTrack[]);
/** From `DocumentAnchorTarget` — only `time-range` anchors resolve here. */
readonly anchorKinds:readonly LyraAnchorKind[];private duration;private currentTimeState;private activeCueId;private activeCueIndex;private searchQuery;private searchMatches;private activeSearchIndex;private metadataLoaded;private sourceError;private playbackError;private canvasEl?;private readonly mediaController;private readonly semanticInternals;private lastTimeChangeAt;private searchLocale;private transcriptLocale;private searchMatchIndices;private cueKeys;private errorAnnouncementSink?;private resizeWindow?;private waveformResizeObserver?;private waveformResizeObserverWindow?;private waveformResizeTarget?;private waveformIntersectionObserver?;private waveformObserverWindow?;private waveformDetachedObserverWindow?;private waveformDrawFrame?;private waveformVisible;private waveformDirty;private lastWaveformAllocation?;private pendingSeekEmission;private lastEmittedTime;private lastReportedSourceError;
/** A connection begins from state, not from a publicly observable source transition. */
private connectionEventBaselinePending;constructor();private get mediaEl();
/** Focus the native `[part="media"]` element — it carries `controls`, so it is this component's
*  primary focusable affordance. */
focus(options?:FocusOptions):void;
/** Blur the native `[part="media"]` element. */
blur():void;
/** Activate the native `[part="media"]` element, so a host-level `.click()` is not a silent
*  no-op. */
click():void;private onMediaFocus;private onMediaBlur;
/** Live playback position: the media element's own `currentTime` once mounted, else the last
*  locally-tracked value (e.g. a `seek()` issued before metadata loaded). */
get currentTime():number;set currentTime(value:number);private detectedKind;private get effectivePreload();protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;connectedCallback():void;firstUpdated(changed:PropertyValues):void;disconnectedCallback():void;adoptedCallback():void;private syncErrorAnnouncementSink;private releaseErrorAnnouncementSink;private announceRenderError;private bindResizeWindow;private unbindResizeWindow;
/** Binds canvas visibility to the document currently owning this element. */
private syncWaveformVisibilityObserver;private unbindWaveformVisibilityObserver;private onWindowResize;private syncWaveformResizeObserver;private unbindWaveformResizeObserver;private canvasRef;private mediaRef;
/** Proxies the native media element's `play()` and preserves its promise/rejection. Resolves
*  immediately before the element mounts. */
play():Promise<void>;
/** Proxies the native media element's `pause()`. A no-op before the element mounts. */
pause():void;
/** Plays if paused, pauses if playing. A no-op before the element mounts. */
toggle():void;
/** Sets `currentTime` and forces an immediate `lr-time-change`, bypassing the playing-time throttle. */
seek(seconds:number):void;protected applyAnchor(anchor:LyraAnchor):Promise<boolean>;private onLoadedMetadata;private onPlay;private onPause;private onMediaError;private onNativeMediaEvent;private onPlaybackFailure;private emitTimeChange;private onTimeUpdate;private reconcileActiveCue;private setActiveCue;private onSeeked;
/** Case-insensitive substring match over cue text and speaker. Reveals the active matching
*  transcript row without changing media playback, then resolves the match count. */
search(query:string):Promise<number>;private reconcileSearchMatches;
/** Advances to the next match, wrapping to the first after the last and revealing it. Resolves
*  `true` once the active match moved, `false` when there are no matches -- the shape the shared
*  `LyraTextViewerTarget` search contract declares, so a find-in-page host can drive every
*  searchable component through one typed surface. */
searchNext():Promise<boolean>;
/** Moves to the previous match, wrapping to the last before the first and revealing it. Resolves
*  `true` once the active match moved, `false` when there are no matches. */
searchPrevious():Promise<boolean>;
/** Clears the query, matches, and active index, and emits a zero-match `lr-search-change`. */
clearSearch():void;private emitSearchChange;private revealActiveSearchMatch;private drawWaveform;
/** Paints once the visibility gate has confirmed that waveform work is useful. */
private paintWaveform;
/** Coalesces the one deferred paint when an off-screen waveform returns to view. */
private scheduleWaveformDraw;private cancelWaveformDrawFrame;private onHighlightActivate;private renderMarkers;private onTimelineClick;private onTimelineKeyDown;
/** `[part="rate-select"]`'s `<option>` values -- `rates`, plus the current `playbackRate` spliced
*  in (numerically sorted) when it isn't already one of them. A native `<select>` shows its first
*  option whenever no `<option>` carries `selected` at all, so a `playbackRate` set outside the
*  offered `rates` list (a caller-driven value, or a rate offered by an earlier `rates` array that
*  has since been narrowed) would otherwise display a rate that doesn't match `playbackRate`. */
private rateOptions;private safeCueStart;private safeCueEnd;private rebuildCueKeys;private cueKey;private renderCue;private transcriptRenderItem;private refreshTranscriptRenderItem;private renderTracks;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-av-player':LyraAvPlayer;}}