import type { Sample } from '../types/index.js';
import { type LoadSamplesResult } from './load-samples.js';
export declare function parseSampleDocument(filePath: string): unknown;
export declare function getSamplesArray(document: unknown, filePath: string): Sample[];
export declare function stringifySampleDocument(filePath: string, document: unknown): string;
/**
 * Persist only changed samples back to the source file that originally owned each
 * sample_id. JSON/YAML and array/wrapper shapes are retained, including `requires`
 * and any other wrapper metadata.
 */
export declare function writeFixedSamplesToSources(loaded: Pick<LoadSamplesResult, 'sourceFiles' | 'sampleSourceById'>, samples: Sample[], changedIds: ReadonlySet<string>): string[];