import type { IOStream } from "../toolkit/ioStream.js";
import { type offset_t } from "../toolkit/types.js";
export declare class Mp4Atom {
    name: string;
    offset: offset_t;
    length: number;
    headerSize: number;
    children: Mp4Atom[];
    private constructor();
    /** Parse one atom from the current stream position. */
    static parse(stream: IOStream): Promise<Mp4Atom>;
    /**
     * Navigate children by successive names.
     * `find("mdia", "hdlr")` finds child "mdia", then its child "hdlr".
     */
    find(...names: string[]): Mp4Atom | null;
    /** Collect all descendants (optionally recursive) matching `name`. */
    findAll(name: string, recursive?: boolean): Mp4Atom[];
    /**
     * Build a path from this atom through children matching successive names.
     * Returns true if the full path was found.
     */
    path(result: Mp4Atom[], ...names: string[]): boolean;
    addToOffset(delta: number): void;
    prependChild(atom: Mp4Atom): void;
    removeChild(child: Mp4Atom): boolean;
}
export declare class Mp4Atoms {
    atoms: Mp4Atom[];
    private constructor();
    static create(stream: IOStream): Promise<Mp4Atoms>;
    /** Navigate from a root-level atom through successive child names. */
    find(...names: string[]): Mp4Atom | null;
    /** Build atom path from root through child hierarchy. */
    path(...names: string[]): Mp4Atom[];
    /**
     * Validate root-level atoms.  Returns false if moov or moof atoms are
     * invalid.  Trailing garbage after a valid moov is trimmed.
     */
    checkRootLevelAtoms(): boolean;
}
//# sourceMappingURL=mp4Atoms.d.ts.map