xbintsc 0.3.14 → 0.3.16

package/scripts/fetch-toolchain.ts

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-/**
- * Download the pinned toolchain that xbintsc bundles for this host into
- * `vendor/<os>-<arch>/`, so `build` needs no user-installed compiler:
- *
- *   Linux   -> official LLVM release (clang + lld + llvm-ar) plus the legacy
- *              `libtinfo.so.5` shared library the official build still needs
- *   Windows -> llvm-mingw (clang + lld + MinGW-w64 CRT/import libraries)
- *   macOS   -> nothing; the Xcode Command Line Tools are the prerequisite
- *
- * Requires `curl`, `tar` and (on Linux) `ar` on PATH; all are present on
- * GitHub-hosted runners. Pass `--force` to refetch an existing toolchain.
- */
-
-import { copyFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { platformSlug, vendorRootDir } from "../src/driver/paths.js";
-import { toolchainDownload, toolchainSupportLibraries } from "../src/driver/toolchain-download.js";
-
-const force = process.argv.includes("--force");
-const target = toolchainDownload();
-
-if (!target) {
-  console.log(
-    `xbintsc: no bundled toolchain for ${platformSlug()}; using the system SDK (macOS: Xcode Command Line Tools)`,
-  );
-  process.exit(0);
-}
-
-const vendorDir = join(vendorRootDir(), platformSlug());
-const clangName = process.platform === "win32" ? "clang.exe" : "clang";
-const clangPath = join(vendorDir, "bin", clangName);
-
-function run(command: string, args: readonly string[], cwd?: string): void {
-  const result = spawnSync(command, [...args], { stdio: "inherit", cwd });
-  if (result.status !== 0) {
-    console.error(`xbintsc: command failed: ${command} ${args.join(" ")}`);
-    process.exit(result.status ?? 1);
-  }
-}
-
-/** Download the first reachable URL to `dest`, failing after the last one. */
-function download(urls: readonly string[], dest: string): void {
-  for (const url of urls) {
-    console.log(`xbintsc: downloading ${url}`);
-    const result = spawnSync("curl", ["-fL", "--retry", "3", "-o", dest, url], { stdio: "inherit" });
-    if (result.status === 0) return;
-    console.log("xbintsc: download failed, trying the next mirror");
-  }
-  console.error(`xbintsc: could not download ${dest}`);
-  process.exit(1);
-}
-
-const workDir = join(tmpdir(), `xbintsc-toolchain-${process.pid}`);
-rmSync(workDir, { recursive: true, force: true });
-mkdirSync(workDir, { recursive: true });
-
-if (existsSync(clangPath) && !force) {
-  console.log(`xbintsc: toolchain already present at ${vendorDir}`);
-} else {
-  const archivePath = join(workDir, target.archive);
-  download([target.url], archivePath);
-  console.log(`xbintsc: extracting into ${vendorDir}`);
-  mkdirSync(vendorDir, { recursive: true });
-  // `tar` here is bsdtar on macOS/Windows and GNU tar on Linux; both accept
-  // `--strip-components`, and bsdtar also unpacks the `.zip` used on Windows.
-  run("tar", ["-xf", archivePath, "-C", vendorDir, `--strip-components=${target.stripComponents}`]);
-}
-
-// Shared libraries the bundled toolchain needs but the OS does not provide.
-const supportLibraries = toolchainSupportLibraries();
-if (supportLibraries.length > 0) {
-  const libDir = join(vendorDir, "lib");
-  mkdirSync(libDir, { recursive: true });
-  for (const library of supportLibraries) {
-    const dest = join(libDir, library.dest);
-    if (existsSync(dest) && !force) {
-      console.log(`xbintsc: already bundled ${library.dest}`);
-      continue;
-    }
-    const debPath = join(workDir, library.archive);
-    download(library.urls, debPath);
-    const debDir = join(workDir, `deb-${library.dest}`);
-    mkdirSync(debDir, { recursive: true });
-    // A `.deb` is an `ar` archive whose `data.tar.*` member holds the files.
-    run("ar", ["x", debPath], debDir);
-    run("tar", ["-xf", join(debDir, "data.tar.xz"), "-C", debDir]);
-    copyFileSync(join(debDir, library.member), dest);
-    console.log(`xbintsc: bundled ${library.dest}`);
-  }
-}
-
-rmSync(workDir, { recursive: true, force: true });
-
-if (!existsSync(clangPath)) {
-  console.error(`xbintsc: expected ${clangPath} after extraction`);
-  process.exit(1);
-}
-console.log(`xbintsc: done -> ${clangPath}`);

package/src/driver/toolchain-download.ts

@@ -1,135 +0,0 @@
-/**
- * Which toolchain xbintsc bundles for each host.
- *
- * The end goal is that `build` needs no user-installed compiler. Per the
- * recorded decisions (see `doc/requirements.md`):
- *
- *   Linux   -> the official LLVM release (clang + lld + llvm-ar)
- *   Windows -> llvm-mingw (clang + lld + the MinGW-w64 sysroot/CRT/import libs)
- *   macOS   -> nothing; the Xcode Command Line Tools are the prerequisite
- *
- * This module only maps a host to a pinned download; the actual fetch lives in
- * `scripts/fetch-toolchain.ts`.
- */
-
-/** Pinned LLVM release used for the Linux bundle. */
-export const LLVM_VERSION = "18.1.8";
-/** Pinned llvm-mingw release used for the Windows bundle. */
-export const LLVM_MINGW_VERSION = "20260908";
-
-export interface ToolchainDownload {
-  /** Download URL. */
-  readonly url: string;
-  /** Suggested local file name for the archive. */
-  readonly archive: string;
-  /** Archive type. Both are unpacked with `tar` (bsdtar reads zip). */
-  readonly kind: "tar.xz" | "zip";
-  /** Leading path segments to strip while extracting. */
-  readonly stripComponents: number;
-}
-
-/**
- * The toolchain to bundle for a host, or undefined when the host's own SDK is
- * used instead (macOS: the Xcode Command Line Tools).
- */
-export function toolchainDownload(
-  platform: string = process.platform,
-  arch: string = process.arch,
-): ToolchainDownload | undefined {
-  if (platform === "linux") {
-    if (arch === "x64") {
-      return {
-        url: `https://github.com/llvm/llvm-project/releases/download/llvmorg-${LLVM_VERSION}/clang+llvm-${LLVM_VERSION}-x86_64-linux-gnu-ubuntu-18.04.tar.xz`,
-        archive: `clang+llvm-${LLVM_VERSION}-x86_64-linux-gnu.tar.xz`,
-        kind: "tar.xz",
-        stripComponents: 1,
-      };
-    }
-    if (arch === "arm64") {
-      return {
-        url: `https://github.com/llvm/llvm-project/releases/download/llvmorg-${LLVM_VERSION}/clang+llvm-${LLVM_VERSION}-aarch64-linux-gnu.tar.xz`,
-        archive: `clang+llvm-${LLVM_VERSION}-aarch64-linux-gnu.tar.xz`,
-        kind: "tar.xz",
-        stripComponents: 1,
-      };
-    }
-    return undefined;
-  }
-
-  if (platform === "win32" && arch === "x64") {
-    return {
-      url: `https://github.com/mstorsjo/llvm-mingw/releases/download/${LLVM_MINGW_VERSION}/llvm-mingw-${LLVM_MINGW_VERSION}-ucrt-x86_64.zip`,
-      archive: `llvm-mingw-${LLVM_MINGW_VERSION}-ucrt-x86_64.zip`,
-      kind: "zip",
-      stripComponents: 1,
-    };
-  }
-
-  if (platform === "win32" && arch === "arm64") {
-    // The llvm-mingw `aarch64` package is the Windows-on-ARM host build; its
-    // clang targets aarch64 by default, so a native Windows ARM64 runner gets
-    // native MinGW-w64 binaries with no MSVC dependency.
-    return {
-      url: `https://github.com/mstorsjo/llvm-mingw/releases/download/${LLVM_MINGW_VERSION}/llvm-mingw-${LLVM_MINGW_VERSION}-ucrt-aarch64.zip`,
-      archive: `llvm-mingw-${LLVM_MINGW_VERSION}-ucrt-aarch64.zip`,
-      kind: "zip",
-      stripComponents: 1,
-    };
-  }
-
-  // macOS (and any other host) uses the system SDK; nothing to bundle.
-  return undefined;
-}
-
-export interface SupportLibrary {
-  /** Candidate download URLs, tried in order. */
-  readonly urls: readonly string[];
-  /** Local file name for the downloaded `.deb`. */
-  readonly archive: string;
-  /** Path inside the extracted `.deb` data tree. */
-  readonly member: string;
-  /** File name placed in `vendor/<os>-<arch>/lib/`. */
-  readonly dest: string;
-}
-
-/**
- * Extra shared libraries the bundled toolchain needs but that are not part of
- * the OS C library. The official Linux LLVM build links the legacy
- * `libtinfo.so.5` soname, which current distributions no longer ship, so we
- * bundle it (from the Ubuntu `libtinfo5` package) into `vendor/<os>-<arch>/lib`
- * and point `LD_LIBRARY_PATH` at that directory.
- */
-export function toolchainSupportLibraries(
-  platform: string = process.platform,
-  arch: string = process.arch,
-): readonly SupportLibrary[] {
-  if (platform === "linux" && arch === "x64") {
-    return [
-      {
-        urls: [
-          "https://security.ubuntu.com/ubuntu/pool/main/n/ncurses/libtinfo5_6.1-1ubuntu1.18.04.1_amd64.deb",
-          "https://archive.ubuntu.com/ubuntu/pool/main/n/ncurses/libtinfo5_6.1-1ubuntu1.18.04.1_amd64.deb",
-        ],
-        archive: "libtinfo5.deb",
-        member: "lib/x86_64-linux-gnu/libtinfo.so.5.9",
-        dest: "libtinfo.so.5",
-      },
-    ];
-  }
-  if (platform === "linux" && arch === "arm64") {
-    // The aarch64 release build links the same removed `libtinfo.so.5` soname as
-    // the x86_64 one; arm64 packages live in the Ubuntu ports archive.
-    return [
-      {
-        urls: [
-          "https://ports.ubuntu.com/ubuntu-ports/pool/main/n/ncurses/libtinfo5_6.1-1ubuntu1.18.04.1_arm64.deb",
-          "http://ports.ubuntu.com/ubuntu-ports/pool/main/n/ncurses/libtinfo5_6.1-1ubuntu1.18.04.1_arm64.deb",
-        ],
-        archive: "libtinfo5.deb",
-        member: "lib/aarch64-linux-gnu/libtinfo.so.5.9",
-        dest: "libtinfo.so.5",
-      },
-    ];
-  }
-  return [];
-}