declare const IS_WINDOWS: boolean;
export interface IdeDefinition {
    name: string;
    /** The top-level JSON key that holds server entries */
    configKey: "mcpServers" | "servers";
    /** Whether each server entry requires "type": "stdio" */
    requiresType: boolean;
    /** Whether Windows requires cmd /c wrapper for npx */
    requiresCmdWrapper: boolean;
    /**
     * FLAW-4 FIX: IDE-native variable for the current workspace/project root.
     * When set, the installer injects `--project-root=<var>` into the MCP args
     * so the server receives the actual workspace path at spawn time, bypassing
     * all heuristic detection.
     *
     * Examples: "${workspaceFolder}" (VS Code/Cursor), "${SolutionDir}" (VS)
     */
    workspaceVar?: string;
    /**
     * IDE-native variable injected as env var ENGRAM_PROJECT_ROOT in the MCP
     * config's "env" block.  Only set this when the IDE is confirmed to expand
     * workspace-aware variables in env values (e.g. a hypothetical "${workspace}").
     * Do NOT set for IDEs that only expand real OS env vars ($VAR/${VAR}) — the
     * literal placeholder string would be passed to the server and silently ignored.
     */
    envVar?: string;
    /**
     * Dynamic global path resolver — used for IDEs with versioned config directories
     * (e.g. Android Studio: AndroidStudio2025.3.2\mcp.json).
     * When set, this function is called at install time to enumerate all matching paths
     * on the current machine instead of using a hardcoded `scopes.global` array.
     * Returns an array of absolute config file paths (may be empty if IDE not installed).
     */
    resolveGlobalPaths?: () => string[];
    /**
     * Extra fields to merge into each server entry written by the installer.
     * Used for IDE-specific required fields (e.g. Android Studio requires `enabled: true`).
     */
    extraEntryFields?: Record<string, unknown>;
    scopes: {
        global?: string[];
        localDirs?: string[];
        /**
         * Override the default config filename for local installs.
         * Defaults: "mcp.json" for non-empty localDirPrefix, ".mcp.json" for empty ("").
         * Example: Gemini CLI uses "settings.json" not "mcp.json".
         */
        localFile?: string;
        /** CLI command for IDE-native installation (e.g. claude mcp add-json) */
        cli?: string;
    };
}
export declare const IDE_CONFIGS: Record<string, IdeDefinition>;
export { IS_WINDOWS };
//# sourceMappingURL=ide-configs.d.ts.map