/**
 * TAR Parser
 *
 * Parses TAR archives from various input sources.
 * Supports POSIX ustar, GNU tar (long filenames), and PAX extensions.
 */
import type { TarEntryInfo } from "./tar-entry-info.js";
export interface TarParseOptions {
    /** Maximum file size to extract into memory (default: 100MB) */
    maxFileSize?: number;
    /** Abort signal for cancellation */
    signal?: AbortSignal;
}
export interface TarEntry {
    /** Entry metadata */
    info: TarEntryInfo;
    /** Extract entry data as Uint8Array */
    data(): Promise<Uint8Array>;
    /** Extract entry data as string (UTF-8) */
    text(): Promise<string>;
    /** Skip this entry without reading data */
    skip(): Promise<void>;
}
/**
 * Parse TAR archive from Uint8Array
 */
export declare function parseTar(data: Uint8Array, options?: TarParseOptions): TarEntry[];
/**
 * Parse TAR archive from async iterable (streaming)
 */
export declare function parseTarStream(source: AsyncIterable<Uint8Array>, options?: TarParseOptions): AsyncGenerator<TarEntry & {
    data(): Promise<Uint8Array>;
}>;
/**
 * Parse TAR archive and return all entries with their data
 */
export declare function untar(source: Uint8Array | AsyncIterable<Uint8Array>, options?: TarParseOptions): Promise<Map<string, {
    info: TarEntryInfo;
    data: Uint8Array;
}>>;