@f5-sales-demo/xcsh 19.51.2

package/src/dap/config.ts

@@ -0,0 +1,150 @@
+import * as path from "node:path";
+import { isRecord } from "@f5xc-salesdemos/pi-utils";
+import { hasRootMarkers, resolveCommand } from "../lsp/config";
+import DEFAULTS from "./defaults.json" with { type: "json" };
+import type { DapAdapterConfig, DapResolvedAdapter } from "./types";
+
+const EXTENSIONLESS_DEBUGGER_ORDER = ["gdb", "lldb-dap"] as const;
+
+function normalizeStringArray(value: unknown): string[] {
+	if (!Array.isArray(value)) return [];
+	return value.filter((entry): entry is string => typeof entry === "string" && entry.length > 0);
+}
+
+function normalizeObject(value: unknown): Record<string, unknown> {
+	return isRecord(value) ? { ...value } : {};
+}
+
+function normalizeAdapterConfig(config: unknown): DapAdapterConfig | null {
+	if (!isRecord(config)) return null;
+	if (typeof config.command !== "string" || config.command.length === 0) return null;
+	const connectMode = config.connectMode === "socket" ? ("socket" as const) : undefined;
+	return {
+		command: config.command,
+		args: normalizeStringArray(config.args),
+		languages: normalizeStringArray(config.languages),
+		fileTypes: normalizeStringArray(config.fileTypes).map(entry => entry.toLowerCase()),
+		rootMarkers: normalizeStringArray(config.rootMarkers),
+		launchDefaults: normalizeObject(config.launchDefaults),
+		attachDefaults: normalizeObject(config.attachDefaults),
+		...(connectMode ? { connectMode } : {}),
+	};
+}
+
+function getDefaults(): Record<string, DapAdapterConfig> {
+	const adapters: Record<string, DapAdapterConfig> = {};
+	for (const [name, config] of Object.entries(DEFAULTS)) {
+		const normalized = normalizeAdapterConfig(config);
+		if (normalized) {
+			adapters[name] = normalized;
+		}
+	}
+	return adapters;
+}
+
+const DEFAULT_ADAPTERS = getDefaults();
+
+export function getAdapterConfigs(): Record<string, DapAdapterConfig> {
+	return { ...DEFAULT_ADAPTERS };
+}
+
+export function resolveAdapter(adapterName: string, cwd: string): DapResolvedAdapter | null {
+	const config = DEFAULT_ADAPTERS[adapterName];
+	if (!config) return null;
+	const resolvedCommand = resolveCommand(config.command, cwd);
+	if (!resolvedCommand) return null;
+	return {
+		name: adapterName,
+		command: config.command,
+		args: config.args ?? [],
+		resolvedCommand,
+		languages: config.languages ?? [],
+		fileTypes: config.fileTypes ?? [],
+		rootMarkers: config.rootMarkers ?? [],
+		launchDefaults: config.launchDefaults ?? {},
+		attachDefaults: config.attachDefaults ?? {},
+		connectMode: config.connectMode ?? "stdio",
+	};
+}
+
+export function getAvailableAdapters(cwd: string): DapResolvedAdapter[] {
+	return Object.keys(DEFAULT_ADAPTERS)
+		.map(name => resolveAdapter(name, cwd))
+		.filter((adapter): adapter is DapResolvedAdapter => adapter !== null);
+}
+
+function getMatchingAdapters(program: string, cwd: string): DapResolvedAdapter[] {
+	const extension = path.extname(program).toLowerCase();
+	const available = getAvailableAdapters(cwd);
+	if (!extension) {
+		// For extensionless binaries, only consider native debuggers (gdb, lldb-dap)
+		// or adapters that match by root markers. Don't silently fall back to
+		// unrelated adapters like debugpy for a C binary.
+		const nativeDebuggers: ReadonlySet<string> = new Set(EXTENSIONLESS_DEBUGGER_ORDER);
+		return available.filter(
+			adapter =>
+				nativeDebuggers.has(adapter.name) ||
+				(adapter.rootMarkers.length > 0 && hasRootMarkers(cwd, adapter.rootMarkers)),
+		);
+	}
+	const exactMatches = available.filter(adapter => adapter.fileTypes.includes(extension));
+	if (exactMatches.length > 0) {
+		return exactMatches;
+	}
+	return available;
+}
+
+function sortAdaptersForLaunch(program: string, cwd: string, adapters: DapResolvedAdapter[]): DapResolvedAdapter[] {
+	const extension = path.extname(program).toLowerCase();
+	const rootAware = adapters.map(adapter => ({
+		adapter,
+		hasExtensionMatch: extension.length > 0 && adapter.fileTypes.includes(extension),
+		hasRootMatch: adapter.rootMarkers.length > 0 && hasRootMarkers(cwd, adapter.rootMarkers),
+	}));
+	rootAware.sort((left, right) => {
+		if (left.hasExtensionMatch !== right.hasExtensionMatch) {
+			return left.hasExtensionMatch ? -1 : 1;
+		}
+		if (left.hasRootMatch !== right.hasRootMatch) {
+			return left.hasRootMatch ? -1 : 1;
+		}
+		const leftDebuggerRank = EXTENSIONLESS_DEBUGGER_ORDER.indexOf(
+			left.adapter.name as (typeof EXTENSIONLESS_DEBUGGER_ORDER)[number],
+		);
+		const rightDebuggerRank = EXTENSIONLESS_DEBUGGER_ORDER.indexOf(
+			right.adapter.name as (typeof EXTENSIONLESS_DEBUGGER_ORDER)[number],
+		);
+		const normalizedLeftRank = leftDebuggerRank === -1 ? Number.MAX_SAFE_INTEGER : leftDebuggerRank;
+		const normalizedRightRank = rightDebuggerRank === -1 ? Number.MAX_SAFE_INTEGER : rightDebuggerRank;
+		if (normalizedLeftRank !== normalizedRightRank) {
+			return normalizedLeftRank - normalizedRightRank;
+		}
+		return left.adapter.name.localeCompare(right.adapter.name);
+	});
+	return rootAware.map(entry => entry.adapter);
+}
+
+export function selectLaunchAdapter(program: string, cwd: string, adapterName?: string): DapResolvedAdapter | null {
+	if (adapterName) {
+		return resolveAdapter(adapterName, cwd);
+	}
+	const matches = getMatchingAdapters(program, cwd);
+	const sorted = sortAdaptersForLaunch(program, cwd, matches);
+	return sorted[0] ?? null;
+}
+
+export function selectAttachAdapter(cwd: string, adapterName?: string, port?: number): DapResolvedAdapter | null {
+	if (adapterName) {
+		return resolveAdapter(adapterName, cwd);
+	}
+	const available = getAvailableAdapters(cwd);
+	if (port !== undefined) {
+		const debugpy = available.find(adapter => adapter.name === "debugpy");
+		if (debugpy) return debugpy;
+	}
+	for (const preferred of EXTENSIONLESS_DEBUGGER_ORDER) {
+		const match = available.find(adapter => adapter.name === preferred);
+		if (match) return match;
+	}
+	return available[0] ?? null;
+}

