export interface WslDistro {
readonly name: string;
readonly isDefault: boolean;
readonly version: 1 | 2;
}
export interface WslConfig {
readonly distro: string | null;
}
// Literal spaces only; \s would accept controls and corrupt UNC distro paths.
const DISTRO_NAME_PATTERN = /^\w(?:[\w \-.]*\w)?$/;
export function parseWslDistroList(stdout: Buffer): readonly WslDistro[] {
const hasUtf16Bom = stdout.length >= 2 && stdout[0] === 0xff && stdout[1] === 0xfe;
const likelyUtf16Le =
hasUtf16Bom ||
Array.from(stdout.subarray(0, Math.min(stdout.length, 80))).filter(
(byte, index) => index % 2 === 1 && byte === 0,
).length > 10;
let text = stdout.toString(likelyUtf16Le ? "utf16le" : "utf8");
if (text.charCodeAt(0) === 0xfeff) text = text.slice(1);
const lines = text.split(/\r?\n/).filter((line) => line.trim().length > 0);
const distros: WslDistro[] = [];
for (let i = 1; i < lines.length; i++) {
const line = lines[i]!;
const isDefault = line.startsWith("*");
const cleaned = isDefault ? line.slice(1).trim() : line.trim();
const fields = cleaned.split(/\s{2,}/);
if (fields.length < 3) continue;
const name = fields[0]!.trim();
const versionNum = parseInt(fields[2]!, 10);
if (!name || (versionNum !== 1 && versionNum !== 2)) continue;
distros.push({ name, isDefault, version: versionNum as 1 | 2 });
}
return distros;
}
// Resolve UNC paths in their owning distro, which can differ from the configured desktop backend.
export function extractDistroFromUncPath(windowsPath: string): string | null {
const match = /^\\\\(?:wsl\.localhost|wsl\$)\\([^\\]+)/i.exec(windowsPath);
if (!match) return null;
const candidate = match[1]!;
return DISTRO_NAME_PATTERN.test(candidate) ? candidate : null;
}
export function wslUncPathToLinuxPath(windowsPath: string): string | null {
const match = /^\\\\(?:wsl\.localhost|wsl\$)\\([^\\]+)(?:\\(.*))?$/i.exec(windowsPath.trim());
if (!match) return null;
const distro = match[1]!;
if (!DISTRO_NAME_PATTERN.test(distro)) return null;
const rest = match[2] ?? "";
if (rest.length === 0) return "/";
return `/${rest.split("\\").filter(Boolean).join("/")}`;
}
function resolveWslHomeUncPath(config: WslConfig, distros: readonly WslDistro[]): string | null {
const distroName = config.distro ?? distros.find((distro) => distro.isDefault)?.name ?? null;
return distroName ? `\\\\wsl.localhost\\${distroName}\\home` : null;
}
export function resolveWslPickFolderDefaultPath(
rawOptions: unknown,
config: WslConfig,
distros: readonly WslDistro[],
userHome: string | null = null,
): string | null {
const homePath = resolveWslHomeUncPath(config, distros);
if (typeof rawOptions !== "object" || rawOptions === null) {
return homePath;
}
const { initialPath } = rawOptions as { initialPath?: unknown };
if (typeof initialPath !== "string") {
return homePath;
}
const trimmedPath = initialPath.trim();
if (trimmedPath.length === 0) {
return homePath;
}
if (trimmedPath.startsWith("\\\\")) {
return trimmedPath;
}
const distroName = config.distro ?? distros.find((distro) => distro.isDefault)?.name ?? null;
if (!distroName) {
return homePath;
}
const toUncPath = (linuxPath: string) =>
`\\\\wsl.localhost\\${distroName}${linuxPath.replaceAll("/", "\\")}`;
const normalizedUserHome = userHome && userHome.startsWith("/") ? userHome : null;
if (trimmedPath === "~") {
return normalizedUserHome ? toUncPath(normalizedUserHome) : homePath;
}
if (trimmedPath.startsWith("~/")) {
const remainder = trimmedPath.slice(2);
if (normalizedUserHome) {
return toUncPath(`${normalizedUserHome}/${remainder}`);
}
return homePath ? `${homePath}\\${remainder.replaceAll("/", "\\")}` : null;
}
if (trimmedPath.startsWith("/")) {
return toUncPath(trimmedPath);
}
return homePath;
}
export function isValidDistroName(value: string): boolean {
return DISTRO_NAME_PATTERN.test(value);
}