/**
 * voice-bubble.ts — vanilla render shell over @oxpulse/voice-core's headless
 * player + static waveform renderer.
 *
 * Replaces the bare `<audio controls>` the widget previously rendered for
 * audio attachments (message-list.ts) and the native `<audio>` preview in the
 * composer. The shell OWNS the `<audio>` element (ADR-3: constructor-injection
 * — the shell creates/mounts/a11y, the controller reads/writes the ref) and
 * wires the player's `source` to the widget's EXISTING authenticated blob
 * loader (`hydrateMediaSrc` contract: hydrate(url, signal) → Blob). The player
 * never sees a raw attachment URL on the authed path — `source.load()` fetches
 * through hydrate, mints the objectURL, and hands the URL back to the player,
 * which sets `audio.src` and revokes it on `destroy()`.
 *
 * The widget supplies its OWN WaveformTheme built from its tokens (active from
 * `--oxp-accent`, inactive from `--oxp-waveform-inactive` — a WCAG 1.4.11
 * audited token with separate light/dark values) — voice-core's app-neutral
 * defaultWaveformTheme is deliberately NOT used so the waveform matches the
 * brand accent, not a generic currentColor.
 *
 * Blob-URL lifecycle (issue #67/#77/#82/#88 leak class): the objectURL the
 * `load` adapter mints is tracked via `trackObjectUrl` (so the widget's
 * eviction/destroy backstop can revoke it if the bubble's own destroy() is
 * missed) AND the player's `destroy()` revokes the URL it set as `audio.src`.
 * The caller MUST call `destroy()` on row eviction + widget destroy; double
 * revoke is idempotent.
 */
import { type Locale } from '../utils/i18n.js';
import type { AttachmentMeta } from '../utils/attachments.js';
export interface VoiceBubbleOptions {
    /** The attachment metadata (url, mime, durationMs, peaks). */
    readonly att: AttachmentMeta;
    /** Authenticated blob loader — the GET /api/sdk/attachments/{id} route is
     *  JWT-authenticated. When present, the player sources audio through it
     *  (NEVER a raw attachment URL). When absent, falls back to the direct URL
     *  (test/mock environments — mirrors hydrateMediaSrc's no-hydrate branch). */
    readonly hydrate?: (url: string, signal?: AbortSignal) => Promise<Blob>;
    /** In-memory Blob source — used by the composer voice preview where the
     *  recording is already in memory (no fetch needed). The headless player
     *  creates + owns the objectURL from the Blob directly and revokes it on
     *  destroy(). Takes precedence over hydrate/att.url when present. */
    readonly blob?: Blob;
    /** Records any blob: URL the load adapter mints, so the widget's
     *  eviction/destroy backstop can revoke it. */
    readonly trackObjectUrl?: (url: string) => void;
    /** Abort signal — aborts an in-flight hydrate before .src is set. */
    readonly signal?: AbortSignal;
    /** Locale for i18n ARIA strings (play/pause/speed/waveform/error). */
    readonly lang: Locale;
}
export interface VoiceBubble {
    /** The wrapper element to append into the bubble. */
    readonly el: HTMLElement;
    /** Tear down: destroy the player (revokes its objectURL) + null handlers.
     *  Idempotent. MUST be called on row eviction + widget destroy. */
    destroy(): void;
}
/** Resolve a CSS custom property from the canvas's computed style, falling
 *  back to the shadow host's computed style (the token is defined on :host).
 *  Returns '' when unavailable (jsdom / overridden tokens). Canvas2D fillStyle
 *  does not resolve CSS custom properties, so the live computed value is read
 *  here. */
export declare function resolveToken(el: HTMLElement, token: string): string;
/** Build a vanilla VoiceBubble over the headless player + static waveform. */
export declare function createVoiceBubble(opts: VoiceBubbleOptions): VoiceBubble;
/** Exported so tests can assert the speed cycle without importing voice-core's
 *  internal ordering. Matches VOICE_SPEEDS. */
export declare const VOICE_BUBBLE_SPEEDS: readonly [1, 1.5, 2];
//# sourceMappingURL=voice-bubble.d.ts.map