/**
 * WsKitError: type-safe error wrapper.
 *
 * Semantics:
 * - wrap(err, code) preserves type safety
 * - Never narrows error codes (immutable)
 * - If err is already WsKitError, return as-is or clone with new code
 * - Never mutates
 */
import type { ErrorCode, WsKitErrorData } from "./codes.js";
export declare class WsKitError<E extends ErrorCode = ErrorCode> extends Error {
    readonly code: E;
    readonly details?: Record<string, unknown>;
    readonly retryable: boolean;
    constructor(code: E, message: string, details?: Record<string, unknown>);
    /**
     * Wrap unknown error with a code (preserves type safety).
     */
    static wrap<E extends ErrorCode>(err: unknown, code?: E, details?: Record<string, unknown>): WsKitError<E | ErrorCode>;
    /**
     * Clone with new code (never mutate).
     */
    with<E2 extends ErrorCode>(opts: {
        code?: E2;
        details?: Record<string, unknown>;
    }): WsKitError<E2 | E>;
    toJSON(): WsKitErrorData;
}
//# sourceMappingURL=error.d.ts.map