type TestLayer = 'contract' | 'unit' | 'integration' | 'e2e' | 'api' | 'ui' | 'data' | 'cli';
type TestMode = 'mock' | 'live' | 'hybrid';
interface TestEnvBase<TMode extends TestMode = TestMode> {
    mode: TMode;
    stop: () => Promise<void>;
}
interface SpecCase {
    id: string;
    observation: string;
    given: string;
    when: string;
    then: string;
    priority: 'P0' | 'P1' | 'P2' | 'P3';
    automation: 'yes' | 'no' | 'manual';
    mode?: TestMode;
    route?: string;
    notes?: string;
}
interface SpecDoc {
    module: string;
    layer: TestLayer;
    cases: SpecCase[];
    raw: string;
    warnings: string[];
}
interface Lease<T> {
    value: T;
    release: () => Promise<void>;
}
interface Pool<T> {
    size: number;
    borrow: () => Promise<Lease<T>>;
    stopAll: () => Promise<void>;
}

interface ParseOptions {
    module?: string;
    defaultLayer?: TestLayer;
}
declare function parseSpec(markdown: string, opts?: ParseOptions): SpecDoc;

interface PoolFactoryOptions<T> {
    size: number;
    acquire: () => Promise<T>;
    reset?: (value: T) => Promise<void>;
    release?: (value: T) => Promise<void>;
}
declare function createPool<T>(opts: PoolFactoryOptions<T>): Promise<Pool<T>>;

export { type Lease, type ParseOptions, type Pool, type PoolFactoryOptions, type SpecCase, type SpecDoc, type TestEnvBase, type TestLayer, type TestMode, createPool, parseSpec };