/** Immutable typed-path counter view exposed to consumers. */
export type TypedPathCounters = Readonly<{
    expensiveTypeCalls: number;
    fallbackInvocations: number;
    prefilterChecks: number;
    prefilterHits: number;
}>;
/**
 * Point-in-time telemetry snapshot grouped by file path.
 */
export type TypedPathTelemetrySnapshot = Readonly<{
    files: readonly Readonly<{
        counters: TypedPathCounters;
        filePath: string;
    }>[];
    totals: Readonly<TypedPathCounters & {
        averageExpensiveCallsPerFileInput: Readonly<{
            expensiveTypeCalls: number;
            fileCount: number;
        }>;
        fallbackInvocationRateInput: Readonly<{
            expensiveTypeCalls: number;
            fallbackInvocations: number;
        }>;
        fileCount: number;
        prefilterHitRateInput: Readonly<{
            prefilterChecks: number;
            prefilterHits: number;
        }>;
    }>;
}>;
/**
 * Record one prefilter evaluation.
 *
 * @param options - Telemetry file key plus whether prefilter short-circuited.
 */
export declare const recordTypedPathPrefilterEvaluation: ({ filePath, prefilterHit, }: Readonly<{
    filePath: null | string | undefined;
    prefilterHit: boolean;
}>) => void;
/**
 * Record one expensive type-resolution invocation.
 */
export declare const recordTypedPathExpensiveTypeCall: (filePath: null | string | undefined) => void;
/**
 * Record one fallback invocation after constrained resolution was unavailable
 * or failed.
 */
export declare const recordTypedPathFallbackInvocation: (filePath: null | string | undefined) => void;
/**
 * Read a deterministic telemetry snapshot for assertions and profiling.
 */
export declare const getTypedPathTelemetrySnapshot: () => TypedPathTelemetrySnapshot;
/**
 * Clear all process-local telemetry counters.
 */
export declare const resetTypedPathTelemetry: () => void;
//# sourceMappingURL=typed-path-telemetry.d.ts.map