import type { IndexingDiagnostic, IndexingOutcomeStatus, IndexingReasonCode } from '../../contracts/indexing.js';
import type { ExtractionEdge, ExtractionNode } from '../../contracts/types.js';
import { type CapabilityRegistry } from '../../infrastructure/capabilities.js';
import { type FileTypeValue } from '../detect.js';
import type { ExtractionStageObserver } from './pipeline.js';
export interface ExtractionFragment {
    nodes: ExtractionNode[];
    edges: ExtractionEdge[];
    diagnostics?: IndexingDiagnostic[];
}
export interface ExtractionFileOutcome {
    filePath: string;
    status: Extract<IndexingOutcomeStatus, 'indexed' | 'indexed_with_warnings' | 'unsupported' | 'failed'>;
    reason: Extract<IndexingReasonCode, 'indexed' | 'indexed_from_cache' | 'parser_fallback' | 'empty_extraction' | 'capability_missing' | 'extractor_error'>;
    capability: string | null;
    diagnostics?: IndexingDiagnostic[];
}
export interface ExtractionDispatchResult {
    fragment: ExtractionFragment;
    outcome: ExtractionFileOutcome;
}
export interface ExtractionCapabilitySelection {
    sourceFileType: FileTypeValue | null;
    capability: ReturnType<CapabilityRegistry['resolveExtractorForPath']>;
}
export interface StagedExtractionFragment {
    fragment: ExtractionFragment;
    augmentFramework: () => ExtractionFragment;
}
export type ExtractorHandlerOutput = ExtractionFragment | StagedExtractionFragment;
export type ExtractorHandler = (filePath: string, allowedTargets: ReadonlySet<string>) => ExtractionFragment;
export type PipelineExtractorHandler = (filePath: string, allowedTargets: ReadonlySet<string>) => ExtractorHandlerOutput;
export type ExtractorHandlerMap = Readonly<Record<string, ExtractorHandler>>;
export type PipelineExtractorHandlerMap = Readonly<Record<string, PipelineExtractorHandler>>;
export interface SingleFileExtractionDependencies {
    registry?: CapabilityRegistry;
    readCached?: (filePath: string) => ExtractionFragment | null | undefined;
    writeCached?: (filePath: string, extraction: ExtractionFragment) => void;
    classifySourceFile?: (filePath: string) => FileTypeValue | null;
    onOutcome?: (outcome: ExtractionFileOutcome) => void;
    onStageDiagnostic?: ExtractionStageObserver;
    recoverFailures?: boolean;
}
export declare const selectExtractionCapability: (filePath: string, dependencies?: Pick<SingleFileExtractionDependencies, "registry" | "classifySourceFile">) => ExtractionCapabilitySelection;
export declare function dispatchSingleFileExtractionWithOutcome(filePath: string, allowedTargets: ReadonlySet<string>, handlers: PipelineExtractorHandlerMap, dependencies?: SingleFileExtractionDependencies): ExtractionDispatchResult;
export declare function dispatchSingleFileExtraction(filePath: string, allowedTargets: ReadonlySet<string>, handlers: PipelineExtractorHandlerMap, dependencies?: SingleFileExtractionDependencies): ExtractionFragment;