import type { FileLoadMeta } from '../io';
import { type ParseProgress, type TrajectorySource } from '../trajectory';
import type { ParseResult, TrajectoryLoadOptions } from './parse';
export interface MaterialPayload extends Partial<FileLoadMeta> {
    data: TrajectorySource;
    filename: string;
    is_base64?: boolean;
}
export type MaterialSource = string | URL | File | MaterialPayload;
export interface MaterialProvenance extends FileLoadMeta {
    filename: string;
    file_size: number;
}
export type OpenedMaterial = ParseResult & {
    provenance: Readonly<MaterialProvenance>;
    dispose: () => void;
};
export interface OpenMaterialOptions extends TrajectoryLoadOptions {
    signal?: AbortSignal;
    on_progress?: (progress: ParseProgress) => void;
    on_acquired?: (payload: MaterialPayload) => void;
}
export declare class MaterialOpenError extends Error {
    readonly stage: `acquire` | `parse`;
    readonly provenance: Partial<MaterialProvenance>;
    constructor(message: string, stage: `acquire` | `parse`, provenance: Partial<MaterialProvenance>, options?: ErrorOptions);
}
export declare const source_provenance: (source: MaterialSource) => Partial<MaterialProvenance>;
export declare const acquire_material: (source: MaterialSource, signal?: AbortSignal) => Promise<MaterialPayload>;
export declare function open_material(source: MaterialSource, options?: OpenMaterialOptions): Promise<OpenedMaterial>;