Add micro-optimization for node:http method name

.aikido

@@ -1,19 +0,0 @@
-exclude:
-  paths:
-    - test
-    - scripts
-    - bench
-    - packages/bun-lambda
-    - packages/bun-release
-    - packages/bun-wasm
-    - packages/bun-vscode
-    - packages/bun-plugin-yaml
-    - packages/bun-plugin-svelte
-    - packages/bun-native-plugin-rs
-    - packages/bun-native-bundler-plugin-api
-    - packages/bun-inspector-protocol
-    - packages/bun-inspector-frontend
-    - packages/bun-error
-    - packages/bun-debug-adapter-protocol
-    - packages/bun-build-mdx-rs
-    - packages/@types/bun

.buildkite/Dockerfile

@@ -1,6 +1,8 @@
 ARG LLVM_VERSION="19"
 ARG REPORTED_LLVM_VERSION="19.1.7"
 ARG OLD_BUN_VERSION="1.1.38"
+ARG DEFAULT_CFLAGS="-mno-omit-leaf-frame-pointer -fno-omit-frame-pointer -ffunction-sections -fdata-sections -faddrsig -fno-unwind-tables -fno-asynchronous-unwind-tables"
+ARG DEFAULT_CXXFLAGS="-flto=full -fwhole-program-vtables -fforce-emit-vtables"
 ARG BUILDKITE_AGENT_TAGS="queue=linux,os=linux,arch=${TARGETARCH}"
 
 FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-arm64
@@ -10,6 +12,8 @@ FROM base-$TARGETARCH as base
 ARG LLVM_VERSION
 ARG OLD_BUN_VERSION
 ARG TARGETARCH
+ARG DEFAULT_CXXFLAGS
+ARG DEFAULT_CFLAGS
 ARG REPORTED_LLVM_VERSION
 
 ENV DEBIAN_FRONTEND=noninteractive \
@@ -48,14 +52,6 @@ RUN --mount=type=tmpfs,target=/tmp \
     wget -O /tmp/cmake.sh "$cmake_url" && \
     sh /tmp/cmake.sh --skip-license --prefix=/usr
 
-RUN --mount=type=tmpfs,target=/tmp \
-    sccache_version="0.12.0" && \
-    arch=$(uname -m) && \
-    sccache_url="https://github.com/mozilla/sccache/releases/download/v${sccache_version}/sccache-v${sccache_version}-${arch}-unknown-linux-musl.tar.gz" && \
-    wget -O /tmp/sccache.tar.gz "$sccache_url" && \
-    tar -xzf /tmp/sccache.tar.gz -C /tmp && \
-    install -m755 /tmp/sccache-v${sccache_version}-${arch}-unknown-linux-musl/sccache /usr/local/bin
-
 RUN update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 130 \
    --slave /usr/bin/g++ g++ /usr/bin/g++-13 \
    --slave /usr/bin/gcc-ar gcc-ar /usr/bin/gcc-ar-13 \
@@ -68,7 +64,9 @@ RUN echo "ARCH_PATH=$([ "$TARGETARCH" = "arm64" ] && echo "aarch64-linux-gnu" ||
 ENV LD_LIBRARY_PATH=/usr/lib/gcc/${ARCH_PATH}/13:/usr/lib/${ARCH_PATH} \
    LIBRARY_PATH=/usr/lib/gcc/${ARCH_PATH}/13:/usr/lib/${ARCH_PATH} \
    CPLUS_INCLUDE_PATH=/usr/include/c++/13:/usr/include/${ARCH_PATH}/c++/13 \
-   C_INCLUDE_PATH=/usr/lib/gcc/${ARCH_PATH}/13/include
+   C_INCLUDE_PATH=/usr/lib/gcc/${ARCH_PATH}/13/include \
+   CFLAGS=${DEFAULT_CFLAGS} \
+   CXXFLAGS="${DEFAULT_CFLAGS} ${DEFAULT_CXXFLAGS}"
 
 RUN if [ "$TARGETARCH" = "arm64" ]; then \
        export ARCH_PATH="aarch64-linux-gnu"; \
@@ -118,14 +116,14 @@ ARG BUILDKITE_AGENT_TAGS
 
 
 # Install Rust nightly
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \ 
     && export PATH=$HOME/.cargo/bin:$PATH \
     && rustup install nightly \
     && rustup default nightly
 
 
 RUN ARCH=$(if [ "$TARGETARCH" = "arm64" ]; then echo "arm64"; else echo "amd64"; fi) && \
-    echo "Downloading buildkite" && \
+    echo "Downloading buildkite" && \ 
     curl -fsSL "https://github.com/buildkite/agent/releases/download/v3.87.0/buildkite-agent-linux-${ARCH}-3.87.0.tar.gz" -o /tmp/buildkite-agent.tar.gz && \
     mkdir -p /tmp/buildkite-agent && \
     tar -xzf /tmp/buildkite-agent.tar.gz -C /tmp/buildkite-agent && \
