import { type CaptionSrtFields, type EntityCaptionUrls } from './captions-url';
export interface CaptionsApi {
    /** Both track URLs from an entity row's SRT columns (presence-gated). */
    forEntity: (entityType: string, entity: CaptionSrtFields | null | undefined) => EntityCaptionUrls;
    /** Both track URLs from entity identity alone (no SRT knowledge — chat cards). */
    forEntityId: (entityType: string, entityId: string | number) => Required<EntityCaptionUrls>;
    /** Rebase an already-built relative `/api/captions/...` URL onto the host base. */
    rebase: <T extends string | null | undefined>(url: T) => T | string;
}
export declare function useCaptions(): CaptionsApi;
//# sourceMappingURL=use-captions.d.ts.map