package/src/dap/defaults.json

@@ -0,0 +1,211 @@
+{
+	"gdb": {
+		"command": "gdb",
+		"args": ["-i", "dap"],
+		"languages": ["c", "cpp", "rust"],
+		"fileTypes": [".c", ".cc", ".cpp", ".cxx", ".h", ".hh", ".hpp", ".hxx", ".rs"],
+		"rootMarkers": ["Makefile", "CMakeLists.txt", "Cargo.toml", "compile_commands.json"],
+		"launchDefaults": {
+			"request": "launch",
+			"stopOnEntry": true,
+			"stopAtBeginningOfMainSubprogram": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"lldb-dap": {
+		"command": "lldb-dap",
+		"args": [],
+		"languages": ["c", "cpp", "objc", "swift", "rust", "zig"],
+		"fileTypes": [".c", ".cc", ".cpp", ".cxx", ".m", ".mm", ".swift", ".rs", ".zig"],
+		"rootMarkers": ["Package.swift", "Cargo.toml", "Makefile", "CMakeLists.txt", "build.zig"],
+		"launchDefaults": {
+			"request": "launch",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"codelldb": {
+		"command": "codelldb",
+		"args": ["--port", "0"],
+		"languages": ["c", "cpp", "rust", "zig"],
+		"fileTypes": [".c", ".cc", ".cpp", ".cxx", ".rs", ".zig"],
+		"rootMarkers": ["Cargo.toml", "CMakeLists.txt", "Makefile", "compile_commands.json", "build.zig"],
+		"launchDefaults": {
+			"request": "launch",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"debugpy": {
+		"command": "python",
+		"args": ["-m", "debugpy.adapter"],
+		"languages": ["python"],
+		"fileTypes": [".py"],
+		"rootMarkers": ["pyproject.toml", "setup.py", "requirements.txt", "Pipfile"],
+		"launchDefaults": {
+			"request": "launch",
+			"justMyCode": false,
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach",
+			"justMyCode": false
+		}
+	},
+	"dlv": {
+		"command": "dlv",
+		"args": ["dap"],
+		"connectMode": "socket",
+		"languages": ["go"],
+		"fileTypes": [".go"],
+		"rootMarkers": ["go.mod", "go.sum"],
+		"launchDefaults": {
+			"request": "launch",
+			"mode": "debug",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach",
+			"mode": "local"
+		}
+	},
+	"js-debug-adapter": {
+		"command": "js-debug-adapter",
+		"args": [],
+		"languages": ["javascript", "typescript"],
+		"fileTypes": [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"],
+		"rootMarkers": ["package.json", "tsconfig.json", "jsconfig.json"],
+		"launchDefaults": {
+			"request": "launch",
+			"type": "pwa-node",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach",
+			"type": "pwa-node"
+		}
+	},
+	"netcoredbg": {
+		"command": "netcoredbg",
+		"args": ["--interpreter=vscode"],
+		"languages": ["csharp", "fsharp"],
+		"fileTypes": [".cs", ".csx", ".fs", ".fsx"],
+		"rootMarkers": ["*.sln", "*.csproj", "*.fsproj", "global.json"],
+		"launchDefaults": {
+			"request": "launch",
+			"stopAtEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"kotlin-debug-adapter": {
+		"command": "kotlin-debug-adapter",
+		"args": [],
+		"languages": ["kotlin"],
+		"fileTypes": [".kt", ".kts"],
+		"rootMarkers": ["build.gradle", "build.gradle.kts", "pom.xml", "settings.gradle", "settings.gradle.kts"],
+		"launchDefaults": {
+			"request": "launch",
+			"mainClass": "",
+			"projectRoot": ""
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"rdbg": {
+		"command": "rdbg",
+		"args": ["--open", "--command", "--"],
+		"languages": ["ruby"],
+		"fileTypes": [".rb", ".rake", ".gemspec"],
+		"rootMarkers": ["Gemfile", "Rakefile", ".ruby-version"],
+		"launchDefaults": {
+			"request": "launch",
+			"type": "rdbg"
+		},
+		"attachDefaults": {
+			"request": "attach",
+			"type": "rdbg"
+		}
+	},
+	"php-debug-adapter": {
+		"command": "php-debug-adapter",
+		"args": [],
+		"languages": ["php"],
+		"fileTypes": [".php", ".phtml"],
+		"rootMarkers": ["composer.json", "composer.lock"],
+		"launchDefaults": {
+			"request": "launch",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"bash-debug-adapter": {
+		"command": "bash-debug-adapter",
+		"args": [],
+		"languages": ["bash", "shell"],
+		"fileTypes": [".sh", ".bash"],
+		"rootMarkers": [".git"],
+		"launchDefaults": {
+			"request": "launch",
+			"type": "bashdb",
+			"pathBashdb": "bashdb",
+			"pathBash": "bash"
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"dart-debug-adapter": {
+		"command": "dart",
+		"args": ["debug_adapter"],
+		"languages": ["dart"],
+		"fileTypes": [".dart"],
+		"rootMarkers": ["pubspec.yaml", "pubspec.lock"],
+		"launchDefaults": {
+			"request": "launch",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"flutter-debug-adapter": {
+		"command": "dart",
+		"args": ["debug_adapter", "--flutter-sdk-path", ""],
+		"languages": ["dart"],
+		"fileTypes": [".dart"],
+		"rootMarkers": ["pubspec.yaml", "android", "ios", "lib/main.dart"],
+		"launchDefaults": {
+			"request": "launch"
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	},
+	"elixir-ls-debugger": {
+		"command": "elixir-ls-debugger",
+		"args": [],
+		"languages": ["elixir"],
+		"fileTypes": [".ex", ".exs", ".heex", ".eex"],
+		"rootMarkers": ["mix.exs", "mix.lock"],
+		"launchDefaults": {
+			"request": "launch",
+			"type": "mix_task",
+			"task": "run",
+			"stopOnEntry": true
+		},
+		"attachDefaults": {
+			"request": "attach"
+		}
+	}
+}

package/src/dap/index.ts

@@ -0,0 +1,4 @@
+export * from "./client";
+export * from "./config";
+export * from "./session";
+export * from "./types";