/**
 * Helpers to classify Vite / esbuild stderr and emit logs that are easy to facet in Datadog
 * (stable tokens: sdk_dev_server_vite_error, category=module_resolve, unresolved_specifier=...).
 */
/** Maximum characters of raw Vite/esbuild output stored on the error meta stack field. */
export declare const VITE_ERROR_RAW_LOG_MAX_CHARS = 12000;
type ViteBuildErrorDiagnostic = {
    category: "module_resolve";
    /** Package specifier esbuild could not resolve, when detected. */
    unresolvedSpecifier: string;
} | {
    category: "optimize_deps" | "unknown";
    unresolvedSpecifier?: undefined;
};
type BuildViteBuildErrorLogDeps = {
    diagnose: typeof diagnoseViteBuildLogMessage;
    formatSummary: typeof formatViteBuildErrorLogSummary;
    errorKind: typeof viteErrorKindForDiagnostic;
    truncate: typeof truncateViteRawLog;
};
type BuildViteBuildErrorLogParams = {
    rawMessage: string;
    sdkVersion: string;
    viteRootBasename: string;
};
/**
 * Best-effort parse of Vite/esbuild multi-line error text (optimizeDeps, build, etc.).
 */
export declare function diagnoseViteBuildLogMessage(msg: string): ViteBuildErrorDiagnostic;
/**
 * The @superblocksteam/library version actually installed in the app, which
 * can lag the version package.json asks for when the install after a version
 * sync was skipped or failed. `unset` when it is not installed.
 */
export declare function readInstalledLibraryVersion(appRoot: string): string;
export declare function formatViteDevServerStartedLog(params: {
    sdkVersion: string;
    viteRootBasename: string;
    installedLibraryVersion: string;
}): string;
export declare function formatViteBuildErrorLogSummary(params: {
    diagnostic: ViteBuildErrorDiagnostic;
    sdkVersion: string;
    viteRootBasename: string;
}): string;
export declare function viteErrorKindForDiagnostic(diagnostic: ViteBuildErrorDiagnostic): string;
export declare function truncateViteRawLog(msg: string): string;
export declare function buildViteBuildErrorLog(params: BuildViteBuildErrorLogParams, overrides?: Partial<BuildViteBuildErrorLogDeps>): {
    error: {
        kind: string;
        message: string;
        stack: string;
    };
    message: string;
};
export declare function logViteBuildError(logger: {
    error: (message: string, meta?: {
        error: {
            kind: string;
            message: string;
            stack?: string;
        };
    }) => void;
}, params: BuildViteBuildErrorLogParams, overrides?: {
    build?: typeof buildViteBuildErrorLog;
}): void;
export {};
//# sourceMappingURL=vite-dev-server-diagnostics.d.mts.map