import type { DatasetSpec, FileSpec } from '../schema/types.js';
import { type TagContext } from '../syntheticFixtures/tagTemplate.js';
import type { UidSet } from '../syntheticFixtures/uid.js';
export type GeneratedFile = {
    filename: string;
    relativePath: string;
    buffer: Uint8Array;
    type: FileSpec['type'];
    index: number;
};
export declare function resolveUid(salt: string | undefined, index: number, override?: Partial<UidSet>): UidSet;
export declare function effectiveSalt(spec: {
    uidSalt?: string;
    seed?: number;
}): string | undefined;
export declare function generateFile(spec: FileSpec, options?: {
    index?: number;
    seed?: number;
    uidSalt?: string;
    padWidth?: number;
    uid?: Partial<UidSet>;
    context?: Partial<TagContext>;
}): Promise<GeneratedFile>;
export declare function withResolvedSeed(spec: DatasetSpec): DatasetSpec;
export declare function withResolvedSalt(spec: DatasetSpec): DatasetSpec;
export type FilePlan = {
    fileSpec: FileSpec;
    index: number;
    uidOverride?: Partial<UidSet>;
    context: TagContext;
    filename: string;
    relativePath: string;
};
export declare function planCollection(spec: DatasetSpec): Generator<FilePlan>;
export declare function materialisePlan(plan: FilePlan, salt: string | undefined): Promise<GeneratedFile>;
export declare function generateCollectionFromSpec(spec: DatasetSpec): AsyncGenerator<GeneratedFile>;
export type CollectionPreviewItem = {
    relativePath: string;
    type: FileSpec['type'];
    index: number;
    approxBytes: number;
};
export declare function previewCollection(spec: DatasetSpec): AsyncGenerator<CollectionPreviewItem>;