/**
 * Minimum aws-cdk-lib version that emits Box-style traces:
 * - per-stack metadata sidecar (`additionalMetadataFile`)
 * - `aws:cdk:propertyAssignment` entries with per-property stackTraces
 * - `aws:cdk:creationStack` (replacing `aws:cdk:cloudformation:stack-trace`)
 *
 * Below this version cdk-insights still works, but findings on deferred
 * properties fall back to the construct's creation site.
 */
export declare const BOX_TRACE_MIN_VERSION = "2.252.0";
export type CdkVersionInfo = {
    /** Resolved aws-cdk-lib version, or null when it can't be detected. */
    version: string | null;
    /** True when version >= BOX_TRACE_MIN_VERSION. False when older or unknown. */
    supportsBoxTraces: boolean;
};
/** Compares semver `x.y.z` strings. Pre-release suffixes are ignored. */
export declare const compareSemver: (a: string, b: string) => number;
/**
 * Resolves the aws-cdk-lib version from the user's project (CWD), not from
 * cdk-insights' own dev dependencies. Memoised per process+cwd so the
 * filesystem lookup happens once per analyse run.
 *
 * `cwdOverride` exists for tests; production callers should omit it.
 */
export declare const detectCdkVersion: (cwdOverride?: string) => CdkVersionInfo;
/** Test-only: drops the memoised result so each test starts fresh. */
export declare const __resetDetectCdkVersionCache: () => void;