import { RationalTime } from "@techsquidtv/canvas-timeline-utils";
import { Clip, TimelineReadonly, Track } from "@techsquidtv/canvas-timeline-core";
//#region src/accessibility.d.ts
/**
 * Options for formatting a single timeline time value for assistive technology.
 */
interface TimelineTimeValueFormatOptions {
  /** Decimal places to keep for sub-second values. Defaults to 2. */
  precision?: number;
}
/**
 * Options for formatting a timeline start/end range for assistive technology.
 */
interface TimelineRangeValueFormatOptions extends TimelineTimeValueFormatOptions {
  /** Whether to include the computed range duration. Defaults to false. */
  includeDuration?: boolean;
}
/**
 * Formats a timeline time for assistive technology.
 *
 * The result intentionally avoids timecode punctuation and raw floating point
 * artifacts so controls can use it as `aria-valuetext`.
 *
 * @param value - Timeline time to format, as rational time or decimal seconds.
 * @param options - Optional decimal precision for the spoken time value.
 */
declare function formatTimelineTimeValue(value: RationalTime | number | undefined, options?: TimelineTimeValueFormatOptions): string;
/**
 * Formats a start/end timeline range for assistive technology.
 *
 * @param start - Range start time, as rational time or decimal seconds.
 * @param end - Range end time, as rational time or decimal seconds.
 * @param options - Optional precision and duration display settings.
 */
declare function formatTimelineRangeValue(start: RationalTime | number | undefined, end: RationalTime | number | undefined, options?: TimelineRangeValueFormatOptions): string;
/**
 * Returns a concise clip name suitable for labels or active-item summaries.
 *
 * @param clip - Timeline clip to describe.
 * @param track - Optional track containing the clip.
 * @template TrackKind - App-defined track kind values carried by the containing
 * track.
 * @returns Short label suitable for `aria-label`, active-descendant text, or
 * inspector headings.
 */
declare function getClipAccessibleName<TrackKind = string>(clip: TimelineReadonly<Clip>, track?: TimelineReadonly<Track<TrackKind>>): string;
/**
 * Returns a richer clip description without requiring one DOM node per clip.
 *
 * @param clip - Timeline clip whose timing and edit state should be described.
 * @param track - Optional track containing the clip.
 * @template TrackKind - App-defined track kind values carried by the containing
 * track.
 * @returns Spoken description with timing, duration, and relevant edit-state
 * flags.
 */
declare function getClipAccessibleDescription<TrackKind = string>(clip: TimelineReadonly<Clip>, track?: TimelineReadonly<Track<TrackKind>>): string;
//#endregion
export { TimelineRangeValueFormatOptions, TimelineTimeValueFormatOptions, formatTimelineRangeValue, formatTimelineTimeValue, getClipAccessibleDescription, getClipAccessibleName };
//# sourceMappingURL=accessibility.d.mts.map