@@ -133,20 +131,6 @@ RUN ARCH=$(if [ "$TARGETARCH" = "arm64" ]; then echo "arm64"; else echo "amd64";
 
 RUN mkdir -p /var/cache/buildkite-agent /var/log/buildkite-agent /var/run/buildkite-agent /etc/buildkite-agent /var/lib/buildkite-agent/cache/bun
 
-# The following is necessary to configure buildkite to use a stable
-# checkout directory. sccache hashes absolute paths into its cache keys,
-# so if buildkite uses a different checkout path each time (which it does
-# by default), sccache will be useless.
-RUN mkdir -p -m 755 /var/lib/buildkite-agent/hooks && \
-    cat <<'EOF' > /var/lib/buildkite-agent/hooks/environment
-#!/bin/sh
-set -efu
-
-export BUILDKITE_BUILD_CHECKOUT_PATH=/var/lib/buildkite-agent/build
-EOF
-
-RUN chmod 744 /var/lib/buildkite-agent/hooks/environment
-
 COPY  ../*/agent.mjs /var/bun/scripts/
 
 ENV BUN_INSTALL_CACHE=/var/lib/buildkite-agent/cache/bun
@@ -169,7 +153,7 @@ COPY . /workspace/bun
 
 
 # Install Rust nightly
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \ 
     && export PATH=$HOME/.cargo/bin:$PATH \
     && rustup install nightly \
     && rustup default nightly
@@ -183,4 +167,4 @@ RUN --mount=type=tmpfs,target=/workspace/bun/build \
     ls -la \
     && bun run build:release \
     && mkdir -p /target \
-    && cp -r /workspace/bun/build/release/bun /target/bun
+    && cp -r /workspace/bun/build/release/bun /target/bun

.buildkite/ci.mjs

@@ -16,7 +16,6 @@ import {
   getEmoji,
   getEnv,
   getLastSuccessfulBuild,
-  getSecret,
   isBuildkite,
   isBuildManual,
   isFork,
@@ -31,12 +30,12 @@ import {
 } from "../scripts/utils.mjs";
 
 /**
- * @typedef {"linux" | "darwin" | "windows" | "freebsd"} Os
+ * @typedef {"linux" | "darwin" | "windows"} Os
  * @typedef {"aarch64" | "x64"} Arch
  * @typedef {"musl"} Abi
  * @typedef {"debian" | "ubuntu" | "alpine" | "amazonlinux"} Distro
  * @typedef {"latest" | "previous" | "oldest" | "eol"} Tier
- * @typedef {"release" | "assert" | "debug" | "asan"} Profile
+ * @typedef {"release" | "assert" | "debug"} Profile
  */
 
 /**
@@ -108,13 +107,11 @@ const buildPlatforms = [
   { os: "linux", arch: "aarch64", distro: "amazonlinux", release: "2023", features: ["docker"] },
   { os: "linux", arch: "x64", distro: "amazonlinux", release: "2023", features: ["docker"] },
   { os: "linux", arch: "x64", baseline: true, distro: "amazonlinux", release: "2023", features: ["docker"] },
-  { os: "linux", arch: "x64", profile: "asan", distro: "amazonlinux", release: "2023", features: ["docker"] },
-  { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.22" },
-  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.22" },
-  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.22" },
+  { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.21" },
+  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.21" },
+  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.21" },
   { os: "windows", arch: "x64", release: "2019" },
   { os: "windows", arch: "x64", baseline: true, release: "2019" },
-  { os: "freebsd", arch: "x64", release: "14.3" },
 ];
 
 /**
@@ -128,16 +125,18 @@ const testPlatforms = [
   { os: "linux", arch: "aarch64", distro: "debian", release: "12", tier: "latest" },
   { os: "linux", arch: "x64", distro: "debian", release: "12", tier: "latest" },
   { os: "linux", arch: "x64", baseline: true, distro: "debian", release: "12", tier: "latest" },
-  { os: "linux", arch: "x64", profile: "asan", distro: "debian", release: "12", tier: "latest" },
-  { os: "linux", arch: "aarch64", distro: "ubuntu", release: "25.04", tier: "latest" },
   { os: "linux", arch: "aarch64", distro: "ubuntu", release: "24.04", tier: "latest" },
-  { os: "linux", arch: "x64", distro: "ubuntu", release: "25.04", tier: "latest" },
+  { os: "linux", arch: "aarch64", distro: "ubuntu", release: "22.04", tier: "previous" },
+  { os: "linux", arch: "aarch64", distro: "ubuntu", release: "20.04", tier: "oldest" },
   { os: "linux", arch: "x64", distro: "ubuntu", release: "24.04", tier: "latest" },
-  { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "25.04", tier: "latest" },
+  { os: "linux", arch: "x64", distro: "ubuntu", release: "22.04", tier: "previous" },
+  { os: "linux", arch: "x64", distro: "ubuntu", release: "20.04", tier: "oldest" },
   { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "24.04", tier: "latest" },
-  { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.22", tier: "latest" },
-  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.22", tier: "latest" },
-  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.22", tier: "latest" },
+  { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "22.04", tier: "previous" },
+  { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "20.04", tier: "oldest" },
+  { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.21", tier: "latest" },
+  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.21", tier: "latest" },
+  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.21", tier: "latest" },
   { os: "windows", arch: "x64", release: "2019", tier: "oldest" },
   { os: "windows", arch: "x64", release: "2019", baseline: true, tier: "oldest" },
 ];
@@ -225,12 +224,18 @@ function getImageName(platform, options) {
  * @param {number} [limit]
  * @link https://buildkite.com/docs/pipelines/command-step#retry-attributes
  */
-function getRetry() {
+function getRetry(limit = 0) {
   return {
     manual: {
       permit_on_passed: true,
     },
-    automatic: false,
+    automatic: [
+      { exit_status: 1, limit },
+      { exit_status: -1, limit: 1 },
+      { exit_status: 255, limit: 1 },
+      { signal_reason: "cancel", limit: 1 },
+      { signal_reason: "agent_stop", limit: 1 },
+    ],
   };
 }
 
@@ -294,7 +299,7 @@ function getEc2Agent(platform, options, ec2Options) {
  * @returns {string}
  */
 function getCppAgent(platform, options) {
-  const { os, arch } = platform;
+  const { os, arch, distro } = platform;
 
   if (os === "darwin") {
     return {
@@ -305,68 +310,32 @@ function getCppAgent(platform, options) {
   }
 
   return getEc2Agent(platform, options, {
-    instanceType: arch === "aarch64" ? "c8g.4xlarge" : "c7i.4xlarge",
+    instanceType: arch === "aarch64" ? "c8g.16xlarge" : "c7i.16xlarge",
+    cpuCount: 32,
+    threadsPerCore: 1,
   });
 }
 
 /**
  * @param {Platform} platform
  * @param {PipelineOptions} options
- * @returns {string}
+ * @returns {Agent}
  */
-function getLinkBunAgent(platform, options) {
-  const { os, arch } = platform;
+function getZigAgent(platform, options) {
+  const { arch } = platform;
 
-  if (os === "darwin") {
-    return {
-      queue: `build-${os}`,
-      os,
-      arch,
-    };
-  }
-
-  if (os === "windows") {
-    return getEc2Agent(platform, options, {
-      instanceType: arch === "aarch64" ? "r8g.large" : "r7i.large",
-    });
-  }
-
-  return getEc2Agent(platform, options, {
-    instanceType: arch === "aarch64" ? "r8g.xlarge" : "r7i.xlarge",
-  });
-}
-
-/**
- * @returns {Platform}
- */
-function getZigPlatform() {
   return {
-    os: "linux",
-    arch: "aarch64",
-    abi: "musl",
-    distro: "alpine",
-    release: "3.22",
+    queue: "build-zig",
   };
 }
 
-/**
- * @param {Platform} platform
- * @param {PipelineOptions} options
- * @returns {Agent}
- */
-function getZigAgent(_platform, options) {
-  return getEc2Agent(getZigPlatform(), options, {
-    instanceType: "r8g.large",
-  });
-}
-
 /**
  * @param {Platform} platform
  * @param {PipelineOptions} options
  * @returns {Agent}
  */
 function getTestAgent(platform, options) {
-  const { os, arch, profile } = platform;
+  const { os, arch } = platform;
 
   if (os === "darwin") {
     return {
@@ -376,7 +345,7 @@ function getTestAgent(platform, options) {
     };
   }
 
-  // TODO: delete this block when we upgrade to mimalloc v3
+  // TODO: `dev-server-ssr-110.test.ts` and `next-build.test.ts` run out of memory at 8GB of memory, so use 16GB instead.
   if (os === "windows") {
     return getEc2Agent(platform, options, {
       instanceType: "c7i.2xlarge",
@@ -386,13 +355,6 @@ function getTestAgent(platform, options) {
   }
 
   if (arch === "aarch64") {
-    if (profile === "asan") {
-      return getEc2Agent(platform, options, {
-        instanceType: "c8g.2xlarge",
-        cpuCount: 2,
-        threadsPerCore: 1,
-      });
-    }
     return getEc2Agent(platform, options, {
       instanceType: "c8g.xlarge",
       cpuCount: 2,
@@ -400,13 +362,6 @@ function getTestAgent(platform, options) {
     });
   }
 
-  if (profile === "asan") {
-    return getEc2Agent(platform, options, {
-      instanceType: "c7i.2xlarge",
-      cpuCount: 2,
-      threadsPerCore: 1,
-    });
-  }
   return getEc2Agent(platform, options, {
     instanceType: "c7i.xlarge",
     cpuCount: 2,
@@ -424,36 +379,45 @@ function getTestAgent(platform, options) {
  * @returns {Record<string, string | undefined>}
  */
 function getBuildEnv(target, options) {
-  const { baseline, abi } = target;
+  const { profile, baseline, abi } = target;
+  const release = !profile || profile === "release";
   const { canary } = options;
   const revision = typeof canary === "number" ? canary : 1;
 
+  const isMusl = abi === "musl";
+
+  let CMAKE_BUILD_TYPE = release ? "Release" : profile === "debug" ? "Debug" : "RelWithDebInfo";
+  if (isMusl && release) {
+    CMAKE_BUILD_TYPE = "MinSizeRel";
+  }
+
   return {
+    CMAKE_BUILD_TYPE,
     ENABLE_BASELINE: baseline ? "ON" : "OFF",
     ENABLE_CANARY: revision > 0 ? "ON" : "OFF",
     CANARY_REVISION: revision,
-    ABI: abi === "musl" ? "musl" : undefined,
-    CMAKE_VERBOSE_MAKEFILE: "ON",
+    ENABLE_ASSERTIONS: release ? "OFF" : "ON",
+    ENABLE_LOGS: release ? "OFF" : "ON",
+    ABI: isMusl ? "musl" : undefined,
     CMAKE_TLS_VERIFY: "0",
   };
 }
 
 /**
- * @param {Target} target
+ * @param {Platform} platform
  * @param {PipelineOptions} options
- * @returns {string}
+ * @returns {Step}
  */
-function getBuildCommand(target, options, label) {
-  const { profile } = target;
-  const buildProfile = profile || "release";
-
-  if (target.os === "windows" && label === "build-bun") {
-    // Only sign release builds, not canary builds (DigiCert charges per signature)
-    const enableSigning = !options.canary ? " -DENABLE_WINDOWS_CODESIGNING=ON" : "";
-    return `bun run build:${buildProfile}${enableSigning}`;
-  }
-
-  return `bun run build:${buildProfile}`;
+function getBuildVendorStep(platform, options) {
+  return {
+    key: `${getTargetKey(platform)}-build-vendor`,
+    label: `${getTargetLabel(platform)} - build-vendor`,
+    agents: getCppAgent(platform, options),
+    retry: getRetry(),
+    cancel_on_build_failing: isMergeQueue(),
+    env: getBuildEnv(platform, options),
+    command: "bun run build:ci --target dependencies",
+  };
 }
 
 /**
@@ -462,7 +426,6 @@ function getBuildCommand(target, options, label) {
  * @returns {Step}
  */
 function getBuildCppStep(platform, options) {
-  const command = getBuildCommand(platform, options);
   return {
     key: `${getTargetKey(platform)}-build-cpp`,
     label: `${getTargetLabel(platform)} - build-cpp`,
@@ -473,10 +436,7 @@ function getBuildCppStep(platform, options) {
       BUN_CPP_ONLY: "ON",
       ...getBuildEnv(platform, options),
     },
-    // We used to build the C++ dependencies and bun in separate steps.
-    // However, as long as the zig build takes longer than both sequentially,
-    // it's cheaper to run them in the same step. Can be revisited in the future.
-    command: [`${command} --target bun`, `${command} --target dependencies`],
+    command: "bun run build:ci --target bun",
   };
 }
 
@@ -505,12 +465,12 @@ function getBuildZigStep(platform, options) {
   const toolchain = getBuildToolchain(platform);
   return {
     key: `${getTargetKey(platform)}-build-zig`,
-    retry: getRetry(),
     label: `${getTargetLabel(platform)} - build-zig`,
     agents: getZigAgent(platform, options),
+    retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: `${getBuildCommand(platform, options)} --target bun-zig --toolchain ${toolchain}`,
+    command: `bun run build:ci --target bun-zig --toolchain ${toolchain}`,
     timeout_in_minutes: 35,
   };
 }
@@ -524,16 +484,19 @@ function getLinkBunStep(platform, options) {
   return {
     key: `${getTargetKey(platform)}-build-bun`,
     label: `${getTargetLabel(platform)} - build-bun`,
-    depends_on: [`${getTargetKey(platform)}-build-cpp`, `${getTargetKey(platform)}-build-zig`],
-    agents: getLinkBunAgent(platform, options),
+    depends_on: [
+      `${getTargetKey(platform)}-build-vendor`,
+      `${getTargetKey(platform)}-build-cpp`,
+      `${getTargetKey(platform)}-build-zig`,
+    ],
+    agents: getCppAgent(platform, options),
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: {
       BUN_LINK_ONLY: "ON",
-      ASAN_OPTIONS: "allow_user_segv_handler=1:disable_coredump=0:detect_leaks=0",
       ...getBuildEnv(platform, options),
     },
-    command: `${getBuildCommand(platform, options, "build-bun")} --target bun`,
+    command: "bun run build:ci --target bun",
   };
 }
 
@@ -550,13 +513,14 @@ function getBuildBunStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: getBuildCommand(platform, options),
+    command: "bun run build:ci",
   };
 }
 
 /**
  * @typedef {Object} TestOptions
  * @property {string} [buildId]
+ * @property {boolean} [unifiedTests]
  * @property {string[]} [testFiles]
  * @property {boolean} [dryRun]
  */
@@ -568,8 +532,8 @@ function getBuildBunStep(platform, options) {
  * @returns {Step}
  */
 function getTestBunStep(platform, options, testOptions = {}) {
-  const { os, profile } = platform;
-  const { buildId, testFiles } = testOptions;
+  const { os } = platform;
+  const { buildId, unifiedTests, testFiles } = testOptions;
 
   const args = [`--step=${getTargetKey(platform)}-build-bun`];
   if (buildId) {
@@ -591,11 +555,7 @@ function getTestBunStep(platform, options, testOptions = {}) {
     agents: getTestAgent(platform, options),
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
-    parallelism: os === "darwin" ? 2 : 10,
-    timeout_in_minutes: profile === "asan" || os === "windows" ? 45 : 30,
-    env: {
-      ASAN_OPTIONS: "allow_user_segv_handler=1:disable_coredump=0:detect_leaks=0",
-    },
+    parallelism: unifiedTests ? undefined : os === "darwin" ? 2 : 10,
     command:
       os === "windows"
         ? `node .\\scripts\\runner.node.mjs ${args.join(" ")}`
@@ -660,7 +620,7 @@ function getReleaseStep(buildPlatforms, options) {
     agents: {
       queue: "test-darwin",
     },
-    depends_on: buildPlatforms.filter(p => p.os !== "freebsd").map(platform => `${getTargetKey(platform)}-build-bun`),
+    depends_on: buildPlatforms.map(platform => `${getTargetKey(platform)}-build-bun`),
     env: {
       CANARY: revision,
     },
@@ -669,7 +629,6 @@ function getReleaseStep(buildPlatforms, options) {
 }
 
 /**
- * @param {Platform[]} buildPlatforms
  * @returns {Step}
  */
 function getBenchmarkStep() {
@@ -677,10 +636,10 @@ function getBenchmarkStep() {
     key: "benchmark",
     label: "📊",
     agents: {
-      queue: "build-image",
+      queue: "build-zig",
     },
-    depends_on: `linux-x64-build-bun`,
-    command: "node .buildkite/scripts/upload-benchmark.mjs",
+    command: "bun .buildkite/scripts/upload-benchmark.ts",
+    depends_on: [`linux-x64-build-bun`],
   };
 }
 
@@ -770,9 +729,12 @@ function getBenchmarkStep() {
  * @property {string | boolean} [buildImages]
  * @property {string | boolean} [publishImages]
  * @property {number} [canary]
+ * @property {Profile[]} [buildProfiles]
  * @property {Platform[]} [buildPlatforms]
  * @property {Platform[]} [testPlatforms]
  * @property {string[]} [testFiles]
+ * @property {boolean} [unifiedBuilds]
+ * @property {boolean} [unifiedTests]
  */
 
 /**
@@ -862,10 +824,6 @@ function getOptionsStep() {
             label: `${getEmoji("assert")} Release with Assertions`,
             value: "assert",
           },
-          {
-            label: `${getEmoji("asan")} Release with ASAN`,
-            value: "asan",
-          },
           {
             label: `${getEmoji("debug")} Debug`,
             value: "debug",
@@ -943,6 +901,22 @@ function getOptionsStep() {
         default: "false",
         options: booleanOptions,
       },
+      {
+        key: "unified-builds",
+        select: "Do you want to build each platform in a single step?",
+        hint: "If true, builds will not be split into seperate steps (this will likely slow down the build)",
+        required: false,
+        default: "false",
+        options: booleanOptions,
+      },
+      {
+        key: "unified-tests",
+        select: "Do you want to run tests in a single step?",
+        hint: "If true, tests will not be split into seperate steps (this will be very slow)",
+        required: false,
+        default: "false",
+        options: booleanOptions,
+      },
     ],
   };
 }
@@ -972,13 +946,8 @@ async function getPipelineOptions() {
     return;
   }
 
-  let filteredBuildPlatforms = buildPlatforms;
-  if (isMainBranch()) {
-    filteredBuildPlatforms = buildPlatforms.filter(({ profile }) => profile !== "asan");
-  }
-
   const canary = await getCanaryRevision();
-  const buildPlatformsMap = new Map(filteredBuildPlatforms.map(platform => [getTargetKey(platform), platform]));
+  const buildPlatformsMap = new Map(buildPlatforms.map(platform => [getTargetKey(platform), platform]));
   const testPlatformsMap = new Map(testPlatforms.map(platform => [getPlatformKey(platform), platform]));
 
   if (isManual) {
@@ -997,7 +966,6 @@ async function getPipelineOptions() {
         ?.map(item => item.trim())
         ?.filter(Boolean);
 
-    const buildProfiles = parseArray(options["build-profiles"]);
     const buildPlatformKeys = parseArray(options["build-platforms"]);
     const testPlatformKeys = parseArray(options["test-platforms"]);
     return {
@@ -1008,11 +976,14 @@ async function getPipelineOptions() {
       buildImages: parseBoolean(options["build-images"]),
       publishImages: parseBoolean(options["publish-images"]),
       testFiles: parseArray(options["test-files"]),
+      unifiedBuilds: parseBoolean(options["unified-builds"]),
+      unifiedTests: parseBoolean(options["unified-tests"]),
+      buildProfiles: parseArray(options["build-profiles"]),
       buildPlatforms: buildPlatformKeys?.length
-        ? buildPlatformKeys.flatMap(key => buildProfiles.map(profile => ({ ...buildPlatformsMap.get(key), profile })))
+        ? buildPlatformKeys.map(key => buildPlatformsMap.get(key))
         : Array.from(buildPlatformsMap.values()),
       testPlatforms: testPlatformKeys?.length
-        ? testPlatformKeys.flatMap(key => buildProfiles.map(profile => ({ ...testPlatformsMap.get(key), profile })))
+        ? testPlatformKeys.map(key => testPlatformsMap.get(key))
         : Array.from(testPlatformsMap.values()),
       dryRun: parseBoolean(options["dry-run"]),
     };
@@ -1047,6 +1018,7 @@ async function getPipelineOptions() {
     publishImages: parseOption(/\[(publish images?)\]/i),
     buildPlatforms: Array.from(buildPlatformsMap.values()),
     testPlatforms: Array.from(testPlatformsMap.values()),
+    buildProfiles: ["release"],
   };
 }
 
@@ -1069,11 +1041,11 @@ async function getPipeline(options = {}) {
     return;
   }
 
-  const { buildPlatforms = [], testPlatforms = [], buildImages, publishImages } = options;
+  const { buildProfiles = [], buildPlatforms = [], testPlatforms = [], buildImages, publishImages } = options;
   const imagePlatforms = new Map(
     buildImages || publishImages
       ? [...buildPlatforms, ...testPlatforms]
-          .filter(({ os }) => os !== "darwin")
+          .filter(({ os }) => os === "linux" || os === "windows")
           .map(platform => [getImageKey(platform), platform])
       : [],
   );
@@ -1089,7 +1061,7 @@ async function getPipeline(options = {}) {
     });
   }
 
-  let { skipBuilds, forceBuilds, dryRun } = options;
+  let { skipBuilds, forceBuilds, unifiedBuilds, dryRun } = options;
   dryRun = dryRun || !!buildImages;
 
   /** @type {string | undefined} */
@@ -1104,51 +1076,43 @@ async function getPipeline(options = {}) {
     }
   }
 
-  const includeASAN = !isMainBranch();
-
   if (!buildId) {
-    let relevantBuildPlatforms = includeASAN
-      ? buildPlatforms
-      : buildPlatforms.filter(({ profile }) => profile !== "asan");
-
-    // run build-image but no build-bun yet
-    relevantBuildPlatforms = relevantBuildPlatforms.filter(({ os }) => os !== "freebsd");
-
     steps.push(
-      ...relevantBuildPlatforms.map(target => {
-        const imageKey = getImageKey(target);
-        const zigImageKey = getImageKey(getZigPlatform());
-        const dependsOn = imagePlatforms.has(zigImageKey) ? [`${zigImageKey}-build-image`] : [];
-        if (imagePlatforms.has(imageKey)) {
-          dependsOn.push(`${imageKey}-build-image`);
-        }
+      ...buildPlatforms
+        .flatMap(platform => buildProfiles.map(profile => ({ ...platform, profile })))
+        .map(target => {
+          const imageKey = getImageKey(target);
 
-        const steps = [];
-        steps.push(getBuildCppStep(target, options));
-        steps.push(getBuildZigStep(target, options));
-        steps.push(getLinkBunStep(target, options));
-
-        return getStepWithDependsOn(
-          {
-            key: getTargetKey(target),
-            group: getTargetLabel(target),
-            steps,
-          },
-          ...dependsOn,
-        );
-      }),
+          return getStepWithDependsOn(
+            {
+              key: getTargetKey(target),
+              group: getTargetLabel(target),
+              steps: unifiedBuilds
+                ? [getBuildBunStep(target, options)]
+                : [
+                    getBuildVendorStep(target, options),
+                    getBuildCppStep(target, options),
+                    getBuildZigStep(target, options),
+                    getLinkBunStep(target, options),
+                  ],
+            },
+            imagePlatforms.has(imageKey) ? `${imageKey}-build-image` : undefined,
+          );
+        }),
     );
   }
 
   if (!isMainBranch()) {
-    const { skipTests, forceTests, testFiles } = options;
+    const { skipTests, forceTests, unifiedTests, testFiles } = options;
     if (!skipTests || forceTests) {
       steps.push(
-        ...testPlatforms.map(target => ({
-          key: getTargetKey(target),
-          group: getTargetLabel(target),
-          steps: [getTestBunStep(target, options, { testFiles, buildId })],
-        })),
+        ...testPlatforms
+          .flatMap(platform => buildProfiles.map(profile => ({ ...platform, profile })))
+          .map(target => ({
+            key: getTargetKey(target),
+            group: getTargetLabel(target),
+            steps: [getTestBunStep(target, options, { unifiedTests, testFiles, buildId })],
+          })),
       );
     }
   }
@@ -1156,6 +1120,7 @@ async function getPipeline(options = {}) {
   if (isMainBranch()) {
     steps.push(getReleaseStep(buildPlatforms, options));
   }
+
   steps.push(getBenchmarkStep());
 
   /** @type {Map<string, GroupStep>} */
@@ -1190,43 +1155,6 @@ async function main() {
     console.log("Generated options:", options);
   }
 
-  startGroup("Querying GitHub for files...");
-  if (options && isBuildkite && !isMainBranch()) {
-    /** @type {string[]} */
-    let allFiles = [];
-    /** @type {string[]} */
-    let newFiles = [];
-    let prFileCount = 0;
-    try {
-      console.log("on buildkite: collecting new files from PR");
-      const per_page = 50;
-      const { BUILDKITE_PULL_REQUEST } = process.env;
-      for (let i = 1; i <= 10; i++) {
-        const res = await fetch(
-          `https://api.github.com/repos/oven-sh/bun/pulls/${BUILDKITE_PULL_REQUEST}/files?per_page=${per_page}&page=${i}`,
-          { headers: { Authorization: `Bearer ${getSecret("GITHUB_TOKEN")}` } },
-        );
-        const doc = await res.json();
-        console.log(`-> page ${i}, found ${doc.length} items`);
-        if (doc.length === 0) break;
-        for (const { filename, status } of doc) {
-          prFileCount += 1;
-          allFiles.push(filename);
-          if (status !== "added") continue;
-          newFiles.push(filename);
-        }
-        if (doc.length < per_page) break;
-      }
-      console.log(`- PR ${BUILDKITE_PULL_REQUEST}, ${prFileCount} files, ${newFiles.length} new files`);
-    } catch (e) {
-      console.error(e);
-    }
-    if (allFiles.every(filename => filename.startsWith("docs/"))) {
-      console.log(`- PR is only docs, skipping tests!`);
-      return;
-    }
-  }
-
   startGroup("Generating pipeline...");
   const pipeline = await getPipeline(options);
   if (!pipeline) {

.buildkite/scripts/sign-windows.ps1

@@ -1,464 +0,0 @@
-# Windows Code Signing Script for Bun
-# Uses DigiCert KeyLocker for Authenticode signing
-# Native PowerShell implementation - no path translation issues
-
-param(
-    [Parameter(Mandatory=$true)]
-    [string]$BunProfileExe,
-    
-    [Parameter(Mandatory=$true)]
-    [string]$BunExe
-)
-
-$ErrorActionPreference = "Stop"
-$ProgressPreference = "SilentlyContinue"
-
-# Logging functions
-function Log-Info {
-    param([string]$Message)
-    Write-Host "[INFO] $Message" -ForegroundColor Cyan
-}
-
-function Log-Success {
-    param([string]$Message)
-    Write-Host "[SUCCESS] $Message" -ForegroundColor Green
-}
-
-function Log-Error {
-    param([string]$Message)
-    Write-Host "[ERROR] $Message" -ForegroundColor Red
-}
-
-function Log-Debug {
-    param([string]$Message)
-    if ($env:DEBUG -eq "true" -or $env:DEBUG -eq "1") {
-        Write-Host "[DEBUG] $Message" -ForegroundColor Gray
-    }
-}
-
-# Load Visual Studio environment if not already loaded
-function Ensure-VSEnvironment {
-    if ($null -eq $env:VSINSTALLDIR) {
-        Log-Info "Loading Visual Studio environment..."
-        
-        $vswhere = "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe"
-        if (!(Test-Path $vswhere)) {
-            throw "Command not found: vswhere (did you install Visual Studio?)"
-        }
-        
-        $vsDir = & $vswhere -prerelease -latest -property installationPath
-        if ($null -eq $vsDir) {
-            $vsDir = Get-ChildItem -Path "C:\Program Files\Microsoft Visual Studio\2022" -Directory -ErrorAction SilentlyContinue
-            if ($null -eq $vsDir) {
-                throw "Visual Studio directory not found."
-            }
-            $vsDir = $vsDir.FullName
-        }
-        
-        Push-Location $vsDir
-        try {
-            $vsShell = Join-Path -Path $vsDir -ChildPath "Common7\Tools\Launch-VsDevShell.ps1"
-            . $vsShell -Arch amd64 -HostArch amd64
-        } finally {
-            Pop-Location
-        }
-        
-        Log-Success "Visual Studio environment loaded"
-    }
-    
-    if ($env:VSCMD_ARG_TGT_ARCH -eq "x86") {
-        throw "Visual Studio environment is targeting 32 bit, but only 64 bit is supported."
-    }
-}
-
-# Check for required environment variables
-function Check-Environment {
-    Log-Info "Checking environment variables..."
-    
-    $required = @{
-        "SM_API_KEY" = $env:SM_API_KEY
-        "SM_CLIENT_CERT_PASSWORD" = $env:SM_CLIENT_CERT_PASSWORD
-        "SM_KEYPAIR_ALIAS" = $env:SM_KEYPAIR_ALIAS
-        "SM_HOST" = $env:SM_HOST
-        "SM_CLIENT_CERT_FILE" = $env:SM_CLIENT_CERT_FILE
-    }
-    
-    $missing = @()
-    foreach ($key in $required.Keys) {
-        if ([string]::IsNullOrEmpty($required[$key])) {
-            $missing += $key
-        } else {
-            Log-Debug "$key is set (length: $($required[$key].Length))"
-        }
-    }
-    
-    if ($missing.Count -gt 0) {
-        throw "Missing required environment variables: $($missing -join ', ')"
-    }
-    
-    Log-Success "All required environment variables are present"
-}
-
-# Setup certificate file
-function Setup-Certificate {
-    Log-Info "Setting up certificate..."
-    
-    # Always try to decode as base64 first
-    # If it fails, then treat as file path
-    try {
-        Log-Info "Attempting to decode certificate as base64..."
-        Log-Debug "Input string length: $($env:SM_CLIENT_CERT_FILE.Length) characters"
-        
-        $tempCertPath = Join-Path $env:TEMP "digicert_cert_$(Get-Random).p12"
-        
-        # Try to decode as base64
-        $certBytes = [System.Convert]::FromBase64String($env:SM_CLIENT_CERT_FILE)
-        [System.IO.File]::WriteAllBytes($tempCertPath, $certBytes)
-        
-        # Validate the decoded certificate size
-        $fileSize = (Get-Item $tempCertPath).Length
-        if ($fileSize -lt 100) {
-            throw "Decoded certificate too small: $fileSize bytes (expected >100 bytes)"
-        }
-        
-        # Update environment to point to file
-        $env:SM_CLIENT_CERT_FILE = $tempCertPath
-        
-        Log-Success "Certificate decoded and written to: $tempCertPath"
-        Log-Debug "Decoded certificate file size: $fileSize bytes"
-        
-        # Register cleanup
-        $global:TEMP_CERT_PATH = $tempCertPath
-        
-    } catch {
-        # If base64 decode fails, check if it's a file path
-        Log-Info "Base64 decode failed, checking if it's a file path..."
-        Log-Debug "Decode error: $_"
-        
-        if (Test-Path $env:SM_CLIENT_CERT_FILE) {
-            $fileSize = (Get-Item $env:SM_CLIENT_CERT_FILE).Length
-            
-            # Validate file size
-            if ($fileSize -lt 100) {
-                throw "Certificate file too small: $fileSize bytes at $env:SM_CLIENT_CERT_FILE (possibly corrupted)"
-            }
-            
-            Log-Info "Using certificate file: $env:SM_CLIENT_CERT_FILE"
-            Log-Debug "Certificate file size: $fileSize bytes"
-        } else {
-            throw "SM_CLIENT_CERT_FILE is neither valid base64 nor an existing file: $env:SM_CLIENT_CERT_FILE"
-        }
-    }
-}
-
-# Install DigiCert KeyLocker tools
-function Install-KeyLocker {
-    Log-Info "Setting up DigiCert KeyLocker tools..."
-    
-    # Define our controlled installation directory
-    $installDir = "C:\BuildTools\DigiCert"
-    $smctlPath = Join-Path $installDir "smctl.exe"
-    
-    # Check if already installed in our controlled location
-    if (Test-Path $smctlPath) {
-        Log-Success "KeyLocker tools already installed at: $smctlPath"
-        
-        # Add to PATH if not already there
-        if ($env:PATH -notlike "*$installDir*") {
-            $env:PATH = "$installDir;$env:PATH"
-            Log-Info "Added to PATH: $installDir"
-        }
-        
-        return $smctlPath
-    }
-    
-    Log-Info "Installing KeyLocker tools to: $installDir"
-    
-    # Create the installation directory if it doesn't exist
-    if (!(Test-Path $installDir)) {
-        Log-Info "Creating installation directory: $installDir"
-        try {
-            New-Item -ItemType Directory -Path $installDir -Force | Out-Null
-            Log-Success "Created directory: $installDir"
-        } catch {
-            throw "Failed to create directory $installDir : $_"
-        }
-    }
-    
-    # Download MSI installer
-    $msiUrl = "https://bun-ci-assets.bun.sh/Keylockertools-windows-x64.msi"
-    $msiPath = Join-Path $env:TEMP "Keylockertools-windows-x64.msi"
-    
-    Log-Info "Downloading MSI from: $msiUrl"
-    Log-Info "Downloading to: $msiPath"
-    
-    try {
-        # Remove existing MSI if present
-        if (Test-Path $msiPath) {
-            Remove-Item $msiPath -Force
-            Log-Debug "Removed existing MSI file"
-        }
-        
-        # Download with progress tracking
-        $webClient = New-Object System.Net.WebClient
-        $webClient.DownloadFile($msiUrl, $msiPath)
-        
-        if (!(Test-Path $msiPath)) {
-            throw "MSI download failed - file not found"
-        }
-        
-        $fileSize = (Get-Item $msiPath).Length
-        Log-Success "MSI downloaded successfully (size: $fileSize bytes)"
-        
-    } catch {
-        throw "Failed to download MSI: $_"
-    }
-    
-    # Install MSI
-    Log-Info "Installing MSI..."
-    Log-Debug "MSI path: $msiPath"
-    Log-Debug "File exists: $(Test-Path $msiPath)"
-    Log-Debug "File size: $((Get-Item $msiPath).Length) bytes"
-    
-    # Check if running as administrator
-    $isAdmin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
-    Log-Info "Running as administrator: $isAdmin"
-    
-    # Install MSI silently to our controlled directory
-    $arguments = @(
-        "/i", "`"$msiPath`"",
-        "/quiet",
-        "/norestart",
-        "TARGETDIR=`"$installDir`"",
-        "INSTALLDIR=`"$installDir`"",
-        "ACCEPT_EULA=1",
-        "ADDLOCAL=ALL"
-    )
-    
-    Log-Debug "Running: msiexec.exe $($arguments -join ' ')"
-    Log-Info "Installing to: $installDir"
-    
-    $process = Start-Process -FilePath "msiexec.exe" -ArgumentList $arguments -Wait -PassThru -NoNewWindow
-    
-    if ($process.ExitCode -ne 0) {
-        Log-Error "MSI installation failed with exit code: $($process.ExitCode)"
-        
-        # Try to get error details from event log
-        try {
-            $events = Get-WinEvent -LogName "Application" -MaxEvents 10 | 
-                Where-Object { $_.ProviderName -eq "MsiInstaller" -and $_.TimeCreated -gt (Get-Date).AddMinutes(-1) }
-            
-            foreach ($event in $events) {
-                Log-Debug "MSI Event: $($event.Message)"
-            }
-        } catch {
-            Log-Debug "Could not retrieve MSI installation events"
-        }
-        
-        throw "MSI installation failed with exit code: $($process.ExitCode)"
-    }
-    
-    Log-Success "MSI installation completed"
-    
-    # Wait for installation to complete
-    Start-Sleep -Seconds 2
-    
-    # Verify smctl.exe exists in our controlled location
-    if (Test-Path $smctlPath) {
-        Log-Success "KeyLocker tools installed successfully at: $smctlPath"
-        
-        # Add to PATH
-        $env:PATH = "$installDir;$env:PATH"
-        Log-Info "Added to PATH: $installDir"
-        
-        return $smctlPath
-    }
-    
-    # If not in our expected location, check if it installed somewhere in the directory
-    $found = Get-ChildItem -Path $installDir -Filter "smctl.exe" -Recurse -ErrorAction SilentlyContinue | 
-        Select-Object -First 1
-    
-    if ($found) {
-        Log-Success "Found smctl.exe at: $($found.FullName)"
-        $smctlDir = $found.DirectoryName
-        $env:PATH = "$smctlDir;$env:PATH"
-        return $found.FullName
-    }
-    
-    throw "KeyLocker tools installation succeeded but smctl.exe not found in $installDir"
-}
-
-# Configure KeyLocker
-function Configure-KeyLocker {
-    param([string]$SmctlPath)
-    
-    Log-Info "Configuring KeyLocker..."
-    
-    # Verify smctl is accessible
-    try {
-        $version = & $SmctlPath --version 2>&1
-        Log-Debug "smctl version: $version"
-    } catch {
-        throw "Failed to run smctl: $_"
-    }
-    
-    # Configure KeyLocker credentials and environment
-    Log-Info "Configuring KeyLocker credentials..."
-    
-    try {
-        # Save credentials (API key and password)
-        Log-Info "Saving credentials to OS store..."
-        $saveOutput = & $SmctlPath credentials save $env:SM_API_KEY $env:SM_CLIENT_CERT_PASSWORD 2>&1 | Out-String
-        Log-Debug "Credentials save output: $saveOutput"
-        
-        if ($saveOutput -like "*Credentials saved*") {
-            Log-Success "Credentials saved successfully"
-        }
-        
-        # Set environment variables for smctl
-        Log-Info "Setting KeyLocker environment variables..."
-        $env:SM_HOST = $env:SM_HOST  # Already set, but ensure it's available
-        $env:SM_API_KEY = $env:SM_API_KEY  # Already set
-        $env:SM_CLIENT_CERT_FILE = $env:SM_CLIENT_CERT_FILE  # Path to decoded cert file
-        Log-Debug "SM_HOST: $env:SM_HOST"
-        Log-Debug "SM_CLIENT_CERT_FILE: $env:SM_CLIENT_CERT_FILE"
-        
-        # Run health check
-        Log-Info "Running KeyLocker health check..."
-        $healthOutput = & $SmctlPath healthcheck 2>&1 | Out-String
-        Log-Debug "Health check output: $healthOutput"
-        
-        if ($healthOutput -like "*Healthy*" -or $healthOutput -like "*SUCCESS*" -or $LASTEXITCODE -eq 0) {
-            Log-Success "KeyLocker health check passed"
-        } else {
-            Log-Error "Health check failed: $healthOutput"
-            # Don't throw here, sometimes healthcheck is flaky but signing still works
-        }
-        
-        # Sync certificates to Windows certificate store
-        Log-Info "Syncing certificates to Windows store..."
-        $syncOutput = & $SmctlPath windows certsync 2>&1 | Out-String
-        Log-Debug "Certificate sync output: $syncOutput"
-        
-        if ($syncOutput -like "*success*" -or $syncOutput -like "*synced*" -or $LASTEXITCODE -eq 0) {
-            Log-Success "Certificates synced to Windows store"
-        } else {
-            Log-Info "Certificate sync output: $syncOutput"
-        }
-        
-    } catch {
-        throw "Failed to configure KeyLocker: $_"
-    }
-}
-
-# Sign an executable
-function Sign-Executable {
-    param(
-        [string]$ExePath,
-        [string]$SmctlPath
-    )
-    
-    if (!(Test-Path $ExePath)) {
-        throw "Executable not found: $ExePath"
-    }
-    
-    $fileName = Split-Path $ExePath -Leaf
-    Log-Info "Signing $fileName..."
-    Log-Debug "Full path: $ExePath"
-    Log-Debug "File size: $((Get-Item $ExePath).Length) bytes"
-    
-    # Check if already signed
-    $existingSig = Get-AuthenticodeSignature $ExePath
-    if ($existingSig.Status -eq "Valid") {
-        Log-Info "$fileName is already signed by: $($existingSig.SignerCertificate.Subject)"
-        Log-Info "Skipping re-signing"
-        return
-    }
-    
-    # Sign the executable using smctl
-    try {
-        # smctl sign command with keypair-alias
-        $signArgs = @(
-            "sign",
-            "--keypair-alias", $env:SM_KEYPAIR_ALIAS,
-            "--input", $ExePath,
-            "--verbose"
-        )
-        
-        Log-Debug "Running: $SmctlPath $($signArgs -join ' ')"
-        
-        $signOutput = & $SmctlPath $signArgs 2>&1 | Out-String
-        
-        if ($LASTEXITCODE -ne 0) {
-            Log-Error "Signing output: $signOutput"
-            throw "Signing failed with exit code: $LASTEXITCODE"
-        }
-        
-        Log-Debug "Signing output: $signOutput"
-        Log-Success "Signing command completed"
-        
-    } catch {
-        throw "Failed to sign $fileName : $_"
-    }
-    
-    # Verify signature
-    $newSig = Get-AuthenticodeSignature $ExePath
-    
-    if ($newSig.Status -eq "Valid") {
-        Log-Success "$fileName signed successfully"
-        Log-Info "Signed by: $($newSig.SignerCertificate.Subject)"
-        Log-Info "Thumbprint: $($newSig.SignerCertificate.Thumbprint)"
-        Log-Info "Valid from: $($newSig.SignerCertificate.NotBefore) to $($newSig.SignerCertificate.NotAfter)"
-    } else {
-        throw "$fileName signature verification failed: $($newSig.Status) - $($newSig.StatusMessage)"
-    }
-}
-
-# Cleanup function
-function Cleanup {
-    if ($global:TEMP_CERT_PATH -and (Test-Path $global:TEMP_CERT_PATH)) {
-        try {
-            Remove-Item $global:TEMP_CERT_PATH -Force
-            Log-Info "Cleaned up temporary certificate"
-        } catch {
-            Log-Error "Failed to cleanup temporary certificate: $_"
-        }
-    }
-}
-
-# Main execution
-try {
-    Write-Host "========================================" -ForegroundColor Cyan
-    Write-Host "  Windows Code Signing for Bun" -ForegroundColor Cyan
-    Write-Host "========================================" -ForegroundColor Cyan
-    
-    # Ensure we're in a VS environment
-    Ensure-VSEnvironment
-    
-    # Check environment variables
-    Check-Environment
-    
-    # Setup certificate
-    Setup-Certificate
-    
-    # Install and configure KeyLocker
-    $smctlPath = Install-KeyLocker
-    Configure-KeyLocker -SmctlPath $smctlPath
-    
-    # Sign both executables
-    Sign-Executable -ExePath $BunProfileExe -SmctlPath $smctlPath
-    Sign-Executable -ExePath $BunExe -SmctlPath $smctlPath
-    
-    Write-Host "========================================" -ForegroundColor Green
-    Write-Host "  Code signing completed successfully!" -ForegroundColor Green
-    Write-Host "========================================" -ForegroundColor Green
-    
-    exit 0
-    
-} catch {
-    Log-Error "Code signing failed: $_"
-    exit 1
-    
-} finally {
-    Cleanup
-}

.claude/commands/dedupe.md

@@ -1,43 +0,0 @@
----
-allowed-tools: Bash(gh issue view:*), Bash(gh search:*), Bash(gh issue list:*), Bash(gh api:*), Bash(gh issue comment:*)
-description: Find duplicate GitHub issues
----
-
-# Issue deduplication command
-
-Find up to 3 likely duplicate issues for a given GitHub issue.
-
-To do this, follow these steps precisely:
-
-1. Use an agent to check if the GitHub issue (a) is closed, (b) does not need to be deduped (eg. because it is broad product feedback without a specific solution, or positive feedback), or (c) already has a duplicate detection comment (check for the exact HTML marker `<!-- dedupe-bot:marker -->` in the issue comments - ignore other bot comments). If so, do not proceed.
-2. Use an agent to view a GitHub issue, and ask the agent to return a summary of the issue
-3. Then, launch 5 parallel agents to search GitHub for duplicates of this issue, using diverse keywords and search approaches, using the summary from Step 2. **IMPORTANT**: Always scope searches with `repo:owner/repo` to constrain results to the current repository only.
-4. Next, feed the results from Steps 2 and 3 into another agent, so that it can filter out false positives, that are likely not actually duplicates of the original issue. If there are no duplicates remaining, do not proceed.
-5. Finally, comment back on the issue with a list of up to three duplicate issues (or zero, if there are no likely duplicates)
-
-Notes (be sure to tell this to your agents, too):
-
-- Use `gh` to interact with GitHub, rather than web fetch
-- Do not use other tools, beyond `gh` (eg. don't use other MCP servers, file edit, etc.)
-- Make a todo list first
-- Always scope searches with `repo:owner/repo` to prevent cross-repo false positives
-- For your comment, follow the following format precisely (assuming for this example that you found 3 suspected duplicates):
-
----
-
-Found 3 possible duplicate issues:
-
-1. <link to issue>
-2. <link to issue>
-3. <link to issue>
-
-This issue will be automatically closed as a duplicate in 3 days.
-
-- If your issue is a duplicate, please close it and 👍 the existing issue instead
-- To prevent auto-closure, add a comment or 👎 this comment
-
-🤖 Generated with [Claude Code](https://claude.ai/code)
-
-<!-- dedupe-bot:marker -->
-
----

.claude/commands/upgrade-nodejs.md

@@ -1,92 +0,0 @@
-# Upgrading Bun's Self-Reported Node.js Version
-
-This guide explains how to upgrade the Node.js version that Bun reports for compatibility with Node.js packages and native addons.
-
-## Overview
-
-Bun reports a Node.js version for compatibility with the Node.js ecosystem. This affects:
-- `process.version` output
-- Node-API (N-API) compatibility
-- Native addon ABI compatibility
-- V8 API compatibility for addons using V8 directly
-
-## Files That Always Need Updates
-
-### 1. Bootstrap Scripts
-- `scripts/bootstrap.sh` - Update `NODEJS_VERSION=`
-- `scripts/bootstrap.ps1` - Update `$NODEJS_VERSION =`
-
-### 2. CMake Configuration
-- `cmake/Options.cmake`
-  - `NODEJS_VERSION` - The Node.js version string (e.g., "24.3.0")
-  - `NODEJS_ABI_VERSION` - The ABI version number (find using command below)
-
-### 3. Version Strings
-- `src/bun.js/bindings/BunProcess.cpp`
-  - Update `Bun__versions_node` with the Node.js version
-  - Update `Bun__versions_v8` with the V8 version (find using command below)
-
-### 4. N-API Version
-- `src/napi/js_native_api.h`
-  - Update `NAPI_VERSION` define (check Node.js release notes)
-
-## Files That May Need Updates
-
-Only check these if the build fails or tests crash after updating version numbers:
-- V8 compatibility files in `src/bun.js/bindings/v8/` (if V8 API changed)
-- Test files (if Node.js requires newer C++ standard)
-
-## Quick Commands to Find Version Info
-
-```bash
-# Get latest Node.js version info
-curl -s https://nodejs.org/dist/index.json | jq '.[0]'
-
-# Get V8 version for a specific Node.js version (replace v24.3.0)
-curl -s https://nodejs.org/dist/v24.3.0/node-v24.3.0-headers.tar.gz | tar -xzO node-v24.3.0/include/node/node_version.h | grep V8_VERSION
-
-# Get ABI version for a specific Node.js version
-curl -s https://nodejs.org/dist/v24.3.0/node-v24.3.0-headers.tar.gz | tar -xzO node-v24.3.0/include/node/node_version.h | grep NODE_MODULE_VERSION
-
-# Or use the ABI registry
-curl -s https://raw.githubusercontent.com/nodejs/node/main/doc/abi_version_registry.json | jq '.NODE_MODULE_VERSION."<version>"'
-```
-
-## Update Process
-
-1. **Gather version info** using the commands above
-2. **Update the required files** listed in the sections above
-3. **Build and test**:
-   ```bash
-   bun bd
-   bun bd -e "console.log(process.version)"
-   bun bd -e "console.log(process.versions.v8)"
-   bun bd test test/v8/v8.test.ts
-   bun bd test test/napi/napi.test.ts
-   ```
-
-4. **Check for V8 API changes** only if build fails or tests crash:
-   - Compare v8-function-callback.h between versions
-   - Check v8-internal.h for Isolate size changes
-   - Look for new required APIs in build errors
-
-## If Build Fails or Tests Crash
-
-The V8 API rarely has breaking changes between minor Node.js versions. If you encounter issues:
-1. Check build errors for missing symbols or type mismatches
-2. Compare V8 headers between old and new Node.js versions
-3. Most issues can be resolved by implementing missing functions or adjusting structures
-
-## Testing Checklist
-
-- [ ] `process.version` returns correct version
-- [ ] `process.versions.v8` returns correct V8 version  
-- [ ] `process.config.variables.node_module_version` returns correct ABI
-- [ ] V8 tests pass
-- [ ] N-API tests pass
-
-## Notes
-
-- Most upgrades only require updating version numbers
-- Major V8 version changes (rare) may require API updates
-- The V8 shim implements only APIs used by common native addons

.claude/commands/upgrade-webkit.md

@@ -1,23 +0,0 @@
-Upgrade Bun's Webkit fork to the latest upstream version of Webkit.
-
-To do that:
-
-- cd vendor/WebKit
-- git fetch upstream
-- git merge upstream main
-- Fix the merge conflicts
-- cd ../../ (back to bun)
-- make jsc-build (this will take about 7 minutes)
-- While it compiles, in another task review the JSC commits between the last version of Webkit and the new version. Write up a summary of the webkit changes in a file called "webkit-changes.md"
-- bun run build:local (build a build of Bun with the new Webkit, make sure it compiles)
-- After making sure it compiles, run some code to make sure things work. something like ./build/debug-local/bun-debug --print '42' should be all you need
-- cd vendor/WebKit
-- git commit -am "Upgrade Webkit to the latest version"
-- git push
-- get the commit SHA in the vendor/WebKit directory of your new commit
-- cd ../../ (back to bun)
-- Update WEBKIT_VERSION in cmake/tools/SetupWebKit.cmake to the commit SHA of your new commit
-- git checkout -b bun/webkit-upgrade-<commit-sha>
-- commit + push (without adding the webkit-changes.md file)
-- create PR titled "Upgrade Webkit to the <commit-sha>", paste your webkit-changes.md into the PR description
-- delete the webkit-changes.md file

.claude/hooks/post-edit-zig-format.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env bun
-import { extname } from "path";
-import { spawnSync } from "child_process";
-
-const input = await Bun.stdin.json();
-
-const toolName = input.tool_name;
-const toolInput = input.tool_input || {};
-const filePath = toolInput.file_path;
-
-// Only process Write, Edit, and MultiEdit tools
-if (!["Write", "Edit", "MultiEdit"].includes(toolName)) {
-  process.exit(0);
-}
-
-const ext = extname(filePath);
-
-// Only format known files
-if (!filePath) {
-  process.exit(0);
-}
-
-function formatZigFile() {
-  try {
-    // Format the Zig file
-    const result = spawnSync("vendor/zig/zig.exe", ["fmt", filePath], {
-      cwd: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
-      encoding: "utf-8",
-    });
-
-    if (result.error) {
-      console.error(`Failed to format ${filePath}: ${result.error.message}`);
-      process.exit(0);
-    }
-
-    if (result.status !== 0) {
-      console.error(`zig fmt failed for ${filePath}:`);
-      if (result.stderr) {
-        console.error(result.stderr);
-      }
-      process.exit(0);
-    }
-  } catch (error) {}
-}
-
-function formatTypeScriptFile() {
-  try {
-    // Format the TypeScript file
-    const result = spawnSync(
-      "./node_modules/.bin/prettier",
-      ["--plugin=prettier-plugin-organize-imports", "--config", ".prettierrc", "--write", filePath],
-      {
-        cwd: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
-        encoding: "utf-8",
-      },
-    );
-  } catch (error) {}
-}
-
-if (ext === ".zig") {
-  formatZigFile();
-} else if (
-  [
-    ".cjs",
-    ".css",
-    ".html",
-    ".js",
-    ".json",
-    ".jsonc",
-    ".jsx",
-    ".less",
-    ".mjs",
-    ".pcss",
-    ".postcss",
-    ".sass",
-    ".scss",
-    ".styl",
-    ".stylus",
-    ".toml",
-    ".ts",
-    ".tsx",
-    ".yaml",
-  ].includes(ext)
-) {
-  formatTypeScriptFile();
-}
-
-process.exit(0);

.claude/hooks/pre-bash-zig-build.js

@@ -1,207 +0,0 @@
-#!/usr/bin/env bun
-import { basename, extname } from "path";
-
-const input = await Bun.stdin.json();
-
-const toolName = input.tool_name;
-const toolInput = input.tool_input || {};
-const command = toolInput.command || "";
-const timeout = toolInput.timeout;
-const cwd = input.cwd || "";
-
-// Get environment variables from the hook context
-// Note: We check process.env directly as env vars are inherited
-let useSystemBun = process.env.USE_SYSTEM_BUN;
-
-if (toolName !== "Bash" || !command) {
-  process.exit(0);
-}
-
-function denyWithReason(reason) {
-  const output = {
-    hookSpecificOutput: {
-      hookEventName: "PreToolUse",
-      permissionDecision: "deny",
-      permissionDecisionReason: reason,
-    },
-  };
-  console.log(JSON.stringify(output));
-  process.exit(0);
-}
-
-// Parse the command to extract argv0 and positional args
-let tokens;
-try {
-  // Simple shell parsing - split on spaces but respect quotes (both single and double)
-  tokens = command.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g)?.map(t => t.replace(/^['"]|['"]$/g, "")) || [];
-} catch {
-  process.exit(0);
-}
-
-if (tokens.length === 0) {
-  process.exit(0);
-}
-
-// Strip inline environment variable assignments (e.g., FOO=1 bun test)
-const inlineEnv = new Map();
-let commandStart = 0;
-while (
-  commandStart < tokens.length &&
-  /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[commandStart]) &&
-  !tokens[commandStart].includes("/")
-) {
-  const [name, value = ""] = tokens[commandStart].split("=", 2);
-  inlineEnv.set(name, value);
-  commandStart++;
-}
-if (commandStart >= tokens.length) {
-  process.exit(0);
-}
-tokens = tokens.slice(commandStart);
-useSystemBun = inlineEnv.get("USE_SYSTEM_BUN") ?? useSystemBun;
-
-// Get the executable name (argv0)
-const argv0 = basename(tokens[0], extname(tokens[0]));
-
-// Check if it's zig or zig.exe
-if (argv0 === "zig") {
-  // Filter out flags (starting with -) to get positional arguments
-  const positionalArgs = tokens.slice(1).filter(arg => !arg.startsWith("-"));
-
-  // Check if the positional args contain "build" followed by "obj"
-  if (positionalArgs.length >= 2 && positionalArgs[0] === "build" && positionalArgs[1] === "obj") {
-    denyWithReason("error: Use `bun bd` to build Bun and wait patiently");
-  }
-}
-
-// Check if argv0 is timeout and the command is "bun bd"
-if (argv0 === "timeout") {
-  // Find the actual command after timeout and its arguments
-  const timeoutArgEndIndex = tokens.slice(1).findIndex(t => !t.startsWith("-") && !/^\d/.test(t));
-  if (timeoutArgEndIndex === -1) {
-    process.exit(0);
-  }
-
-  const actualCommandIndex = timeoutArgEndIndex + 1;
-  if (actualCommandIndex >= tokens.length) {
-    process.exit(0);
-  }
-
-  const actualCommand = basename(tokens[actualCommandIndex]);
-  const restArgs = tokens.slice(actualCommandIndex + 1);
-
-  // Check if it's "bun bd" or "bun-debug bd" without other positional args
-  if (actualCommand === "bun" || actualCommand.includes("bun-debug")) {
-    // Claude is a sneaky fucker
-    let positionalArgs = restArgs.filter(arg => !arg.startsWith("-"));
-    const redirectStderrToStdoutIndex = positionalArgs.findIndex(arg => arg === "2>&1");
-    if (redirectStderrToStdoutIndex !== -1) {
-      positionalArgs.splice(redirectStderrToStdoutIndex, 1);
-    }
-    const redirectStdoutToStderrIndex = positionalArgs.findIndex(arg => arg === "1>&2");
-    if (redirectStdoutToStderrIndex !== -1) {
-      positionalArgs.splice(redirectStdoutToStderrIndex, 1);
-    }
-
-    const redirectToFileIndex = positionalArgs.findIndex(arg => arg === ">");
-    if (redirectToFileIndex !== -1) {
-      positionalArgs.splice(redirectToFileIndex, 2);
-    }
-
-    const redirectToFileAppendIndex = positionalArgs.findIndex(arg => arg === ">>");
-    if (redirectToFileAppendIndex !== -1) {
-      positionalArgs.splice(redirectToFileAppendIndex, 2);
-    }
-
-    const redirectTOFileInlineIndex = positionalArgs.findIndex(arg => arg.startsWith(">"));
-    if (redirectTOFileInlineIndex !== -1) {
-      positionalArgs.splice(redirectTOFileInlineIndex, 1);
-    }
-
-    const pipeIndex = positionalArgs.findIndex(arg => arg === "|");
-    if (pipeIndex !== -1) {
-      positionalArgs = positionalArgs.slice(0, pipeIndex);
-    }
-
-    positionalArgs = positionalArgs.map(arg => arg.trim()).filter(Boolean);
-
-    if (positionalArgs.length === 1 && positionalArgs[0] === "bd") {
-      denyWithReason("error: Run `bun bd` without a timeout");
-    }
-  }
-}
-
-// Check if command is "bun .* test" or "bun-debug test" with -u/--update-snapshots AND -t/--test-name-pattern
-if (argv0 === "bun" || argv0.includes("bun-debug")) {
-  const allArgs = tokens.slice(1);
-
-  // Check if "test" is in positional args or "bd" followed by "test"
-  const positionalArgs = allArgs.filter(arg => !arg.startsWith("-"));
-  const hasTest = positionalArgs.includes("test") || (positionalArgs[0] === "bd" && positionalArgs[1] === "test");
-
-  if (hasTest) {
-    const hasUpdateSnapshots = allArgs.some(arg => arg === "-u" || arg === "--update-snapshots");
-    const hasTestNamePattern = allArgs.some(arg => arg === "-t" || arg === "--test-name-pattern");
-
-    if (hasUpdateSnapshots && hasTestNamePattern) {
-      denyWithReason("error: Cannot use -u/--update-snapshots with -t/--test-name-pattern");
-    }
-  }
-}
-
-// Check if timeout option is set for "bun bd" command
-if (timeout !== undefined && (argv0 === "bun" || argv0.includes("bun-debug"))) {
-  const positionalArgs = tokens.slice(1).filter(arg => !arg.startsWith("-"));
-  if (positionalArgs.length === 1 && positionalArgs[0] === "bd") {
-    denyWithReason("error: Run `bun bd` without a timeout");
-  }
-}
-
-// Check if running "bun test <file>" without USE_SYSTEM_BUN=1
-if ((argv0 === "bun" || argv0.includes("bun-debug")) && useSystemBun !== "1") {
-  const allArgs = tokens.slice(1);
-  const positionalArgs = allArgs.filter(arg => !arg.startsWith("-"));
-
-  // Check if it's "test" (not "bd test")
-  if (positionalArgs.length >= 1 && positionalArgs[0] === "test" && positionalArgs[0] !== "bd") {
-    denyWithReason(
-      "error: In development, use `bun bd test <file>` to test your changes. If you meant to use a release version, set USE_SYSTEM_BUN=1",
-    );
-  }
-}
-
-// Check if running "bun bd test" from bun repo root or test folder without a file path
-if (argv0 === "bun" || argv0.includes("bun-debug")) {
-  const allArgs = tokens.slice(1);
-  const positionalArgs = allArgs.filter(arg => !arg.startsWith("-"));
-
-  // Check if it's "bd test"
-  if (positionalArgs.length >= 2 && positionalArgs[0] === "bd" && positionalArgs[1] === "test") {
-    // Check if cwd is the bun repo root or test folder
-    const isBunRepoRoot = cwd === "/workspace/bun" || cwd.endsWith("/bun");
-    const isTestFolder = cwd.endsWith("/bun/test");
-
-    if (isBunRepoRoot || isTestFolder) {
-      // Check if there's a file path argument (looks like a path: contains / or has test extension)
-      const hasFilePath = positionalArgs
-        .slice(2)
-        .some(
-          arg =>
-            arg.includes("/") ||
-            arg.endsWith(".test.ts") ||
-            arg.endsWith(".test.js") ||
-            arg.endsWith(".test.tsx") ||
-            arg.endsWith(".test.jsx"),
-        );
-
-      if (!hasFilePath) {
-        denyWithReason(
-          "error: `bun bd test` from repo root or test folder will run all tests. Use `bun bd test <path>` with a specific test file.",
-        );
-      }
-    }
-  }
-}
-
-// Allow the command to proceed
-process.exit(0);

.claude/settings.json

@@ -1,26 +0,0 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-bash-zig-build.js"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/post-edit-zig-format.js"
-          }
-        ]
-      }
-    ]
-  }
-}

.coderabbit.yaml

@@ -1,143 +0,0 @@
-language: en-US
-
-reviews:
-  profile: assertive
-  request_changes_workflow: false
-  high_level_summary: false
-  high_level_summary_placeholder: "@coderabbitai summary"
-  high_level_summary_in_walkthrough: true
-  auto_title_placeholder: "@coderabbitai"
-  review_status: false
-  commit_status: false
-  fail_commit_status: false
-  collapse_walkthrough: false
-  changed_files_summary: true
-  sequence_diagrams: false
-  estimate_code_review_effort: false
-  assess_linked_issues: true
-  related_issues: true
-  related_prs: true
-  suggested_labels: false
-  suggested_reviewers: true
-  in_progress_fortune: false
-  poem: false
-  abort_on_close: true
-
-  path_filters:
-    - "!test/js/node/test/"
-
-  auto_review:
-    enabled: true
-    auto_incremental_review: true
-    drafts: false
-
-  finishing_touches:
-    docstrings:
-      enabled: false
-    unit_tests:
-      enabled: false
-
-  pre_merge_checks:
-    docstrings:
-      mode: off
-    title:
-      mode: warning
-    description:
-      mode: warning
-    issue_assessment:
-      mode: warning
-
-  tools:
-    shellcheck:
-      enabled: true
-    ruff:
-      enabled: true
-    markdownlint:
-      enabled: true
-    github-checks:
-      enabled: true
-      timeout_ms: 90000
-    languagetool:
-      enabled: true
-      enabled_only: false
-      level: default
-    biome:
-      enabled: true
-    hadolint:
-      enabled: true
-    swiftlint:
-      enabled: true
-    phpstan:
-      enabled: true
-      level: default
-    phpmd:
-      enabled: true
-    phpcs:
-      enabled: true
-    golangci-lint:
-      enabled: true
-    yamllint:
-      enabled: true
-    gitleaks:
-      enabled: true
-    checkov:
-      enabled: true
-    detekt:
-      enabled: true
-    eslint:
-      enabled: true
-    flake8:
-      enabled: true
-    rubocop:
-      enabled: true
-    buf:
-      enabled: true
-    regal:
-      enabled: true
-    actionlint:
-      enabled: true
-    pmd:
-      enabled: true
-    clang:
-      enabled: true
-    cppcheck:
-      enabled: true
-    semgrep:
-      enabled: true
-    circleci:
-      enabled: true
-    clippy:
-      enabled: true
-    sqlfluff:
-      enabled: true
-    prismaLint:
-      enabled: true
-    pylint:
-      enabled: true
-    oxc:
-      enabled: true
-    shopifyThemeCheck:
-      enabled: true
-    luacheck:
-      enabled: true
-    brakeman:
-      enabled: true
-    dotenvLint:
-      enabled: true
-    htmlhint:
-      enabled: true
-    checkmake:
-      enabled: true
-    osvScanner:
-      enabled: true
-
-chat:
-  auto_reply: true
-
-knowledge_base:
-  opt_out: false
-  code_guidelines:
-    enabled: true
-    filePatterns:
-      - "**/.cursor/rules/*.mdc"
-      - "**/CLAUDE.md"

.cursor/environment.json

@@ -1,10 +0,0 @@
-{
-  "snapshot": "snapshot-20250706-71021aff-cc0d-4a7f-a468-d443b16c4bf1",
-  "install": "bun install",
-  "terminals": [
-    {
-      "name": "bun build",
-      "command": "bun run build"
-    }
-  ]
-}

.cursor/rules/building-bun.mdc

@@ -1,41 +1,27 @@
 ---
-description:
-globs: src/**/*.cpp,src/**/*.zig
-alwaysApply: false
+description: How to build Bun
+globs: 
 ---
+# How to build Bun
 
-### Build Commands
+## CMake
 
-- **Build debug version**: `bun bd` or `bun run build:debug`
-  - Creates a debug build at `./build/debug/bun-debug`
-  - Compilation takes ~2.5 minutes
-- **Run tests with your debug build**: `bun bd test <test-file>`
-  - **CRITICAL**: Never use `bun test` directly - it won't include your changes
-- **Run any command with debug build**: `bun bd <command>`
+Bun is built using CMake, which you can find in `CMakeLists.txt` and in the `cmake/` directory.
 
-### Run a file
+* `CMakeLists.txt`
+* `cmake/`
+  * `Globals.cmake` - macros and functions used by all the other files
+  * `Options.cmake` - build options for configuring the build (e.g. debug/release mode)
+  * `CompilerFlags.cmake` - compiler and linker flags used by all the targets
+  * `tools/` - setup scripts for various build tools (e.g. llvm, zig, webkit, rust, etc.)
+  * `targets/` - targets for bun and its dependencies (e.g. brotli, boringssl, libuv, etc.)
 
-To run a file, use:
+## How to
+
+There are `package.json` scripts that make it easy to build Bun without calling CMake directly, for example:
 
 ```sh
-bun bd <file> <...args>
+bun run build # builds a debug build: `build/debug/bun-debug`
+bun run build:release # builds a release build: `build/release/bun`
+bun run build:assert # builds a release build with debug assertions: `build/assert/bun`
 ```
-
-**CRITICAL**: Never use `bun <file>` directly. It will not have your changes.
-
-### Logging
-
-`BUN_DEBUG_$(SCOPE)=1` enables debug logs for a specific debug log scope.
-
-Debug logs look like this:
-
-```zig
-const log = bun.Output.scoped(.${SCOPE}, .hidden);
-
-// ...later
-log("MY DEBUG LOG", .{})
-```
-
-### Code Generation
-
-Code generation happens automatically as part of the build process. There are no commands to run.

.cursor/rules/dev-server-tests.mdc

@@ -91,7 +91,7 @@ devTest("html file is watched", {
 
 `files` holds the initial state, and the callback runs with the server running. `dev.fetch()` runs HTTP requests, while `dev.client()` opens a browser instance to the code.
 
-Functions `dev.write` and `dev.patch` and `dev.delete` mutate the filesystem. Do not use `node:fs` APIs, as the dev server ones are hooked to wait for hot-reload, and all connected clients to receive changes.
+Functions `dev.write` and `dev.patch` and `dev.delete` mutate the filesystem. Do not use `node:fs` APIs, as the dev server ones are hooked to wait for hot-reload, and all connected clients to recieve changes.
 
 When a change performs a hard-reload, that must be explicitly annotated with `expectReload`. This tells `client-fixture.mjs` that the test is meant to reload the page once; All other hard reloads automatically fail the test.
 

.cursor/rules/javascriptcore-class.mdc

@@ -1,14 +1,13 @@
 ---
 description: JavaScript class implemented in C++
 globs: *.cpp
-alwaysApply: false
 ---
 
 # Implementing JavaScript classes in C++
 
 If there is a publicly accessible Constructor and Prototype, then there are 3 classes:
 
-- IF there are C++ class members we need a destructor, so `class Foo : public JSC::DestructibleObject`, if no C++ class fields (only JS properties) then we don't need a class at all usually. We can instead use JSC::constructEmptyObject(vm, structure) and `putDirectOffset` like in [NodeFSStatBinding.cpp](mdc:src/bun.js/bindings/NodeFSStatBinding.cpp).
+- IF there are C++ class members we need a destructor, so `class Foo : public JSC::DestructibleObject`, if no C++ class fields (only JS properties) then we don't need a class at all usually. We can instead use JSC::constructEmptyObject(vm, structure) and `putDirectOffset` like in [NodeFSBinding.cpp](mdc:src/bun.js/bindings/NodeFSBinding.cpp).
 - class FooPrototype : public JSC::JSNonFinalObject
 - class FooConstructor : public JSC::InternalFunction
 
@@ -19,7 +18,6 @@ If there are C++ fields on the Foo class, the Foo class will need an iso subspac
 Usually you'll need to #include "root.h" at the top of C++ files or you'll get lint errors.
 
 Generally, defining the subspace looks like this:
-
 ```c++
 
 class Foo : public JSC::DestructibleObject {
@@ -47,7 +45,6 @@ It's better to put it in the .cpp file instead of the .h file, when possible.
 ## Defining properties
 
 Define properties on the prototype. Use a const HashTableValues like this:
-
 ```C++
 static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckEmail);
 static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckHost);
@@ -161,7 +158,6 @@ void JSX509CertificatePrototype::finishCreation(VM& vm)
 ```
 
 ### Getter definition:
-
 ```C++
 
 JSC_DEFINE_CUSTOM_GETTER(jsX509CertificateGetter_ca, (JSGlobalObject * globalObject, EncodedJSValue thisValue, PropertyName))
@@ -216,6 +212,7 @@ JSC_DEFINE_HOST_FUNCTION(jsX509CertificateProtoFuncToJSON, (JSGlobalObject * glo
 }
 ```
 
+
 ### Constructor definition
 
 ```C++
@@ -262,6 +259,7 @@ private:
 };
 ```
 
+
 ### Structure caching
 
 If there's a class, prototype, and constructor:
@@ -281,7 +279,6 @@ void GlobalObject::finishCreation(VM& vm) {
 ```
 
 Then, implement the function that creates the structure:
-
 ```c++
 void setupX509CertificateClassStructure(LazyClassStructure::Initializer& init)
 {
@@ -304,12 +301,11 @@ If there's only a class, use `JSC::LazyProperty<JSGlobalObject, Structure>` inst
 1. Add the `JSC::LazyProperty<JSGlobalObject, Structure>` to @ZigGlobalObject.h
 2. Initialize the class structure in @ZigGlobalObject.cpp in `void GlobalObject::finishCreation(VM& vm)`
 3. Visit the lazy property in visitChildren in @ZigGlobalObject.cpp in `void GlobalObject::visitChildrenImpl`
-   void GlobalObject::finishCreation(VM& vm) {
-   // ...
+void GlobalObject::finishCreation(VM& vm) {
+// ...
    this.m_myLazyProperty.initLater([](const JSC::LazyProperty<JSC::JSGlobalObject, JSC::Structure>::Initializer& init) {
-   init.set(Bun::initMyStructure(init.vm, reinterpret_cast<Zig::GlobalObject\*>(init.owner)));
-   });
-
+        init.set(Bun::initMyStructure(init.vm, reinterpret_cast<Zig::GlobalObject*>(init.owner)));
+    });
 ```
 
 Then, implement the function that creates the structure:
@@ -320,7 +316,7 @@ Structure* setupX509CertificateStructure(JSC::VM &vm, Zig::GlobalObject* globalO
     auto* prototypeStructure = JSX509CertificatePrototype::createStructure(init.vm, init.global, init.global->objectPrototype());
     auto* prototype = JSX509CertificatePrototype::create(init.vm, init.global, prototypeStructure);
 
-    // If there is no prototype or it only has
+    // If there is no prototype or it only has 
 
     auto* structure = JSX509Certificate::createStructure(init.vm, init.global, prototype);
     init.setPrototype(prototype);
@@ -329,6 +325,7 @@ Structure* setupX509CertificateStructure(JSC::VM &vm, Zig::GlobalObject* globalO
 }
 ```
 
+
 Then, use the structure by calling `globalObject.m_myStructureName.get(globalObject)`
 
 ```C++
@@ -360,8 +357,9 @@ JSC_DEFINE_HOST_FUNCTION(x509CertificateConstructorConstruct, (JSGlobalObject *
 
         auto* functionGlobalObject = defaultGlobalObject(getFunctionRealm(globalObject, newTarget.getObject()));
         RETURN_IF_EXCEPTION(scope, {});
-        structure = InternalFunction::createSubclassStructure(globalObject, newTarget.getObject(), functionGlobalObject->NodeVMScriptStructure());
-        RETURN_IF_EXCEPTION(scope, {});
+        structure = InternalFunction::createSubclassStructure(
+            globalObject, newTarget.getObject(), functionGlobalObject->NodeVMScriptStructure());
+        scope.release();
     }
 
     return JSValue::encode(createX509Certificate(vm, globalObject, structure, arg));
@@ -380,14 +378,12 @@ extern "C" JSC::EncodedJSValue Bun__JSBigIntStatsObjectConstructor(Zig::GlobalOb
 ```
 
 Zig:
-
 ```zig
 extern "c" fn Bun__JSBigIntStatsObjectConstructor(*JSC.JSGlobalObject) JSC.JSValue;
 pub const getBigIntStatsConstructor =  Bun__JSBigIntStatsObjectConstructor;
 ```
 
-To create an object (instance) of a JS class defined in C++ from Zig, follow the \_\_toJS convention like this:
-
+To create an object (instance) of a JS class defined in C++ from Zig, follow the __toJS convention like this:
 ```c++
 // X509* is whatever we need to create the object
 extern "C" EncodedJSValue Bun__X509__toJS(Zig::GlobalObject* globalObject, X509* cert)
@@ -399,13 +395,12 @@ extern "C" EncodedJSValue Bun__X509__toJS(Zig::GlobalObject* globalObject, X509*
 ```
 
 And from Zig:
-
 ```zig
 const X509 = opaque {
-    // ... class
+    // ... class 
 
     extern fn Bun__X509__toJS(*JSC.JSGlobalObject, *X509) JSC.JSValue;
-
+    
     pub fn toJS(this: *X509, globalObject: *JSC.JSGlobalObject) JSC.JSValue {
         return Bun__X509__toJS(globalObject, this);
     }

.cursor/rules/registering-bun-modules.mdc

@@ -1,203 +0,0 @@
-# Registering Functions, Objects, and Modules in Bun
-
-This guide documents the process of adding new functionality to the Bun global object and runtime.
-
-## Overview
-
-Bun's architecture exposes functionality to JavaScript through a set of carefully registered functions, objects, and modules. Most core functionality is implemented in Zig, with JavaScript bindings that make these features accessible to users.
-
-There are several key ways to expose functionality in Bun:
-
-1. **Global Functions**: Direct methods on the `Bun` object (e.g., `Bun.serve()`)
-2. **Getter Properties**: Lazily initialized properties on the `Bun` object (e.g., `Bun.sqlite`)
-3. **Constructor Classes**: Classes available through the `Bun` object (e.g., `Bun.ValkeyClient`)
-4. **Global Modules**: Modules that can be imported directly (e.g., `import {X} from "bun:*"`)
-
-## The Registration Process
-
-Adding new functionality to Bun involves several coordinated steps across multiple files:
-
-### 1. Implement the Core Functionality in Zig
-
-First, implement your feature in Zig, typically in its own directory in `src/`. Examples:
-
-- `src/valkey/` for Redis/Valkey client
-- `src/semver/` for SemVer functionality
-- `src/smtp/` for SMTP client
-
-### 2. Create JavaScript Bindings
-
-Create bindings that expose your Zig functionality to JavaScript:
-
-- Create a class definition file (e.g., `js_bindings.classes.ts`) to define the JavaScript interface
-- Implement `JSYourFeature` struct in a file like `js_your_feature.zig`
-
-Example from a class definition file:
-
-```typescript
-// Example from a .classes.ts file
-import { define } from "../../codegen/class-definitions";
-
-export default [
-  define({
-    name: "YourFeature",
-    construct: true,
-    finalize: true,
-    hasPendingActivity: true,
-    memoryCost: true,
-    klass: {},
-    JSType: "0b11101110",
-    proto: {
-      yourMethod: {
-        fn: "yourZigMethod",
-        length: 1,
-      },
-      property: {
-        getter: "getProperty",
-      },
-    },
-    values: ["cachedValues"],
-  }),
-];
-```
-
-### 3. Register with BunObject in `src/bun.js/bindings/BunObject+exports.h`
-
-Add an entry to the `FOR_EACH_GETTER` macro:
-
-```c
-// In BunObject+exports.h
-#define FOR_EACH_GETTER(macro) \
-    macro(CSRF) \
-    macro(CryptoHasher) \
-    ... \
-    macro(YourFeature) \
-```
-
-### 4. Create a Getter Function in `src/bun.js/api/BunObject.zig`
-
-Implement a getter function in `BunObject.zig` that returns your feature:
-
-```zig
-// In BunObject.zig
-pub const YourFeature = toJSGetter(Bun.getYourFeatureConstructor);
-
-// In the exportAll() function:
-@export(&BunObject.YourFeature, .{ .name = getterName("YourFeature") });
-```
-
-### 5. Implement the Getter Function in a Relevant Zig File
-
-Implement the function that creates your object:
-
-```zig
-// In your main module file (e.g., src/your_feature/your_feature.zig)
-pub fn getYourFeatureConstructor(globalThis: *JSC.JSGlobalObject, _: *JSC.JSObject) JSC.JSValue {
-    return JSC.API.YourFeature.getConstructor(globalThis);
-}
-```
-
-### 6. Add to Build System
-
-Ensure your files are included in the build system by adding them to the appropriate targets.
-
-## Example: Adding a New Module
-
-Here's a comprehensive example of adding a hypothetical SMTP module:
-
-1. Create implementation files in `src/smtp/`:
-
-   - `index.zig`: Main entry point that exports everything
-   - `SmtpClient.zig`: Core SMTP client implementation
-   - `js_smtp.zig`: JavaScript bindings
-   - `js_bindings.classes.ts`: Class definition
-
-2. Define your JS class in `js_bindings.classes.ts`:
-
-```typescript
-import { define } from "../../codegen/class-definitions";
-
-export default [
-  define({
-    name: "EmailClient",
-    construct: true,
-    finalize: true,
-    hasPendingActivity: true,
-    configurable: false,
-    memoryCost: true,
-    klass: {},
-    JSType: "0b11101110",
-    proto: {
-      send: {
-        fn: "send",
-        length: 1,
-      },
-      verify: {
-        fn: "verify",
-        length: 0,
-      },
-      close: {
-        fn: "close",
-        length: 0,
-      },
-    },
-    values: ["connectionPromise"],
-  }),
-];
-```
-
-3. Add getter to `BunObject+exports.h`:
-
-```c
-#define FOR_EACH_GETTER(macro) \
-    macro(CSRF) \
-    ... \
-    macro(SMTP) \
-```
-
-4. Add getter function to `BunObject.zig`:
-
-```zig
-pub const SMTP = toJSGetter(Bun.getSmtpConstructor);
-
-// In exportAll:
-@export(&BunObject.SMTP, .{ .name = getterName("SMTP") });
-```
-
-5. Implement getter in your module:
-
-```zig
-pub fn getSmtpConstructor(globalThis: *JSC.JSGlobalObject, _: *JSC.JSObject) JSC.JSValue {
-    return JSC.API.JSEmailClient.getConstructor(globalThis);
-}
-```
-
-## Best Practices
-
-1. **Follow Naming Conventions**: Align your naming with existing patterns
-2. **Reference Existing Modules**: Study similar modules like Valkey or S3Client for guidance
-3. **Memory Management**: Be careful with memory management and reference counting
-4. **Error Handling**: Use `bun.JSError!JSValue` for proper error propagation
-5. **Documentation**: Add JSDoc comments to your JavaScript bindings
-6. **Testing**: Add tests for your new functionality
-
-## Common Gotchas
-
-- Be sure to handle reference counting properly with `ref()`/`deref()`
-- Always implement proper cleanup in `deinit()` and `finalize()`
-- For network operations, manage socket lifetimes correctly
-- Use `JSC.Codegen` correctly to generate necessary binding code
-
-## Related Files
-
-- `src/bun.js/bindings/BunObject+exports.h`: Registration of getters and functions
-- `src/bun.js/api/BunObject.zig`: Implementation of getters and object creation
-- `src/bun.js/api/BunObject.classes.ts`: Class definitions
-- `.cursor/rules/zig-javascriptcore-classes.mdc`: More details on class bindings
-
-## Additional Resources
-
-For more detailed information on specific topics:
-
-- See `zig-javascriptcore-classes.mdc` for details on creating JS class bindings
-- Review existing modules like `valkey`, `sqlite`, or `s3` for real-world examples

.cursor/rules/writing-tests.mdc

@@ -11,10 +11,10 @@ You'll find all of Bun's tests in the `test/` directory.
 * `test/`
   * `cli/` - CLI command tests, like `bun install` or `bun init`
   * `js/` - JavaScript & TypeScript tests
-    * `bun/` - `Bun` APIs tests, separated by category, for example: `glob/` for `Bun.Glob` tests
-    * `node/` - Node.js module tests, separated by module, for example: `assert/` for `node:assert` tests
+    * `bun/` - `Bun` APIs tests, seperated by category, for example: `glob/` for `Bun.Glob` tests
+    * `node/` - Node.js module tests, seperated by module, for example: `assert/` for `node:assert` tests
       * `test/` - Vendored Node.js tests, taken from the Node.js repository (does not conform to Bun's test style)
-    * `web/` - Web API tests, separated by category, for example: `fetch/` for `Request` and `Response` tests
+    * `web/` - Web API tests, seperated by category, for example: `fetch/` for `Request` and `Response` tests
     * `third_party/` - npm package tests, to validate that basic usage works in Bun
   * `napi/` - N-API tests
   * `v8/` - V8 C++ API tests

.cursor/rules/zig-javascriptcore-classes.mdc

@@ -1,509 +0,0 @@
----
-description: How Zig works with JavaScriptCore bindings generator
-globs:
-alwaysApply: false
----
-
-# Bun's JavaScriptCore Class Bindings Generator
-
-This document explains how Bun's class bindings generator works to bridge Zig and JavaScript code through JavaScriptCore (JSC).
-
-## Architecture Overview
-
-Bun's binding system creates a seamless bridge between JavaScript and Zig, allowing Zig implementations to be exposed as JavaScript classes. The system has several key components:
-
-1. **Zig Implementation** (.zig files)
-2. **JavaScript Interface Definition** (.classes.ts files)
-3. **Generated Code** (C++/Zig files that connect everything)
-
-## Class Definition Files
-
-### JavaScript Interface (.classes.ts)
-
-The `.classes.ts` files define the JavaScript API using a declarative approach:
-
-```typescript
-// Example: encoding.classes.ts
-define({
-  name: "TextDecoder",
-  constructor: true,
-  JSType: "object",
-  finalize: true,
-  proto: {
-    decode: {
-      // Function definition
-      args: 1,
-    },
-    encoding: {
-      // Getter with caching
-      getter: true,
-      cache: true,
-    },
-    fatal: {
-      // Read-only property
-      getter: true,
-    },
-    ignoreBOM: {
-      // Read-only property
-      getter: true,
-    },
-  },
-});
-```
-
-Each class definition specifies:
-
-- The class name
-- Whether it has a constructor
-- JavaScript type (object, function, etc.)
-- Properties and methods in the `proto` field
-- Caching strategy for properties
-- Finalization requirements
-
-### Zig Implementation (.zig)
-
-The Zig files implement the native functionality:
-
-```zig
-// Example: TextDecoder.zig
-pub const TextDecoder = struct {
-    // Expose generated bindings as `js` namespace with trait conversion methods
-    pub const js = JSC.Codegen.JSTextDecoder;
-    pub const toJS = js.toJS;
-    pub const fromJS = js.fromJS;
-    pub const fromJSDirect = js.fromJSDirect;
-
-    // Internal state
-    encoding: []const u8,
-    fatal: bool,
-    ignoreBOM: bool,
-
-    // Constructor implementation - note use of globalObject
-    pub fn constructor(
-        globalObject: *JSGlobalObject,
-        callFrame: *JSC.CallFrame,
-    ) bun.JSError!*TextDecoder {
-        // Implementation
-
-        return bun.new(TextDecoder, .{
-            // Fields
-        });
-    }
-
-    // Prototype methods - note return type includes JSError
-    pub fn decode(
-        this: *TextDecoder,
-        globalObject: *JSGlobalObject,
-        callFrame: *JSC.CallFrame,
-    ) bun.JSError!JSC.JSValue {
-        // Implementation
-    }
-
-    // Getters
-    pub fn getEncoding(this: *TextDecoder, globalObject: *JSGlobalObject) JSC.JSValue {
-        return JSC.JSValue.createStringFromUTF8(globalObject, this.encoding);
-    }
-
-    pub fn getFatal(this: *TextDecoder, globalObject: *JSGlobalObject) JSC.JSValue {
-        return JSC.JSValue.jsBoolean(this.fatal);
-    }
-
-    // Cleanup - note standard pattern of using deinit/deref
-    fn deinit(this: *TextDecoder) void {
-        // Release any retained resources
-        // Free the pointer at the end.
-        bun.destroy(this);
-    }
-
-    // Finalize - called by JS garbage collector. This should call deinit, or deref if reference counted.
-    pub fn finalize(this: *TextDecoder) void {
-        this.deinit();
-    }
-};
-```
-
-Key components in the Zig file:
-
-- The struct containing native state
-- `pub const js = JSC.Codegen.JS<ClassName>` to include generated code
-- Constructor and methods using `bun.JSError!JSValue` return type for proper error handling
-- Consistent use of `globalObject` parameter name instead of `ctx`
-- Methods matching the JavaScript interface
-- Getters/setters for properties
-- Proper resource cleanup pattern with `deinit()` and `finalize()`
-- Update `src/bun.js/bindings/generated_classes_list.zig` to include the new class
-
-## Code Generation System
-
-The binding generator produces C++ code that connects JavaScript and Zig:
-
-1. **JSC Class Structure**: Creates C++ classes for the JS object, prototype, and constructor
-2. **Memory Management**: Handles GC integration through JSC's WriteBarrier
-3. **Method Binding**: Connects JS function calls to Zig implementations
-4. **Type Conversion**: Converts between JS values and Zig types
-5. **Property Caching**: Implements the caching system for properties
-
-The generated C++ code includes:
-
-- A JSC wrapper class (`JSTextDecoder`)
-- A prototype class (`JSTextDecoderPrototype`)
-- A constructor function (`JSTextDecoderConstructor`)
-- Function bindings (`TextDecoderPrototype__decodeCallback`)
-- Property getters/setters (`TextDecoderPrototype__encodingGetterWrap`)
-
-## CallFrame Access
-
-The `CallFrame` object provides access to JavaScript execution context:
-
-```zig
-pub fn decode(
-    this: *TextDecoder,
-    globalObject: *JSGlobalObject,
-    callFrame: *JSC.CallFrame
-) bun.JSError!JSC.JSValue {
-    // Get arguments
-    const input = callFrame.argument(0);
-    const options = callFrame.argument(1);
-
-    // Get this value
-    const thisValue = callFrame.thisValue();
-
-    // Implementation with error handling
-    if (input.isUndefinedOrNull()) {
-        return globalObject.throw("Input cannot be null or undefined", .{});
-    }
-
-    // Return value or throw error
-    return JSC.JSValue.jsString(globalObject, "result");
-}
-```
-
-CallFrame methods include:
-
-- `argument(i)`: Get the i-th argument
-- `argumentCount()`: Get the number of arguments
-- `thisValue()`: Get the `this` value
-- `callee()`: Get the function being called
-
-## Property Caching and GC-Owned Values
-
-The `cache: true` option in property definitions enables JSC's WriteBarrier to efficiently store values:
-
-```typescript
-encoding: {
-  getter: true,
-  cache: true, // Enable caching
-}
-```
-
-### C++ Implementation
-
-In the generated C++ code, caching uses JSC's WriteBarrier:
-
-```cpp
-JSC_DEFINE_CUSTOM_GETTER(TextDecoderPrototype__encodingGetterWrap, (...)) {
-    auto& vm = JSC::getVM(lexicalGlobalObject);
-    Zig::GlobalObject *globalObject = reinterpret_cast<Zig::GlobalObject*>(lexicalGlobalObject);
-    auto throwScope = DECLARE_THROW_SCOPE(vm);
-    JSTextDecoder* thisObject = jsCast<JSTextDecoder*>(JSValue::decode(encodedThisValue));
-    JSC::EnsureStillAliveScope thisArg = JSC::EnsureStillAliveScope(thisObject);
-
-    // Check for cached value and return if present
-    if (JSValue cachedValue = thisObject->m_encoding.get())
-        return JSValue::encode(cachedValue);
-
-    // Get value from Zig implementation
-    JSC::JSValue result = JSC::JSValue::decode(
-        TextDecoderPrototype__getEncoding(thisObject->wrapped(), globalObject)
-    );
-    RETURN_IF_EXCEPTION(throwScope, {});
-
-    // Store in cache for future access
-    thisObject->m_encoding.set(vm, thisObject, result);
-    RELEASE_AND_RETURN(throwScope, JSValue::encode(result));
-}
-```
-
-### Zig Accessor Functions
-
-For each cached property, the generator creates Zig accessor functions that allow Zig code to work with these GC-owned values:
-
-```zig
-// External function declarations
-extern fn TextDecoderPrototype__encodingSetCachedValue(JSC.JSValue, *JSC.JSGlobalObject, JSC.JSValue) callconv(JSC.conv) void;
-extern fn TextDecoderPrototype__encodingGetCachedValue(JSC.JSValue) callconv(JSC.conv) JSC.JSValue;
-
-/// `TextDecoder.encoding` setter
-/// This value will be visited by the garbage collector.
-pub fn encodingSetCached(thisValue: JSC.JSValue, globalObject: *JSC.JSGlobalObject, value: JSC.JSValue) void {
-    JSC.markBinding(@src());
-    TextDecoderPrototype__encodingSetCachedValue(thisValue, globalObject, value);
-}
-
-/// `TextDecoder.encoding` getter
-/// This value will be visited by the garbage collector.
-pub fn encodingGetCached(thisValue: JSC.JSValue) ?JSC.JSValue {
-    JSC.markBinding(@src());
-    const result = TextDecoderPrototype__encodingGetCachedValue(thisValue);
-    if (result == .zero)
-        return null;
-
-    return result;
-}
-```
-
-### Benefits of GC-Owned Values
-
-This system provides several key benefits:
-
-1. **Automatic Memory Management**: The JavaScriptCore GC tracks and manages these values
-2. **Proper Garbage Collection**: The WriteBarrier ensures values are properly visited during GC
-3. **Consistent Access**: Zig code can easily get/set these cached JS values
-4. **Performance**: Cached values avoid repeated computation or serialization
-
-### Use Cases
-
-GC-owned cached values are particularly useful for:
-
-1. **Computed Properties**: Store expensive computation results
-2. **Lazily Created Objects**: Create objects only when needed, then cache them
-3. **References to Other Objects**: Store references to other JS objects that need GC tracking
-4. **Memoization**: Cache results based on input parameters
-
-The WriteBarrier mechanism ensures that any JS values stored in this way are properly tracked by the garbage collector.
-
-## Memory Management and Finalization
-
-The binding system handles memory management across the JavaScript/Zig boundary:
-
-1. **Object Creation**: JavaScript `new TextDecoder()` creates both a JS wrapper and a Zig struct
-2. **Reference Tracking**: JSC's GC tracks all JS references to the object
-3. **Finalization**: When the JS object is collected, the finalizer releases Zig resources
-
-Bun uses a consistent pattern for resource cleanup:
-
-```zig
-// Resource cleanup method - separate from finalization
-pub fn deinit(this: *TextDecoder) void {
-    // Release resources like strings
-    this._encoding.deref(); // String deref pattern
-
-    // Free any buffers
-    if (this.buffer) |buffer| {
-        bun.default_allocator.free(buffer);
-    }
-}
-
-// Called by the GC when object is collected
-pub fn finalize(this: *TextDecoder) void {
-    JSC.markBinding(@src()); // For debugging
-    this.deinit(); // Clean up resources
-    bun.default_allocator.destroy(this); // Free the object itself
-}
-```
-
-Some objects that hold references to other JS objects use `.deref()` instead:
-
-```zig
-pub fn finalize(this: *SocketAddress) void {
-    JSC.markBinding(@src());
-    this._presentation.deref(); // Release references
-    this.destroy();
-}
-```
-
-## Error Handling with JSError
-
-Bun uses `bun.JSError!JSValue` return type for proper error handling:
-
-```zig
-pub fn decode(
-    this: *TextDecoder,
-    globalObject: *JSGlobalObject,
-    callFrame: *JSC.CallFrame
-) bun.JSError!JSC.JSValue {
-    // Throwing an error
-    if (callFrame.argumentCount() < 1) {
-        return globalObject.throw("Missing required argument", .{});
-    }
-
-    // Or returning a success value
-    return JSC.JSValue.jsString(globalObject, "Success!");
-}
-```
-
-This pattern allows Zig functions to:
-
-1. Return JavaScript values on success
-2. Throw JavaScript exceptions on error
-3. Propagate errors automatically through the call stack
-
-## Type Safety and Error Handling
-
-The binding system includes robust error handling:
-
-```cpp
-// Example of type checking in generated code
-JSTextDecoder* thisObject = jsDynamicCast<JSTextDecoder*>(callFrame->thisValue());
-if (UNLIKELY(!thisObject)) {
-    scope.throwException(lexicalGlobalObject,
-        Bun::createInvalidThisError(lexicalGlobalObject, callFrame->thisValue(), "TextDecoder"_s));
-    return {};
-}
-```
-
-## Prototypal Inheritance
-
-The binding system creates proper JavaScript prototype chains:
-
-1. **Constructor**: JSTextDecoderConstructor with standard .prototype property
-2. **Prototype**: JSTextDecoderPrototype with methods and properties
-3. **Instances**: Each JSTextDecoder instance with **proto** pointing to prototype
-
-This ensures JavaScript inheritance works as expected:
-
-```cpp
-// From generated code
-void JSTextDecoderConstructor::finishCreation(VM& vm, JSC::JSGlobalObject* globalObject, JSTextDecoderPrototype* prototype)
-{
-    Base::finishCreation(vm, 0, "TextDecoder"_s, PropertyAdditionMode::WithoutStructureTransition);
-
-    // Set up the prototype chain
-    putDirectWithoutTransition(vm, vm.propertyNames->prototype, prototype, PropertyAttribute::DontEnum | PropertyAttribute::DontDelete | PropertyAttribute::ReadOnly);
-    ASSERT(inherits(info()));
-}
-```
-
-## Performance Considerations
-
-The binding system is optimized for performance:
-
-1. **Direct Pointer Access**: JavaScript objects maintain a direct pointer to Zig objects
-2. **Property Caching**: WriteBarrier caching avoids repeated native calls for stable properties
-3. **Memory Management**: JSC garbage collection integrated with Zig memory management
-4. **Type Conversion**: Fast paths for common JavaScript/Zig type conversions
-
-## Creating a New Class Binding
-
-To create a new class binding in Bun:
-
-1. **Define the class interface** in a `.classes.ts` file:
-
-   ```typescript
-   define({
-     name: "MyClass",
-     constructor: true,
-     finalize: true,
-     proto: {
-       myMethod: {
-         args: 1,
-       },
-       myProperty: {
-         getter: true,
-         cache: true,
-       },
-     },
-   });
-   ```
-
-2. **Implement the native functionality** in a `.zig` file:
-
-   ```zig
-   pub const MyClass = struct {
-       // Generated bindings
-       pub const js = JSC.Codegen.JSMyClass;
-       pub const toJS = js.toJS;
-       pub const fromJS = js.fromJS;
-       pub const fromJSDirect = js.fromJSDirect;
-
-       // State
-       value: []const u8,
-
-       pub const new = bun.TrivialNew(@This());
-
-       // Constructor
-       pub fn constructor(
-           globalObject: *JSGlobalObject,
-           callFrame: *JSC.CallFrame,
-       ) bun.JSError!*MyClass {
-           const arg = callFrame.argument(0);
-           // Implementation
-       }
-
-       // Method
-       pub fn myMethod(
-           this: *MyClass,
-           globalObject: *JSGlobalObject,
-           callFrame: *JSC.CallFrame,
-       ) bun.JSError!JSC.JSValue {
-           // Implementation
-       }
-
-       // Getter
-       pub fn getMyProperty(this: *MyClass, globalObject: *JSGlobalObject) JSC.JSValue {
-           return JSC.JSValue.jsString(globalObject, this.value);
-       }
-
-       // Resource cleanup
-       pub fn deinit(this: *MyClass) void {
-           // Clean up resources
-       }
-
-       pub fn finalize(this: *MyClass) void {
-           this.deinit();
-           bun.destroy(this);
-       }
-   };
-   ```
-
-3. **The binding generator** creates all necessary C++ and Zig glue code to connect JavaScript and Zig, including:
-   - C++ class definitions
-   - Method and property bindings
-   - Memory management utilities
-   - GC integration code
-
-## Generated Code Structure
-
-The binding generator produces several components:
-
-### 1. C++ Classes
-
-For each Zig class, the system generates:
-
-- **JS<Class>**: Main wrapper that holds a pointer to the Zig object (`JSTextDecoder`)
-- **JS<Class>Prototype**: Contains methods and properties (`JSTextDecoderPrototype`)
-- **JS<Class>Constructor**: Implementation of the JavaScript constructor (`JSTextDecoderConstructor`)
-
-### 2. C++ Methods and Properties
-
-- **Method Callbacks**: `TextDecoderPrototype__decodeCallback`
-- **Property Getters/Setters**: `TextDecoderPrototype__encodingGetterWrap`
-- **Initialization Functions**: `finishCreation` methods for setting up the class
-
-### 3. Zig Bindings
-
-- **External Function Declarations**:
-
-  ```zig
-  extern fn TextDecoderPrototype__decode(*TextDecoder, *JSC.JSGlobalObject, *JSC.CallFrame) callconv(JSC.conv) JSC.EncodedJSValue;
-  ```
-
-- **Cached Value Accessors**:
-
-  ```zig
-  pub fn encodingGetCached(thisValue: JSC.JSValue) ?JSC.JSValue { ... }
-  pub fn encodingSetCached(thisValue: JSC.JSValue, globalObject: *JSC.JSGlobalObject, value: JSC.JSValue) void { ... }
-  ```
-
-- **Constructor Helpers**:
-  ```zig
-  pub fn create(globalObject: *JSC.JSGlobalObject) bun.JSError!JSC.JSValue { ... }
-  ```
-
-### 4. GC Integration
-
-- **Memory Cost Calculation**: `estimatedSize` method
-- **Child Visitor Methods**: `visitChildrenImpl` and `visitAdditionalChildren`
-- **Heap Analysis**: `analyzeHeap` for debugging memory issues
-
-This architecture makes it possible to implement high-performance native functionality in Zig while exposing a clean, idiomatic JavaScript API to users.

.git-blame-ignore-revs

@@ -1,10 +0,0 @@
-# Add commits to ignore in `git blame`. This allows large stylistic refactors to
-# avoid mucking up blames.
-#
-# To configure git to use this, run: 
-#
-#    git config blame.ignoreRevsFile .git-blame-ignore-revs
-#
-4ec410e0d7c5f6a712c323444edbf56b48d432d8 # make @import("bun") work in zig (#19096)
-dedd433cbf2e2fe38e51bc166e08fbcc601ad42b # JSValue.undefined -> .jsUndefined()
-6b4662ff55f58247cc2fd22e85b4f9805b0950a5 # JSValue.jsUndefined() -> .js_undefined

.gitattributes

@@ -16,7 +16,6 @@
 *.map text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.md text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.mdc text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
-*.mdx text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.mjs text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.mts text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 
@@ -53,6 +52,3 @@ test/js/node/test/fixtures linguist-vendored
 test/js/node/test/common linguist-vendored
 
 test/js/bun/css/files linguist-vendored
-
-.vscode/*.json linguist-language=JSON-with-Comments
-src/cli/init/tsconfig.default.json linguist-language=JSON-with-Comments

.github/CODEOWNERS

@@ -1,9 +0,0 @@
-# Project
-/.github/CODEOWNERS @Jarred-Sumner
-
-# Tests
-/test/expectations.txt @Jarred-Sumner
-
-# Types
-*.d.ts @alii
-/packages/bun-types/ @alii

.github/ISSUE_TEMPLATE/2-bug-report.yml

@@ -12,7 +12,7 @@ body:
         If you need help or support using Bun, and are not reporting a bug, please
         join our [Discord](https://discord.gg/CXdq2DP29u) server, where you can ask questions in the [`#help`](https://discord.gg/32EtH6p7HN) forum.
 
-        Make sure you are running the [latest](https://bun.com/docs/installation#upgrading) version of Bun.
+        Make sure you are running the [latest](https://bun.sh/docs/installation#upgrading) version of Bun.
         The bug you are experiencing may already have been fixed.
 
         Please try to include as much information as possible.

.github/ISSUE_TEMPLATE/3-typescript-bug-report.yml

@@ -2,44 +2,44 @@ name: 🇹 TypeScript Type Bug Report
 description: Report an issue with TypeScript types
 labels: [bug, types]
 body:
-  - type: markdown
-    attributes:
-      value: |
-        Thank you for submitting a bug report. It helps make Bun better.
+- type: markdown
+  attributes:
+    value: |
+      Thank you for submitting a bug report. It helps make Bun better.
 
-        If you need help or support using Bun, and are not reporting a bug, please
-        join our [Discord](https://discord.gg/CXdq2DP29u) server, where you can ask questions in the [`#help`](https://discord.gg/32EtH6p7HN) forum.
+      If you need help or support using Bun, and are not reporting a bug, please
+      join our [Discord](https://discord.gg/CXdq2DP29u) server, where you can ask questions in the [`#help`](https://discord.gg/32EtH6p7HN) forum.
 
-        Make sure you are running the [latest](https://bun.com/docs/installation#upgrading) version of Bun.
-        The bug you are experiencing may already have been fixed.
+      Make sure you are running the [latest](https://bun.sh/docs/installation#upgrading) version of Bun.
+      The bug you are experiencing may already have been fixed.
 
-        Please try to include as much information as possible.
+      Please try to include as much information as possible.
 
-  - type: input
-    attributes:
-      label: What version of Bun is running?
-      description: Copy the output of `bun --revision`
-  - type: input
-    attributes:
-      label: What platform is your computer?
-      description: |
-        For MacOS and Linux: copy the output of `uname -mprs`
-        For Windows: copy the output of `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"` in the PowerShell console
-  - type: textarea
-    attributes:
-      label: What steps can reproduce the bug?
-      description: Explain the bug and provide a code snippet that can reproduce it.
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: What is the expected behavior?
-      description: If possible, please provide text instead of a screenshot.
-  - type: textarea
-    attributes:
-      label: What do you see instead?
-      description: If possible, please provide text instead of a screenshot.
-  - type: textarea
-    attributes:
-      label: Additional information
-      description: Is there anything else you think we should know?
+- type: input
+  attributes:
+    label: What version of Bun is running?
+    description: Copy the output of `bun --revision`
+- type: input
+  attributes:
+    label: What platform is your computer?
+    description: |
+      For MacOS and Linux: copy the output of `uname -mprs`
+      For Windows: copy the output of `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"` in the PowerShell console
+- type: textarea
+  attributes:
+    label: What steps can reproduce the bug?
+    description: Explain the bug and provide a code snippet that can reproduce it.
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: What is the expected behavior?
+    description: If possible, please provide text instead of a screenshot.
+- type: textarea
+  attributes:
+    label: What do you see instead?
+    description: If possible, please provide text instead of a screenshot.
+- type: textarea
+  attributes:
+    label: Additional information
+    description: Is there anything else you think we should know?

.github/ISSUE_TEMPLATE/6-crash-report.yml

@@ -2,7 +2,6 @@ name: Prefilled crash report
 description: Report a crash in Bun
 labels:
   - crash
-  - needs triage
 body:
   - type: markdown
     attributes:

.github/actions/bump/action.yml

@@ -25,7 +25,7 @@ runs:
         echo "version=$LATEST" >> $GITHUB_OUTPUT
         echo "message=$MESSAGE" >> $GITHUB_OUTPUT
     - name: Create Pull Request
-      uses: peter-evans/create-pull-request@v7
+      uses: peter-evans/create-pull-request@v4
       with:
         add-paths: |
           CMakeLists.txt

.github/pull_request_template.md

@@ -1,3 +1,50 @@
 ### What does this PR do?
 
+<!-- **Please explain what your changes do**, example: -->
+
+<!--
+
+This adds a new flag --bail to bun test. When set, it will stop running tests after the first failure. This is useful for CI environments where you want to fail fast.
+
+-->
+
+- [ ] Documentation or TypeScript types (it's okay to leave the rest blank in this case)
+- [ ] Code changes
+
 ### How did you verify your code works?
+
+<!-- **For code changes, please include automated tests**. Feel free to uncomment the line below -->
+
+<!-- I wrote automated tests -->
+
+<!-- If JavaScript/TypeScript modules or builtins changed:
+
+- [ ] I included a test for the new code, or existing tests cover it
+- [ ] I ran my tests locally and they pass (`bun-debug test test-file-name.test`)
+
+-->
+
+<!-- If Zig files changed:
+
+- [ ] I checked the lifetime of memory allocated to verify it's (1) freed and (2) only freed when it should be
+- [ ] I included a test for the new code, or an existing test covers it
+- [ ] JSValue used outside of the stack is either wrapped in a JSC.Strong or is JSValueProtect'ed
+- [ ] I wrote TypeScript/JavaScript tests and they pass locally (`bun-debug test test-file-name.test`)
+-->
+
+<!-- If new methods, getters, or setters were added to a publicly exposed class:
+
+- [ ] I added TypeScript types for the new methods, getters, or setters
+-->
+
+<!-- If dependencies in tests changed:
+
+- [ ] I made sure that specific versions of dependencies are used instead of ranged or tagged versions
+-->
+
+<!-- If a new builtin ESM/CJS module was added:
+
+- [ ] I updated Aliases in `module_loader.zig` to include the new module
+- [ ] I added a test that imports the module
+- [ ] I added a test that require() the module
+-->

.github/workflows/CLAUDE.md

@@ -1,103 +0,0 @@
-# GitHub Actions Workflow Maintenance Guide
-
-This document provides guidance for maintaining the GitHub Actions workflows in this repository.
-
-## format.yml Workflow
-
-### Overview
-The `format.yml` workflow runs code formatters (Prettier, clang-format, and Zig fmt) on pull requests and pushes to main. It's optimized for speed by running all formatters in parallel.
-
-### Key Components
-
-#### 1. Clang-format Script (`scripts/run-clang-format.sh`)
-- **Purpose**: Formats C++ source and header files
-- **What it does**:
-  - Reads C++ files from `cmake/sources/CxxSources.txt`
-  - Finds all header files in `src/` and `packages/`
-  - Excludes third-party directories (libuv, napi, deps, vendor, sqlite, etc.)
-  - Requires specific clang-format version (no fallbacks)
-
-**Important exclusions**:
-- `src/napi/` - Node API headers (third-party)
-- `src/bun.js/bindings/libuv/` - libuv headers (third-party)
-- `src/bun.js/bindings/sqlite/` - SQLite headers (third-party)
-- `src/bun.js/api/ffi-*.h` - FFI headers (generated/third-party)
-- `src/deps/` - Dependencies (third-party)
-- Files in `vendor/`, `third_party/`, `generated/` directories
-
-#### 2. Parallel Execution
-The workflow runs all three formatters simultaneously:
-- Each formatter outputs with a prefix (`[prettier]`, `[clang-format]`, `[zig]`)
-- Output is streamed in real-time without blocking
-- Uses GitHub Actions groups (`::group::`) for collapsible sections
-
-#### 3. Tool Installation
-
-##### Clang-format-19
-- Installs ONLY `clang-format-19` package (not the entire LLVM toolchain)
-- Uses `--no-install-recommends --no-install-suggests` to skip unnecessary packages
-- Quiet installation with `-qq` and `-o=Dpkg::Use-Pty=0`
-
-##### Zig
-- Downloads from `oven-sh/zig` releases (musl build for static linking)
-- URL: `https://github.com/oven-sh/zig/releases/download/autobuild-{COMMIT}/bootstrap-x86_64-linux-musl.zip`
-- Extracts to temp directory to avoid polluting the repository
-- Directory structure: `bootstrap-x86_64-linux-musl/zig`
-
-### Updating the Workflow
-
-#### To update Zig version:
-1. Find the new commit hash from https://github.com/oven-sh/zig/releases
-2. Replace the hash in the wget URL (line 65 of format.yml)
-3. Test that the URL is valid and the binary works
-
-#### To update clang-format version:
-1. Update `LLVM_VERSION_MAJOR` environment variable at the top of format.yml
-2. Update the version check in `scripts/run-clang-format.sh`
-
-#### To add/remove file exclusions:
-1. Edit the exclusion patterns in `scripts/run-clang-format.sh` (lines 34-39)
-2. Test locally to ensure the right files are being formatted
-
-### Performance Optimizations
-1. **Parallel execution**: All formatters run simultaneously
-2. **Minimal installations**: Only required packages, no extras
-3. **Temp directories**: Tools downloaded to temp dirs, cleaned up after use
-4. **Streaming output**: Real-time feedback without buffering
-5. **Early start**: Formatting begins immediately after each tool is ready
-
-### Troubleshooting
-
-**If formatters appear to run sequentially:**
-- Check if output is being buffered (should use `sed` for line prefixing)
-- Ensure background processes use `&` and proper wait commands
-
-**If third-party files are being formatted:**
-- Review exclusion patterns in `scripts/run-clang-format.sh`
-- Check if new third-party directories were added that need exclusion
-
-**If clang-format installation is slow:**
-- Ensure using minimal package installation flags
-- Check if apt cache needs updating
-- Consider caching the clang-format binary between runs
-
-### Testing Changes Locally
-
-```bash
-# Test the clang-format script
-export LLVM_VERSION_MAJOR=19
-./scripts/run-clang-format.sh format
-
-# Test with check mode (no modifications)
-./scripts/run-clang-format.sh check
-
-# Test specific file exclusions
-./scripts/run-clang-format.sh format 2>&1 | grep -E "(libuv|napi|deps)"
-# Should return nothing if exclusions work correctly
-```
-
-### Important Notes
-- The script defaults to **format** mode (modifies files)
-- Always test locally before pushing workflow changes
-- The musl Zig build works on glibc systems due to static linking
-- Keep the exclusion list updated as new third-party code is added

.github/workflows/auto-assign-types.yml

@@ -1,19 +0,0 @@
-name: Auto Assign Types Issues
-
-on:
-  issues:
-    types: [labeled]
-
-jobs:
-  auto-assign:
-    runs-on: ubuntu-latest
-    if: github.event.label.name == 'types'
-    permissions:
-      issues: write
-    steps:
-      - name: Assign to alii
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-        run: |
-          gh issue edit ${{ github.event.issue.number }} --add-assignee alii

.github/workflows/auto-close-duplicates.yml

@@ -1,29 +0,0 @@
-name: Auto-close duplicate issues
-on:
-  schedule:
-    - cron: "0 9 * * *"
-  workflow_dispatch:
-
-jobs:
-  auto-close-duplicates:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    concurrency:
-      group: auto-close-duplicates-${{ github.repository }}
-      cancel-in-progress: true
-    permissions:
-      contents: read
-      issues: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: ./.github/actions/setup-bun
-
-      - name: Auto-close duplicate issues
-        run: bun run scripts/auto-close-duplicates.ts
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GITHUB_REPOSITORY: ${{ github.repository }}

.github/workflows/auto-label-claude-prs.yml

@@ -1,24 +0,0 @@
-name: Auto-label Claude PRs
-
-on:
-  pull_request:
-    types: [opened]
-
-jobs:
-  auto-label:
-    if: github.event.pull_request.user.login == 'robobun' || contains(github.event.pull_request.body, '🤖 Generated with')
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-    steps:
-      - name: Add claude label to PRs from robobun
-        uses: actions/github-script@v7
-        with:
-          script: |
-            github.rest.issues.addLabels({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              labels: ['claude']
-            });

.github/workflows/clang-format.yml

@@ -0,0 +1,41 @@
+name: clang-format
+
+permissions:
+  contents: write
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  merge_group:
+
+env:
+  BUN_VERSION: "1.2.0"
+  LLVM_VERSION: "19.1.7"
+  LLVM_VERSION_MAJOR: "19"
+
+jobs:
+  clang-format:
+    name: clang-format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Install LLVM
+        run: |
+          curl -fsSL https://apt.llvm.org/llvm.sh | sudo bash -s -- ${{ env.LLVM_VERSION_MAJOR }} all
+      - name: Clang Format
+        env:
+          LLVM_VERSION: ${{ env.LLVM_VERSION }}
+        run: |
+          bun run clang-format
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run clang-format`"

.github/workflows/clang-tidy.yml

@@ -0,0 +1,41 @@
+name: clang-tidy
+
+permissions:
+  contents: write
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  merge_group:
+
+env:
+  BUN_VERSION: "1.2.0"
+  LLVM_VERSION: "19.1.7"
+  LLVM_VERSION_MAJOR: "19"
+
+jobs:
+  clang-tidy:
+    name: clang-tidy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Install LLVM
+        run: |
+          curl -fsSL https://apt.llvm.org/llvm.sh | sudo bash -s -- ${{ env.LLVM_VERSION_MAJOR }} all
+      - name: Clang Tidy
+        env:
+          LLVM_VERSION: ${{ env.LLVM_VERSION }}
+        run: |
+          bun run clang-tidy:diff
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run clang-tidy`"

.github/workflows/claude-dedupe-issues.yml

@@ -1,34 +0,0 @@
-name: Claude Issue Dedupe
-on:
-  issues:
-    types: [opened]
-  workflow_dispatch:
-    inputs:
-      issue_number:
-        description: 'Issue number to process for duplicate detection'
-        required: true
-        type: string
-
-jobs:
-  claude-dedupe-issues:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    concurrency:
-      group: claude-dedupe-issues-${{ github.event.issue.number || inputs.issue_number }}
-      cancel-in-progress: true
-    permissions:
-      contents: read
-      issues: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Run Claude Code slash command
-        uses: anthropics/claude-code-base-action@beta
-        with:
-          prompt: "/dedupe ${{ github.repository }}/issues/${{ github.event.issue.number || inputs.issue_number }}"
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          claude_args: "--model claude-sonnet-4-5-20250929"
-          claude_env: |
-            GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/claude.yml

@@ -1,66 +0,0 @@
-name: Claude Code
-
-on:
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  issues:
-    types: [opened, assigned]
-  pull_request_review:
-    types: [submitted]
-
-jobs:
-  claude:
-    if: |
-      github.repository == 'oven-sh/bun' &&
-      (
-        (github.event_name == 'issue_comment' && (github.event.comment.author_association == 'MEMBER' || github.event.comment.author_association == 'OWNER' || github.event.comment.author_association == 'COLLABORATOR')) ||
-        (github.event_name == 'pull_request_review_comment' && (github.event.comment.author_association == 'MEMBER' || github.event.comment.author_association == 'OWNER' || github.event.comment.author_association == 'COLLABORATOR')) ||
-        (github.event_name == 'pull_request_review' && (github.event.review.author_association == 'MEMBER' || github.event.review.author_association == 'OWNER' || github.event.review.author_association == 'COLLABORATOR')) ||
-        (github.event_name == 'issues' && (github.event.issue.author_association == 'MEMBER' || github.event.issue.author_association == 'OWNER' || github.event.issue.author_association == 'COLLABORATOR'))
-      ) &&
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
-    runs-on: claude
-    env:
-      IS_SANDBOX: 1
-    container:
-      image: localhost:5000/claude-bun:latest
-      options: --privileged --user 1000:1000
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - name: Checkout repository
-        working-directory: /workspace/bun
-        run: |
-          git config --global user.email "claude-bot@bun.sh" && \
-          git config --global user.name "Claude Bot" && \
-          git config --global url."git@github.com:".insteadOf "https://github.com/" && \
-          git config --global url."git@github.com:".insteadOf "http://github.com/" && \
-          git config --global --add safe.directory /workspace/bun && \
-          git config --global push.default current && \
-          git config --global pull.rebase true && \
-          git config --global init.defaultBranch main && \
-          git config --global core.editor "vim" && \
-          git config --global color.ui auto && \
-          git config --global fetch.prune true && \
-          git config --global diff.colorMoved zebra && \
-          git config --global merge.conflictStyle diff3 && \
-          git config --global rerere.enabled true && \
-          git config --global core.autocrlf input
-          git fetch origin ${{ github.event.pull_request.head.sha }}
-          git checkout ${{ github.event.pull_request.head.ref }}
-          git reset --hard origin/${{ github.event.pull_request.head.ref }}
-      - name: Run Claude Code
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          timeout_minutes: "180"
-          claude_args: |
-            --dangerously-skip-permissions
-            --system-prompt "You are working on the Bun codebase"
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

.github/workflows/codex-test-sync.yml

@@ -1,58 +0,0 @@
-name: Codex Test Sync
-
-on:
-  pull_request:
-    types: [labeled, opened]
-
-env:
-  BUN_VERSION: "1.2.15"
-
-jobs:
-  sync-node-tests:
-    runs-on: ubuntu-latest
-    if: |
-      (github.event.action == 'labeled' && github.event.label.name == 'codex') ||
-      (github.event.action == 'opened' && contains(github.event.pull_request.labels.*.name, 'codex')) ||
-      contains(github.head_ref, 'codex')
-    permissions:
-      contents: write
-      pull-requests: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          fetch-depth: 0
-
-      - name: Setup Bun
-        uses: ./.github/actions/setup-bun
-        with:
-          bun-version: ${{ env.BUN_VERSION }}
-
-      - name: Get changed files
-        id: changed-files
-        uses: tj-actions/changed-files@v44
-        with:
-          files: |
-            test/js/node/test/parallel/**/*.{js,mjs,ts}
-            test/js/node/test/sequential/**/*.{js,mjs,ts}
-
-      - name: Sync tests
-        if: steps.changed-files.outputs.any_changed == 'true'
-        shell: bash
-        run: |
-          echo "Changed test files:"
-          echo "${{ steps.changed-files.outputs.all_changed_files }}"
-
-          # Process each changed test file
-          for file in ${{ steps.changed-files.outputs.all_changed_files }}; do
-            # Extract test name from file path
-            test_name=$(basename "$file" | sed 's/\.[^.]*$//')
-            echo "Syncing test: $test_name"
-            bun node:test:cp "$test_name"
-          done
-
-      - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v5
-        with:
-          commit_message: "Sync Node.js tests with upstream"

.github/workflows/docs.yml

@@ -0,0 +1,21 @@
+name: Docs
+
+on:
+  push:
+    paths:
+      - "docs/**"
+      - "CONTRIBUTING.md"
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'oven-sh' }}
+    steps:
+      # redeploy Vercel site when a file in `docs` changes
+      # using VERCEL_DEPLOY_HOOK environment variable
+      - name: Trigger Webhook
+        run: |
+          curl -v ${{ secrets.VERCEL_DEPLOY_HOOK }}

.github/workflows/format.yml

@@ -1,109 +0,0 @@
-name: autofix.ci
-
-permissions:
-  contents: read
-
-on:
-  workflow_call:
-  workflow_dispatch:
-  pull_request:
-  merge_group:
-env:
-  BUN_VERSION: "1.3.2"
-  LLVM_VERSION: "19.1.7"
-  LLVM_VERSION_MAJOR: "19"
-
-jobs:
-  autofix:
-    name: Format
-    runs-on: ubuntu-latest
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}
-      cancel-in-progress: true
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Configure Git
-        run: |
-          git config --global core.autocrlf true
-          git config --global core.ignorecase true
-          git config --global core.precomposeUnicode true
-      - name: Setup Bun
-        uses: ./.github/actions/setup-bun
-        with:
-          bun-version: ${{ env.BUN_VERSION }}
-      - name: Setup Dependencies
-        run: |
-          bun install
-          bun scripts/glob-sources.mjs
-      - name: Format Code
-        run: |
-          # Start prettier in background with prefixed output
-          echo "::group::Prettier"
-          (bun run prettier 2>&1 | sed 's/^/[prettier] /' || echo "[prettier] Failed with exit code $?") &
-          PRETTIER_PID=$!
-
-          # Start clang-format installation and formatting in background with prefixed output
-          echo "::group::Clang-format"
-          (
-            echo "[clang-format] Installing clang-format-${{ env.LLVM_VERSION_MAJOR }}..."
-            wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc > /dev/null
-            echo "deb http://apt.llvm.org/$(lsb_release -cs)/ llvm-toolchain-$(lsb_release -cs)-${{ env.LLVM_VERSION_MAJOR }} main" | sudo tee /etc/apt/sources.list.d/llvm.list > /dev/null
-            sudo apt-get update -qq
-            sudo apt-get install -y -qq --no-install-recommends --no-install-suggests -o=Dpkg::Use-Pty=0 clang-format-${{ env.LLVM_VERSION_MAJOR }}
-            echo "[clang-format] Running clang-format..."
-            LLVM_VERSION_MAJOR=${{ env.LLVM_VERSION_MAJOR }} ./scripts/run-clang-format.sh format 2>&1 | sed 's/^/[clang-format] /'
-          ) &
-          CLANG_PID=$!
-
-          # Setup Zig in temp directory and run zig fmt in background with prefixed output
-          echo "::group::Zig fmt"
-          (
-            ZIG_TEMP=$(mktemp -d)
-            echo "[zig] Downloading Zig (musl build)..."
-            wget -q -O "$ZIG_TEMP/zig.zip" https://github.com/oven-sh/zig/releases/download/autobuild-e0b7c318f318196c5f81fdf3423816a7b5bb3112/bootstrap-x86_64-linux-musl.zip
-            unzip -q -d "$ZIG_TEMP" "$ZIG_TEMP/zig.zip"
-            export PATH="$ZIG_TEMP/bootstrap-x86_64-linux-musl:$PATH"
-            echo "[zig] Running zig fmt..."
-            zig fmt src 2>&1 | sed 's/^/[zig] /'
-            ./scripts/sort-imports.ts src 2>&1 | sed 's/^/[zig] /'
-            zig fmt src 2>&1 | sed 's/^/[zig] /'
-            rm -rf "$ZIG_TEMP"
-          ) &
-          ZIG_PID=$!
-
-          # Wait for all formatting tasks to complete
-          echo ""
-          echo "Running formatters in parallel..."
-          FAILED=0
-
-          if ! wait $PRETTIER_PID; then
-            echo "::error::Prettier failed"
-            FAILED=1
-          fi
-          echo "::endgroup::"
-
-          if ! wait $CLANG_PID; then
-            echo "::error::Clang-format failed"
-            FAILED=1
-          fi
-          echo "::endgroup::"
-
-          if ! wait $ZIG_PID; then
-            echo "::error::Zig fmt failed"
-            FAILED=1
-          fi
-          echo "::endgroup::"
-
-          # Exit with error if any formatter failed
-          if [ $FAILED -eq 1 ]; then
-            echo "::error::One or more formatters failed"
-            exit 1
-          fi
-
-          echo "✅ All formatters completed successfully"
-      - name: Ban Words
-        run: |
-          bun ./test/internal/ban-words.test.ts
-          git rm -f cmake/sources/*.txt || true
-      - uses: autofix-ci/action@635ffb0c9798bd160680f18fd73371e355b85f27

.github/workflows/labeled.yml

@@ -0,0 +1,171 @@
+name: Issue Labeled
+env:
+  BUN_VERSION: 1.1.44
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  # on-bug:
+  #   runs-on: ubuntu-latest
+  #   if: github.event.label.name == 'bug' || github.event.label.name == 'crash'
+  #   permissions:
+  #     issues: write
+  #   steps:
+  #     - name: Checkout
+  #       uses: actions/checkout@v4
+  #       with:
+  #         sparse-checkout: |
+  #           scripts
+  #           .github
+  #           CMakeLists.txt
+  #     - name: Setup Bun
+  #       uses: ./.github/actions/setup-bun
+  #       with:
+  #         bun-version: ${{ env.BUN_VERSION }}
+  #     - name: "categorize bug"
+  #       id: add-labels
+  #       env:
+  #         GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+  #         GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
+  #         ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+  #       shell: bash
+  #       run: |
+  #         echo '{"dependencies": { "@anthropic-ai/sdk": "latest" }}' > scripts/package.json && bun install --cwd=./scripts
+  #         LABELS=$(bun scripts/label-issue.ts)
+  #         echo "labels=$LABELS" >> $GITHUB_OUTPUT
+  #     - name: Add labels
+  #       uses: actions-cool/issues-helper@v3
+  #       if: steps.add-labels.outputs.labels != ''
+  #       with:
+  #         actions: "add-labels"
+  #         token: ${{ secrets.GITHUB_TOKEN }}
+  #         issue-number: ${{ github.event.issue.number }}
+  #         labels: ${{ steps.add-labels.outputs.labels }}
+  on-labeled:
+    runs-on: ubuntu-latest
+    if: github.event.label.name == 'crash' || github.event.label.name == 'needs repro'
+    permissions:
+      issues: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            scripts
+            .github
+            CMakeLists.txt
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: "add platform and command label"
+        id: add-labels
+        if: github.event.label.name == 'crash'
+        env:
+          GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+          GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
+        shell: bash
+        run: |
+          LABELS=$(bun scripts/read-issue.ts)
+          echo "labels=$LABELS" >> $GITHUB_OUTPUT
+          bun scripts/is-outdated.ts
+
+          if [[ -f "is-outdated.txt" ]]; then
+            echo "is-outdated=true" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "outdated.txt" ]]; then
+            echo "oudated=$(cat outdated.txt)" >> $GITHUB_OUTPUT
+          fi
+
+          echo "latest=$(cat LATEST)" >> $GITHUB_OUTPUT
+
+          rm -rf is-outdated.txt outdated.txt latest.txt
+      - name: Generate comment text with Sentry Link
+        if: github.event.label.name == 'crash'
+        # ignore if fail
+        continue-on-error: true
+        id: generate-comment-text
+        env:
+          GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_EVENTS_SECRET }}
+        shell: bash
+        run: |
+          bun scripts/associate-issue-with-sentry.ts
+
+          if [[ -f "sentry-link.txt" ]]; then
+            echo "sentry-link=$(cat sentry-link.txt)" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "sentry-id.txt" ]]; then
+            echo "sentry-id=$(cat sentry-id.txt)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Add labels
+        uses: actions-cool/issues-helper@v3
+        if: github.event.label.name == 'crash'
+        with:
+          actions: "add-labels"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          labels: ${{ steps.add-labels.outputs.labels }}
+      - name: Comment outdated
+        if: steps.add-labels.outputs.is-outdated == 'true' && github.event.label.name == 'crash' && steps.generate-comment-text.outputs.sentry-link == ''
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.oudated }}.
+
+            Are you able to reproduce this crash on the latest version of Bun?
+
+            ```sh
+            bun upgrade
+            ```
+      - name: Comment with Sentry Link and outdated version
+        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated == 'true'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.oudated }}.
+
+            Are you able to reproduce this crash on the latest version of Bun?
+
+            ```sh
+            bun upgrade
+            ```
+
+            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
+
+            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
+            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
+      - name: Comment with Sentry Link
+        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated != 'true'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            Thank you for reporting this crash.
+
+            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
+
+            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
+            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
+      - name: Comment needs repro
+        if: github.event.label.name == 'needs repro'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            Hello @${{ github.event.issue.user.login }}. Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository, [Replit](https://replit.com/@replit/Bun), [CodeSandbox](https://codesandbox.io/templates/bun), or provide a bulleted list of commands to run that reproduce this issue. Issues marked with `needs repro` will be closed if they have no activity within 3 days.

.github/workflows/labeled.yml.disabled

@@ -1,278 +0,0 @@
-name: Issue Labeled
-env:
-  BUN_VERSION: 1.1.44
-
-on:
-  issues:
-    types: [labeled]
-  pull_request_target:
-    types: [labeled, opened, reopened, synchronize, unlabeled]
-
-jobs:
-  # on-bug:
-  #   runs-on: ubuntu-latest
-  #   if: github.event.label.name == 'bug' || github.event.label.name == 'crash'
-  #   permissions:
-  #     issues: write
-  #   steps:
-  #     - name: Checkout
-  #       uses: actions/checkout@v4
-  #       with:
-  #         sparse-checkout: |
-  #           scripts
-  #           .github
-  #           CMakeLists.txt
-  #     - name: Setup Bun
-  #       uses: ./.github/actions/setup-bun
-  #       with:
-  #         bun-version: ${{ env.BUN_VERSION }}
-  #     - name: "categorize bug"
-  #       id: add-labels
-  #       env:
-  #         GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
-  #         GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
-  #         ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-  #       shell: bash
-  #       run: |
-  #         echo '{"dependencies": { "@anthropic-ai/sdk": "latest" }}' > scripts/package.json && bun install --cwd=./scripts
-  #         LABELS=$(bun scripts/label-issue.ts)
-  #         echo "labels=$LABELS" >> $GITHUB_OUTPUT
-  #     - name: Add labels
-  #       uses: actions-cool/issues-helper@v3
-  #       if: steps.add-labels.outputs.labels != ''
-  #       with:
-  #         actions: "add-labels"
-  #         token: ${{ secrets.GITHUB_TOKEN }}
-  #         issue-number: ${{ github.event.issue.number }}
-  #         labels: ${{ steps.add-labels.outputs.labels }}
-  on-slop:
-    runs-on: ubuntu-latest
-    if: github.event_name == 'pull_request_target' && contains(github.event.pull_request.labels.*.name, 'slop')
-    permissions:
-      issues: write
-      pull-requests: write
-      contents: write
-    steps:
-      - name: Update PR title and body for slop and close
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const pr = await github.rest.pulls.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              pull_number: context.issue.number
-            });
-
-            await github.rest.pulls.update({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              pull_number: context.issue.number,
-              title: 'ai slop',
-              body: 'This PR has been marked as AI slop and the description has been updated to avoid confusion or misleading reviewers.\n\nMany AI PRs are fine, but sometimes they submit a PR too early, fail to test if the problem is real, fail to reproduce the problem, or fail to test that the problem is fixed. If you think this PR is not AI slop, please leave a comment.',
-              state: 'closed'
-            });
-
-            // Delete the branch if it's from a fork or if it's not a protected branch
-            try {
-              await github.rest.git.deleteRef({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                ref: `heads/${pr.data.head.ref}`
-              });
-            } catch (error) {
-              console.log('Could not delete branch:', error.message);
-            }
-  on-labeled:
-    runs-on: ubuntu-latest
-    if: github.event_name == 'issues' && (github.event.label.name == 'crash' || github.event.label.name == 'needs repro')
-    permissions:
-      issues: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          sparse-checkout: |
-            scripts
-            .github
-            CMakeLists.txt
-      - name: Setup Bun
-        uses: ./.github/actions/setup-bun
-        with:
-          bun-version: ${{ env.BUN_VERSION }}
-      - name: "add platform and command label"
-        id: add-labels
-        if: github.event.label.name == 'crash'
-        env:
-          GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
-          GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
-          GITHUB_ISSUE_NUMBER: ${{ github.event.issue.number }}
-        shell: bash
-        run: |
-          LABELS=$(bun scripts/read-issue.ts)
-          bun scripts/is-outdated.ts
-
-          # Check for patterns that should close the issue
-          CLOSE_ACTION=$(bun scripts/handle-crash-patterns.ts)
-          echo "close-action=$CLOSE_ACTION" >> $GITHUB_OUTPUT
-
-          if [[ -f "is-outdated.txt" ]]; then
-            echo "is-outdated=true" >> $GITHUB_OUTPUT
-          fi
-
-          if [[ -f "outdated.txt" ]]; then
-            echo "outdated=$(cat outdated.txt)" >> $GITHUB_OUTPUT
-          fi
-
-          if [[ -f "is-standalone.txt" ]]; then
-            echo "is-standalone=true" >> $GITHUB_OUTPUT
-          fi
-
-          if [[ -f "is-very-outdated.txt" ]]; then
-            echo "is-very-outdated=true" >> $GITHUB_OUTPUT
-            LABELS="$LABELS,old-version"
-          else
-            echo "is-very-outdated=false" >> $GITHUB_OUTPUT
-          fi
-
-          echo "latest=$(cat LATEST)" >> $GITHUB_OUTPUT
-          echo "labels=$LABELS" >> $GITHUB_OUTPUT
-          rm -rf is-outdated.txt outdated.txt latest.txt is-very-outdated.txt is-standalone.txt
-      - name: Close issue if pattern detected
-        if: github.event.label.name == 'crash' && fromJson(steps.add-labels.outputs.close-action).close == true
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const closeAction = ${{ fromJson(steps.add-labels.outputs.close-action) }};
-
-            // Comment with the reason
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              body: closeAction.comment
-            });
-
-            // Close the issue
-            await github.rest.issues.update({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              state: 'closed',
-              state_reason: closeAction.reason
-            });
-      - name: Generate comment text with Sentry Link
-        if: github.event.label.name == 'crash' && fromJson(steps.add-labels.outputs.close-action).close != true
-        # ignore if fail
-        continue-on-error: true
-        id: generate-comment-text
-        env:
-          GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
-          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_EVENTS_SECRET }}
-        shell: bash
-        run: |
-          bun scripts/associate-issue-with-sentry.ts
-
-          if [[ -f "sentry-link.txt" ]]; then
-            echo "sentry-link=$(cat sentry-link.txt)" >> $GITHUB_OUTPUT
-          fi
-
-          if [[ -f "sentry-id.txt" ]]; then
-            echo "sentry-id=$(cat sentry-id.txt)" >> $GITHUB_OUTPUT
-          fi
-      - name: Remove old labels
-        uses: actions-cool/issues-helper@v3
-        if: github.event.label.name == 'crash' && steps.add-labels.outputs.is-very-outdated == 'false'
-        with:
-          actions: "remove-labels"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          labels: old-version
-      - name: Add labels
-        uses: actions-cool/issues-helper@v3
-        if: github.event.label.name == 'crash'
-        with:
-          actions: "add-labels"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          labels: ${{ steps.add-labels.outputs.labels }}
-      - name: Comment outdated (standalone executable)
-        if: steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone == 'true' && github.event.label.name == 'crash' && steps.generate-comment-text.outputs.sentry-link == ''
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-comment"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          body: |
-            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but the standalone executable is running Bun v${{ steps.add-labels.outputs.outdated }}. When the CLI using Bun's single-file executable next updates it might be fixed.
-      - name: Comment outdated
-        if: steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone != 'true' && github.event.label.name == 'crash' && steps.generate-comment-text.outputs.sentry-link == ''
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-comment"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          body: |
-            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.outdated }}.
-
-            Are you able to reproduce this crash on the latest version of Bun?
-
-            ```sh
-            bun upgrade
-            ```
-      - name: Comment with Sentry Link and outdated version (standalone executable)
-        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone == 'true'
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-comment"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          body: |
-            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but the standalone executable is running Bun v${{ steps.add-labels.outputs.outdated }}. When the CLI using Bun's single-file executable next updates it might be fixed.
-
-            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
-
-            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
-            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
-      - name: Comment with Sentry Link and outdated version
-        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone != 'true'
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-comment"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          body: |
-            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.outdated }}.
-
-            Are you able to reproduce this crash on the latest version of Bun?
-
-            ```sh
-            bun upgrade
-            ```
-
-            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
-
-            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
-            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
-      - name: Comment with Sentry Link
-        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated != 'true'
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-comment"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          body: |
-            Thank you for reporting this crash.
-
-            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
-
-            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
-            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
-      - name: Comment needs repro
-        if: github.event.label.name == 'needs repro'
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-comment"
-          token: ${{ secrets.GITHUB_TOKEN }}
-          issue-number: ${{ github.event.issue.number }}
-          body: |
-            Hello @${{ github.event.issue.user.login }}. Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository, [Replit](https://replit.com/@replit/Bun), [CodeSandbox](https://codesandbox.io/templates/bun), or provide a bulleted list of commands to run that reproduce this issue. Issues marked with `needs repro` will be closed if they have no activity within 3 days.

.github/workflows/lint.yml

@@ -5,7 +5,8 @@ on:
   workflow_dispatch:
 
 env:
-  BUN_VERSION: "1.2.10"
+  BUN_VERSION: "1.2.0"
+  OXLINT_VERSION: "0.15.0"
 
 jobs:
   lint-js:
@@ -18,4 +19,4 @@ jobs:
         with:
           bun-version: ${{ env.BUN_VERSION }}
       - name: Lint
-        run: bun lint
+        run: bunx oxlint --config oxlint.json --quiet --format github

.github/workflows/on-submodule-update.yml

@@ -0,0 +1,89 @@
+name: Comment on updated submodule
+
+on:
+  pull_request_target:
+    paths:
+      - "src/generated_versions_list.zig"
+      - ".github/workflows/on-submodule-update.yml"
+
+jobs:
+  comment:
+    name: Comment
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'oven-sh' }}
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Checkout current
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            src
+      - name: Hash generated versions list
+        id: hash
+        run: |
+          echo "hash=$(sha256sum src/generated_versions_list.zig |  cut -d ' ' -f 1)" >> $GITHUB_OUTPUT
+      - name: Checkout base
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.base_ref }}
+          sparse-checkout: |
+            src
+      - name: Hash base
+        id: base
+        run: |
+          echo "base=$(sha256sum src/generated_versions_list.zig |  cut -d ' ' -f 1)" >> $GITHUB_OUTPUT
+      - name: Compare
+        id: compare
+        run: |
+          if [ "${{ steps.hash.outputs.hash }}" != "${{ steps.base.outputs.base }}" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+          fi
+      - name: Find Comment
+        id: comment
+        uses: peter-evans/find-comment@v3
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: github-actions[bot]
+          body-includes: <!-- generated-comment submodule-updated -->
+      - name: Write Warning Comment
+        uses: peter-evans/create-or-update-comment@v4
+        if: steps.compare.outputs.changed == 'true'
+        with:
+          comment-id: ${{ steps.comment.outputs.comment-id }}
+          issue-number: ${{ github.event.pull_request.number }}
+          edit-mode: replace
+          body: |
+            ⚠️ **Warning:** @${{ github.actor }}, this PR has changes to submodule versions. 
+
+            If this change was intentional, please ignore this message. If not, please undo changes to submodules and rebase your branch.
+
+            <!-- generated-comment submodule-updated -->
+      - name: Add labels
+        uses: actions-cool/issues-helper@v3
+        if: steps.compare.outputs.changed == 'true'
+        with:
+          actions: "add-labels"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.pull_request.number }}
+          labels: "changed-submodules"
+      - name: Remove labels
+        uses: actions-cool/issues-helper@v3
+        if: steps.compare.outputs.changed == 'false'
+        with:
+          actions: "remove-labels"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.pull_request.number }}
+          labels: "changed-submodules"
+      - name: Delete outdated comment
+        uses: actions-cool/issues-helper@v3
+        if: steps.compare.outputs.changed == 'false' && steps.comment.outputs.comment-id != ''
+        with:
+          actions: "delete-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-id: ${{ steps.comment.outputs.comment-id }}

.github/workflows/prettier-format.yml

@@ -0,0 +1,37 @@
+name: prettier-format
+
+permissions:
+  contents: write
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  merge_group:
+
+env:
+  BUN_VERSION: "1.2.0"
+
+jobs:
+  prettier-format:
+    name: prettier-format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Setup Dependencies
+        run: |
+          bun install
+      - name: Prettier Format
+        run: |
+          bun run prettier:diff
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run prettier:extra`"

.github/workflows/release.yml

@@ -202,7 +202,7 @@ jobs:
           body: |
             Update `bun-types` version to ${{ steps.bun-version.outputs.BUN_VERSION }}
 
-            https://bun.com/blog/${{ env.BUN_VERSION }}
+            https://bun.sh/blog/${{ env.BUN_VERSION }}
           push-to-fork: oven-sh/DefinitelyTyped
           branch: ${{env.BUN_VERSION}}
   docker:

.github/workflows/run-lint.yml

@@ -0,0 +1,32 @@
+name: Lint
+
+permissions:
+  contents: read
+env:
+  BUN_VERSION: "1.2.0"
+
+on:
+  workflow_call:
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    outputs:
+      text_output: ${{ steps.lint.outputs.text_output }}
+      json_output: ${{ steps.lint.outputs.json_output }}
+      count: ${{ steps.lint.outputs.count }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Install Dependencies
+        run: |
+          bun --cwd=packages/bun-internal-test install
+      - name: Lint
+        id: lint
+        run: |
+          bun packages/bun-internal-test/src/linter.ts

.github/workflows/typos.yml

@@ -0,0 +1,19 @@
+name: Typos
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Spellcheck
+        uses: crate-ci/typos@v1.29.4
+        with:
+          files: docs/**/*

.github/workflows/update-cares.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 
@@ -80,7 +75,7 @@ jobs:
 
       - name: Create Pull Request
         if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           add-paths: |

.github/workflows/update-hdrhistogram.yml

@@ -1,102 +0,0 @@
-name: Update hdrhistogram
-
-on:
-  schedule:
-    - cron: "0 4 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check hdrhistogram version
-        id: check-version
-        run: |
-          set -euo pipefail
-
-          # Extract the commit hash from the line after COMMIT
-          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildHdrHistogram.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildHdrHistogram.cmake"
-            exit 1
-          fi
-
-          # Validate that it looks like a git hash
-          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
-            echo "Error: Invalid git hash format in BuildHdrHistogram.cmake"
-            echo "Found: $CURRENT_VERSION"
-            echo "Expected: 40 character hexadecimal string"
-            exit 1
-          fi
-
-          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-
-          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/HdrHistogram/HdrHistogram_c/releases/latest)
-          if [ -z "$LATEST_RELEASE" ]; then
-            echo "Error: Failed to fetch latest release from GitHub API"
-            exit 1
-          fi
-
-          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
-          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
-            echo "Error: Could not extract tag name from GitHub API response"
-            exit 1
-          fi
-
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/HdrHistogram/HdrHistogram_c/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-
-          # Try to get commit SHA from tag object (for annotated tags)
-          # If it fails, assume it's a lightweight tag pointing directly to commit
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/HdrHistogram/HdrHistogram_c/git/tags/$LATEST_TAG_SHA" 2>/dev/null | jq -r '.object.sha // empty')
-          if [ -z "$LATEST_SHA" ]; then
-            # Lightweight tag - SHA points directly to commit
-            LATEST_SHA="$LATEST_TAG_SHA"
-          fi
-
-          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
-            echo "Error: Invalid SHA format received from GitHub"
-            echo "Found: $LATEST_SHA"
-            echo "Expected: 40 character hexadecimal string"
-            exit 1
-          fi
-
-          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
-          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
-
-      - name: Update version if needed
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        run: |
-          set -euo pipefail
-          # Handle multi-line format where COMMIT and its value are on separate lines
-          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildHdrHistogram.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildHdrHistogram.cmake
-          commit-message: "deps: update hdrhistogram to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update hdrhistogram to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-hdrhistogram-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates hdrhistogram to version ${{ steps.check-version.outputs.tag }}
-
-            Compare: https://github.com/HdrHistogram/HdrHistogram_c/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-hdrhistogram.yml)

.github/workflows/update-highway.yml

@@ -1,118 +0,0 @@
-name: Update highway
-
-on:
-  schedule:
-    - cron: "0 4 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check highway version
-        id: check-version
-        run: |
-          set -euo pipefail
-
-          # Extract the commit hash from the line after COMMIT
-          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildHighway.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildHighway.cmake"
-            exit 1
-          fi
-
-          # Validate that it looks like a git hash
-          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
-            echo "Error: Invalid git hash format in BuildHighway.cmake"
-            echo "Found: $CURRENT_VERSION"
-            echo "Expected: 40 character hexadecimal string"
-            exit 1
-          fi
-
-          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-
-          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/google/highway/releases/latest)
-          if [ -z "$LATEST_RELEASE" ]; then
-            echo "Error: Failed to fetch latest release from GitHub API"
-            exit 1
-          fi
-
-          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
-          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
-            echo "Error: Could not extract tag name from GitHub API response"
-            exit 1
-          fi
-
-          TAG_REF=$(curl -sL "https://api.github.com/repos/google/highway/git/refs/tags/$LATEST_TAG")
-          if [ -z "$TAG_REF" ]; then
-            echo "Error: Could not fetch tag reference for $LATEST_TAG"
-            exit 1
-          fi
-
-          TAG_OBJECT_SHA=$(echo "$TAG_REF" | jq -r '.object.sha')
-          TAG_OBJECT_TYPE=$(echo "$TAG_REF" | jq -r '.object.type')
-
-          if [ -z "$TAG_OBJECT_SHA" ] || [ "$TAG_OBJECT_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-
-          # Handle both lightweight tags (type: commit) and annotated tags (type: tag)
-          if [ "$TAG_OBJECT_TYPE" = "commit" ]; then
-            # Lightweight tag - object.sha is already the commit SHA
-            LATEST_SHA="$TAG_OBJECT_SHA"
-          elif [ "$TAG_OBJECT_TYPE" = "tag" ]; then
-            # Annotated tag - need to fetch the tag object to get the commit SHA
-            LATEST_SHA=$(curl -sL "https://api.github.com/repos/google/highway/git/tags/$TAG_OBJECT_SHA" | jq -r '.object.sha')
-            if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-              echo "Error: Could not fetch commit SHA for annotated tag $LATEST_TAG @ $TAG_OBJECT_SHA"
-              exit 1
-            fi
-          else
-            echo "Error: Unexpected tag object type: $TAG_OBJECT_TYPE"
-            exit 1
-          fi
-
-          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
-            echo "Error: Invalid SHA format received from GitHub"
-            echo "Found: $LATEST_SHA"
-            echo "Expected: 40 character hexadecimal string"
-            exit 1
-          fi
-
-          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
-          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
-
-      - name: Update version if needed
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        run: |
-          set -euo pipefail
-          # Handle multi-line format where COMMIT and its value are on separate lines
-          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildHighway.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildHighway.cmake
-          commit-message: "deps: update highway to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update highway to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-highway-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates highway to version ${{ steps.check-version.outputs.tag }}
-
-            Compare: https://github.com/google/highway/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-highway.yml)

.github/workflows/update-libarchive.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 
@@ -80,7 +75,7 @@ jobs:
 
       - name: Create Pull Request
         if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           add-paths: |

.github/workflows/update-libdeflate.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 
@@ -80,7 +75,7 @@ jobs:
 
       - name: Create Pull Request
         if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           add-paths: |

.github/workflows/update-lolhtml.yml

@@ -50,29 +50,12 @@ jobs:
             exit 1
           fi
 
-          # Get the commit SHA that the tag points to
-          # This handles both lightweight tags (direct commit refs) and annotated tags (tag objects)
-          TAG_REF_RESPONSE=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/refs/tags/$LATEST_TAG")
-          LATEST_TAG_SHA=$(echo "$TAG_REF_RESPONSE" | jq -r '.object.sha')
-          TAG_OBJECT_TYPE=$(echo "$TAG_REF_RESPONSE" | jq -r '.object.type')
-
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
             echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 
-          if [ "$TAG_OBJECT_TYPE" = "tag" ]; then
-            # This is an annotated tag, we need to get the commit it points to
-            LATEST_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
-            if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-              echo "Error: Could not fetch commit SHA for annotated tag $LATEST_TAG @ $LATEST_TAG_SHA"
-              exit 1
-            fi
-          else
-            # This is a lightweight tag pointing directly to a commit
-            LATEST_SHA="$LATEST_TAG_SHA"
-          fi
-
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
             echo "Found: $LATEST_SHA"
@@ -92,7 +75,7 @@ jobs:
 
       - name: Create Pull Request
         if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           add-paths: |

.github/workflows/update-lshpack.yml

@@ -50,34 +50,12 @@ jobs:
             exit 1
           fi
 
-          # Get the tag reference, which contains both SHA and type
-          TAG_REF=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/refs/tags/$LATEST_TAG")
-          if [ -z "$TAG_REF" ]; then
-            echo "Error: Could not fetch tag reference for $LATEST_TAG"
-            exit 1
-          fi
-
-          LATEST_TAG_SHA=$(echo "$TAG_REF" | jq -r '.object.sha')
-          TAG_TYPE=$(echo "$TAG_REF" | jq -r '.object.type')
-
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
             echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 
-          # If it's an annotated tag, we need to dereference it to get the commit SHA
-          # If it's a lightweight tag, the SHA already points to the commit
-          if [ "$TAG_TYPE" = "tag" ]; then
-            LATEST_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
-            if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-              echo "Error: Could not fetch commit SHA for annotated tag $LATEST_TAG"
-              exit 1
-            fi
-          else
-            # For lightweight tags, the SHA is already the commit SHA
-            LATEST_SHA="$LATEST_TAG_SHA"
-          fi
-
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
             echo "Found: $LATEST_SHA"
@@ -97,7 +75,7 @@ jobs:
 
       - name: Create Pull Request
         if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           add-paths: |

.github/workflows/update-sqlite3.yml

@@ -70,11 +70,28 @@ jobs:
       - name: Update SQLite if needed
         if: success() && steps.check-version.outputs.current_num < steps.check-version.outputs.latest_num
         run: |
-          ./scripts/update-sqlite-amalgamation.sh ${{ steps.check-version.outputs.latest_num }} ${{ steps.check-version.outputs.latest_year }}
+          set -euo pipefail
+
+          TEMP_DIR=$(mktemp -d)
+          cd $TEMP_DIR
+
+          echo "Downloading from: https://sqlite.org/${{ steps.check-version.outputs.latest_year }}/sqlite-amalgamation-${{ steps.check-version.outputs.latest_num }}.zip"
+
+          # Download and extract latest version
+          wget "https://sqlite.org/${{ steps.check-version.outputs.latest_year }}/sqlite-amalgamation-${{ steps.check-version.outputs.latest_num }}.zip"
+          unzip "sqlite-amalgamation-${{ steps.check-version.outputs.latest_num }}.zip"
+          cd "sqlite-amalgamation-${{ steps.check-version.outputs.latest_num }}"
+
+          # Add header comment and copy files
+          echo "// clang-format off" > $GITHUB_WORKSPACE/src/bun.js/bindings/sqlite/sqlite3.c
+          cat sqlite3.c >> $GITHUB_WORKSPACE/src/bun.js/bindings/sqlite/sqlite3.c
+
+          echo "// clang-format off" > $GITHUB_WORKSPACE/src/bun.js/bindings/sqlite/sqlite3_local.h
+          cat sqlite3.h >> $GITHUB_WORKSPACE/src/bun.js/bindings/sqlite/sqlite3_local.h
 
       - name: Create Pull Request
         if: success() && steps.check-version.outputs.current_num < steps.check-version.outputs.latest_num
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           add-paths: |

.github/workflows/update-vendor.yml

@@ -1,79 +0,0 @@
-name: Update vendor
-
-on:
-  schedule:
-    - cron: "0 4 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    strategy:
-      matrix:
-        package:
-          - elysia
-
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Check version
-        id: check-version
-        run: |
-          set -euo pipefail
-
-          # Extract the commit hash from the line after COMMIT
-          current=$(bun -p '(await Bun.file("test/vendor.json").json()).filter(v=>v.package===process.argv[1])[0].tag' ${{ matrix.package }})
-          repository=$(bun -p '(await Bun.file("test/vendor.json").json()).filter(v=>v.package===process.argv[1])[0].repository' ${{ matrix.package }} | cut -d'/' -f4,5)
-
-          if [ -z "$current" ]; then
-            echo "Error: Could not find COMMIT line in test/vendor.json"
-            exit 1
-          fi
-
-          echo "current=$current" >> $GITHUB_OUTPUT
-          echo "repository=$repository" >> $GITHUB_OUTPUT
-
-          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/${repository}/releases/latest)
-          if [ -z "$LATEST_RELEASE" ]; then
-            echo "Error: Failed to fetch latest release from GitHub API"
-            exit 1
-          fi
-
-          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
-          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
-            echo "Error: Could not extract tag name from GitHub API response"
-            exit 1
-          fi
-
-          echo "latest=$LATEST_TAG" >> $GITHUB_OUTPUT
-
-      - name: Update version if needed
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        run: |
-          set -euo pipefail
-          bun -e 'await Bun.write("test/vendor.json", JSON.stringify((await Bun.file("test/vendor.json").json()).map(v=>{if(v.package===process.argv[1])v.tag=process.argv[2];return v;}), null, 2) + "\n")' ${{ matrix.package }} ${{ steps.check-version.outputs.latest }}
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            test/vendor.json
-          commit-message: "deps: update ${{ matrix.package }} to ${{ steps.check-version.outputs.latest }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update ${{ matrix.package }} to ${{ steps.check-version.outputs.latest }}"
-          delete-branch: true
-          branch: deps/update-${{ matrix.package }}-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates ${{ matrix.package }} to version ${{ steps.check-version.outputs.latest }}
-
-            Compare: https://github.com/${{ steps.check-version.outputs.repository }}/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-vendor.yml)

.github/workflows/update-zstd.yml

@@ -1,99 +0,0 @@
-name: Update zstd
-
-on:
-  schedule:
-    - cron: "0 1 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check zstd version
-        id: check-version
-        run: |
-          set -euo pipefail
-
-          # Extract the commit hash from the line after COMMIT
-          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/CloneZstd.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in CloneZstd.cmake"
-            exit 1
-          fi
-
-          # Validate that it looks like a git hash
-          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
-            echo "Error: Invalid git hash format in CloneZstd.cmake"
-            echo "Found: $CURRENT_VERSION"
-            echo "Expected: 40 character hexadecimal string"
-            exit 1
-          fi
-
-          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-
-          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/facebook/zstd/releases/latest)
-          if [ -z "$LATEST_RELEASE" ]; then
-            echo "Error: Failed to fetch latest release from GitHub API"
-            exit 1
-          fi
-
-          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
-          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
-            echo "Error: Could not extract tag name from GitHub API response"
-            exit 1
-          fi
-
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/facebook/zstd/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/facebook/zstd/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
-          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
-            exit 1
-          fi
-
-          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
-            echo "Error: Invalid SHA format received from GitHub"
-            echo "Found: $LATEST_SHA"
-            echo "Expected: 40 character hexadecimal string"
-            exit 1
-          fi
-
-          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
-          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
-
-      - name: Update version if needed
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        run: |
-          set -euo pipefail
-          # Handle multi-line format where COMMIT and its value are on separate lines
-          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/CloneZstd.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v7
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/CloneZstd.cmake
-          commit-message: "deps: update zstd to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update zstd to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-zstd-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates zstd to version ${{ steps.check-version.outputs.tag }}
-
-            Compare: https://github.com/facebook/zstd/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-zstd.yml)

.github/workflows/vscode-release.yml

@@ -1,52 +0,0 @@
-name: VSCode Extension Publish
-on:
-  workflow_dispatch:
-    inputs:
-      version:
-        description: "Version to publish (e.g. 0.0.25) - Check the marketplace for the latest version"
-        required: true
-        type: string
-
-jobs:
-  publish:
-    name: "Publish to VS Code Marketplace"
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: ./.github/actions/setup-bun
-        with:
-          bun-version: "1.2.18"
-
-      - name: Install dependencies (root)
-        run: bun install
-
-      - name: Install dependencies
-        run: bun install
-        working-directory: packages/bun-vscode
-
-      - name: Set Version
-        run: bun pm version ${{ github.event.inputs.version }} --no-git-tag-version --allow-same-version
-        working-directory: packages/bun-vscode
-
-      - name: Build (inspector protocol)
-        run: bun install && bun run build
-        working-directory: packages/bun-inspector-protocol
-
-      - name: Build (vscode extension)
-        run: bun run build
-        working-directory: packages/bun-vscode
-
-      - name: Publish
-        if: success()
-        run: bunx vsce publish
-        env:
-          VSCE_PAT: ${{ secrets.VSCODE_EXTENSION }}
-        working-directory: packages/bun-vscode/extension
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: bun-vscode-${{ github.event.inputs.version }}.vsix
-          path: packages/bun-vscode/extension/bun-vscode-${{ github.event.inputs.version }}.vsix

.github/workflows/zig-format.yml

@@ -0,0 +1,34 @@
+name: zig-format
+
+permissions:
+  contents: write
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  merge_group:
+
+env:
+  BUN_VERSION: "1.2.0"
+
+jobs:
+  zig-format:
+    name: zig-format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Zig Format
+        run: |
+          bun run zig-format:diff
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run zig-format`"

.gitignore

@@ -1,9 +1,7 @@
-.claude/settings.local.json
 .DS_Store
 .env
 .envrc
 .eslintcache
-.gdb_history
 .idea
 .next
 .ninja_deps
@@ -38,7 +36,6 @@
 *.out.refresh.js
 *.pdb
 *.sqlite
-*.swp
 *.tmp
 *.trace
 *.wat
@@ -156,7 +153,6 @@ test/cli/install/registry/packages/publish-pkg-*
 test/cli/install/registry/packages/@secret/publish-pkg-8
 test/js/third_party/prisma/prisma/sqlite/dev.db-journal
 tmp
-codegen-for-zig-team.tar.gz
 
 # Dependencies
 /vendor
@@ -186,9 +182,4 @@ codegen-for-zig-team.tar.gz
 *.sock
 scratch*.{js,ts,tsx,cjs,mjs}
 
-*.bun-build
-
-scripts/lldb-inline
-
-# We regenerate these in all the build scripts
-cmake/sources/*.txt
+*.bun-build

.lldbinit

@@ -1 +1,16 @@
-command source -C -s true -e true misctools/lldb/init.lldb
+# Tell LLDB what to do when the debugged process receives SIGPWR: pass it through to the process
+# (-p), but do not stop the process (-s) or notify the user (-n).
+#
+# JSC's garbage collector sends this signal (as configured by Bun WebKit in
+# Thread::initializePlatformThreading() in ThreadingPOSIX.cpp) to the JS thread to suspend or resume
+# it. So stopping the process would just create noise when debugging any long-running script.
+process handle -p true -s false -n false SIGPWR
+
+command script import misctools/lldb/lldb_pretty_printers.py
+type category enable zig.lang
+type category enable zig.std
+
+command script import misctools/lldb/lldb_webkit.py
+
+command script delete btjs
+command alias btjs p {printf("gathering btjs trace...\n");printf("%s\n", (char*)dumpBtjsTrace())}

.prettierignore

@@ -7,8 +7,4 @@ src/react-refresh.js
 *.min.js
 test/snippets
 test/js/node/test
-test/napi/node-napi-tests
 bun.lock
-
-# the output codeblocks need to stay minified
-docs/bundler/minifier.mdx

.prettierrc

@@ -19,12 +19,6 @@
       "options": {
         "printWidth": 80
       }
-    },
-    {
-      "files": ["src/codegen/bindgenv2/**/*.ts", "*.bindv2.ts"],
-      "options": {
-        "printWidth": 100
-      }
     }
   ]
 }

.vscode/settings.json

@@ -30,7 +30,7 @@
   "zig.initialSetupDone": true,
   "zig.buildOption": "build",
   "zig.zls.zigLibPath": "${workspaceFolder}/vendor/zig/lib",
-  "zig.buildArgs": ["-Dgenerated-code=./build/debug/codegen", "--watch", "-fincremental"],
+  "zig.buildArgs": ["-Dgenerated-code=./build/debug/codegen"],
   "zig.zls.buildOnSaveStep": "check",
   // "zig.zls.enableBuildOnSave": true,
   // "zig.buildOnSave": true,
@@ -43,9 +43,6 @@
     "editor.tabSize": 4,
     "editor.useTabStops": false,
     "editor.defaultFormatter": "ziglang.vscode-zig",
-    "editor.codeActionsOnSave": {
-      "source.organizeImports": "never",
-    },
   },
 
   // lldb
@@ -139,6 +136,9 @@
     "**/*.xcscheme": true,
     "**/*.xcodeproj": true,
     "**/*.i": true,
+
+    // uws WebSocket.cpp conflicts with webcore WebSocket.cpp
+    "packages/bun-uws/fuzzing": true,
   },
   "files.associations": {
     "*.css": "tailwindcss",
@@ -146,8 +146,6 @@
     "*.mdc": "markdown",
     "array": "cpp",
     "ios": "cpp",
-    "oxlint.json": "jsonc",
-    "bun.lock": "jsonc",
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,
@@ -168,5 +166,4 @@
     "WebKit/WebInspectorUI": true,
   },
   "git.detectSubmodules": false,
-  "bun.test.customScript": "./build/debug/bun-debug test",
 }

AGENTS.md

@@ -1 +0,0 @@
-CLAUDE.md

CLAUDE.md

@@ -1,211 +0,0 @@
-This is the Bun repository - an all-in-one JavaScript runtime & toolkit designed for speed, with a bundler, test runner, and Node.js-compatible package manager. It's written primarily in Zig with C++ for JavaScriptCore integration, powered by WebKit's JavaScriptCore engine.
-
-## Building and Running Bun
-
-### Build Commands
-
-- **Build Bun**: `bun bd`
-  - Creates a debug build at `./build/debug/bun-debug`
-  - **CRITICAL**: no need for a timeout, the build is really fast!
-- **Run tests with your debug build**: `bun bd test <test-file>`
-  - **CRITICAL**: Never use `bun test` directly - it won't include your changes
-- **Run any command with debug build**: `bun bd <command>`
-
-Tip: Bun is already installed and in $PATH. The `bd` subcommand is a package.json script.
-
-## Testing
-
-### Running Tests
-
-- **Single test file**: `bun bd test test/js/bun/http/serve.test.ts`
-- **Fuzzy match test file**: `bun bd test http/serve.test.ts`
-- **With filter**: `bun bd test test/js/bun/http/serve.test.ts -t "should handle"`
-
-### Test Organization
-
-If a test is for a specific numbered GitHub Issue, it should be placed in `test/regression/issue/${issueNumber}.test.ts`. Ensure the issue number is **REAL** and not a placeholder!
-
-If no valid issue number is provided, find the best existing file to modify instead, such as;
-
-- `test/js/bun/` - Bun-specific API tests (http, crypto, ffi, shell, etc.)
-- `test/js/node/` - Node.js compatibility tests
-- `test/js/web/` - Web API tests (fetch, WebSocket, streams, etc.)
-- `test/cli/` - CLI command tests (install, run, test, etc.)
-- `test/bundler/` - Bundler and transpiler tests. Use `itBundled` helper.
-- `test/integration/` - End-to-end integration tests
-- `test/napi/` - N-API compatibility tests
-- `test/v8/` - V8 C++ API compatibility tests
-
-### Writing Tests
-
-Tests use Bun's Jest-compatible test runner with proper test fixtures.
-
-- For **single-file tests**, prefer `-e` over `tempDir`.
-- For **multi-file tests**, prefer `tempDir` and `Bun.spawn`.
-
-```typescript
-import { test, expect } from "bun:test";
-import { bunEnv, bunExe, normalizeBunSnapshot, tempDir } from "harness";
-
-test("(single-file test) my feature", async () => {
-  await using proc = Bun.spawn({
-    cmd: [bunExe(), "-e", "console.log('Hello, world!')"],
-    env: bunEnv,
-  });
-
-  const [stdout, stderr, exitCode] = await Promise.all([
-    proc.stdout.text(),
-    proc.stderr.text(),
-    proc.exited,
-  ]);
-
-  expect(normalizeBunSnapshot(stdout)).toMatchInlineSnapshot(`"Hello, world!"`);
-  expect(exitCode).toBe(0);
-});
-
-test("(multi-file test) my feature", async () => {
-  // Create temp directory with test files
-  using dir = tempDir("test-prefix", {
-    "index.js": `import { foo } from "./foo.ts"; foo();`,
-    "foo.ts": `export function foo() { console.log("foo"); }`,
-  });
-
-  // Spawn Bun process
-  await using proc = Bun.spawn({
-    cmd: [bunExe(), "index.js"],
-    env: bunEnv,
-    cwd: String(dir),
-    stderr: "pipe",
-  });
-
-  const [stdout, stderr, exitCode] = await Promise.all([
-    proc.stdout.text(),
-    proc.stderr.text(),
-    proc.exited,
-  ]);
-
-  // Prefer snapshot tests over expect(stdout).toBe("hello\n");
-  expect(normalizeBunSnapshot(stdout, dir)).toMatchInlineSnapshot(`"hello"`);
-
-  // Assert the exit code last. This gives you a more useful error message on test failure.
-  expect(exitCode).toBe(0);
-});
-```
-
-- Always use `port: 0`. Do not hardcode ports. Do not use your own random port number function.
-- Use `normalizeBunSnapshot` to normalize snapshot output of the test.
-- NEVER write tests that check for no "panic" or "uncaught exception" or similar in the test output. That is NOT a valid test.
-- Use `tempDir` from `"harness"` to create a temporary directory. **Do not** use `tmpdirSync` or `fs.mkdtempSync` to create temporary directories.
-- When spawning processes, tests should expect(stdout).toBe(...) BEFORE expect(exitCode).toBe(0). This gives you a more useful error message on test failure.
-- **CRITICAL**: Do not write flaky tests. Do not use `setTimeout` in tests. Instead, `await` the condition to be met. You are not testing the TIME PASSING, you are testing the CONDITION.
-- **CRITICAL**: Verify your test fails with `USE_SYSTEM_BUN=1 bun test <file>` and passes with `bun bd test <file>`. Your test is NOT VALID if it passes with `USE_SYSTEM_BUN=1`.
-
-## Code Architecture
-
-### Language Structure
-
-- **Zig code** (`src/*.zig`): Core runtime, JavaScript bindings, package manager
-- **C++ code** (`src/bun.js/bindings/*.cpp`): JavaScriptCore bindings, Web APIs
-- **TypeScript** (`src/js/`): Built-in JavaScript modules with special syntax (see JavaScript Modules section)
-- **Generated code**: Many files are auto-generated from `.classes.ts` and other sources. Bun will automatically rebuild these files when you make changes to them.
-
-### Core Source Organization
-
-#### Runtime Core (`src/`)
-
-- `bun.zig` - Main entry point
-- `cli.zig` - CLI command orchestration
-- `js_parser.zig`, `js_lexer.zig`, `js_printer.zig` - JavaScript parsing/printing
-- `transpiler.zig` - Wrapper around js_parser with sourcemap support
-- `resolver/` - Module resolution system
-- `allocators/` - Custom memory allocators for performance
-
-#### JavaScript Runtime (`src/bun.js/`)
-
-- `bindings/` - C++ JavaScriptCore bindings
-  - Generated classes from `.classes.ts` files
-  - Manual bindings for complex APIs
-- `api/` - Bun-specific APIs
-  - `server.zig` - HTTP server implementation
-  - `FFI.zig` - Foreign Function Interface
-  - `crypto.zig` - Cryptographic operations
-  - `glob.zig` - File pattern matching
-- `node/` - Node.js compatibility layer
-  - Module implementations (fs, path, crypto, etc.)
-  - Process and Buffer APIs
-- `webcore/` - Web API implementations
-  - `fetch.zig` - Fetch API
-  - `streams.zig` - Web Streams
-  - `Blob.zig`, `Response.zig`, `Request.zig`
-- `event_loop/` - Event loop and task management
-
-#### Build Tools & Package Manager
-
-- `src/bundler/` - JavaScript bundler
-  - Advanced tree-shaking
-  - CSS processing
-  - HTML handling
-- `src/install/` - Package manager
-  - `lockfile/` - Lockfile handling
-  - `npm.zig` - npm registry client
-  - `lifecycle_script_runner.zig` - Package scripts
-
-#### Other Key Components
-
-- `src/shell/` - Cross-platform shell implementation
-- `src/css/` - CSS parser and processor
-- `src/http/` - HTTP client implementation
-  - `websocket_client/` - WebSocket client (including deflate support)
-- `src/sql/` - SQL database integrations
-- `src/bake/` - Server-side rendering framework
-
-### JavaScript Class Implementation (C++)
-
-When implementing JavaScript classes in C++:
-
-1. Create three classes if there's a public constructor:
-   - `class Foo : public JSC::JSDestructibleObject` (if has C++ fields)
-   - `class FooPrototype : public JSC::JSNonFinalObject`
-   - `class FooConstructor : public JSC::InternalFunction`
-
-2. Define properties using HashTableValue arrays
-3. Add iso subspaces for classes with C++ fields
-4. Cache structures in ZigGlobalObject
-
-### Code Generation
-
-Code generation happens automatically as part of the build process. The main scripts are:
-
-- `src/codegen/generate-classes.ts` - Generates Zig & C++ bindings from `*.classes.ts` files
-- `src/codegen/generate-jssink.ts` - Generates stream-related classes
-- `src/codegen/bundle-modules.ts` - Bundles built-in modules like `node:fs`
-- `src/codegen/bundle-functions.ts` - Bundles global functions like `ReadableStream`
-
-In development, bundled modules can be reloaded without rebuilding Zig by running `bun run build`.
-
-## JavaScript Modules (`src/js/`)
-
-Built-in JavaScript modules use special syntax and are organized as:
-
-- `node/` - Node.js compatibility modules (`node:fs`, `node:path`, etc.)
-- `bun/` - Bun-specific modules (`bun:ffi`, `bun:sqlite`, etc.)
-- `thirdparty/` - NPM modules we replace (like `ws`)
-- `internal/` - Internal modules not exposed to users
-- `builtins/` - Core JavaScript builtins (streams, console, etc.)
-
-## Important Development Notes
-
-1. **Never use `bun test` or `bun <file>` directly** - always use `bun bd test` or `bun bd <command>`. `bun bd` compiles & runs the debug build.
-2. **All changes must be tested** - if you're not testing your changes, you're not done.
-3. **Get your tests to pass**. If you didn't run the tests, your code does not work.
-4. **Follow existing code style** - check neighboring files for patterns
-5. **Create tests in the right folder** in `test/` and the test must end in `.test.ts` or `.test.tsx`
-6. **Use absolute paths** - Always use absolute paths in file operations
-7. **Avoid shell commands** - Don't use `find` or `grep` in tests; use Bun's Glob and built-in tools
-8. **Memory management** - In Zig code, be careful with allocators and use defer for cleanup
-9. **Cross-platform** - Run `bun run zig:check-all` to compile the Zig code on all platforms when making platform-specific changes
-10. **Debug builds** - Use `BUN_DEBUG_QUIET_LOGS=1` to disable debug logging, or `BUN_DEBUG_<scopeName>=1` to enable specific `Output.scoped(.${scopeName}, .visible)`s
-11. **Be humble & honest** - NEVER overstate what you got done or what actually works in commits, PRs or in messages to the user.
-12. **Branch names must start with `claude/`** - This is a requirement for the CI to work.
-
-**ONLY** push up changes after running `bun bd test <file>` and ensuring your tests pass.

CMakeLists.txt

@@ -24,17 +24,13 @@ if(CMAKE_HOST_APPLE)
   include(SetupMacSDK)
 endif()
 include(SetupLLVM)
+include(SetupCcache)
 
 # --- Project ---
 
 parse_package_json(VERSION_VARIABLE DEFAULT_VERSION)
 optionx(VERSION STRING "The version of Bun" DEFAULT ${DEFAULT_VERSION})
 project(Bun VERSION ${VERSION})
-
-# Bun uses C++23, which is compatible with BoringSSL's C++17 requirement
-set(CMAKE_CXX_STANDARD 23)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-
 include(Options)
 include(CompilerFlags)
 
@@ -47,19 +43,6 @@ include(SetupEsbuild)
 include(SetupZig)
 include(SetupRust)
 
-find_program(SCCACHE_PROGRAM sccache)
-if(SCCACHE_PROGRAM AND NOT DEFINED ENV{NO_SCCACHE})
-  include(SetupSccache)
-else()
-  find_program(CCACHE_PROGRAM ccache)
-  if(CCACHE_PROGRAM)
-    include(SetupCcache)
-  endif()
-endif()
-
-# Generate dependency versions header
-include(GenerateDependencyVersions)
-
 # --- Targets ---
 
 include(BuildBun)

CONTRIBUTING.md

@@ -1,41 +1,27 @@
 Configuring a development environment for Bun can take 10-30 minutes depending on your internet connection and computer speed. You will need ~10GB of free disk space for the repository and build artifacts.
 
-If you are using Windows, please refer to [this guide](https://bun.com/docs/project/building-windows)
+If you are using Windows, please refer to [this guide](https://bun.sh/docs/project/building-windows)
 
-## Using Nix (Alternative)
-
-A Nix flake is provided as an alternative to manual dependency installation:
-
-```bash
-nix develop
-# or explicitly use the pure shell
-# nix develop .#pure
-export CMAKE_SYSTEM_PROCESSOR=$(uname -m)
-bun bd
-```
-
-This provides all dependencies in an isolated, reproducible environment without requiring sudo.
-
-## Install Dependencies (Manual)
+## Install Dependencies
 
 Using your system's package manager, install Bun's dependencies:
 
 {% codetabs group="os" %}
 
 ```bash#macOS (Homebrew)
-$ brew install automake cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby sccache
+$ brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby
 ```
 
 ```bash#Ubuntu/Debian
-$ sudo apt install curl wget lsb-release software-properties-common cargo cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
+$ sudo apt install curl wget lsb-release software-properties-common cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
 ```
 
 ```bash#Arch
-$ sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config python rust sed unzip ruby
+$ sudo pacman -S base-devel ccache cmake git go libiconv libtool make ninja pkg-config python rust sed unzip ruby
 ```
 
 ```bash#Fedora
-$ sudo dnf install cargo clang19 llvm19 lld19 cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
+$ sudo dnf install cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
 ```
 
 ```bash#openSUSE Tumbleweed
@@ -51,7 +37,7 @@ Before starting, you will need to already have a release build of Bun installed,
 {% codetabs %}
 
 ```bash#Native
-$ curl -fsSL https://bun.com/install | bash
+$ curl -fsSL https://bun.sh/install | bash
 ```
 
 ```bash#npm
@@ -65,79 +51,41 @@ $ brew install bun
 
 {% /codetabs %}
 
-### Optional: Install `sccache`
-
-sccache is used to cache compilation artifacts, significantly speeding up builds. It must be installed with S3 support:
-
-```bash
-# For macOS
-$ brew install sccache
-
-# For Linux. Note that the version in your package manager may not have S3 support.
-$ cargo install sccache --features=s3
-```
-
-This will install `sccache` with S3 support. Our build scripts will automatically detect and use `sccache` with our shared S3 cache. **Note**: Not all versions of `sccache` are compiled with S3 support, hence we recommend installing it via `cargo`.
-
-#### Registering AWS Credentials for `sccache` (Core Developers Only)
-
-Core developers have write access to the shared S3 cache. To enable write access, you must log in with AWS credentials. The easiest way to do this is to use the [`aws` CLI](https://aws.amazon.com/cli/) and invoke [`aws configure` to provide your AWS security info](https://docs.aws.amazon.com/cli/latest/reference/configure/).
-
-The `cmake` scripts should automatically detect your AWS credentials from the environment or the `~/.aws/credentials` file.
-
-<details>
-    <summary>Logging in to the `aws` CLI</summary>
-
-    1. Install the AWS CLI by following [the official guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
-    2. Log in to your AWS account console. A team member should provide you with your credentials.
-    3. Click your name in the top right > Security credentials.
-    4. Scroll to "Access keys" and create a new access key.
-    5. Run `aws configure` in your terminal and provide the access key ID and secret access key when prompted.
-</details>
-
-<details>
-    <summary>Common Issues You May Encounter</summary>
-
-    - To confirm that the cache is being used, you can use the `sccache --show-stats` command right after a build. This will expose very useful statistics, including cache hits/misses.
-    - If you have multiple AWS profiles configured, ensure that the correct profile is set in the `AWS_PROFILE` environment variable.
-    - `sccache` follows a server-client model. If you run into weird issues where `sccache` refuses to use S3, even though you have AWS credentials configured, try killing any running `sccache` servers with `sccache --stop-server` and then re-running the build.
-</details>
-
 ## Install LLVM
 
-Bun requires LLVM 19 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
+Bun requires LLVM 18 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
 
 {% codetabs group="os" %}
 
 ```bash#macOS (Homebrew)
-$ brew install llvm@19
+$ brew install llvm@18
 ```
 
 ```bash#Ubuntu/Debian
 $ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
-$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 18 all
 ```
 
 ```bash#Arch
-$ sudo pacman -S llvm clang lld
+$ sudo pacman -S llvm clang18 lld
 ```
 
 ```bash#Fedora
-$ sudo dnf install llvm clang lld-devel
+$ sudo dnf install llvm18 clang18 lld18-devel
 ```
 
 ```bash#openSUSE Tumbleweed
-$ sudo zypper install clang19 lld19 llvm19
+$ sudo zypper install clang18 lld18 llvm18
 ```
 
 {% /codetabs %}
 
 If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.7).
 
-Make sure Clang/LLVM 19 is in your path:
+Make sure Clang/LLVM 18 is in your path:
 
 ```bash
-$ which clang-19
+$ which clang-18
 ```
 
 If not, run this to manually add it:
@@ -146,13 +94,13 @@ If not, run this to manually add it:
 
 ```bash#macOS (Homebrew)
 # use fish_add_path if you're using fish
-# use path+="$(brew --prefix llvm@19)/bin" if you are using zsh
-$ export PATH="$(brew --prefix llvm@19)/bin:$PATH"
+# use path+="$(brew --prefix llvm@18)/bin" if you are using zsh
+$ export PATH="$(brew --prefix llvm@18)/bin:$PATH"
 ```
 
 ```bash#Arch
 # use fish_add_path if you're using fish
-$ export PATH="$PATH:/usr/lib/llvm19/bin"
+$ export PATH="$PATH:/usr/lib/llvm18/bin"
 ```
 
 {% /codetabs %}
@@ -186,24 +134,6 @@ We recommend adding `./build/debug` to your `$PATH` so that you can run `bun-deb
 $ bun-debug
 ```
 
-## Running debug builds
-
-The `bd` package.json script compiles and runs a debug build of Bun, only printing the output of the build process if it fails.
-
-```sh
-$ bun bd <args>
-$ bun bd test foo.test.ts
-$ bun bd ./foo.ts
-```
-
-Bun generally takes about 2.5 minutes to compile a debug build when there are Zig changes. If your development workflow is "change one line, save, rebuild", you will spend too much time waiting for the build to finish. Instead:
-
-- Batch up your changes
-- Ensure zls is running with incremental watching for LSP errors (if you use VSCode and install Zig and run `bun run build` once to download Zig, this should just work)
-- Prefer using the debugger ("CodeLLDB" in VSCode) to step through the code.
-- Use debug logs. `BUN_DEBUG_<scope>=1` will enable debug logging for the corresponding `Output.scoped(.<scope>, .hidden)` logs. You can also set `BUN_DEBUG_QUIET_LOGS=1` to disable all debug logging that isn't explicitly enabled. To dump debug logs into a file, `BUN_DEBUG=<path-to-file>.log`. Debug logs are aggressively removed in release builds.
-- src/js/\*\*.ts changes are pretty much instant to rebuild. C++ changes are a bit slower, but still much faster than the Zig code (Zig is one compilation unit, C++ is many).
-
 ## Code generation scripts
 
 Several code generation scripts are used during Bun's build process. These are run automatically when changes are made to certain files.
@@ -212,7 +142,6 @@ In particular, these are:
 
 - `./src/codegen/generate-jssink.ts` -- Generates `build/debug/codegen/JSSink.cpp`, `build/debug/codegen/JSSink.h` which implement various classes for interfacing with `ReadableStream`. This is internally how `FileSink`, `ArrayBufferSink`, `"type": "direct"` streams and other code related to streams works.
 - `./src/codegen/generate-classes.ts` -- Generates `build/debug/codegen/ZigGeneratedClasses*`, which generates Zig & C++ bindings for JavaScriptCore classes implemented in Zig. In `**/*.classes.ts` files, we define the interfaces for various classes, methods, prototypes, getters/setters etc which the code generator reads to generate boilerplate code implementing the JavaScript objects in C++ and wiring them up to Zig
-- `./src/codegen/cppbind.ts` -- Generates automatic Zig bindings for C++ functions marked with `[[ZIG_EXPORT]]` attributes.
 - `./src/codegen/bundle-modules.ts` -- Bundles built-in modules like `node:fs`, `bun:ffi` into files we can include in the final binary. In development, these can be reloaded without rebuilding Zig (you still need to run `bun run build`, but it re-reads the transpiled files from disk afterwards). In release builds, these are embedded into the binary.
 - `./src/codegen/bundle-functions.ts` -- Bundles globally-accessible functions implemented in JavaScript/TypeScript like `ReadableStream`, `WritableStream`, and a handful more. These are used similarly to the builtin modules, but the output more closely aligns with what WebKit/Safari does for Safari's built-in functions so that we can copy-paste the implementations from WebKit as a starting point.
 
@@ -240,7 +169,6 @@ To run a release build from a pull request, you can use the `bun-pr` npm package
 bunx bun-pr <pr-number>
 bunx bun-pr <branch-name>
 bunx bun-pr "https://github.com/oven-sh/bun/pull/1234566"
-bunx bun-pr --asan <pr-number> # Linux x64 only
 ```
 
 This will download the release build from the pull request and add it to `$PATH` as `bun-${pr-number}`. You can then run the build with `bun-${pr-number}`.
@@ -251,18 +179,24 @@ bun-1234566 --version
 
 This works by downloading the release build from the GitHub Actions artifacts on the linked pull request. You may need the `gh` CLI installed to authenticate with GitHub.
 
-## AddressSanitizer
+## Valgrind
 
-[AddressSanitizer](https://en.wikipedia.org/wiki/AddressSanitizer) helps find memory issues, and is enabled by default in debug builds of Bun on Linux and macOS. This includes the Zig code and all dependencies. It makes the Zig code take about 2x longer to build, if that's stopping you from being productive you can disable it by setting `-Denable_asan=$<IF:$<BOOL:${ENABLE_ASAN}>,true,false>` to `-Denable_asan=false` in the `cmake/targets/BuildBun.cmake` file, but generally we recommend batching your changes up between builds.
+On Linux, valgrind can help find memory issues.
 
-To build a release build with Address Sanitizer, run:
+Keep in mind:
+
+- JavaScriptCore doesn't support valgrind. It will report spurious errors.
+- Valgrind is slow
+- Mimalloc will sometimes cause spurious errors when debug build is enabled
+
+You'll need a very recent version of Valgrind due to DWARF 5 debug symbols. You may need to manually compile Valgrind instead of using it from your Linux package manager.
+
+`--fair-sched=try` is necessary if running multithreaded code in Bun (such as the bundler). Otherwise it will hang.
 
 ```bash
-$ bun run build:release:asan
+$ valgrind --fair-sched=try --track-origins=yes bun-debug <args>
 ```
 
-In CI, we run our test suite with at least one target that is built with Address Sanitizer.
-
 ## Building WebKit locally + Debug mode of JSC
 
 WebKit is not cloned by default (to save time and disk space). To clone and build WebKit locally, run:
@@ -275,11 +209,8 @@ $ git clone https://github.com/oven-sh/WebKit vendor/WebKit
 $ git -C vendor/WebKit checkout <commit_hash>
 
 # Make a debug build of JSC. This will output build artifacts in ./vendor/WebKit/WebKitBuild/Debug
-# Optionally, you can use `bun run jsc:build` for a release build
-$ bun run jsc:build:debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
-
-# After an initial run of `make jsc-debug`, you can rebuild JSC with:
-$ cmake --build vendor/WebKit/WebKitBuild/Debug --target jsc && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
+# Optionally, you can use `make jsc` for a release build
+$ make jsc-debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
 
 # Build bun with the local JSC build
 $ bun run build:local
@@ -319,7 +250,7 @@ The issue may manifest when initially running `bun setup` as Clang being unable
 ```
 The C++ compiler
 
-  "/usr/bin/clang++-19"
+  "/usr/bin/clang++-18"
 
 is not able to compile a simple test program.
 ```
@@ -369,6 +300,15 @@ $ bun run build -DUSE_STATIC_LIBATOMIC=OFF
 
 The built version of Bun may not work on other systems if compiled this way.
 
+### ccache conflicts with building TinyCC on macOS
+
+If you run into issues with `ccache` when building TinyCC, try reinstalling ccache
+
+```bash
+brew uninstall ccache
+brew install ccache
+```
+
 ## Using bun-debug
 
 - Disable logging: `BUN_DEBUG_QUIET_LOGS=1 bun-debug ...` (to disable all debug logging)

LATEST

@@ -1 +1 @@
-1.3.3
+1.2.5

README.md

@@ -1,16 +1,16 @@
 <p align="center">
-  <a href="https://bun.com"><img src="https://github.com/user-attachments/assets/50282090-adfd-4ddb-9e27-c30753c6b161" alt="Logo" height=170></a>
+  <a href="https://bun.sh"><img src="https://github.com/user-attachments/assets/50282090-adfd-4ddb-9e27-c30753c6b161" alt="Logo" height=170></a>
 </p>
 <h1 align="center">Bun</h1>
 
 <p align="center">
-<a href="https://bun.com/discord" target="_blank"><img height=20 src="https://img.shields.io/discord/876711213126520882" /></a>
+<a href="https://bun.sh/discord" target="_blank"><img height=20 src="https://img.shields.io/discord/876711213126520882" /></a>
 <img src="https://img.shields.io/github/stars/oven-sh/bun" alt="stars">
 <a href="https://twitter.com/jarredsumner/status/1542824445810642946"><img src="https://img.shields.io/static/v1?label=speed&message=fast&color=success" alt="Bun speed" /></a>
 </p>
 
 <div align="center">
-  <a href="https://bun.com/docs">Documentation</a>
+  <a href="https://bun.sh/docs">Documentation</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
   <a href="https://discord.com/invite/CXdq2DP29u">Discord</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
@@ -20,7 +20,7 @@
   <br />
 </div>
 
-### [Read the docs →](https://bun.com/docs)
+### [Read the docs →](https://bun.sh/docs)
 
 ## What is Bun?
 
@@ -47,11 +47,9 @@ Bun supports Linux (x64 & arm64), macOS (x64 & Apple Silicon) and Windows (x64).
 
 > **Linux users** — Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1.
 
-> **x64 users** — if you see "illegal instruction" or similar errors, check our [CPU requirements](https://bun.com/docs/installation#cpu-requirements-and-baseline-builds)
-
 ```sh
 # with install script (recommended)
-curl -fsSL https://bun.com/install | bash
+curl -fsSL https://bun.sh/install | bash
 
 # on windows
 powershell -c "irm bun.sh/install.ps1 | iex"
@@ -87,329 +85,315 @@ bun upgrade --canary
 ## Quick links
 
 - Intro
-  - [What is Bun?](https://bun.com/docs/index)
-  - [Installation](https://bun.com/docs/installation)
-  - [Quickstart](https://bun.com/docs/quickstart)
-  - [TypeScript](https://bun.com/docs/typescript)
+
+  - [What is Bun?](https://bun.sh/docs/index)
+  - [Installation](https://bun.sh/docs/installation)
+  - [Quickstart](https://bun.sh/docs/quickstart)
+  - [TypeScript](https://bun.sh/docs/typescript)
 
 - Templating
-  - [`bun init`](https://bun.com/docs/cli/init)
-  - [`bun create`](https://bun.com/docs/cli/bun-create)
 
-- CLI
-  - [`bun upgrade`](https://bun.com/docs/cli/bun-upgrade)
+  - [`bun init`](https://bun.sh/docs/cli/init)
+  - [`bun create`](https://bun.sh/docs/cli/bun-create)
 
 - Runtime
-  - [`bun run`](https://bun.com/docs/cli/run)
-  - [File types (Loaders)](https://bun.com/docs/runtime/loaders)
-  - [TypeScript](https://bun.com/docs/runtime/typescript)
-  - [JSX](https://bun.com/docs/runtime/jsx)
-  - [Environment variables](https://bun.com/docs/runtime/environment-variables)
-  - [Bun APIs](https://bun.com/docs/runtime/bun-apis)
-  - [Web APIs](https://bun.com/docs/runtime/web-apis)
-  - [Node.js compatibility](https://bun.com/docs/runtime/nodejs-compat)
-  - [Single-file executable](https://bun.com/docs/bundler/executables)
-  - [Plugins](https://bun.com/docs/runtime/plugins)
-  - [Watch mode / Hot Reloading](https://bun.com/docs/runtime/watch-mode)
-  - [Module resolution](https://bun.com/docs/runtime/modules)
-  - [Auto-install](https://bun.com/docs/runtime/autoimport)
-  - [bunfig.toml](https://bun.com/docs/runtime/bunfig)
-  - [Debugger](https://bun.com/docs/runtime/debugger)
-  - [$ Shell](https://bun.com/docs/runtime/shell)
+
+  - [`bun run`](https://bun.sh/docs/cli/run)
+  - [File types](https://bun.sh/docs/runtime/loaders)
+  - [TypeScript](https://bun.sh/docs/runtime/typescript)
+  - [JSX](https://bun.sh/docs/runtime/jsx)
+  - [Environment variables](https://bun.sh/docs/runtime/env)
+  - [Bun APIs](https://bun.sh/docs/runtime/bun-apis)
+  - [Web APIs](https://bun.sh/docs/runtime/web-apis)
+  - [Node.js compatibility](https://bun.sh/docs/runtime/nodejs-apis)
+  - [Single-file executable](https://bun.sh/docs/bundler/executables)
+  - [Plugins](https://bun.sh/docs/runtime/plugins)
+  - [Watch mode](https://bun.sh/docs/runtime/hot)
+  - [Module resolution](https://bun.sh/docs/runtime/modules)
+  - [Auto-install](https://bun.sh/docs/runtime/autoimport)
+  - [bunfig.toml](https://bun.sh/docs/runtime/bunfig)
+  - [Debugger](https://bun.sh/docs/runtime/debugger)
+  - [Framework API](https://bun.sh/docs/runtime/framework)
 
 - Package manager
-  - [`bun install`](https://bun.com/docs/cli/install)
-  - [`bun add`](https://bun.com/docs/cli/add)
-  - [`bun remove`](https://bun.com/docs/cli/remove)
-  - [`bun update`](https://bun.com/docs/cli/update)
-  - [`bun link`](https://bun.com/docs/cli/link)
-  - [`bun unlink`](https://bun.com/docs/cli/unlink)
-  - [`bun pm`](https://bun.com/docs/cli/pm)
-  - [`bun outdated`](https://bun.com/docs/cli/outdated)
-  - [`bun publish`](https://bun.com/docs/cli/publish)
-  - [`bun patch`](https://bun.com/docs/install/patch)
-  - [`bun patch-commit`](https://bun.com/docs/cli/patch-commit)
-  - [Global cache](https://bun.com/docs/install/cache)
-  - [Workspaces](https://bun.com/docs/install/workspaces)
-  - [Lifecycle scripts](https://bun.com/docs/install/lifecycle)
-  - [Filter](https://bun.com/docs/cli/filter)
-  - [Lockfile](https://bun.com/docs/install/lockfile)
-  - [Scopes and registries](https://bun.com/docs/install/registries)
-  - [Overrides and resolutions](https://bun.com/docs/install/overrides)
-  - [`.npmrc`](https://bun.com/docs/install/npmrc)
+
+  - [`bun install`](https://bun.sh/docs/cli/install)
+  - [`bun add`](https://bun.sh/docs/cli/add)
+  - [`bun remove`](https://bun.sh/docs/cli/remove)
+  - [`bun update`](https://bun.sh/docs/cli/update)
+  - [`bun link`](https://bun.sh/docs/cli/link)
+  - [`bun pm`](https://bun.sh/docs/cli/pm)
+  - [Global cache](https://bun.sh/docs/install/cache)
+  - [Workspaces](https://bun.sh/docs/install/workspaces)
+  - [Lifecycle scripts](https://bun.sh/docs/install/lifecycle)
+  - [Filter](https://bun.sh/docs/cli/filter)
+  - [Lockfile](https://bun.sh/docs/install/lockfile)
+  - [Scopes and registries](https://bun.sh/docs/install/registries)
+  - [Overrides and resolutions](https://bun.sh/docs/install/overrides)
 
 - Bundler
-  - [`Bun.build`](https://bun.com/docs/bundler)
-  - [Loaders](https://bun.com/docs/bundler/loaders)
-  - [Plugins](https://bun.com/docs/bundler/plugins)
-  - [Macros](https://bun.com/docs/bundler/macros)
-  - [vs esbuild](https://bun.com/docs/bundler/vs-esbuild)
-  - [Single-file executable](https://bun.com/docs/bundler/executables)
-  - [CSS](https://bun.com/docs/bundler/css)
-  - [HTML](https://bun.com/docs/bundler/html)
-  - [Hot Module Replacement (HMR)](https://bun.com/docs/bundler/hmr)
-  - [Full-stack with HTML imports](https://bun.com/docs/bundler/fullstack)
+
+  - [`Bun.build`](https://bun.sh/docs/bundler)
+  - [Loaders](https://bun.sh/docs/bundler/loaders)
+  - [Plugins](https://bun.sh/docs/bundler/plugins)
+  - [Macros](https://bun.sh/docs/bundler/macros)
+  - [vs esbuild](https://bun.sh/docs/bundler/vs-esbuild)
 
 - Test runner
-  - [`bun test`](https://bun.com/docs/cli/test)
-  - [Writing tests](https://bun.com/docs/test/writing)
-  - [Watch mode](https://bun.com/docs/test/hot)
-  - [Lifecycle hooks](https://bun.com/docs/test/lifecycle)
-  - [Mocks](https://bun.com/docs/test/mocks)
-  - [Snapshots](https://bun.com/docs/test/snapshots)
-  - [Dates and times](https://bun.com/docs/test/time)
-  - [DOM testing](https://bun.com/docs/test/dom)
-  - [Code coverage](https://bun.com/docs/test/coverage)
-  - [Configuration](https://bun.com/docs/test/configuration)
-  - [Discovery](https://bun.com/docs/test/discovery)
-  - [Reporters](https://bun.com/docs/test/reporters)
-  - [Runtime Behavior](https://bun.com/docs/test/runtime-behavior)
+
+  - [`bun test`](https://bun.sh/docs/cli/test)
+  - [Writing tests](https://bun.sh/docs/test/writing)
+  - [Watch mode](https://bun.sh/docs/test/hot)
+  - [Lifecycle hooks](https://bun.sh/docs/test/lifecycle)
+  - [Mocks](https://bun.sh/docs/test/mocks)
+  - [Snapshots](https://bun.sh/docs/test/snapshots)
+  - [Dates and times](https://bun.sh/docs/test/time)
+  - [DOM testing](https://bun.sh/docs/test/dom)
+  - [Code coverage](https://bun.sh/docs/test/coverage)
 
 - Package runner
-  - [`bunx`](https://bun.com/docs/cli/bunx)
+
+  - [`bunx`](https://bun.sh/docs/cli/bunx)
 
 - API
-  - [HTTP server (`Bun.serve`)](https://bun.com/docs/api/http)
-  - [WebSockets](https://bun.com/docs/api/websockets)
-  - [Workers](https://bun.com/docs/api/workers)
-  - [Binary data](https://bun.com/docs/api/binary-data)
-  - [Streams](https://bun.com/docs/api/streams)
-  - [File I/O (`Bun.file`)](https://bun.com/docs/api/file-io)
-  - [import.meta](https://bun.com/docs/api/import-meta)
-  - [SQLite (`bun:sqlite`)](https://bun.com/docs/api/sqlite)
-  - [PostgreSQL (`Bun.sql`)](https://bun.com/docs/api/sql)
-  - [Redis (`Bun.redis`)](https://bun.com/docs/api/redis)
-  - [S3 Client (`Bun.s3`)](https://bun.com/docs/api/s3)
-  - [FileSystemRouter](https://bun.com/docs/api/file-system-router)
-  - [TCP sockets](https://bun.com/docs/api/tcp)
-  - [UDP sockets](https://bun.com/docs/api/udp)
-  - [Globals](https://bun.com/docs/api/globals)
-  - [$ Shell](https://bun.com/docs/runtime/shell)
-  - [Child processes (spawn)](https://bun.com/docs/api/spawn)
-  - [Transpiler (`Bun.Transpiler`)](https://bun.com/docs/api/transpiler)
-  - [Hashing](https://bun.com/docs/api/hashing)
-  - [Colors (`Bun.color`)](https://bun.com/docs/api/color)
-  - [Console](https://bun.com/docs/api/console)
-  - [FFI (`bun:ffi`)](https://bun.com/docs/api/ffi)
-  - [C Compiler (`bun:ffi` cc)](https://bun.com/docs/api/cc)
-  - [HTMLRewriter](https://bun.com/docs/api/html-rewriter)
-  - [Testing (`bun:test`)](https://bun.com/docs/api/test)
-  - [Cookies (`Bun.Cookie`)](https://bun.com/docs/api/cookie)
-  - [Utils](https://bun.com/docs/api/utils)
-  - [Node-API](https://bun.com/docs/api/node-api)
-  - [Glob (`Bun.Glob`)](https://bun.com/docs/api/glob)
-  - [Semver (`Bun.semver`)](https://bun.com/docs/api/semver)
-  - [DNS](https://bun.com/docs/api/dns)
-  - [fetch API extensions](https://bun.com/docs/api/fetch)
+
+  - [HTTP server](https://bun.sh/docs/api/http)
+  - [WebSockets](https://bun.sh/docs/api/websockets)
+  - [Workers](https://bun.sh/docs/api/workers)
+  - [Binary data](https://bun.sh/docs/api/binary-data)
+  - [Streams](https://bun.sh/docs/api/streams)
+  - [File I/O](https://bun.sh/docs/api/file-io)
+  - [import.meta](https://bun.sh/docs/api/import-meta)
+  - [SQLite](https://bun.sh/docs/api/sqlite)
+  - [FileSystemRouter](https://bun.sh/docs/api/file-system-router)
+  - [TCP sockets](https://bun.sh/docs/api/tcp)
+  - [UDP sockets](https://bun.sh/docs/api/udp)
+  - [Globals](https://bun.sh/docs/api/globals)
+  - [$ Shell](https://bun.sh/docs/runtime/shell)
+  - [Child processes](https://bun.sh/docs/api/spawn)
+  - [Transpiler](https://bun.sh/docs/api/transpiler)
+  - [Hashing](https://bun.sh/docs/api/hashing)
+  - [Console](https://bun.sh/docs/api/console)
+  - [FFI](https://bun.sh/docs/api/ffi)
+  - [HTMLRewriter](https://bun.sh/docs/api/html-rewriter)
+  - [Testing](https://bun.sh/docs/api/test)
+  - [Utils](https://bun.sh/docs/api/utils)
+  - [Node-API](https://bun.sh/docs/api/node-api)
+  - [Glob](https://bun.sh/docs/api/glob)
+  - [Semver](https://bun.sh/docs/api/semver)
+
+- Project
+  - [Roadmap](https://bun.sh/docs/project/roadmap)
+  - [Benchmarking](https://bun.sh/docs/project/benchmarking)
+  - [Contributing](https://bun.sh/docs/project/contributing)
+  - [Building Windows](https://bun.sh/docs/project/building-windows)
+  - [License](https://bun.sh/docs/project/licensing)
 
 ## Guides
 
 - Binary
-  - [Convert a Blob to a string](https://bun.com/guides/binary/blob-to-string)
-  - [Convert a Buffer to a blob](https://bun.com/guides/binary/buffer-to-blob)
-  - [Convert a Blob to a DataView](https://bun.com/guides/binary/blob-to-dataview)
-  - [Convert a Buffer to a string](https://bun.com/guides/binary/buffer-to-string)
-  - [Convert a Blob to a ReadableStream](https://bun.com/guides/binary/blob-to-stream)
-  - [Convert a Blob to a Uint8Array](https://bun.com/guides/binary/blob-to-typedarray)
-  - [Convert a DataView to a string](https://bun.com/guides/binary/dataview-to-string)
-  - [Convert a Uint8Array to a Blob](https://bun.com/guides/binary/typedarray-to-blob)
-  - [Convert a Blob to an ArrayBuffer](https://bun.com/guides/binary/blob-to-arraybuffer)
-  - [Convert an ArrayBuffer to a Blob](https://bun.com/guides/binary/arraybuffer-to-blob)
-  - [Convert a Buffer to a Uint8Array](https://bun.com/guides/binary/buffer-to-typedarray)
-  - [Convert a Uint8Array to a Buffer](https://bun.com/guides/binary/typedarray-to-buffer)
-  - [Convert a Uint8Array to a string](https://bun.com/guides/binary/typedarray-to-string)
-  - [Convert a Buffer to an ArrayBuffer](https://bun.com/guides/binary/buffer-to-arraybuffer)
-  - [Convert an ArrayBuffer to a Buffer](https://bun.com/guides/binary/arraybuffer-to-buffer)
-  - [Convert an ArrayBuffer to a string](https://bun.com/guides/binary/arraybuffer-to-string)
-  - [Convert a Uint8Array to a DataView](https://bun.com/guides/binary/typedarray-to-dataview)
-  - [Convert a Buffer to a ReadableStream](https://bun.com/guides/binary/buffer-to-readablestream)
-  - [Convert a Uint8Array to an ArrayBuffer](https://bun.com/guides/binary/typedarray-to-arraybuffer)
-  - [Convert an ArrayBuffer to a Uint8Array](https://bun.com/guides/binary/arraybuffer-to-typedarray)
-  - [Convert an ArrayBuffer to an array of numbers](https://bun.com/guides/binary/arraybuffer-to-array)
-  - [Convert a Uint8Array to a ReadableStream](https://bun.com/guides/binary/typedarray-to-readablestream)
+
+  - [Convert a Blob to a DataView](https://bun.sh/guides/binary/blob-to-dataview)
+  - [Convert a Blob to a ReadableStream](https://bun.sh/guides/binary/blob-to-stream)
+  - [Convert a Blob to a string](https://bun.sh/guides/binary/blob-to-string)
+  - [Convert a Blob to a Uint8Array](https://bun.sh/guides/binary/blob-to-typedarray)
+  - [Convert a Blob to an ArrayBuffer](https://bun.sh/guides/binary/blob-to-arraybuffer)
+  - [Convert a Buffer to a blob](https://bun.sh/guides/binary/buffer-to-blob)
+  - [Convert a Buffer to a ReadableStream](https://bun.sh/guides/binary/buffer-to-readablestream)
+  - [Convert a Buffer to a string](https://bun.sh/guides/binary/buffer-to-string)
+  - [Convert a Buffer to a Uint8Array](https://bun.sh/guides/binary/buffer-to-typedarray)
+  - [Convert a Buffer to an ArrayBuffer](https://bun.sh/guides/binary/buffer-to-arraybuffer)
+  - [Convert a DataView to a string](https://bun.sh/guides/binary/dataview-to-string)
+  - [Convert a Uint8Array to a Blob](https://bun.sh/guides/binary/typedarray-to-blob)
+  - [Convert a Uint8Array to a Buffer](https://bun.sh/guides/binary/typedarray-to-buffer)
+  - [Convert a Uint8Array to a DataView](https://bun.sh/guides/binary/typedarray-to-dataview)
+  - [Convert a Uint8Array to a ReadableStream](https://bun.sh/guides/binary/typedarray-to-readablestream)
+  - [Convert a Uint8Array to a string](https://bun.sh/guides/binary/typedarray-to-string)
+  - [Convert a Uint8Array to an ArrayBuffer](https://bun.sh/guides/binary/typedarray-to-arraybuffer)
+  - [Convert an ArrayBuffer to a Blob](https://bun.sh/guides/binary/arraybuffer-to-blob)
+  - [Convert an ArrayBuffer to a Buffer](https://bun.sh/guides/binary/arraybuffer-to-buffer)
+  - [Convert an ArrayBuffer to a string](https://bun.sh/guides/binary/arraybuffer-to-string)
+  - [Convert an ArrayBuffer to a Uint8Array](https://bun.sh/guides/binary/arraybuffer-to-typedarray)
+  - [Convert an ArrayBuffer to an array of numbers](https://bun.sh/guides/binary/arraybuffer-to-array)
 
 - Ecosystem
-  - [Use React and JSX](https://bun.com/guides/ecosystem/react)
-  - [Use Gel with Bun](https://bun.com/guides/ecosystem/gel)
-  - [Use Prisma with Bun](https://bun.com/guides/ecosystem/prisma)
-  - [Add Sentry to a Bun app](https://bun.com/guides/ecosystem/sentry)
-  - [Create a Discord bot](https://bun.com/guides/ecosystem/discordjs)
-  - [Run Bun as a daemon with PM2](https://bun.com/guides/ecosystem/pm2)
-  - [Use Drizzle ORM with Bun](https://bun.com/guides/ecosystem/drizzle)
-  - [Build an app with Nuxt and Bun](https://bun.com/guides/ecosystem/nuxt)
-  - [Build an app with Qwik and Bun](https://bun.com/guides/ecosystem/qwik)
-  - [Build an app with Astro and Bun](https://bun.com/guides/ecosystem/astro)
-  - [Build an app with Remix and Bun](https://bun.com/guides/ecosystem/remix)
-  - [Build a frontend using Vite and Bun](https://bun.com/guides/ecosystem/vite)
-  - [Build an app with Next.js and Bun](https://bun.com/guides/ecosystem/nextjs)
-  - [Run Bun as a daemon with systemd](https://bun.com/guides/ecosystem/systemd)
-  - [Deploy a Bun application on Render](https://bun.com/guides/ecosystem/render)
-  - [Build an HTTP server using Hono and Bun](https://bun.com/guides/ecosystem/hono)
-  - [Build an app with SvelteKit and Bun](https://bun.com/guides/ecosystem/sveltekit)
-  - [Build an app with SolidStart and Bun](https://bun.com/guides/ecosystem/solidstart)
-  - [Build an HTTP server using Elysia and Bun](https://bun.com/guides/ecosystem/elysia)
-  - [Build an HTTP server using StricJS and Bun](https://bun.com/guides/ecosystem/stric)
-  - [Containerize a Bun application with Docker](https://bun.com/guides/ecosystem/docker)
-  - [Build an HTTP server using Express and Bun](https://bun.com/guides/ecosystem/express)
-  - [Use Neon Postgres through Drizzle ORM](https://bun.com/guides/ecosystem/neon-drizzle)
-  - [Server-side render (SSR) a React component](https://bun.com/guides/ecosystem/ssr-react)
-  - [Read and write data to MongoDB using Mongoose and Bun](https://bun.com/guides/ecosystem/mongoose)
-  - [Use Neon's Serverless Postgres with Bun](https://bun.com/guides/ecosystem/neon-serverless-postgres)
 
-- HTMLRewriter
-  - [Extract links from a webpage using HTMLRewriter](https://bun.com/guides/html-rewriter/extract-links)
-  - [Extract social share images and Open Graph tags](https://bun.com/guides/html-rewriter/extract-social-meta)
+  - [Build a frontend using Vite and Bun](https://bun.sh/guides/ecosystem/vite)
+  - [Build an app with Astro and Bun](https://bun.sh/guides/ecosystem/astro)
+  - [Build an app with Next.js and Bun](https://bun.sh/guides/ecosystem/nextjs)
+  - [Build an app with Nuxt and Bun](https://bun.sh/guides/ecosystem/nuxt)
+  - [Build an app with Qwik and Bun](https://bun.sh/guides/ecosystem/qwik)
+  - [Build an app with Remix and Bun](https://bun.sh/guides/ecosystem/remix)
+  - [Build an app with SolidStart and Bun](https://bun.sh/guides/ecosystem/solidstart)
+  - [Build an app with SvelteKit and Bun](https://bun.sh/guides/ecosystem/sveltekit)
+  - [Build an HTTP server using Elysia and Bun](https://bun.sh/guides/ecosystem/elysia)
+  - [Build an HTTP server using Express and Bun](https://bun.sh/guides/ecosystem/express)
+  - [Build an HTTP server using Hono and Bun](https://bun.sh/guides/ecosystem/hono)
+  - [Build an HTTP server using StricJS and Bun](https://bun.sh/guides/ecosystem/stric)
+  - [Containerize a Bun application with Docker](https://bun.sh/guides/ecosystem/docker)
+  - [Create a Discord bot](https://bun.sh/guides/ecosystem/discordjs)
+  - [Deploy a Bun application on Render](https://bun.sh/guides/ecosystem/render)
+  - [Read and write data to MongoDB using Mongoose and Bun](https://bun.sh/guides/ecosystem/mongoose)
+  - [Run Bun as a daemon with PM2](https://bun.sh/guides/ecosystem/pm2)
+  - [Run Bun as a daemon with systemd](https://bun.sh/guides/ecosystem/systemd)
+  - [Server-side render (SSR) a React component](https://bun.sh/guides/ecosystem/ssr-react)
+  - [Use Drizzle ORM with Bun](https://bun.sh/guides/ecosystem/drizzle)
+  - [Use EdgeDB with Bun](https://bun.sh/guides/ecosystem/edgedb)
+  - [Use Neon's Serverless Postgres with Bun](https://bun.sh/guides/ecosystem/neon-serverless-postgres)
+  - [Use Prisma with Bun](https://bun.sh/guides/ecosystem/prisma)
+  - [Use React and JSX](https://bun.sh/guides/ecosystem/react)
+  - [Add Sentry to a Bun app](https://bun.sh/guides/ecosystem/sentry)
 
 - HTTP
-  - [Hot reload an HTTP server](https://bun.com/guides/http/hot)
-  - [Common HTTP server usage](https://bun.com/guides/http/server)
-  - [Write a simple HTTP server](https://bun.com/guides/http/simple)
-  - [Configure TLS on an HTTP server](https://bun.com/guides/http/tls)
-  - [Send an HTTP request using fetch](https://bun.com/guides/http/fetch)
-  - [Proxy HTTP requests using fetch()](https://bun.com/guides/http/proxy)
-  - [Start a cluster of HTTP servers](https://bun.com/guides/http/cluster)
-  - [Stream a file as an HTTP Response](https://bun.com/guides/http/stream-file)
-  - [fetch with unix domain sockets in Bun](https://bun.com/guides/http/fetch-unix)
-  - [Upload files via HTTP using FormData](https://bun.com/guides/http/file-uploads)
-  - [Streaming HTTP Server with Async Iterators](https://bun.com/guides/http/stream-iterator)
-  - [Streaming HTTP Server with Node.js Streams](https://bun.com/guides/http/stream-node-streams-in-bun)
+
+  - [Common HTTP server usage](https://bun.sh/guides/http/server)
+  - [Configure TLS on an HTTP server](https://bun.sh/guides/http/tls)
+  - [fetch with unix domain sockets in Bun](https://bun.sh/guides/http/fetch-unix)
+  - [Hot reload an HTTP server](https://bun.sh/guides/http/hot)
+  - [Proxy HTTP requests using fetch()](https://bun.sh/guides/http/proxy)
+  - [Send an HTTP request using fetch](https://bun.sh/guides/http/fetch)
+  - [Start a cluster of HTTP servers](https://bun.sh/guides/http/cluster)
+  - [Stream a file as an HTTP Response](https://bun.sh/guides/http/stream-file)
+  - [Streaming HTTP Server with Async Iterators](https://bun.sh/guides/http/stream-iterator)
+  - [Streaming HTTP Server with Node.js Streams](https://bun.sh/guides/http/stream-node-streams-in-bun)
+  - [Upload files via HTTP using FormData](https://bun.sh/guides/http/file-uploads)
+  - [Write a simple HTTP server](https://bun.sh/guides/http/simple)
 
 - Install
-  - [Add a dependency](https://bun.com/guides/install/add)
-  - [Add a Git dependency](https://bun.com/guides/install/add-git)
-  - [Add a peer dependency](https://bun.com/guides/install/add-peer)
-  - [Add a trusted dependency](https://bun.com/guides/install/trusted)
-  - [Add a development dependency](https://bun.com/guides/install/add-dev)
-  - [Add a tarball dependency](https://bun.com/guides/install/add-tarball)
-  - [Add an optional dependency](https://bun.com/guides/install/add-optional)
-  - [Generate a yarn-compatible lockfile](https://bun.com/guides/install/yarnlock)
-  - [Configuring a monorepo using workspaces](https://bun.com/guides/install/workspaces)
-  - [Install a package under a different name](https://bun.com/guides/install/npm-alias)
-  - [Install dependencies with Bun in GitHub Actions](https://bun.com/guides/install/cicd)
-  - [Using bun install with Artifactory](https://bun.com/guides/install/jfrog-artifactory)
-  - [Configure git to diff Bun's lockb lockfile](https://bun.com/guides/install/git-diff-bun-lockfile)
-  - [Override the default npm registry for bun install](https://bun.com/guides/install/custom-registry)
-  - [Using bun install with an Azure Artifacts npm registry](https://bun.com/guides/install/azure-artifacts)
-  - [Migrate from npm install to bun install](https://bun.com/guides/install/from-npm-install-to-bun-install)
-  - [Configure a private registry for an organization scope with bun install](https://bun.com/guides/install/registry-scope)
+
+  - [Add a dependency](https://bun.sh/guides/install/add)
+  - [Add a development dependency](https://bun.sh/guides/install/add-dev)
+  - [Add a Git dependency](https://bun.sh/guides/install/add-git)
+  - [Add a peer dependency](https://bun.sh/guides/install/add-peer)
+  - [Add a tarball dependency](https://bun.sh/guides/install/add-tarball)
+  - [Add a trusted dependency](https://bun.sh/guides/install/trusted)
+  - [Add an optional dependency](https://bun.sh/guides/install/add-optional)
+  - [Configure a private registry for an organization scope with bun install](https://bun.sh/guides/install/registry-scope)
+  - [Configure git to diff Bun's lockb lockfile](https://bun.sh/guides/install/git-diff-bun-lockfile)
+  - [Configuring a monorepo using workspaces](https://bun.sh/guides/install/workspaces)
+  - [Generate a human-readable lockfile](https://bun.sh/guides/install/yarnlock)
+  - [Install a package under a different name](https://bun.sh/guides/install/npm-alias)
+  - [Install dependencies with Bun in GitHub Actions](https://bun.sh/guides/install/cicd)
+  - [Override the default npm registry for bun install](https://bun.sh/guides/install/custom-registry)
+  - [Using bun install with an Azure Artifacts npm registry](https://bun.sh/guides/install/azure-artifacts)
+  - [Using bun install with Artifactory](https://bun.sh/guides/install/jfrog-artifactory)
 
 - Process
-  - [Read from stdin](https://bun.com/guides/process/stdin)
-  - [Listen for CTRL+C](https://bun.com/guides/process/ctrl-c)
-  - [Spawn a child process](https://bun.com/guides/process/spawn)
-  - [Listen to OS signals](https://bun.com/guides/process/os-signals)
-  - [Parse command-line arguments](https://bun.com/guides/process/argv)
-  - [Read stderr from a child process](https://bun.com/guides/process/spawn-stderr)
-  - [Read stdout from a child process](https://bun.com/guides/process/spawn-stdout)
-  - [Get the process uptime in nanoseconds](https://bun.com/guides/process/nanoseconds)
-  - [Spawn a child process and communicate using IPC](https://bun.com/guides/process/ipc)
+
+  - [Get the process uptime in nanoseconds](https://bun.sh/guides/process/nanoseconds)
+  - [Listen for CTRL+C](https://bun.sh/guides/process/ctrl-c)
+  - [Listen to OS signals](https://bun.sh/guides/process/os-signals)
+  - [Parse command-line arguments](https://bun.sh/guides/process/argv)
+  - [Read from stdin](https://bun.sh/guides/process/stdin)
+  - [Read stderr from a child process](https://bun.sh/guides/process/spawn-stderr)
+  - [Read stdout from a child process](https://bun.sh/guides/process/spawn-stdout)
+  - [Spawn a child process](https://bun.sh/guides/process/spawn)
+  - [Spawn a child process and communicate using IPC](https://bun.sh/guides/process/ipc)
 
 - Read file
-  - [Read a JSON file](https://bun.com/guides/read-file/json)
-  - [Check if a file exists](https://bun.com/guides/read-file/exists)
-  - [Read a file as a string](https://bun.com/guides/read-file/string)
-  - [Read a file to a Buffer](https://bun.com/guides/read-file/buffer)
-  - [Get the MIME type of a file](https://bun.com/guides/read-file/mime)
-  - [Watch a directory for changes](https://bun.com/guides/read-file/watch)
-  - [Read a file as a ReadableStream](https://bun.com/guides/read-file/stream)
-  - [Read a file to a Uint8Array](https://bun.com/guides/read-file/uint8array)
-  - [Read a file to an ArrayBuffer](https://bun.com/guides/read-file/arraybuffer)
+
+  - [Check if a file exists](https://bun.sh/guides/read-file/exists)
+  - [Get the MIME type of a file](https://bun.sh/guides/read-file/mime)
+  - [Read a file as a ReadableStream](https://bun.sh/guides/read-file/stream)
+  - [Read a file as a string](https://bun.sh/guides/read-file/string)
+  - [Read a file to a Buffer](https://bun.sh/guides/read-file/buffer)
+  - [Read a file to a Uint8Array](https://bun.sh/guides/read-file/uint8array)
+  - [Read a file to an ArrayBuffer](https://bun.sh/guides/read-file/arraybuffer)
+  - [Read a JSON file](https://bun.sh/guides/read-file/json)
+  - [Watch a directory for changes](https://bun.sh/guides/read-file/watch)
 
 - Runtime
-  - [Delete files](https://bun.com/guides/runtime/delete-file)
-  - [Run a Shell Command](https://bun.com/guides/runtime/shell)
-  - [Import a JSON file](https://bun.com/guides/runtime/import-json)
-  - [Import a TOML file](https://bun.com/guides/runtime/import-toml)
-  - [Set a time zone in Bun](https://bun.com/guides/runtime/timezone)
-  - [Set environment variables](https://bun.com/guides/runtime/set-env)
-  - [Re-map import paths](https://bun.com/guides/runtime/tsconfig-paths)
-  - [Delete directories](https://bun.com/guides/runtime/delete-directory)
-  - [Read environment variables](https://bun.com/guides/runtime/read-env)
-  - [Import a HTML file as text](https://bun.com/guides/runtime/import-html)
-  - [Install and run Bun in GitHub Actions](https://bun.com/guides/runtime/cicd)
-  - [Debugging Bun with the web debugger](https://bun.com/guides/runtime/web-debugger)
-  - [Install TypeScript declarations for Bun](https://bun.com/guides/runtime/typescript)
-  - [Debugging Bun with the VS Code extension](https://bun.com/guides/runtime/vscode-debugger)
-  - [Inspect memory usage using V8 heap snapshots](https://bun.com/guides/runtime/heap-snapshot)
-  - [Define and replace static globals & constants](https://bun.com/guides/runtime/define-constant)
-  - [Codesign a single-file JavaScript executable on macOS](https://bun.com/guides/runtime/codesign-macos-executable)
+
+  - [Debugging Bun with the VS Code extension](https://bun.sh/guides/runtime/vscode-debugger)
+  - [Debugging Bun with the web debugger](https://bun.sh/guides/runtime/web-debugger)
+  - [Define and replace static globals & constants](https://bun.sh/guides/runtime/define-constant)
+  - [Import a JSON file](https://bun.sh/guides/runtime/import-json)
+  - [Import a TOML file](https://bun.sh/guides/runtime/import-toml)
+  - [Import HTML file as text](https://bun.sh/guides/runtime/import-html)
+  - [Install and run Bun in GitHub Actions](https://bun.sh/guides/runtime/cicd)
+  - [Install TypeScript declarations for Bun](https://bun.sh/guides/runtime/typescript)
+  - [Re-map import paths](https://bun.sh/guides/runtime/tsconfig-paths)
+  - [Read environment variables](https://bun.sh/guides/runtime/read-env)
+  - [Run a Shell Command](https://bun.sh/guides/runtime/shell)
+  - [Set a time zone in Bun](https://bun.sh/guides/runtime/timezone)
+  - [Set environment variables](https://bun.sh/guides/runtime/set-env)
 
 - Streams
-  - [Convert a ReadableStream to JSON](https://bun.com/guides/streams/to-json)
-  - [Convert a ReadableStream to a Blob](https://bun.com/guides/streams/to-blob)
-  - [Convert a ReadableStream to a Buffer](https://bun.com/guides/streams/to-buffer)
-  - [Convert a ReadableStream to a string](https://bun.com/guides/streams/to-string)
-  - [Convert a ReadableStream to a Uint8Array](https://bun.com/guides/streams/to-typedarray)
-  - [Convert a ReadableStream to an array of chunks](https://bun.com/guides/streams/to-array)
-  - [Convert a Node.js Readable to JSON](https://bun.com/guides/streams/node-readable-to-json)
-  - [Convert a ReadableStream to an ArrayBuffer](https://bun.com/guides/streams/to-arraybuffer)
-  - [Convert a Node.js Readable to a Blob](https://bun.com/guides/streams/node-readable-to-blob)
-  - [Convert a Node.js Readable to a string](https://bun.com/guides/streams/node-readable-to-string)
-  - [Convert a Node.js Readable to an Uint8Array](https://bun.com/guides/streams/node-readable-to-uint8array)
-  - [Convert a Node.js Readable to an ArrayBuffer](https://bun.com/guides/streams/node-readable-to-arraybuffer)
+
+  - [Convert a Node.js Readable to a Blob](https://bun.sh/guides/streams/node-readable-to-blob)
+  - [Convert a Node.js Readable to a string](https://bun.sh/guides/streams/node-readable-to-string)
+  - [Convert a Node.js Readable to an ArrayBuffer](https://bun.sh/guides/streams/node-readable-to-arraybuffer)
+  - [Convert a Node.js Readable to JSON](https://bun.sh/guides/streams/node-readable-to-json)
+  - [Convert a ReadableStream to a Blob](https://bun.sh/guides/streams/to-blob)
+  - [Convert a ReadableStream to a Buffer](https://bun.sh/guides/streams/to-buffer)
+  - [Convert a ReadableStream to a string](https://bun.sh/guides/streams/to-string)
+  - [Convert a ReadableStream to a Uint8Array](https://bun.sh/guides/streams/to-typedarray)
+  - [Convert a ReadableStream to an array of chunks](https://bun.sh/guides/streams/to-array)
+  - [Convert a ReadableStream to an ArrayBuffer](https://bun.sh/guides/streams/to-arraybuffer)
+  - [Convert a ReadableStream to JSON](https://bun.sh/guides/streams/to-json)
 
 - Test
-  - [Spy on methods in `bun test`](https://bun.com/guides/test/spy-on)
-  - [Bail early with the Bun test runner](https://bun.com/guides/test/bail)
-  - [Mock functions in `bun test`](https://bun.com/guides/test/mock-functions)
-  - [Run tests in watch mode with Bun](https://bun.com/guides/test/watch-mode)
-  - [Use snapshot testing in `bun test`](https://bun.com/guides/test/snapshot)
-  - [Skip tests with the Bun test runner](https://bun.com/guides/test/skip-tests)
-  - [Using Testing Library with Bun](https://bun.com/guides/test/testing-library)
-  - [Update snapshots in `bun test`](https://bun.com/guides/test/update-snapshots)
-  - [Run your tests with the Bun test runner](https://bun.com/guides/test/run-tests)
-  - [Set the system time in Bun's test runner](https://bun.com/guides/test/mock-clock)
-  - [Set a per-test timeout with the Bun test runner](https://bun.com/guides/test/timeout)
-  - [Migrate from Jest to Bun's test runner](https://bun.com/guides/test/migrate-from-jest)
-  - [Write browser DOM tests with Bun and happy-dom](https://bun.com/guides/test/happy-dom)
-  - [Mark a test as a "todo" with the Bun test runner](https://bun.com/guides/test/todo-tests)
-  - [Re-run tests multiple times with the Bun test runner](https://bun.com/guides/test/rerun-each)
-  - [Generate code coverage reports with the Bun test runner](https://bun.com/guides/test/coverage)
-  - [import, require, and test Svelte components with bun test](https://bun.com/guides/test/svelte-test)
-  - [Set a code coverage threshold with the Bun test runner](https://bun.com/guides/test/coverage-threshold)
+
+  - [Bail early with the Bun test runner](https://bun.sh/guides/test/bail)
+  - [Generate code coverage reports with the Bun test runner](https://bun.sh/guides/test/coverage)
+  - [Mark a test as a "todo" with the Bun test runner](https://bun.sh/guides/test/todo-tests)
+  - [Migrate from Jest to Bun's test runner](https://bun.sh/guides/test/migrate-from-jest)
+  - [Mock functions in `bun test`](https://bun.sh/guides/test/mock-functions)
+  - [Re-run tests multiple times with the Bun test runner](https://bun.sh/guides/test/rerun-each)
+  - [Run tests in watch mode with Bun](https://bun.sh/guides/test/watch-mode)
+  - [Run your tests with the Bun test runner](https://bun.sh/guides/test/run-tests)
+  - [Set a code coverage threshold with the Bun test runner](https://bun.sh/guides/test/coverage-threshold)
+  - [Set a per-test timeout with the Bun test runner](https://bun.sh/guides/test/timeout)
+  - [Set the system time in Bun's test runner](https://bun.sh/guides/test/mock-clock)
+  - [Skip tests with the Bun test runner](https://bun.sh/guides/test/skip-tests)
+  - [Spy on methods in `bun test`](https://bun.sh/guides/test/spy-on)
+  - [Update snapshots in `bun test`](https://bun.sh/guides/test/update-snapshots)
+  - [Use snapshot testing in `bun test`](https://bun.sh/guides/test/snapshot)
+  - [Write browser DOM tests with Bun and happy-dom](https://bun.sh/guides/test/happy-dom)
 
 - Util
-  - [Generate a UUID](https://bun.com/guides/util/javascript-uuid)
-  - [Hash a password](https://bun.com/guides/util/hash-a-password)
-  - [Escape an HTML string](https://bun.com/guides/util/escape-html)
-  - [Get the current Bun version](https://bun.com/guides/util/version)
-  - [Encode and decode base64 strings](https://bun.com/guides/util/base64)
-  - [Compress and decompress data with gzip](https://bun.com/guides/util/gzip)
-  - [Sleep for a fixed number of milliseconds](https://bun.com/guides/util/sleep)
-  - [Detect when code is executed with Bun](https://bun.com/guides/util/detect-bun)
-  - [Check if two objects are deeply equal](https://bun.com/guides/util/deep-equals)
-  - [Compress and decompress data with DEFLATE](https://bun.com/guides/util/deflate)
-  - [Get the absolute path to the current entrypoint](https://bun.com/guides/util/main)
-  - [Get the directory of the current file](https://bun.com/guides/util/import-meta-dir)
-  - [Check if the current file is the entrypoint](https://bun.com/guides/util/entrypoint)
-  - [Get the file name of the current file](https://bun.com/guides/util/import-meta-file)
-  - [Convert a file URL to an absolute path](https://bun.com/guides/util/file-url-to-path)
-  - [Convert an absolute path to a file URL](https://bun.com/guides/util/path-to-file-url)
-  - [Get the absolute path of the current file](https://bun.com/guides/util/import-meta-path)
-  - [Get the path to an executable bin file](https://bun.com/guides/util/which-path-to-executable-bin)
+
+  - [Check if the current file is the entrypoint](https://bun.sh/guides/util/entrypoint)
+  - [Check if two objects are deeply equal](https://bun.sh/guides/util/deep-equals)
+  - [Compress and decompress data with DEFLATE](https://bun.sh/guides/util/deflate)
+  - [Compress and decompress data with gzip](https://bun.sh/guides/util/gzip)
+  - [Convert a file URL to an absolute path](https://bun.sh/guides/util/file-url-to-path)
+  - [Convert an absolute path to a file URL](https://bun.sh/guides/util/path-to-file-url)
+  - [Detect when code is executed with Bun](https://bun.sh/guides/util/detect-bun)
+  - [Encode and decode base64 strings](https://bun.sh/guides/util/base64)
+  - [Escape an HTML string](https://bun.sh/guides/util/escape-html)
+  - [Get the absolute path of the current file](https://bun.sh/guides/util/import-meta-path)
+  - [Get the absolute path to the current entrypoint](https://bun.sh/guides/util/main)
+  - [Get the current Bun version](https://bun.sh/guides/util/version)
+  - [Get the directory of the current file](https://bun.sh/guides/util/import-meta-dir)
+  - [Get the file name of the current file](https://bun.sh/guides/util/import-meta-file)
+  - [Get the path to an executable bin file](https://bun.sh/guides/util/which-path-to-executable-bin)
+  - [Hash a password](https://bun.sh/guides/util/hash-a-password)
+  - [Sleep for a fixed number of milliseconds](https://bun.sh/guides/util/sleep)
 
 - WebSocket
-  - [Build a publish-subscribe WebSocket server](https://bun.com/guides/websocket/pubsub)
-  - [Build a simple WebSocket server](https://bun.com/guides/websocket/simple)
-  - [Enable compression for WebSocket messages](https://bun.com/guides/websocket/compression)
-  - [Set per-socket contextual data on a WebSocket](https://bun.com/guides/websocket/context)
+
+  - [Build a publish-subscribe WebSocket server](https://bun.sh/guides/websocket/pubsub)
+  - [Build a simple WebSocket server](https://bun.sh/guides/websocket/simple)
+  - [Enable compression for WebSocket messages](https://bun.sh/guides/websocket/compression)
+  - [Set per-socket contextual data on a WebSocket](https://bun.sh/guides/websocket/context)
 
 - Write file
-  - [Delete a file](https://bun.com/guides/write-file/unlink)
-  - [Write to stdout](https://bun.com/guides/write-file/stdout)
-  - [Write a file to stdout](https://bun.com/guides/write-file/cat)
-  - [Write a Blob to a file](https://bun.com/guides/write-file/blob)
-  - [Write a string to a file](https://bun.com/guides/write-file/basic)
-  - [Append content to a file](https://bun.com/guides/write-file/append)
-  - [Write a file incrementally](https://bun.com/guides/write-file/filesink)
-  - [Write a Response to a file](https://bun.com/guides/write-file/response)
-  - [Copy a file to another location](https://bun.com/guides/write-file/file-cp)
-  - [Write a ReadableStream to a file](https://bun.com/guides/write-file/stream)
+  - [Append content to a file](https://bun.sh/guides/write-file/append)
+  - [Copy a file to another location](https://bun.sh/guides/write-file/file-cp)
+  - [Delete a file](https://bun.sh/guides/write-file/unlink)
+  - [Write a Blob to a file](https://bun.sh/guides/write-file/blob)
+  - [Write a file incrementally](https://bun.sh/guides/write-file/filesink)
+  - [Write a file to stdout](https://bun.sh/guides/write-file/cat)
+  - [Write a ReadableStream to a file](https://bun.sh/guides/write-file/stream)
+  - [Write a Response to a file](https://bun.sh/guides/write-file/response)
+  - [Write a string to a file](https://bun.sh/guides/write-file/basic)
+  - [Write to stdout](https://bun.sh/guides/write-file/stdout)
 
 ## Contributing
 
-Refer to the [Project > Contributing](https://bun.com/docs/project/contributing) guide to start contributing to Bun.
+Refer to the [Project > Contributing](https://bun.sh/docs/project/contributing) guide to start contributing to Bun.
 
 ## License
 
-Refer to the [Project > License](https://bun.com/docs/project/licensing) page for information about Bun's licensing.
+Refer to the [Project > License](https://bun.sh/docs/project/licensing) page for information about Bun's licensing.

SECURITY.md

@@ -8,4 +8,5 @@
 
 ## Reporting a Vulnerability
 
-Report any discovered vulnerabilities to the Bun team by emailing `security@bun.com`. Your report will acknowledged within 5 days, and a team member will be assigned as the primary handler. To the greatest extent possible, the security team will endeavor to keep you informed of the progress being made towards a fix and full announcement, and may ask for additional information or guidance surrounding the reported issue.
+Report any discovered vulnerabilities to the Bun team by emailing `security@bun.sh`. Your report will acknowledged within 5 days, and a team member will be assigned as the primary handler. To the greatest extent possible, the security team will endeavor to keep you informed of the progress being made towards a fix and full announcement, and may ask for additional information or guidance surrounding the reported issue.
+

bench/bun.lock

@@ -15,13 +15,11 @@
         "eventemitter3": "^5.0.0",
         "execa": "^8.0.1",
         "fast-glob": "3.3.1",
-        "fastify": "^5.0.0",
         "fdir": "^6.1.0",
         "mitata": "^1.0.25",
         "react": "^18.3.1",
         "react-dom": "^18.3.1",
         "string-width": "7.1.0",
-        "strip-ansi": "^7.1.0",
         "tinycolor2": "^1.6.0",
         "zx": "^7.2.3",
       },
@@ -95,18 +93,6 @@
 
     "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.14.54", "", { "os": "linux", "cpu": "none" }, "sha512-bZBrLAIX1kpWelV0XemxBZllyRmM6vgFQQG2GdNb+r3Fkp0FOh1NJSvekXDs7jq70k4euu1cryLMfU+mTXlEpw=="],
 
-    "@fastify/ajv-compiler": ["@fastify/ajv-compiler@4.0.2", "", { "dependencies": { "ajv": "^8.12.0", "ajv-formats": "^3.0.1", "fast-uri": "^3.0.0" } }, "sha512-Rkiu/8wIjpsf46Rr+Fitd3HRP+VsxUFDDeag0hs9L0ksfnwx2g7SPQQTFL0E8Qv+rfXzQOxBJnjUB9ITUDjfWQ=="],
-
-    "@fastify/error": ["@fastify/error@4.2.0", "", {}, "sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ=="],
-
-    "@fastify/fast-json-stringify-compiler": ["@fastify/fast-json-stringify-compiler@5.0.3", "", { "dependencies": { "fast-json-stringify": "^6.0.0" } }, "sha512-uik7yYHkLr6fxd8hJSZ8c+xF4WafPK+XzneQDPU+D10r5X19GW8lJcom2YijX2+qtFF1ENJlHXKFM9ouXNJYgQ=="],
-
-    "@fastify/forwarded": ["@fastify/forwarded@3.0.0", "", {}, "sha512-kJExsp4JCms7ipzg7SJ3y8DwmePaELHxKYtg+tZow+k0znUTf3cb+npgyqm8+ATZOdmfgfydIebPDWM172wfyA=="],
-
-    "@fastify/merge-json-schemas": ["@fastify/merge-json-schemas@0.2.1", "", { "dependencies": { "dequal": "^2.0.3" } }, "sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A=="],
-
-    "@fastify/proxy-addr": ["@fastify/proxy-addr@5.0.0", "", { "dependencies": { "@fastify/forwarded": "^3.0.0", "ipaddr.js": "^2.1.0" } }, "sha512-37qVVA1qZ5sgH7KpHkkC4z9SK6StIsIcOmpjvMPXNb3vx2GQxhZocogVYbr2PbbeLCQxYIPDok307xEvRZOzGA=="],
-
     "@jridgewell/gen-mapping": ["@jridgewell/gen-mapping@0.1.1", "", { "dependencies": { "@jridgewell/set-array": "^1.0.0", "@jridgewell/sourcemap-codec": "^1.4.10" } }, "sha512-sQXCasFk+U8lWYEe66WxRDOE9PjVz4vSM51fTu3Hw+ClTpUSQb718772vH3pyS5pShp6lvQM7SxgIDXXXmOX7w=="],
 
     "@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.0", "", {}, "sha512-F2msla3tad+Mfht5cJq7LSXcdudKTWCVYUgw6pLFOOHSTtZlj6SWNYAp+AhuqLmWdBO2X5hPrLcu8cVP8fy28w=="],
@@ -157,20 +143,10 @@
 
     "@types/which": ["@types/which@3.0.3", "", {}, "sha512-2C1+XoY0huExTbs8MQv1DuS5FS86+SEjdM9F/+GS61gg5Hqbtj8ZiDSx8MfWcyei907fIPbfPGCOrNUTnVHY1g=="],
 
-    "abstract-logging": ["abstract-logging@2.0.1", "", {}, "sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA=="],
-
-    "ajv": ["ajv@8.17.1", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g=="],
-
-    "ajv-formats": ["ajv-formats@3.0.1", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ=="],
-
     "ansi-regex": ["ansi-regex@6.0.1", "", {}, "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA=="],
 
     "ansi-styles": ["ansi-styles@3.2.1", "", { "dependencies": { "color-convert": "^1.9.0" } }, "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA=="],
 
-    "atomic-sleep": ["atomic-sleep@1.0.0", "", {}, "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ=="],
-
-    "avvio": ["avvio@9.1.0", "", { "dependencies": { "@fastify/error": "^4.0.0", "fastq": "^1.17.1" } }, "sha512-fYASnYi600CsH/j9EQov7lECAniYiBFiiAtBNuZYLA2leLe9qOvZzqYHFjtIj6gD2VMoMLP14834LFWvr4IfDw=="],
-
     "benchmark": ["benchmark@2.1.4", "", { "dependencies": { "lodash": "^4.17.4", "platform": "^1.3.3" } }, "sha512-l9MlfN4M1K/H2fbhfMy3B7vJd6AGKJVQn2h6Sg/Yx+KckoUA7ewS5Vv6TjSq18ooE1kS9hhAlQRH3AkXIh/aOQ=="],
 
     "braces": ["braces@3.0.2", "", { "dependencies": { "fill-range": "^7.0.1" } }, "sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A=="],
@@ -191,16 +167,12 @@
 
     "convert-source-map": ["convert-source-map@1.9.0", "", {}, "sha512-ASFBup0Mz1uyiIjANan1jzLQami9z1PoYSZCiiYW2FczPbenXc45FZdBZLzOT+r6+iciuEModtmCti+hjaAk0A=="],
 
-    "cookie": ["cookie@1.0.2", "", {}, "sha512-9Kr/j4O16ISv8zBBhJoi4bXOYNTkFLOqSL3UDB0njXxCXNezjeyVrJyGOWtgfs/q2km1gwBcfH8q1yEGoMYunA=="],
-
     "cross-spawn": ["cross-spawn@7.0.3", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w=="],
 
     "data-uri-to-buffer": ["data-uri-to-buffer@4.0.1", "", {}, "sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A=="],
 
     "debug": ["debug@4.3.4", "", { "dependencies": { "ms": "2.1.2" } }, "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ=="],
 
-    "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],
-
     "dir-glob": ["dir-glob@3.0.1", "", { "dependencies": { "path-type": "^4.0.0" } }, "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA=="],
 
     "duplexer": ["duplexer@0.1.2", "", {}, "sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg=="],
@@ -261,22 +233,10 @@
 
     "execa": ["execa@8.0.1", "", { "dependencies": { "cross-spawn": "^7.0.3", "get-stream": "^8.0.1", "human-signals": "^5.0.0", "is-stream": "^3.0.0", "merge-stream": "^2.0.0", "npm-run-path": "^5.1.0", "onetime": "^6.0.0", "signal-exit": "^4.1.0", "strip-final-newline": "^3.0.0" } }, "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg=="],
 
-    "fast-decode-uri-component": ["fast-decode-uri-component@1.0.1", "", {}, "sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg=="],
-
     "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
 
     "fast-glob": ["fast-glob@3.3.1", "", { "dependencies": { "@nodelib/fs.stat": "^2.0.2", "@nodelib/fs.walk": "^1.2.3", "glob-parent": "^5.1.2", "merge2": "^1.3.0", "micromatch": "^4.0.4" } }, "sha512-kNFPyjhh5cKjrUltxs+wFx+ZkbRaxxmZ+X0ZU31SOsxCEtP9VPgtq2teZw1DebupL5GmDaNQ6yKMMVcM41iqDg=="],
 
-    "fast-json-stringify": ["fast-json-stringify@6.0.1", "", { "dependencies": { "@fastify/merge-json-schemas": "^0.2.0", "ajv": "^8.12.0", "ajv-formats": "^3.0.1", "fast-uri": "^3.0.0", "json-schema-ref-resolver": "^2.0.0", "rfdc": "^1.2.0" } }, "sha512-s7SJE83QKBZwg54dIbD5rCtzOBVD43V1ReWXXYqBgwCwHLYAAT0RQc/FmrQglXqWPpz6omtryJQOau5jI4Nrvg=="],
-
-    "fast-querystring": ["fast-querystring@1.1.2", "", { "dependencies": { "fast-decode-uri-component": "^1.0.1" } }, "sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg=="],
-
-    "fast-redact": ["fast-redact@3.5.0", "", {}, "sha512-dwsoQlS7h9hMeYUq1W++23NDcBLV4KqONnITDV9DjfS3q1SgDGVrBdvvTLUotWtPSD7asWDV9/CmsZPy8Hf70A=="],
-
-    "fast-uri": ["fast-uri@3.0.6", "", {}, "sha512-Atfo14OibSv5wAp4VWNsFYE1AchQRTv9cBGWET4pZWHzYshFSS9NQI6I57rdKn9croWVMbYFbLhJ+yJvmZIIHw=="],
-
-    "fastify": ["fastify@5.5.0", "", { "dependencies": { "@fastify/ajv-compiler": "^4.0.0", "@fastify/error": "^4.0.0", "@fastify/fast-json-stringify-compiler": "^5.0.0", "@fastify/proxy-addr": "^5.0.0", "abstract-logging": "^2.0.1", "avvio": "^9.0.0", "fast-json-stringify": "^6.0.0", "find-my-way": "^9.0.0", "light-my-request": "^6.0.0", "pino": "^9.0.0", "process-warning": "^5.0.0", "rfdc": "^1.3.1", "secure-json-parse": "^4.0.0", "semver": "^7.6.0", "toad-cache": "^3.7.0" } }, "sha512-ZWSWlzj3K/DcULCnCjEiC2zn2FBPdlZsSA/pnPa/dbUfLvxkD/Nqmb0XXMXLrWkeM4uQPUvjdJpwtXmTfriXqw=="],
-
     "fastq": ["fastq@1.15.0", "", { "dependencies": { "reusify": "^1.0.4" } }, "sha512-wBrocU2LCXXa+lWBt8RoIRD89Fi8OdABODa/kEnyeyjS5aZO5/GNvI5sEINADqP/h8M29UHTHUb53sUu5Ihqdw=="],
 
     "fdir": ["fdir@6.1.0", "", { "peerDependencies": { "picomatch": "2.x" } }, "sha512-274qhz5PxNnA/fybOu6apTCUnM0GnO3QazB6VH+oag/7DQskdYq8lm07ZSm90kEQuWYH5GvjAxGruuHrEr0bcg=="],
@@ -285,8 +245,6 @@
 
     "fill-range": ["fill-range@7.0.1", "", { "dependencies": { "to-regex-range": "^5.0.1" } }, "sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ=="],
 
-    "find-my-way": ["find-my-way@9.3.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-querystring": "^1.0.0", "safe-regex2": "^5.0.0" } }, "sha512-eRoFWQw+Yv2tuYlK2pjFS2jGXSxSppAs3hSQjfxVKxM5amECzIgYYc1FEI8ZmhSh/Ig+FrKEz43NLRKJjYCZVg=="],
-
     "formdata-polyfill": ["formdata-polyfill@4.0.10", "", { "dependencies": { "fetch-blob": "^3.1.2" } }, "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g=="],
 
     "from": ["from@0.1.7", "", {}, "sha512-twe20eF1OxVxp/ML/kq2p1uc6KvFK/+vs8WjEbeKmV2He22MKm7YF2ANIt+EOqhJ5L3K/SuuPhk0hWQDjOM23g=="],
@@ -315,8 +273,6 @@
 
     "ignore": ["ignore@5.3.0", "", {}, "sha512-g7dmpshy+gD7mh88OC9NwSGTKoc3kyLAZQRU1mt53Aw/vnvfXnbC+F/7F7QoYVKbV+KNvJx8wArewKy1vXMtlg=="],
 
-    "ipaddr.js": ["ipaddr.js@2.2.0", "", {}, "sha512-Ag3wB2o37wslZS19hZqorUnrnzSkpOVy+IiiDEiTqNubEYpYuHWIf6K4psgN2ZWKExS4xhVCrRVfb/wfW8fWJA=="],
-
     "is-arrayish": ["is-arrayish@0.3.2", "", {}, "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ=="],
 
     "is-extglob": ["is-extglob@2.1.1", "", {}, "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ=="],
@@ -333,16 +289,10 @@
 
     "jsesc": ["jsesc@2.5.2", "", { "bin": { "jsesc": "bin/jsesc" } }, "sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA=="],
 
-    "json-schema-ref-resolver": ["json-schema-ref-resolver@2.0.1", "", { "dependencies": { "dequal": "^2.0.3" } }, "sha512-HG0SIB9X4J8bwbxCbnd5FfPEbcXAJYTi1pBJeP/QPON+w8ovSME8iRG+ElHNxZNX2Qh6eYn1GdzJFS4cDFfx0Q=="],
-
-    "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
-
     "json5": ["json5@2.2.3", "", { "bin": { "json5": "lib/cli.js" } }, "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg=="],
 
     "jsonfile": ["jsonfile@6.1.0", "", { "dependencies": { "universalify": "^2.0.0" }, "optionalDependencies": { "graceful-fs": "^4.1.6" } }, "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ=="],
 
-    "light-my-request": ["light-my-request@6.6.0", "", { "dependencies": { "cookie": "^1.0.1", "process-warning": "^4.0.0", "set-cookie-parser": "^2.6.0" } }, "sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A=="],
-
     "lodash": ["lodash@4.17.21", "", {}, "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="],
 
     "loose-envify": ["loose-envify@1.4.0", "", { "dependencies": { "js-tokens": "^3.0.0 || ^4.0.0" }, "bin": { "loose-envify": "cli.js" } }, "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q=="],
@@ -373,8 +323,6 @@
 
     "npm-run-path": ["npm-run-path@5.2.0", "", { "dependencies": { "path-key": "^4.0.0" } }, "sha512-W4/tgAXFqFA0iL7fk0+uQ3g7wkL8xJmx3XdK0VGb4cHW//eZTtKGvFBBoRKVTpY7n6ze4NL9ly7rgXcHufqXKg=="],
 
-    "on-exit-leak-free": ["on-exit-leak-free@2.1.2", "", {}, "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA=="],
-
     "onetime": ["onetime@6.0.0", "", { "dependencies": { "mimic-fn": "^4.0.0" } }, "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ=="],
 
     "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
@@ -387,50 +335,24 @@
 
     "picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],
 
-    "pino": ["pino@9.9.0", "", { "dependencies": { "atomic-sleep": "^1.0.0", "fast-redact": "^3.1.1", "on-exit-leak-free": "^2.1.0", "pino-abstract-transport": "^2.0.0", "pino-std-serializers": "^7.0.0", "process-warning": "^5.0.0", "quick-format-unescaped": "^4.0.3", "real-require": "^0.2.0", "safe-stable-stringify": "^2.3.1", "sonic-boom": "^4.0.1", "thread-stream": "^3.0.0" }, "bin": { "pino": "bin.js" } }, "sha512-zxsRIQG9HzG+jEljmvmZupOMDUQ0Jpj0yAgE28jQvvrdYTlEaiGwelJpdndMl/MBuRr70heIj83QyqJUWaU8mQ=="],
-
-    "pino-abstract-transport": ["pino-abstract-transport@2.0.0", "", { "dependencies": { "split2": "^4.0.0" } }, "sha512-F63x5tizV6WCh4R6RHyi2Ml+M70DNRXt/+HANowMflpgGFMAym/VKm6G7ZOQRjqN7XbGxK1Lg9t6ZrtzOaivMw=="],
-
-    "pino-std-serializers": ["pino-std-serializers@7.0.0", "", {}, "sha512-e906FRY0+tV27iq4juKzSYPbUj2do2X2JX4EzSca1631EB2QJQUqGbDuERal7LCtOpxl6x3+nvo9NPZcmjkiFA=="],
-
     "platform": ["platform@1.3.6", "", {}, "sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg=="],
 
-    "process-warning": ["process-warning@5.0.0", "", {}, "sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA=="],
-
     "ps-tree": ["ps-tree@1.2.0", "", { "dependencies": { "event-stream": "=3.3.4" }, "bin": { "ps-tree": "./bin/ps-tree.js" } }, "sha512-0VnamPPYHl4uaU/nSFeZZpR21QAWRz+sRv4iW9+v/GS/J5U5iZB5BNN6J0RMoOvdx2gWM2+ZFMIm58q24e4UYA=="],
 
     "queue-microtask": ["queue-microtask@1.2.3", "", {}, "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A=="],
 
-    "quick-format-unescaped": ["quick-format-unescaped@4.0.4", "", {}, "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg=="],
-
     "react": ["react@18.3.1", "", { "dependencies": { "loose-envify": "^1.1.0" } }, "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ=="],
 
     "react-dom": ["react-dom@18.3.1", "", { "dependencies": { "loose-envify": "^1.1.0", "scheduler": "^0.23.2" }, "peerDependencies": { "react": "^18.3.1" } }, "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw=="],
 
-    "real-require": ["real-require@0.2.0", "", {}, "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg=="],
-
-    "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="],
-
-    "ret": ["ret@0.5.0", "", {}, "sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw=="],
-
     "reusify": ["reusify@1.0.4", "", {}, "sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw=="],
 
-    "rfdc": ["rfdc@1.4.1", "", {}, "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="],
-
     "run-parallel": ["run-parallel@1.2.0", "", { "dependencies": { "queue-microtask": "^1.2.2" } }, "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA=="],
 
-    "safe-regex2": ["safe-regex2@5.0.0", "", { "dependencies": { "ret": "~0.5.0" } }, "sha512-YwJwe5a51WlK7KbOJREPdjNrpViQBI3p4T50lfwPuDhZnE3XGVTlGvi+aolc5+RvxDD6bnUmjVsU9n1eboLUYw=="],
-
-    "safe-stable-stringify": ["safe-stable-stringify@2.5.0", "", {}, "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA=="],
-
     "scheduler": ["scheduler@0.23.2", "", { "dependencies": { "loose-envify": "^1.1.0" } }, "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ=="],
 
-    "secure-json-parse": ["secure-json-parse@4.0.0", "", {}, "sha512-dxtLJO6sc35jWidmLxo7ij+Eg48PM/kleBsxpC8QJE0qJICe+KawkDQmvCMZUr9u7WKVHgMW6vy3fQ7zMiFZMA=="],
-
     "semver": ["semver@6.3.0", "", { "bin": { "semver": "./bin/semver.js" } }, "sha512-b39TBaTSfV6yBrapU89p5fKekE2m/NwnDocOVruQFS1/veMgdzuPcnOM34M6CwxW8jH/lxEa5rBoDeUwu5HHTw=="],
 
-    "set-cookie-parser": ["set-cookie-parser@2.7.1", "", {}, "sha512-IOc8uWeOZgnb3ptbCURJWNjWUPcO3ZnTTdzsurqERrP6nPyv+paC55vJM0LpOlT2ne+Ix+9+CRG1MNLlyZ4GjQ=="],
-
     "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
 
     "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
@@ -441,12 +363,8 @@
 
     "slash": ["slash@4.0.0", "", {}, "sha512-3dOsAHXXUkQTpOYcoAxLIorMTp4gIQr5IW3iVb7A7lFIp0VHhnynm9izx6TssdrIcVIESAlVjtnO2K8bg+Coew=="],
 
-    "sonic-boom": ["sonic-boom@4.2.0", "", { "dependencies": { "atomic-sleep": "^1.0.0" } }, "sha512-INb7TM37/mAcsGmc9hyyI6+QR3rR1zVRu36B0NeGXKnOOLiZOfER5SA+N7X7k3yUYRzLWafduTDvJAfDswwEww=="],
-
     "split": ["split@0.3.3", "", { "dependencies": { "through": "2" } }, "sha512-wD2AeVmxXRBoX44wAycgjVpMhvbwdI2aZjCkvfNcH1YqHQvJVa1duWc73OyVGJUc05fhFaTZeQ/PYsrmyH0JVA=="],
 
-    "split2": ["split2@4.2.0", "", {}, "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg=="],
-
     "stream-combiner": ["stream-combiner@0.0.4", "", { "dependencies": { "duplexer": "~0.1.1" } }, "sha512-rT00SPnTVyRsaSz5zgSPma/aHSOic5U1prhYdRy5HS2kTZviFpmDgzilbtsJsxiroqACmayynDN/9VzIbX5DOw=="],
 
     "string-width": ["string-width@7.1.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-SEIJCWiX7Kg4c129n48aDRwLbFb2LJmXXFrWBG4NGaRtMQ3myKPKbwrD1BKqQn74oCoNMBVrfDEr5M9YxCsrkw=="],
@@ -457,8 +375,6 @@
 
     "supports-color": ["supports-color@5.5.0", "", { "dependencies": { "has-flag": "^3.0.0" } }, "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow=="],
 
-    "thread-stream": ["thread-stream@3.1.0", "", { "dependencies": { "real-require": "^0.2.0" } }, "sha512-OqyPZ9u96VohAyMfJykzmivOrY2wfMSf3C5TtFJVgN+Hm6aj+voFhlK+kZEIv2FBh1X6Xp3DlnCOfEQ3B2J86A=="],
-
     "through": ["through@2.3.8", "", {}, "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg=="],
 
     "tinycolor2": ["tinycolor2@1.6.0", "", {}, "sha512-XPaBkWQJdsf3pLKJV9p4qN/S+fm2Oj8AIPo1BTUhg5oxkvm9+SVEGFdhyOz7tTdUTfvxMiAs4sp6/eZO2Ew+pw=="],
@@ -467,8 +383,6 @@
 
     "to-regex-range": ["to-regex-range@5.0.1", "", { "dependencies": { "is-number": "^7.0.0" } }, "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ=="],
 
-    "toad-cache": ["toad-cache@3.7.0", "", {}, "sha512-/m8M+2BJUpoJdgAHoG+baCwBT+tf2VraSfkBgl0Y00qIWt41DJ8R5B8nsEw0I58YwF5IZH6z24/2TobDKnqSWw=="],
-
     "undici-types": ["undici-types@5.26.5", "", {}, "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA=="],
 
     "universalify": ["universalify@2.0.1", "", {}, "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw=="],
@@ -493,14 +407,8 @@
 
     "ansi-styles/color-convert": ["color-convert@1.9.3", "", { "dependencies": { "color-name": "1.1.3" } }, "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg=="],
 
-    "avvio/fastq": ["fastq@1.19.1", "", { "dependencies": { "reusify": "^1.0.4" } }, "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ=="],
-
     "cross-spawn/which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
 
-    "fastify/semver": ["semver@7.7.2", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA=="],
-
-    "light-my-request/process-warning": ["process-warning@4.0.1", "", {}, "sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q=="],
-
     "npm-run-path/path-key": ["path-key@4.0.0", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],
 
     "ansi-styles/color-convert/color-name": ["color-name@1.1.3", "", {}, "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw=="],

bench/expect-to-equal/README.md

@@ -40,4 +40,4 @@ vitest (node v18.11.0)
 
 > expect().toEqual() x 10000: 401.08ms
 
-This project was created using `bun init` in bun v0.3.0. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+This project was created using `bun init` in bun v0.3.0. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

bench/express/tsconfig.json

@@ -1,9 +1,9 @@
 {
   "compilerOptions": {
     // Enable latest features
-    "lib": ["ESNext"],
+    "lib": ["ESNext", "DOM"],
     "target": "ESNext",
-    "module": "Preserve",
+    "module": "ESNext",
     "moduleDetection": "force",
     "jsx": "react-jsx",
     "allowJs": true,

bench/hot-module-reloading/css-stress-test/.gitignore

@@ -0,0 +1,5 @@
+bun
+next
+src/*.mov
+src/*.blob
+

bench/hot-module-reloading/css-stress-test/Makefile

@@ -0,0 +1,77 @@
+SLEEP_INTERVAL ?= 32
+SCREEN_WIDTH ?= $(shell system_profiler -json SPDisplaysDataType 2>/dev/null | jq -r '.. | objects | select(.spdisplays_main) | ._spdisplays_pixels | split(" ")[0]')
+SCREEN_HEIGHT ?= $(shell system_profiler -json SPDisplaysDataType 2>/dev/null | jq -r '.. | objects | select(.spdisplays_main) | ._spdisplays_pixels | split(" ")[2]')
+PROJECT ?= bun
+PACKAGE_NAME ?= bun-cli
+RUN_COUNT ?= 128
+ENDPOINT ?= /
+
+ifeq ($(PROJECT),bun)
+PACKAGE_NAME := bun-cli
+endif
+
+ifeq ($(PROJECT),next)
+PACKAGE_NAME := next
+endif
+
+generate:
+	@killall -9 bun next node || echo ""
+	PROJECT=$(PROJECT) SCREEN_WIDTH=$(SCREEN_WIDTH) SCREEN_HEIGHT=$(SCREEN_HEIGHT) ENDPOINT=$(ENDPOINT) node browser.js 
+
+generate-css-in-js:
+	@killall -9 bun next node || echo ""
+	PROJECT=$(PROJECT) SCREEN_WIDTH=$(SCREEN_WIDTH) SCREEN_HEIGHT=$(SCREEN_HEIGHT) ENDPOINT=/css-in-js node browser.js 
+loop:
+	cp src/colors.css.0 src/colors.css
+	sleep 3
+	osascript -e 'tell application "System Events" to tell process "Chromium"' \
+		-e 'set frontmost to true' \
+		-e 'if windows is not {} then perform action "AXRaise" of item 1 of windows' \
+		-e 'end tell'
+	sleep 0.5
+	cd src; zig run -Doptimize=ReleaseFast ../color-looper.zig -- ./colors.css:0 $(SLEEP_INTERVAL)
+	cp src/colors.css.blob $(PROJECT)/colors.css.blob
+
+loop-emotion:
+	cp src/css-in-js-styles.0 src/css-in-js-styles.tsx
+	sleep 3
+	osascript -e 'tell application "System Events" to tell process "Chromium"' \
+		-e 'set frontmost to true' \
+		-e 'if windows is not {} then perform action "AXRaise" of item 1 of windows' \
+		-e 'end tell'
+	sleep 0.5
+	cd src; zig run -Doptimize=ReleaseFast ../color-looper.emotion.zig -- ./css-in-js-styles.tsx:0 $(SLEEP_INTERVAL)
+	cp src/css-in-js-styles.tsx.blob $(PROJECT)/css-in-js-styles.blob
+
+process_video: 
+	rm -rf $(FRAMES_DIR); mkdir -p $(FRAMES_DIR); ffmpeg -i src/colors.css.mov -vf fps=120,format=gray $(FRAMES_DIR)/%d.tif
+
+FRAMES_DIR ?= $(shell mkdir -p ./$(PROJECT)/frames; realpath ./$(PROJECT)/frames)
+
+TIF_FILES := $(wildcard $(FRAMES_DIR)/*.tif)
+TXT_FILES := $(wildcard $(FRAMES_DIR)/*.txt)
+
+OBJ_FILES := $(patsubst $(SRC_DIR)/%.tif,$(OBJ_DIR)/%.txt,$(TIF_FILES))
+TRIM_FILES := $(patsubst $(SRC_DIR)/%.txt,$(OBJ_DIR)/%.trim,$(TXT_FILES))
+
+frames: $(OBJ_FILES)
+
+
+$(FRAMES_DIR)/%.txt: $(FRAMES_DIR)/%.tif
+	 tesseract -l eng $< $@ 
+
+trim: $(TRIM_FILES) cleanup print
+
+
+
+$(FRAMES_DIR)/%.trim: $(FRAMES_DIR)/%.txt
+	 (grep "Ran:" $< || echo "\n") >> $(PROJECT)/frames.all
+
+cleanup:
+	sed 's/^Ran: *//' $(PROJECT)/frames.all | tr -d ' ' | sort | uniq > $(PROJECT)/frames.all.clean
+
+print:
+	PACKAGE_NAME=$(PACKAGE_NAME) SLEEP_INTERVAL=$(SLEEP_INTERVAL) PROJECT=$(PROJECT) OUTFILE=timings/$(PACKAGE_NAME) node read-frames.js 
+
+print-emotion:
+	PACKAGE_NAME=$(PACKAGE_NAME) SLEEP_INTERVAL=$(SLEEP_INTERVAL) PROJECT=$(PROJECT) OUTFILE=timings/emotion_$(PACKAGE_NAME) node read-frames.js 

bench/hot-module-reloading/css-stress-test/README.md

@@ -0,0 +1,62 @@
+# CSS Stress Test
+
+This benchmarks bundler performance for CSS hot reloading.
+
+## Results
+
+bun is 14x faster than Next.js at hot reloading CSS.
+
+```
+ bun v0.0.34
+ Saving every 16ms
+
+ Frame time:
+ 50th percentile: 22.2ms
+ 75th percentile: 23.9ms
+ 90th percentile: 25.3ms
+ 95th percentile: 43.6ms
+ 99th percentile: 49.1ms
+ Rendered frames: 922 / 1024 (90%)
+```
+
+```
+ Next.js v11.1.2
+ Saving every 16ms
+
+ Frame time:
+ 50th percentile: 312ms
+ 75th percentile: 337.6ms
+ 90th percentile: 387.7ms
+ 95th percentile: 446.9ms
+ 99th percentile: 591.7ms
+ Rendered frames: 64 / 1024 (6%)
+```
+
+## How it works
+
+It times pixels instead of builds. `color-looper.zig` writes color updates and the timestamp to a css file, while simultaneously screen recording a non-headless Chromium instance. After it finishes, it OCRs the video frames and verifies the scanned timestamps against the actual data. This data measures (1) how long each update took from saving to disk up to the pixels visible on the screen and (2) what % of frames were rendered.
+
+The intent is to be as accurate as possible. Measuring times reported client-side is simpler, but lower accuracy since those times may not correspond to pixels on the screen and do not start from when the data was written to disk (at best, they measure when the filesystem watcher detected the update, but often not that either). `color-looper.zig` must run separately from `browser.js` or the results will be inaccurate.
+
+It works like this:
+
+1. `browser.js` loads either bun or Next.js and a Chromium instance opened to the correct webpage
+2. `color-looper.zig` updates [`./src/colors.css`](./src/colors.css) in a loop up to `1024` times (1024 is arbitrary), sleeping every `16`ms or `32`ms (a CLI arg you can pass it). The `var(--timestamp)` CSS variable contains the UTC timestamp with precision of milliseconds and one extra decimal point
+3. `color-looper.zig` automatically records the screen via `screencapture` (builtin on macOS) and saves it, along with a `BigUint64Array` containing all the expected timestamps. When it's done, it writes to a designated file on disk which `browser.js` picks up as the signal to close the browser.
+4. `ffmpeg` converts each frame into a black and white `.tif` file, which `tesseract` then OCRs
+5. Various cleanup scripts extract the timestamp from each of those OCR'd frames into a single file
+6. Using the OCR'd data, `./read-frames.js` calculates the 50th, 75th, 90th, 95th, and 99th percentile frame time, along with how many frames were skipped. Frame time is the metric here that matters here because that's how much time elapsed between each update. It includes the artificial sleep interval, so it will not be faster than the sleep interval.
+
+The script `run.sh` runs all the commands necessary to do this work unattended. It takes awhile though. The slow part is OCR'ing all the frames.
+
+To run this, you need:
+
+- `zig`
+- `bun-cli`
+- `node`
+- `tesseract`
+- `screencapture` (macOS builtin)
+- `ffmpeg`
+- `puppeteer` (from the package.json)
+
+You will need to run `bun bun --use next` first, with `next@11.1.2`. It will only run on macOS due to the dependencies on `screencapture`, how it detects screen resolution (so that Chromium is maximized), and how it auto-focuses Chromium (apple script)

bench/hot-module-reloading/css-stress-test/browser.js

@@ -0,0 +1,114 @@
+const puppeteer = require("puppeteer");
+const http = require("http");
+const path = require("path");
+const url = require("url");
+const fs = require("fs");
+const child_process = require("child_process");
+const serverURL = process.env.TEST_SERVER_URL || "http://localhost:8080";
+
+if (process.env.PROJECT === "bun") {
+  const bunFlags = [`--origin=${serverURL}`].filter(Boolean);
+  const bunExec = process.env.BUN_BIN || "bun";
+  const bunProcess = child_process.spawn(bunExec, bunFlags, {
+    cwd: process.cwd(),
+    stdio: "ignore",
+    env: {
+      ...process.env,
+      DISABLE_BUN_ANALYTICS: "1",
+    },
+
+    shell: false,
+  });
+  console.log("$", bunExec, bunFlags.join(" "));
+  const isDebug = bunExec.endsWith("-debug");
+
+  // bunProcess.stderr.pipe(process.stderr);
+  // bunProcess.stdout.pipe(process.stdout);
+  bunProcess.once("error", err => {
+    console.error("❌ bun error", err);
+    process.exit(1);
+  });
+  process.on("beforeExit", () => {
+    bunProcess?.kill(0);
+  });
+} else if (process.env.PROJECT === "next") {
+  const bunProcess = child_process.spawn("./node_modules/.bin/next", ["--port", "8080"], {
+    cwd: process.cwd(),
+    stdio: "ignore",
+    env: {
+      ...process.env,
+    },
+
+    shell: false,
+  });
+}
+
+const delay = new Promise((resolve, reject) => {
+  const watcher = fs.watch(path.resolve(process.cwd(), "src/colors.css.blob"));
+  watcher.once("change", () => {
+    setTimeout(() => {
+      resolve();
+    }, 1000);
+  });
+});
+
+async function main() {
+  const browser = await puppeteer.launch({
+    headless: false,
+    waitForInitialPage: true,
+    args: [
+      `--window-size=${parseInt(process.env.SCREEN_WIDTH || "1024", 10) / 2},${
+        parseInt(process.env.SCREEN_HEIGHT || "1024", 10) / 2
+      }`,
+    ],
+    defaultViewport: {
+      width: parseInt(process.env.SCREEN_WIDTH || "1024", 10) / 2,
+      height: parseInt(process.env.SCREEN_HEIGHT || "1024", 10) / 2,
+    },
+  });
+  const promises = [];
+  let allTestsPassed = true;
+
+  async function runPage(key) {
+    var page;
+
+    try {
+      console.log("Opening page");
+      page = await browser.newPage();
+
+      console.log(`Navigating to "http://localhost:8080/"`);
+
+      while (true) {
+        try {
+          await page.goto("http://localhost:8080/", { waitUntil: "load" });
+          break;
+        } catch (exception) {
+          if (!exception.toString().includes("ERR_CONNECTION_REFUSED")) break;
+        }
+      }
+
+      await page.bringToFront();
+
+      await delay;
+
+      //   runner.stdout.pipe(process.stdout);
+      //   runner.stderr.pipe(process.stderr);
+      var didResolve = false;
+
+      console.log(`Completed. Done.`);
+    } catch (error) {
+      console.error(error);
+    } finally {
+      await page.close();
+      await browser.close();
+    }
+  }
+
+  return runPage();
+}
+
+main().catch(error =>
+  setTimeout(() => {
+    throw error;
+  }),
+);

bench/hot-module-reloading/css-stress-test/bun.latest.16ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=16 PROJECT=bun node read-frames.js
+bun
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 22.2ms 
+ 75th percentile: 23.9ms 
+ 90th percentile: 25.3ms 
+ 95th percentile: 43.6ms 
+ 99th percentile: 49.1ms 
+ Rendered frames: 922 / 1024 (90%)

bench/hot-module-reloading/css-stress-test/bun.latest.24ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=24 PROJECT=bun node read-frames.js
+bun
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 33.4ms 
+ 75th percentile: 34.5ms 
+ 90th percentile: 35.8ms 
+ 95th percentile: 65.5ms 
+ 99th percentile: 87.9ms 
+ Rendered frames: 937 / 1024 (92%)

bench/hot-module-reloading/css-stress-test/bun.latest.32ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=32 PROJECT=bun node read-frames.js
+bun
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 40.7ms 
+ 75th percentile: 42.3ms 
+ 90th percentile: 43.5ms 
+ 95th percentile: 76.4ms 
+ 99th percentile: 118.8ms 
+ Rendered frames: 958 / 1024 (94%)

bench/hot-module-reloading/css-stress-test/bun.latest.8ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=8 PROJECT=bun node read-frames.js
+bun
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 20ms 
+ 75th percentile: 24.4ms 
+ 90th percentile: 41ms 
+ 95th percentile: 53.9ms 
+ 99th percentile: 90.4ms 
+ Rendered frames: 475 / 1024 (46%)

bench/hot-module-reloading/css-stress-test/color-looper.emotion.zig

@@ -0,0 +1,218 @@
+const std = @import("std");
+
+pub const Counter = extern struct {
+    timestamp: usize,
+    percent: f64,
+    rotate: u32,
+    color_values: [8 * 3]u32,
+};
+
+const RUN_COUNT = 1024;
+
+var counters: [RUN_COUNT]Counter = undefined;
+
+pub const Blob = extern struct {
+    run_count: u32,
+    interval: u64,
+};
+
+pub var all_timestamps: [RUN_COUNT + 1]usize = undefined;
+
+// usage:
+// ./file-path:0 10
+// 1           2 3
+
+// 1. file path
+// 2. Byte offset in file
+// 3. ms update interval
+var color_buf: [8192 + SIMULATE_LONG_FILE.len]u8 = undefined;
+
+pub fn main() anyerror!void {
+    var allocator = std.heap.c_allocator;
+    var timer = try std.time.Timer.start();
+
+    var args = std.mem.span(try std.process.argsAlloc(allocator));
+
+    var basepath_with_colon: []u8 = args[args.len - 2];
+    var basepath: []u8 = "";
+    var position_str: []u8 = "";
+    if (std.mem.lastIndexOfScalar(u8, basepath_with_colon, ':')) |colon| {
+        basepath = basepath_with_colon[0..colon];
+        position_str = basepath_with_colon[colon + 1 ..];
+    }
+    var position = try std.fmt.parseInt(u32, position_str, 10);
+    const filepath = try std.fs.path.resolve(allocator, &.{basepath});
+    var file = try std.fs.openFileAbsolute(filepath, .{ .write = true });
+    var ms = @as(u64, @truncate((try std.fmt.parseInt(u128, args[args.len - 1], 10)) * std.time.ns_per_ms));
+    std.debug.assert(ms > 0);
+    // std.debug.assert(std.math.isFinite(position));
+    var prng = std.rand.DefaultPrng.init(0);
+    var stdout = std.io.getStdOut();
+    var log = stdout.writer();
+    var colors = std.mem.zeroes([4][3]u32);
+    var progress_bar: f64 = 0.0;
+    var destination_count: f64 = 18.0;
+
+    // Randomize initial colors
+    colors[0][0] = prng.random.int(u32);
+    colors[0][1] = prng.random.int(u32);
+    colors[0][2] = prng.random.int(u32);
+
+    colors[1][0] = prng.random.int(u32);
+    colors[1][1] = prng.random.int(u32);
+    colors[1][2] = prng.random.int(u32);
+
+    colors[2][0] = prng.random.int(u32);
+    colors[2][1] = prng.random.int(u32);
+    colors[2][2] = prng.random.int(u32);
+
+    colors[3][0] = prng.random.int(u32);
+    colors[3][1] = prng.random.int(u32);
+    colors[3][2] = prng.random.int(u32);
+    var rotate: u32 = 0;
+    var counter: usize = 0;
+    const video = std.fmt.allocPrint(allocator, "{s}.mov", .{filepath}) catch unreachable;
+    std.fs.deleteFileAbsolute(video) catch {};
+    var screen_recorder_argv = [_][]const u8{ "screencapture", "-v", video };
+
+    var recorder = std.ChildProcess.init(&screen_recorder_argv, allocator);
+    recorder.stdin_behavior = .Pipe;
+    try recorder.spawn();
+    std.time.sleep(std.time.ns_per_s);
+    var wrote: []u8 = undefined;
+    while (counter < RUN_COUNT) {
+        colors[0][0] += 1;
+        colors[0][1] += 1;
+        colors[0][2] += 1;
+        colors[1][0] += 1;
+        colors[1][1] += 1;
+        colors[1][2] += 1;
+        colors[2][0] += 1;
+        colors[2][1] += 1;
+        colors[2][2] += 1;
+        colors[3][0] += 1;
+        colors[3][1] += 1;
+        colors[3][2] += 1;
+        rotate += 1;
+        const fmtd: []const u8 = comptime brk: {
+            break :brk (
+                \\
+                \\import {{ Global }} from "@emotion/react";
+                \\export function CSSInJSStyles() {{
+                \\  return (
+                \\    <Global
+                \\      styles={{`
+                \\:root {{
+                \\  --timestamp: "{d}";
+                \\  --interval: "{s}";
+                \\  --progress-bar: {d}%;
+                \\  --spinner-1-muted: rgb({d}, {d}, {d});
+                \\  --spinner-1-primary: rgb({d}, {d}, {d});
+                \\  --spinner-2-muted: rgb({d}, {d}, {d});
+                \\  --spinner-2-primary: rgb({d}, {d}, {d});
+                \\  --spinner-3-muted: rgb({d}, {d}, {d});
+                \\  --spinner-3-primary: rgb({d}, {d}, {d});
+                \\  --spinner-4-muted: rgb({d}, {d}, {d});
+                \\  --spinner-4-primary: rgb({d}, {d}, {d});
+                \\  --spinner-rotate: {d}deg;
+                \\}}
+            ++ SIMULATE_LONG_FILE ++
+                \\  `}}
+                \\    />
+                \\  );
+                \\}}
+                \\
+            );
+        };
+
+        counters[counter].timestamp = @as(u64, @truncate(@as(u128, @intCast(std.time.nanoTimestamp())) / (std.time.ns_per_ms / 10)));
+        counters[counter].rotate = rotate % 360;
+        counters[counter].percent = std.math.mod(f64, std.math.round(((progress_bar + 1.0) / destination_count) * 1000) / 1000, 100) catch 0;
+        counters[counter].color_values[0] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[0][0] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[1] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[0][1] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[2] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[0][2] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[3] = (colors[0][0] + 1) % 256;
+        counters[counter].color_values[4] = (colors[0][1] + 1) % 256;
+        counters[counter].color_values[5] = (colors[0][2] + 1) % 256;
+        counters[counter].color_values[6] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[1][0] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[7] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[1][1] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[8] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[1][2] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[9] = (colors[1][0] + 1) % 256;
+        counters[counter].color_values[10] = (colors[1][1] + 1) % 256;
+        counters[counter].color_values[11] = (colors[1][2] + 1) % 256;
+        counters[counter].color_values[12] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[2][0] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[13] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[2][1] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[14] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[2][2] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[15] = (colors[2][0] + 1) % 256;
+        counters[counter].color_values[16] = (colors[2][1] + 1) % 256;
+        counters[counter].color_values[17] = (colors[2][2] + 1) % 256;
+        counters[counter].color_values[18] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[3][0] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[19] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[3][1] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[20] = @as(u32, @intFromFloat(std.math.round(@as(f64, @floatFromInt(((colors[3][2] + 1) % 256))) * 0.8)));
+        counters[counter].color_values[21] = (colors[3][0] + 1) % 256;
+        counters[counter].color_values[22] = (colors[3][1] + 1) % 256;
+        counters[counter].color_values[23] = (colors[3][2] + 1) % 256;
+
+        file = try std.fs.createFileAbsolute(filepath, .{ .truncate = true });
+        wrote = try std.fmt.bufPrint(&color_buf, fmtd, .{
+            counters[counter].timestamp,
+            args[args.len - 1],
+            counters[counter].percent,
+            counters[counter].color_values[0],
+            counters[counter].color_values[1],
+            counters[counter].color_values[2],
+            counters[counter].color_values[3],
+            counters[counter].color_values[4],
+            counters[counter].color_values[5],
+            counters[counter].color_values[6],
+            counters[counter].color_values[7],
+            counters[counter].color_values[8],
+            counters[counter].color_values[9],
+            counters[counter].color_values[10],
+            counters[counter].color_values[11],
+            counters[counter].color_values[12],
+            counters[counter].color_values[13],
+            counters[counter].color_values[14],
+            counters[counter].color_values[15],
+            counters[counter].color_values[16],
+            counters[counter].color_values[17],
+            counters[counter].color_values[18],
+            counters[counter].color_values[19],
+            counters[counter].color_values[20],
+            counters[counter].color_values[21],
+            counters[counter].color_values[22],
+            counters[counter].color_values[23],
+            counters[counter].rotate,
+        });
+        progress_bar += 1.0;
+        _ = try file.writeAll(wrote);
+
+        try log.print("[{d}] \"{s}\":{d}\n", .{
+            std.time.nanoTimestamp(),
+            filepath,
+            position,
+        });
+        counter += 1;
+        // If we don't close the file, Parcel seems to never recognize it
+        file.close();
+        std.time.sleep(ms);
+    }
+
+    try recorder.stdin.?.writeAll(&[_]u8{ 3, ';' });
+
+    _ = try recorder.wait();
+
+    all_timestamps[0] = wrote.len;
+    for (counters, 0..) |count, i| {
+        all_timestamps[i + 1] = count.timestamp;
+    }
+
+    std.time.sleep(std.time.ns_per_s);
+    var blob_file = try std.fs.createFileAbsolute(std.fmt.allocPrint(std.heap.c_allocator, "{s}.blob", .{filepath}) catch unreachable, .{ .truncate = true });
+    try blob_file.writeAll(std.mem.asBytes(&all_timestamps));
+    blob_file.close();
+}
+
+const SIMULATE_LONG_FILE =
+    \\
+;

bench/hot-module-reloading/css-stress-test/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <link
+      rel="stylesheet"
+      crossorigin="anonymous"
+      href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;700&family=Space+Mono:wght@400;700&display=swap"
+    />
+    <link rel="stylesheet" href="src/index.css" />
+    <script async src="src/index.tsx" type="module"></script>
+  </head>
+  <body>
+    <div id="reactroot"></div>
+  </body>
+</html>

bench/hot-module-reloading/css-stress-test/inject.js

@@ -0,0 +1,2 @@
+import React from "react";
+export { React };

bench/hot-module-reloading/css-stress-test/next-env.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="next" />
+/// <reference types="next/types/global" />
 /// <reference types="next/image-types/global" />
 
 // NOTE: This file should not be edited

bench/hot-module-reloading/css-stress-test/next.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  experimental: {
+    swcLoader: true,
+  },
+};

bench/hot-module-reloading/css-stress-test/next.latest.16ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=16 PROJECT=next node read-frames.js
+next
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 312ms 
+ 75th percentile: 337.6ms 
+ 90th percentile: 387.7ms 
+ 95th percentile: 446.9ms 
+ 99th percentile: 591.7ms 
+ Rendered frames: 64 / 1024 (6%)

bench/hot-module-reloading/css-stress-test/next.latest.24ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=24 PROJECT=next node read-frames.js
+next
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 310.1ms 
+ 75th percentile: 360.3ms 
+ 90th percentile: 461.6ms 
+ 95th percentile: 660.4ms 
+ 99th percentile: 1009.9ms 
+ Rendered frames: 78 / 1024 (8%)

bench/hot-module-reloading/css-stress-test/next.latest.32ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=32 PROJECT=next node read-frames.js
+next
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 306.7ms 
+ 75th percentile: 324.7ms 
+ 90th percentile: 380ms 
+ 95th percentile: 483.6ms 
+ 99th percentile: 933.6ms 
+ Rendered frames: 116 / 1024 (11%)

bench/hot-module-reloading/css-stress-test/next.latest.8ms.txt

@@ -0,0 +1,11 @@
+SLEEP_INTERVAL=8 PROJECT=next node read-frames.js
+next
+ --------------------------------------------------
+ CSS HMR FRAME TIME
+
+ 50th percentile: 320.4ms 
+ 75th percentile: 368.8ms 
+ 90th percentile: 527.2ms 
+ 95th percentile: 532.4ms 
+ 99th percentile: 532.4ms 
+ Rendered frames: 32 / 1024 (3%)

bench/hot-module-reloading/css-stress-test/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "simple-react",
+  "version": "1.0.0",
+  "license": "MIT",
+  "dependencies": {
+    "@emotion/core": "latest",
+    "@emotion/css": "latest",
+    "@emotion/react": "latest",
+    "@vitejs/plugin-react-refresh": "^1.3.3",
+    "antd": "^4.16.1",
+    "bun-framework-next": "latest",
+    "left-pad": "^1.3.0",
+    "next": "^12",
+    "parcel": "2.0.0-beta.3",
+    "path-browserify": "^1.0.1",
+    "percentile": "^1.5.0",
+    "puppeteer": "^10.4.0",
+    "puppeteer-video-recorder": "^1.0.5",
+    "react": "^17.0.2",
+    "react-bootstrap": "^1.6.1",
+    "react-dom": "^17.0.2",
+    "react-form": "^4.0.1",
+    "react-hook-form": "^7.8.3",
+    "url": "^0.11.0",
+    "wipwipwipwip-next-donotuse": "4.0.0"
+  },
+  "parcel": "parceldist/index.js",
+  "targets": {
+    "parcel": {
+      "outputFormat": "esmodule",
+      "sourceMap": false,
+      "optimize": false,
+      "engines": {
+        "chrome": "last 1 version"
+      }
+    }
+  },
+  "devDependencies": {
+    "@microsoft/fetch-event-source": "^2.0.1",
+    "@snowpack/plugin-react-refresh": "^2.5.0",
+    "typescript": "^4.3.4"
+  }
+}

bench/hot-module-reloading/css-stress-test/pages/_app.tsx

@@ -0,0 +1,13 @@
+// @ts-nocheck
+import "../src/index.css";
+
+import App from "next/app";
+
+class MyApp extends App {
+  render() {
+    const { Component, pageProps } = this.props;
+    return <Component {...pageProps} />;
+  }
+}
+
+export default MyApp;

bench/hot-module-reloading/css-stress-test/pages/index.tsx

@@ -0,0 +1,13 @@
+import { Main } from "src/main";
+export function IndexPage() {
+  return (
+    <Main
+      productName={
+        // @ts-ignore
+        typeof location !== "undefined" ? location.search.substring(1) : ""
+      }
+    />
+  );
+}
+
+export default IndexPage;

bench/hot-module-reloading/css-stress-test/react-inject.js

@@ -0,0 +1 @@
+export { default as React } from "react";

bench/hot-module-reloading/css-stress-test/read-frames.js

@@ -0,0 +1,99 @@
+const fs = require("fs");
+
+const path = require("path");
+const PROJECT = process.env.PROJECT || "bun";
+const percentile = require("percentile");
+const PACKAGE_NAME = process.env.PACKAGE_NAME;
+const label = `${PACKAGE_NAME}@${require(PACKAGE_NAME + "/package.json").version}`;
+
+const BASEFOLDER = path.resolve(PROJECT);
+const OUTFILE = path.join(process.cwd(), process.env.OUTFILE);
+
+const buf = fs.readFileSync(BASEFOLDER + "/colors.css.blob");
+const VALID_TIMES = new BigUint64Array(buf.buffer).subarray(1);
+const cssFileSize = new BigUint64Array(buf.buffer)[0];
+
+const TOTAL_FRAMES = VALID_TIMES.length;
+
+const timings = fs
+  .readFileSync(BASEFOLDER + "/frames.all.clean", "utf8")
+  .split("\n")
+  .map(a => a.replace(/[Ran:'\.]?/gm, "").trim())
+  .filter(a => parseInt(a, 10))
+  .filter(a => a.length > 0 && VALID_TIMES.includes(BigInt(parseInt(a, 10))))
+  .map(num => BigInt(num));
+
+timings.sort();
+
+const frameTimesCount = timings.length;
+
+var frameTime = new Array(Math.floor(frameTimesCount / 2));
+
+for (let i = 0; i < frameTime.length; i++) {
+  const i1 = i * 2;
+  const i2 = i * 2 + 1;
+
+  frameTime[i] = Math.max(Number(timings[i2] - timings[i1]), 0);
+}
+
+const report = {
+  label,
+  cssFileSize: Number(cssFileSize),
+  at: new Date().toISOString(),
+  sleep: process.env.SLEEP_INTERVAL,
+  package: {
+    name: PACKAGE_NAME,
+    version: require(PACKAGE_NAME + "/package.json").version,
+  },
+  timestamps: timings.map(a => Number(a)),
+  frameTimes: frameTime,
+  percentileMs: {
+    50: percentile(50, frameTime) / 10,
+    75: percentile(75, frameTime) / 10,
+    90: percentile(90, frameTime) / 10,
+    95: percentile(95, frameTime) / 10,
+    99: percentile(99, frameTime) / 10,
+  },
+};
+
+fs.writeFileSync(
+  path.join(
+    path.dirname(OUTFILE),
+    path.basename(OUTFILE) +
+      "@" +
+      report.package.version +
+      "." +
+      process.env.SLEEP_INTERVAL +
+      "ms." +
+      `${process.platform}-${process.arch === "arm64" ? "aarch64" : process.arch}` +
+      ".json",
+  ),
+  JSON.stringify(report, null, 2),
+);
+
+console.log(
+  label + "\n",
+  "-".repeat(50) + "\n",
+  "CSS HMR FRAME TIME\n" + "\n",
+
+  "50th percentile:",
+  percentile(50, frameTime) / 10 + "ms",
+  "\n",
+  "75th percentile:",
+  percentile(75, frameTime) / 10 + "ms",
+  "\n",
+  "90th percentile:",
+  percentile(90, frameTime) / 10 + "ms",
+  "\n",
+  "95th percentile:",
+  percentile(95, frameTime) / 10 + "ms",
+  "\n",
+  "99th percentile:",
+  percentile(99, frameTime) / 10 + "ms",
+  "\n",
+  "Rendered frames:",
+  timings.length,
+  "/",
+  TOTAL_FRAMES,
+  "(" + Math.round(Math.max(Math.min(1.0, timings.length / TOTAL_FRAMES), 0) * 100) + "%)",
+);