import type { InvalidEntry } from '../wal.js';
import type { TraceEvent, TraceMetadata } from './trace-file.type.js';
export declare function generateTraceContent(events: TraceEvent[], metadata?: Partial<TraceMetadata>): string;
/**
 * Codec for encoding and decoding trace events.
 * Encodes nested objects in args.detail and args.data.detail to JSON strings for storage.
 */
export declare const traceEventCodec: {
    encode: (event: TraceEvent) => string;
    decode: (json: string) => TraceEvent;
};
/**
 * Creates a WAL (Write-Ahead Logging) format configuration for Chrome DevTools trace files.
 * Automatically finalizes shards into complete trace files with proper metadata and margin events.
 * @returns WalFormat configuration object with baseName, codec, extensions, and finalizer
 */
export declare function traceEventWalFormat(): {
    baseName: string;
    walExtension: string;
    finalExtension: string;
    codec: {
        encode: (event: TraceEvent) => string;
        decode: (json: string) => TraceEvent;
    };
    finalizer: (records: (TraceEvent | InvalidEntry)[], metadata?: Record<string, unknown>) => string;
};