Try zero fill

.buildkite/Dockerfile

@@ -1,170 +0,0 @@
-ARG LLVM_VERSION="18"
-ARG REPORTED_LLVM_VERSION="18.1.8"
-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
-FROM --platform=$BUILDPLATFORM ubuntu:18.04 as base-amd64
-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 \
-   CI=true \
-   DOCKER=true
-
-RUN echo "Acquire::Queue-Mode \"host\";" > /etc/apt/apt.conf.d/99-apt-queue-mode.conf \
-    && echo "Acquire::Timeout \"120\";" >> /etc/apt/apt.conf.d/99-apt-timeout.conf \
-    && echo "Acquire::Retries \"3\";" >> /etc/apt/apt.conf.d/99-apt-retries.conf \
-    && echo "APT::Install-Recommends \"false\";" >> /etc/apt/apt.conf.d/99-apt-install-recommends.conf \
-    && echo "APT::Install-Suggests \"false\";" >> /etc/apt/apt.conf.d/99-apt-install-suggests.conf
-
-RUN apt-get update && apt-get install -y --no-install-recommends \
-   wget curl git python3 python3-pip ninja-build \
-   software-properties-common apt-transport-https \
-   ca-certificates gnupg lsb-release unzip \
-   libxml2-dev ruby ruby-dev bison gawk perl make golang \
-   && add-apt-repository ppa:ubuntu-toolchain-r/test \
-   && apt-get update \
-   && apt-get install -y gcc-13 g++-13 libgcc-13-dev libstdc++-13-dev \
-       libasan6 libubsan1 libatomic1 libtsan0 liblsan0 \
-       libgfortran5 libc6-dev \
-   && wget https://apt.llvm.org/llvm.sh \
-   && chmod +x llvm.sh \
-   && ./llvm.sh ${LLVM_VERSION} all \
-   && rm llvm.sh
-
-
-RUN --mount=type=tmpfs,target=/tmp \
-    cmake_version="3.30.5" && \
-    if [ "$TARGETARCH" = "arm64" ]; then \
-        cmake_url="https://github.com/Kitware/CMake/releases/download/v${cmake_version}/cmake-${cmake_version}-linux-aarch64.sh"; \
-    else \
-        cmake_url="https://github.com/Kitware/CMake/releases/download/v${cmake_version}/cmake-${cmake_version}-linux-x86_64.sh"; \
-    fi && \
-    wget -O /tmp/cmake.sh "$cmake_url" && \
-    sh /tmp/cmake.sh --skip-license --prefix=/usr
-
-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 \
-   --slave /usr/bin/gcc-nm gcc-nm /usr/bin/gcc-nm-13 \
-   --slave /usr/bin/gcc-ranlib gcc-ranlib /usr/bin/gcc-ranlib-13
-
-RUN echo "ARCH_PATH=$([ "$TARGETARCH" = "arm64" ] && echo "aarch64-linux-gnu" || echo "x86_64-linux-gnu")" >> /etc/environment \
-   && echo "BUN_ARCH=$([ "$TARGETARCH" = "arm64" ] && echo "aarch64" || echo "x64")" >> /etc/environment
-
-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 \
-   CFLAGS=${DEFAULT_CFLAGS} \
-   CXXFLAGS="${DEFAULT_CFLAGS} ${DEFAULT_CXXFLAGS}"
-
-RUN if [ "$TARGETARCH" = "arm64" ]; then \
-       export ARCH_PATH="aarch64-linux-gnu"; \
-   else \
-       export ARCH_PATH="x86_64-linux-gnu"; \
-   fi \
-   && mkdir -p /usr/lib/gcc/${ARCH_PATH}/13 \
-   && ln -sf /usr/lib/${ARCH_PATH}/libstdc++.so.6 /usr/lib/gcc/${ARCH_PATH}/13/ \
-   && echo "/usr/lib/gcc/${ARCH_PATH}/13" > /etc/ld.so.conf.d/gcc-13.conf \
-   && echo "/usr/lib/${ARCH_PATH}" >> /etc/ld.so.conf.d/gcc-13.conf \
-   && ldconfig
-
-RUN for f in /usr/lib/llvm-${LLVM_VERSION}/bin/*; do ln -sf "$f" /usr/bin; done \
-   && ln -sf /usr/bin/clang-${LLVM_VERSION} /usr/bin/clang \
-   && ln -sf /usr/bin/clang++-${LLVM_VERSION} /usr/bin/clang++ \
-   && ln -sf /usr/bin/lld-${LLVM_VERSION} /usr/bin/lld \
-   && ln -sf /usr/bin/lldb-${LLVM_VERSION} /usr/bin/lldb \
-   && ln -sf /usr/bin/clangd-${LLVM_VERSION} /usr/bin/clangd \
-   && ln -sf /usr/bin/llvm-ar-${LLVM_VERSION} /usr/bin/llvm-ar \
-   && ln -sf /usr/bin/ld.lld /usr/bin/ld \
-   && ln -sf /usr/bin/clang /usr/bin/cc \
-   && ln -sf /usr/bin/clang++ /usr/bin/c++
-
-ENV CC="clang" \
-   CXX="clang++" \
-   AR="llvm-ar-${LLVM_VERSION}" \
-   RANLIB="llvm-ranlib-${LLVM_VERSION}" \
-   LD="lld-${LLVM_VERSION}"
-
-RUN --mount=type=tmpfs,target=/tmp \
-   bash -c '\
-      set -euxo pipefail && \
-      source /etc/environment && \
-      echo "Downloading bun-v${OLD_BUN_VERSION}/bun-linux-$BUN_ARCH.zip from https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/bun-v${OLD_BUN_VERSION}/bun-linux-$BUN_ARCH.zip" && \
-      curl -fsSL https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/bun-v${OLD_BUN_VERSION}/bun-linux-$BUN_ARCH.zip -o /tmp/bun.zip && \
-      unzip /tmp/bun.zip -d /tmp/bun && \
-      mv /tmp/bun/*/bun /usr/bin/bun && \
-      chmod +x /usr/bin/bun'
-
-ENV LLVM_VERSION=${REPORTED_LLVM_VERSION}
-
-WORKDIR /workspace
-
-
-FROM --platform=$BUILDPLATFORM base as buildkite
-ARG BUILDKITE_AGENT_TAGS
-
-
-# Install Rust nightly
-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" && \ 
-    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 && \
-    mv /tmp/buildkite-agent/buildkite-agent /usr/bin/buildkite-agent
-
-RUN mkdir -p /var/cache/buildkite-agent /var/log/buildkite-agent /var/run/buildkite-agent /etc/buildkite-agent /var/lib/buildkite-agent/cache/bun
-
-COPY  ../*/agent.mjs /var/bun/scripts/
-
-ENV BUN_INSTALL_CACHE=/var/lib/buildkite-agent/cache/bun
-ENV BUILDKITE_AGENT_TAGS=${BUILDKITE_AGENT_TAGS}
-
-
-WORKDIR /var/bun/scripts
-
-ENV PATH=/root/.cargo/bin:$PATH
-
-
-CMD ["bun", "/var/bun/scripts/agent.mjs", "start"]
-
-FROM --platform=$BUILDPLATFORM base as bun-build-linux-local
-
-ARG LLVM_VERSION
-WORKDIR /workspace/bun
-
-COPY . /workspace/bun
-
-
-# Install Rust nightly
-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
-
-ENV PATH=/root/.cargo/bin:$PATH
-
-ENV LLVM_VERSION=${REPORTED_LLVM_VERSION}
-
-
-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

.buildkite/Dockerfile-bootstrap.sh

@@ -1,122 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# Check if running as root
-if [ "$EUID" -ne 0 ]; then
-    echo "error: must run as root"
-    exit 1
-fi
-
-# Check OS compatibility
-if ! command -v dnf &> /dev/null; then
-    echo "error: this script requires dnf (RHEL/Fedora/CentOS)"
-    exit 1
-fi
-
-# Ensure /tmp/agent.mjs, /tmp/Dockerfile are present
-if [ ! -f /tmp/agent.mjs ] || [ ! -f /tmp/Dockerfile ]; then
-    # Print each missing file
-    if [ ! -f /tmp/agent.mjs ]; then
-        echo "error: /tmp/agent.mjs is missing"
-    fi
-    if [ ! -f /tmp/Dockerfile ]; then
-        echo "error: /tmp/Dockerfile is missing"
-    fi
-    exit 1
-fi
-
-# Install Docker
-dnf update -y
-dnf install -y docker
-
-systemctl enable docker
-systemctl start docker || {
-    echo "error: failed to start Docker"
-    exit 1
-}
-
-# Create builder
-docker buildx create --name builder --driver docker-container --bootstrap --use || {
-    echo "error: failed to create Docker buildx builder"
-    exit 1
-}
-
-# Set up Docker to start on boot
-cat << 'EOF' > /etc/systemd/system/buildkite-agent.service
-[Unit]
-Description=Buildkite Docker Container
-After=docker.service network-online.target
-Requires=docker.service network-online.target
-
-[Service]
-TimeoutStartSec=0
-Restart=always
-RestartSec=5
-ExecStartPre=-/usr/bin/docker stop buildkite
-ExecStartPre=-/usr/bin/docker rm buildkite
-ExecStart=/usr/bin/docker run \
-    --name buildkite \
-    --restart=unless-stopped \
-    --network host \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    -v /tmp:/tmp \
-    buildkite:latest
-
-[Install]
-WantedBy=multi-user.target
-EOF
-
-echo "Building Buildkite image"
-
-# Clean up any previous build artifacts
-rm -rf /tmp/fakebun
-mkdir -p /tmp/fakebun/scripts /tmp/fakebun/.buildkite
-
-# Copy required files
-cp /tmp/agent.mjs /tmp/fakebun/scripts/ || {
-    echo "error: failed to copy agent.mjs"
-    exit 1
-}
-cp /tmp/Dockerfile /tmp/fakebun/.buildkite/Dockerfile || {
-    echo "error: failed to copy Dockerfile"
-    exit 1
-}
-
-cd /tmp/fakebun || {
-    echo "error: failed to change directory"
-    exit 1
-}
-
-# Build the Buildkite image
-docker buildx build \
-    --platform $(uname -m | sed 's/aarch64/linux\/arm64/;s/x86_64/linux\/amd64/') \
-    --tag buildkite:latest \
-    --target buildkite \
-    -f .buildkite/Dockerfile \
-    --load \
-    . || {
-    echo "error: Docker build failed"
-    exit 1
-}
-
-# Create container to ensure image is cached in AMI
-docker container create \
-    --name buildkite \
-    --restart=unless-stopped \
-    buildkite:latest || {
-    echo "error: failed to create buildkite container"
-    exit 1
-}
-
-# Reload systemd to pick up new service
-systemctl daemon-reload
-
-# Enable the service, but don't start it yet
-systemctl enable buildkite-agent || {
-    echo "error: failed to enable buildkite-agent service"
-    exit 1
-}
-
-echo "Bootstrap complete"
-echo "To start the Buildkite agent, run: "
-echo "  systemctl start buildkite-agent"

.buildkite/bootstrap.yml

@@ -13,4 +13,19 @@ steps:
     agents:
       queue: "build-darwin"
     command:
-      - "node .buildkite/ci.mjs"
+      - ".buildkite/scripts/prepare-build.sh"
+
+  - if: "build.branch == 'main' && !build.pull_request.repository.fork"
+    label: ":github:"
+    agents:
+      queue: "test-darwin"
+    depends_on:
+      - "darwin-aarch64-build-bun"
+      - "darwin-x64-build-bun"
+      - "linux-aarch64-build-bun"
+      - "linux-x64-build-bun"
+      - "linux-x64-baseline-build-bun"
+      - "windows-x64-build-bun"
+      - "windows-x64-baseline-build-bun"
+    command:
+      - ".buildkite/scripts/upload-release.sh"

.buildkite/scripts/prepare-build.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+set -eo pipefail
+
+function run_command() {
+  set -x
+  "$@"
+  { set +x; } 2>/dev/null
+}
+
+run_command node ".buildkite/ci.mjs"

.buildkite/scripts/upload-release.sh

@@ -3,6 +3,10 @@
 set -eo pipefail
 
 function assert_main() {
+  if [ "$RELEASE" == "1" ]; then
+    echo "info: Skipping canary release because this is a release build"
+    exit 0
+  fi
   if [ -z "$BUILDKITE_REPO" ]; then
     echo "error: Cannot find repository for this build"
     exit 1
@@ -190,18 +194,14 @@ function create_release() {
   local artifacts=(
     bun-darwin-aarch64.zip
     bun-darwin-aarch64-profile.zip
+    bun-darwin-x64.zip
+    bun-darwin-x64-profile.zip
     bun-linux-aarch64.zip
     bun-linux-aarch64-profile.zip
     bun-linux-x64.zip
     bun-linux-x64-profile.zip
     bun-linux-x64-baseline.zip
     bun-linux-x64-baseline-profile.zip
-    bun-linux-aarch64-musl.zip
-    bun-linux-aarch64-musl-profile.zip
-    bun-linux-x64-musl.zip
-    bun-linux-x64-musl-profile.zip
-    bun-linux-x64-musl-baseline.zip
-    bun-linux-x64-musl-baseline-profile.zip
     bun-windows-x64.zip
     bun-windows-x64-profile.zip
     bun-windows-x64-baseline.zip
@@ -231,7 +231,8 @@ function create_release() {
 }
 
 function assert_canary() {
-  if [ -z "$CANARY" ] || [ "$CANARY" == "0" ]; then
+  local canary="$(buildkite-agent meta-data get canary 2>/dev/null)"
+  if [ -z "$canary" ] || [ "$canary" == "0" ]; then
     echo "warn: Skipping release because this is not a canary build"
     exit 0
   fi

.clangd

@@ -3,6 +3,3 @@ Index:
 
 CompileFlags:
   CompilationDatabase: build/debug
-
-Diagnostics:
-  UnusedIncludes: None

.cursorignore

@@ -1,7 +0,0 @@
-# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
-bench
-vendor
-*-fixture.{js,ts}
-zig-cache
-packages/bun-uws/fuzzing
-build

.dockerignore

@@ -16,6 +16,3 @@ zig-out
 build
 vendor
 node_modules
-*.trace
-
-packages/bun-uws/fuzzing

.github/workflows/lint.yml

@@ -1,26 +0,0 @@
-name: Lint
-
-on:
-  pull_request:
-  workflow_dispatch:
-
-env:
-  BUN_VERSION: "1.1.38"
-  OXLINT_VERSION: "0.15.0"
-
-jobs:
-  lint-js:
-    name: "Lint JavaScript"
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup Bun
-        uses: ./.github/actions/setup-bun
-        with:
-          bun-version: ${{ env.BUN_VERSION }}
-      - name: Lint
-        run: bunx oxlint --config oxlint.json --quiet --format github
-
-
-
-

.github/workflows/typos.yml

@@ -1,19 +0,0 @@
-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

@@ -1,92 +0,0 @@
-name: Update c-ares
-
-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 c-ares 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/BuildCares.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildCares.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 BuildCares.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/c-ares/c-ares/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_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"
-            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/BuildCares.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildCares.cmake
-          commit-message: "deps: update c-ares to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update c-ares to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-cares-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates c-ares to version ${{ steps.check-version.outputs.tag }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-cares.yml)

.github/workflows/update-libarchive.yml

@@ -1,92 +0,0 @@
-name: Update libarchive
-
-on:
-  schedule:
-    - cron: "0 3 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check libarchive 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/BuildLibArchive.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildLibArchive.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 BuildLibArchive.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/libarchive/libarchive/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_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"
-            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/BuildLibArchive.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildLibArchive.cmake
-          commit-message: "deps: update libarchive to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update libarchive to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-libarchive-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates libarchive to version ${{ steps.check-version.outputs.tag }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-libarchive.yml)

.github/workflows/update-libdeflate.yml

@@ -1,92 +0,0 @@
-name: Update libdeflate
-
-on:
-  schedule:
-    - cron: "0 2 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check libdeflate 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/BuildLibDeflate.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildLibDeflate.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 BuildLibDeflate.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/ebiggers/libdeflate/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_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"
-            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/BuildLibDeflate.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildLibDeflate.cmake
-          commit-message: "deps: update libdeflate to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update libdeflate to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-libdeflate-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates libdeflate to version ${{ steps.check-version.outputs.tag }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-libdeflate.yml)

.github/workflows/update-lolhtml.yml

@@ -1,92 +0,0 @@
-name: Update lolhtml
-
-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 lolhtml 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/BuildLolHtml.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildLolHtml.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 BuildLolHtml.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/cloudflare/lol-html/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_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 ! [[ $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/BuildLolHtml.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildLolHtml.cmake
-          commit-message: "deps: update lolhtml to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update lolhtml to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-lolhtml-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates lolhtml to version ${{ steps.check-version.outputs.tag }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-lolhtml.yml)

.github/workflows/update-lshpack.yml

@@ -1,92 +0,0 @@
-name: Update lshpack
-
-on:
-  schedule:
-    - cron: "0 5 * * 0"
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check lshpack 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/BuildLshpack.cmake)
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "Error: Could not find COMMIT line in BuildLshpack.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 BuildLshpack.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/litespeedtech/ls-hpack/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_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 ! [[ $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/BuildLshpack.cmake
-
-      - name: Create Pull Request
-        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
-        uses: peter-evans/create-pull-request@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            cmake/targets/BuildLshpack.cmake
-          commit-message: "deps: update lshpack to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
-          title: "deps: update lshpack to ${{ steps.check-version.outputs.tag }}"
-          delete-branch: true
-          branch: deps/update-lshpack-${{ github.run_number }}
-          body: |
-            ## What does this PR do?
-
-            Updates lshpack to version ${{ steps.check-version.outputs.tag }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-lshpack.yml)

.github/workflows/update-sqlite3.yml

@@ -1,109 +0,0 @@
-name: Update SQLite3
-
-on:
-  schedule:
-    - cron: "0 6 * * 0" # Run weekly
-  workflow_dispatch:
-
-jobs:
-  check-update:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Check SQLite version
-        id: check-version
-        run: |
-          set -euo pipefail
-
-          # Get current version from the header file using SQLITE_VERSION_NUMBER
-          CURRENT_VERSION_NUM=$(grep -o '#define SQLITE_VERSION_NUMBER [0-9]\+' src/bun.js/bindings/sqlite/sqlite3_local.h | awk '{print $3}' | tr -d '\n\r')
-          if [ -z "$CURRENT_VERSION_NUM" ]; then
-            echo "Error: Could not find SQLITE_VERSION_NUMBER in sqlite3_local.h"
-            exit 1
-          fi
-
-          # Convert numeric version to semantic version for display
-          CURRENT_MAJOR=$((CURRENT_VERSION_NUM / 1000000))
-          CURRENT_MINOR=$((($CURRENT_VERSION_NUM / 1000) % 1000))
-          CURRENT_PATCH=$((CURRENT_VERSION_NUM % 1000))
-          CURRENT_VERSION="$CURRENT_MAJOR.$CURRENT_MINOR.$CURRENT_PATCH"
-
-          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-          echo "current_num=$CURRENT_VERSION_NUM" >> $GITHUB_OUTPUT
-
-          # Fetch SQLite download page
-          DOWNLOAD_PAGE=$(curl -sL https://sqlite.org/download.html)
-          if [ -z "$DOWNLOAD_PAGE" ]; then
-            echo "Error: Failed to fetch SQLite download page"
-            exit 1
-          fi
-
-          # Extract latest version and year from the amalgamation link
-          LATEST_INFO=$(echo "$DOWNLOAD_PAGE" | grep -o 'sqlite-amalgamation-[0-9]\{7\}.zip' | head -n1)
-          LATEST_YEAR=$(echo "$DOWNLOAD_PAGE" | grep -o '[0-9]\{4\}/sqlite-amalgamation-[0-9]\{7\}.zip' | head -n1 | cut -d'/' -f1 | tr -d '\n\r')
-          LATEST_VERSION_NUM=$(echo "$LATEST_INFO" | grep -o '[0-9]\{7\}' | tr -d '\n\r')
-
-          if [ -z "$LATEST_VERSION_NUM" ] || [ -z "$LATEST_YEAR" ]; then
-            echo "Error: Could not extract latest version info"
-            exit 1
-          fi
-
-          # Convert numeric version to semantic version for display
-          LATEST_MAJOR=$((10#$LATEST_VERSION_NUM / 1000000))
-          LATEST_MINOR=$((($LATEST_VERSION_NUM / 1000) % 1000))
-          LATEST_PATCH=$((10#$LATEST_VERSION_NUM % 1000))
-          LATEST_VERSION="$LATEST_MAJOR.$LATEST_MINOR.$LATEST_PATCH"
-
-          echo "latest=$LATEST_VERSION" >> $GITHUB_OUTPUT
-          echo "latest_year=$LATEST_YEAR" >> $GITHUB_OUTPUT
-          echo "latest_num=$LATEST_VERSION_NUM" >> $GITHUB_OUTPUT
-
-          # Debug output
-          echo "Current version: $CURRENT_VERSION ($CURRENT_VERSION_NUM)"
-          echo "Latest version: $LATEST_VERSION ($LATEST_VERSION_NUM)"
-
-      - name: Update SQLite if needed
-        if: success() && steps.check-version.outputs.current_num < steps.check-version.outputs.latest_num
-        run: |
-          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@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          add-paths: |
-            src/bun.js/bindings/sqlite/sqlite3.c
-            src/bun.js/bindings/sqlite/sqlite3_local.h
-          commit-message: "deps: update sqlite to ${{ steps.check-version.outputs.latest }}"
-          title: "deps: update sqlite to ${{ steps.check-version.outputs.latest }}"
-          delete-branch: true
-          branch: deps/update-sqlite-${{ steps.check-version.outputs.latest }}
-          body: |
-            ## What does this PR do?
-
-            Updates SQLite to version ${{ steps.check-version.outputs.latest }}
-
-            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-sqlite3.yml)

.gitignore

@@ -26,7 +26,6 @@
 *.db
 *.dmg
 *.dSYM
-*.generated.ts
 *.jsb
 *.lib
 *.log
@@ -54,8 +53,8 @@
 /test-report.md
 /test.js
 /test.ts
-/test.zig
 /testdir
+/test.zig
 build
 build.ninja
 bun-binary
@@ -112,14 +111,10 @@ pnpm-lock.yaml
 profile.json
 README.md.template
 release/
-scripts/env.local
 sign.*.json
 sign.json
-src/bake/generated.ts
-src/generated_enum_extractor.zig
 src/bun.js/bindings-obj
 src/bun.js/bindings/GeneratedJS2Native.zig
-src/bun.js/bindings/GeneratedBindings.zig
 src/bun.js/debug-bindings-obj
 src/deps/zig-clap/.gitattributes
 src/deps/zig-clap/.github
@@ -136,7 +131,6 @@ src/runtime.version
 src/tests.zig
 test.txt
 test/js/bun/glob/fixtures
-test/node.js/upstream
 tsconfig.tsbuildinfo
 txt.js
 x64
@@ -148,9 +142,6 @@ test/node.js/upstream
 scripts/env.local
 *.generated.ts
 src/bake/generated.ts
-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
 
 # Dependencies
 /vendor
@@ -158,24 +149,22 @@ test/js/third_party/prisma/prisma/sqlite/dev.db-journal
 # Dependencies (before CMake)
 # These can be removed in the far future
 /src/bun.js/WebKit
+/src/deps/WebKit
 /src/deps/boringssl
 /src/deps/brotli
 /src/deps/c*ares
+/src/deps/lol*html
 /src/deps/libarchive
 /src/deps/libdeflate
 /src/deps/libuv
-/src/deps/lol*html
 /src/deps/ls*hpack
 /src/deps/mimalloc
 /src/deps/picohttpparser
 /src/deps/tinycc
-/src/deps/WebKit
-/src/deps/zig
-/src/deps/zlib
 /src/deps/zstd
+/src/deps/zlib
+/src/deps/zig
 
 # Generated files
 
 .buildkite/ci.yml
-*.sock
-scratch*.{js,ts,tsx,cjs,mjs}

.lldbinit

@@ -1,4 +1,4 @@
-# command script import vendor/zig/tools/lldb_pretty_printers.py
+command script import vendor/zig/tools/lldb_pretty_printers.py
 command script import vendor/WebKit/Tools/lldb/lldb_webkit.py
 
 # type summary add --summary-string "${var} | inner=${var[0-30]}, source=${var[33-64]}, tag=${var[31-32]}" "unsigned long"

.mailmap

@@ -1,2 +0,0 @@
-# To learn more about git's mailmap: https://ntietz.com/blog/git-mailmap-for-name-changes
-chloe caruso <git@paperclover.net> <me@paperdave.net>

.prettierignore

@@ -5,5 +5,6 @@ test/js/deno
 test/node.js
 src/react-refresh.js
 *.min.js
+test/js/node/test/fixtures
+test/js/node/test/common
 test/snippets
-test/js/node/test

.typos.toml

@@ -1,2 +0,0 @@
-[type.md]
-extend-ignore-words-re = ["^ba"]

.vscode/launch.json

@@ -16,13 +16,14 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "1",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -32,13 +33,14 @@
       "args": ["test", "--only", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "1",
         "BUN_DEBUG_jest": "1",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -54,13 +56,14 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -70,13 +73,14 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "0",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -86,13 +90,14 @@
       "args": ["test", "--watch", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -102,13 +107,14 @@
       "args": ["test", "--hot", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -118,6 +124,7 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
@@ -125,7 +132,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -140,6 +147,7 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
@@ -147,7 +155,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -169,7 +177,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -179,6 +187,7 @@
       "args": ["run", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
         "BUN_DEBUG_IncrementalGraph": "1",
@@ -188,7 +197,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -198,12 +207,13 @@
       "args": ["run", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "0",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -213,15 +223,13 @@
       "args": ["run", "--watch", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "env": {
-        // "BUN_DEBUG_DEBUGGER": "1",
-        // "BUN_DEBUG_INTERNAL_DEBUGGER": "1",
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
-        // "BUN_INSPECT": "ws+unix:///var/folders/jk/8fzl9l5119598vsqrmphsw7m0000gn/T/tl15npi7qtf.sock?report=1",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -231,12 +239,13 @@
       "args": ["run", "--hot", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -253,7 +262,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -275,7 +284,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -291,13 +300,14 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -307,13 +317,14 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -323,13 +334,14 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -339,13 +351,14 @@
       "args": ["test", "--watch", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -355,13 +368,14 @@
       "args": ["test", "--hot", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -371,6 +385,7 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
@@ -378,7 +393,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -393,6 +408,7 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_DEBUG_jest": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
@@ -400,7 +416,7 @@
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -416,12 +432,13 @@
       "args": ["exec", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     // bun test [*]
     {
@@ -432,12 +449,13 @@
       "args": ["test"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -447,12 +465,13 @@
       "args": ["test"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -462,13 +481,14 @@
       "args": ["test"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
         "BUN_INSPECT": "ws://localhost:0/",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -483,12 +503,13 @@
       "args": ["install"],
       "cwd": "${fileDirname}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     {
       "type": "lldb",
@@ -498,12 +519,13 @@
       "args": ["test/runner.node.mjs"],
       "cwd": "${workspaceFolder}",
       "env": {
+        "FORCE_COLOR": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
     // Windows: bun test [file]
     {
@@ -517,6 +539,10 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -542,6 +568,10 @@
       "args": ["test", "--only", "${file}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -567,6 +597,10 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -592,6 +626,10 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "0",
@@ -617,6 +655,10 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -651,6 +693,10 @@
       "args": ["test", "${file}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -686,6 +732,10 @@
       "args": ["run", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -711,6 +761,10 @@
       "args": ["install"],
       "cwd": "${fileDirname}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -732,6 +786,10 @@
       "args": ["run", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -753,6 +811,10 @@
       "args": ["run", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -783,6 +845,10 @@
       "args": ["run", "${fileBasename}"],
       "cwd": "${fileDirname}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -814,6 +880,10 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -839,6 +909,10 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -864,6 +938,10 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "0",
@@ -889,6 +967,10 @@
       "args": ["test", "--watch", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -914,6 +996,10 @@
       "args": ["test", "--hot", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -939,6 +1025,10 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -973,6 +1063,10 @@
       "args": ["test", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -1008,6 +1102,10 @@
       "args": ["exec", "${input:testName}"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -1030,6 +1128,10 @@
       "args": ["test"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -1051,6 +1153,10 @@
       "args": ["test"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -1076,6 +1182,10 @@
       "args": ["test"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -1110,6 +1220,10 @@
       "args": ["test/runner.node.mjs"],
       "cwd": "${workspaceFolder}",
       "environment": [
+        {
+          "name": "FORCE_COLOR",
+          "value": "1",
+        },
         {
           "name": "BUN_DEBUG_QUIET_LOGS",
           "value": "1",
@@ -1125,7 +1239,7 @@
       ],
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "postRunCommands": ["process handle -p true -s false -n false SIGUSR1"],
     },
   ],
   "inputs": [

.vscode/settings.json

@@ -63,6 +63,7 @@
     "editor.tabSize": 4,
     "editor.defaultFormatter": "xaver.clang-format",
   },
+  "clangd.arguments": ["-header-insertion=never"],
 
   // JavaScript
   "prettier.enable": true,
@@ -77,7 +78,7 @@
   "prettier.prettierPath": "./node_modules/prettier",
 
   // TypeScript
-  "typescript.tsdk": "node_modules/typescript/lib",
+  "typescript.tsdk": "${workspaceFolder}/node_modules/typescript/lib",
   "[typescript]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode",
   },

.vscode/tasks.json

@@ -2,57 +2,50 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "Build Bun",
-      "type": "shell",
-      "command": "bun run build",
-      "group": {
-        "kind": "build",
-        "isDefault": true,
+      "type": "process",
+      "label": "Install Dependencies",
+      "command": "scripts/all-dependencies.sh",
+      "windows": {
+        "command": "scripts/all-dependencies.ps1",
       },
-      "problemMatcher": [
-        {
-          "owner": "zig",
-          "fileLocation": ["relative", "${workspaceFolder}"],
-          "pattern": [
-            {
-              "regexp": "^(.+?):(\\d+):(\\d+): (error|warning|note): (.+)$",
-              "file": 1,
-              "line": 2,
-              "column": 3,
-              "severity": 4,
-              "message": 5,
-            },
-            {
-              "regexp": "^\\s+(.+)$",
-              "message": 1,
-              "loop": true,
-            },
-          ],
-        },
-        {
-          "owner": "clang",
-          "fileLocation": ["relative", "${workspaceFolder}"],
-          "pattern": [
-            {
-              "regexp": "^([^:]+):(\\d+):(\\d+):\\s+(warning|error|note|remark):\\s+(.*)$",
-              "file": 1,
-              "line": 2,
-              "column": 3,
-              "severity": 4,
-              "message": 5,
-            },
-            {
-              "regexp": "^\\s*(.*)$",
-              "message": 1,
-              "loop": true,
-            },
-          ],
-        },
-      ],
-      "presentation": {
-        "reveal": "always",
-        "panel": "shared",
-        "clear": true,
+      "icon": {
+        "id": "arrow-down",
+      },
+      "options": {
+        "cwd": "${workspaceFolder}",
+      },
+    },
+    {
+      "type": "process",
+      "label": "Setup Environment",
+      "dependsOn": ["Install Dependencies"],
+      "command": "scripts/setup.sh",
+      "windows": {
+        "command": "scripts/setup.ps1",
+      },
+      "icon": {
+        "id": "check",
+      },
+      "options": {
+        "cwd": "${workspaceFolder}",
+      },
+    },
+    {
+      "type": "process",
+      "label": "Build Bun",
+      "dependsOn": ["Setup Environment"],
+      "command": "bun",
+      "args": ["run", "build"],
+      "icon": {
+        "id": "gear",
+      },
+      "options": {
+        "cwd": "${workspaceFolder}",
+      },
+      "isBuildCommand": true,
+      "runOptions": {
+        "instanceLimit": 1,
+        "reevaluateOnRerun": true,
       },
     },
   ],

CONTRIBUTING.md

@@ -1,12 +1,17 @@
 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.sh/docs/project/building-windows)
+If you are using Windows, please refer to [this guide](/docs/project/building-windows)
+
+{% details summary="For Ubuntu users" %}
+TL;DR: Ubuntu 22.04 is suggested.
+Bun currently requires `glibc >=2.32` in development which means if you're on Ubuntu 20.04 (glibc == 2.31), you may likely meet `error: undefined symbol: __libc_single_threaded `. You need to take extra configurations. Also, according to this [issue](https://github.com/llvm/llvm-project/issues/97314), LLVM 16 is no longer maintained on Ubuntu 24.04 (noble). And instead, you might want `brew` to install LLVM 16 for your Ubuntu 24.04.
+{% /details %}
 
 ## Install Dependencies
 
 Using your system's package manager, install Bun's dependencies:
 
-{% codetabs group="os" %}
+{% codetabs %}
 
 ```bash#macOS (Homebrew)
 $ brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby
@@ -53,9 +58,9 @@ $ brew install bun
 
 ## Install LLVM
 
-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:
+Bun requires LLVM 16 (`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" %}
+{% codetabs %}
 
 ```bash#macOS (Homebrew)
 $ brew install llvm@18
@@ -63,7 +68,7 @@ $ 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 -- 18 all
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 16 all
 ```
 
 ```bash#Arch
@@ -71,36 +76,38 @@ $ sudo pacman -S llvm clang lld
 ```
 
 ```bash#Fedora
-$ sudo dnf install llvm18 clang18 lld18-devel
+$ sudo dnf install 'dnf-command(copr)'
+$ sudo dnf copr enable -y @fedora-llvm-team/llvm17
+$ sudo dnf install llvm16 clang16 lld16-devel
 ```
 
 ```bash#openSUSE Tumbleweed
-$ sudo zypper install clang18 lld18 llvm18
+$ sudo zypper install clang16 lld16 llvm16
 ```
 
 {% /codetabs %}
 
-If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8).
+If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-16.0.6).
 
-Make sure Clang/LLVM 18 is in your path:
+Make sure Clang/LLVM 16 is in your path:
 
 ```bash
-$ which clang-18
+$ which clang-16
 ```
 
 If not, run this to manually add it:
 
-{% codetabs group="os" %}
+{% codetabs %}
 
 ```bash#macOS (Homebrew)
 # use fish_add_path if you're using fish
-# use path+="$(brew --prefix llvm@18)/bin" if you are using zsh
-$ export PATH="$(brew --prefix llvm@18)/bin:$PATH"
+# use path+="$(brew --prefix llvm@16)/bin" if you are using zsh
+$ export PATH="$(brew --prefix llvm@16)/bin:$PATH"
 ```
 
 ```bash#Arch
 # use fish_add_path if you're using fish
-$ export PATH="$PATH:/usr/lib/llvm18/bin"
+$ export PATH="$PATH:/usr/lib/llvm16/bin"
 ```
 
 {% /codetabs %}
@@ -161,7 +168,7 @@ The binary will be located at `./build/release/bun` and `./build/release/bun-pro
 
 ### Download release build from pull requests
 
-To save you time spent building a release build locally, we provide a way to run release builds from pull requests. This is useful for manually testing changes in a release build before they are merged.
+To save you time spent building a release build locally, we provide a way to run release builds from pull requests. This is useful for manully testing changes in a release build before they are merged.
 
 To run a release build from a pull request, you can use the `bun-pr` npm package:
 
@@ -207,7 +214,7 @@ $ git clone https://github.com/oven-sh/WebKit vendor/WebKit
 
 # Make a debug build of JSC. This will output build artifacts in ./vendor/WebKit/WebKitBuild/Debug
 # Optionally, you can use `make jsc` for a release build
-$ make jsc-debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
+$ make jsc-debug
 
 # Build bun with the local JSC build
 $ bun run build:local
@@ -238,7 +245,7 @@ The issue may manifest when initially running `bun setup` as Clang being unable
 ```
 The C++ compiler
 
-  "/usr/bin/clang++-18"
+  "/usr/bin/clang++-16"
 
 is not able to compile a simple test program.
 ```

LATEST

@@ -1 +1 @@
-1.1.43
+1.1.34

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

@@ -1,7 +1,7 @@
 import ReactDOM from "react-dom";
 import { Main } from "./main";
 
-const Base = () => {
+const Base = ({}) => {
   const name = typeof location !== "undefined" ? decodeURIComponent(location.search.substring(1)) : null;
   return <Main productName={name} />;
 };

bench/package.json

@@ -13,7 +13,7 @@
     "execa": "^8.0.1",
     "fast-glob": "3.3.1",
     "fdir": "^6.1.0",
-    "mitata": "^1.0.25",
+    "mitata": "^1.0.10",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "string-width": "7.1.0",

bench/snippets/byteLength.mjs

@@ -1,27 +0,0 @@
-import { Buffer } from "node:buffer";
-import { bench, run } from "../runner.mjs";
-
-const variations = [
-  ["latin1", "hello world"],
-  ["utf16", "hello emoji 🤔"],
-];
-
-for (const [label, string] of variations) {
-  const big = Buffer.alloc(1000000, string).toString();
-  const small = Buffer.from(string).toString();
-  const substring = big.slice(0, big.length - 2);
-
-  bench(`${substring.length}`, () => {
-    return Buffer.byteLength(substring, "utf8");
-  });
-
-  bench(`${small.length}`, () => {
-    return Buffer.byteLength(small);
-  });
-
-  bench(`${big.length}`, () => {
-    return Buffer.byteLength(big);
-  });
-}
-
-await run();

bench/snippets/native-overhead.mjs

@@ -1,14 +1,20 @@
-import { noOpForTesting as noop } from "bun:internal-for-testing";
 import { bench, run } from "../runner.mjs";
 
 // These are no-op C++ functions that are exported to JS.
+const lazy = globalThis[Symbol.for("Bun.lazy")];
+const noop = lazy("noop");
 const fn = noop.function;
+const regular = noop.functionRegular;
 const callback = noop.callback;
 
 bench("C++ callback into JS", () => {
   callback(() => {});
 });
 
+bench("C++ fn regular", () => {
+  regular();
+});
+
 bench("C++ fn", () => {
   fn();
 });

bench/snippets/node-zlib-brotli.mjs

@@ -1,37 +0,0 @@
-import { bench, run } from "../runner.mjs";
-import { brotliCompress, brotliDecompress, createBrotliCompress, createBrotliDecompress } from "node:zlib";
-import { promisify } from "node:util";
-import { pipeline } from "node:stream/promises";
-import { Readable } from "node:stream";
-import { readFileSync } from "node:fs";
-
-const brotliCompressAsync = promisify(brotliCompress);
-const brotliDecompressAsync = promisify(brotliDecompress);
-
-const testData =
-  process.argv.length > 2
-    ? readFileSync(process.argv[2])
-    : Buffer.alloc(1024 * 1024 * 16, "abcdefghijklmnopqrstuvwxyz");
-let compressed;
-
-bench("brotli compress", async () => {
-  compressed = await brotliCompressAsync(testData);
-});
-
-bench("brotli decompress", async () => {
-  await brotliDecompressAsync(compressed);
-});
-
-bench("brotli compress stream", async () => {
-  const source = Readable.from([testData]);
-  const compress = createBrotliCompress();
-  await pipeline(source, compress);
-});
-
-bench("brotli decompress stream", async () => {
-  const source = Readable.from([compressed]);
-  const decompress = createBrotliDecompress();
-  await pipeline(source, decompress);
-});
-
-await run();

bench/snippets/urlsearchparams.mjs

@@ -10,6 +10,7 @@ bench("new URLSearchParams(obj)", () => {
     "Content-Length": "123",
     "User-Agent": "node-fetch/1.0",
     "Accept-Encoding": "gzip,deflate",
+    "Content-Length": "0",
     "Content-Range": "bytes 0-9/10",
   });
 });

bench/snippets/zlib.mjs

@@ -1,62 +0,0 @@
-import { bench, run } from "../runner.mjs";
-import zlib from "node:zlib";
-import { promisify } from "node:util";
-
-const deflate = promisify(zlib.deflate);
-const inflate = promisify(zlib.inflate);
-
-const short = "Hello World!";
-const long = "Hello World!".repeat(1024);
-const veryLong = "Hello World!".repeat(10240);
-
-// Pre-compress some data for decompression tests
-const shortBuf = Buffer.from(short);
-const longBuf = Buffer.from(long);
-const veryLongBuf = Buffer.from(veryLong);
-
-let [shortCompressed, longCompressed, veryLongCompressed] = await Promise.all([
-  deflate(shortBuf, { level: 6 }),
-  deflate(longBuf, { level: 6 }),
-  deflate(veryLongBuf, { level: 6 }),
-]);
-
-const format = new Intl.NumberFormat("en-US", { notation: "compact", unit: "byte" });
-// Compression tests at different levels
-bench(`deflate ${format.format(short.length)}B (level 1)`, async () => {
-  await deflate(shortBuf, { level: 1 });
-});
-
-bench(`deflate ${format.format(short.length)} (level 6)`, async () => {
-  await deflate(shortBuf, { level: 6 });
-});
-
-bench(`deflate ${format.format(long.length)} (level 1)`, async () => {
-  await deflate(longBuf, { level: 1 });
-});
-
-bench(`deflate ${format.format(long.length)} (level 6)`, async () => {
-  await deflate(longBuf, { level: 6 });
-});
-
-bench(`deflate ${format.format(veryLong.length)} (level 1)`, async () => {
-  await deflate(veryLongBuf, { level: 1 });
-});
-
-bench(`deflate ${format.format(veryLong.length)} (level 6)`, async () => {
-  await deflate(veryLongBuf, { level: 6 });
-});
-
-// Decompression tests
-bench(`inflate ${format.format(short.length)}`, async () => {
-  await inflate(shortCompressed);
-});
-
-bench(`inflate ${format.format(long.length)}`, async () => {
-  await inflate(longCompressed);
-});
-
-bench(`inflate ${format.format(veryLong.length)}`, async () => {
-  await inflate(veryLongCompressed);
-});
-
-await run();

build.zig

@@ -327,25 +327,6 @@ pub fn build(b: *Build) !void {
             .{ .os = .windows, .arch = .x86_64 },
         });
     }
-
-    // zig build translate-c-headers
-    {
-        const step = b.step("translate-c", "Copy generated translated-c-headers.zig to zig-out");
-        step.dependOn(&b.addInstallFile(getTranslateC(b, b.host, .Debug).getOutput(), "translated-c-headers.zig").step);
-    }
-
-    // zig build enum-extractor
-    {
-        // const step = b.step("enum-extractor", "Extract enum definitions (invoked by a code generator)");
-        // const exe = b.addExecutable(.{
-        //     .name = "enum_extractor",
-        //     .root_source_file = b.path("./src/generated_enum_extractor.zig"),
-        //     .target = b.graph.host,
-        //     .optimize = .Debug,
-        // });
-        // const run = b.addRunArtifact(exe);
-        // step.dependOn(&run.step);
-    }
 }
 
 pub fn addMultiCheck(
@@ -386,25 +367,6 @@ pub fn addMultiCheck(
     }
 }
 
-fn getTranslateC(b: *Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *Step.TranslateC {
-    const translate_c = b.addTranslateC(.{
-        .root_source_file = b.path("src/c-headers-for-zig.h"),
-        .target = target,
-        .optimize = optimize,
-        .link_libc = true,
-    });
-    inline for ([_](struct { []const u8, bool }){
-        .{ "WINDOWS", translate_c.target.result.os.tag == .windows },
-        .{ "POSIX", translate_c.target.result.os.tag != .windows },
-        .{ "LINUX", translate_c.target.result.os.tag == .linux },
-        .{ "DARWIN", translate_c.target.result.os.tag.isDarwin() },
-    }) |entry| {
-        const str, const value = entry;
-        translate_c.defineCMacroRaw(b.fmt("{s}={d}", .{ str, @intFromBool(value) }));
-    }
-    return translate_c;
-}
-
 pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
     const obj = b.addObject(.{
         .name = if (opts.optimize == .Debug) "bun-debug" else "bun",
@@ -452,10 +414,6 @@ pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
     }
     addInternalPackages(b, obj, opts);
     obj.root_module.addImport("build_options", opts.buildOptionsModule(b));
-
-    const translate_c = getTranslateC(b, opts.target, opts.optimize);
-    obj.root_module.addImport("translated-c-headers", translate_c.createModule());
-
     return obj;
 }
 
@@ -470,11 +428,6 @@ pub fn addInstallObjectFile(
     name: []const u8,
     out_mode: ObjectFormat,
 ) *Step {
-    if (@import("builtin").os.tag != .windows and std.posix.getenvZ("COMPILE_ERRORS_ONLY") != null) {
-        const failstep = b.addSystemCommand(&.{"COMPILE_ERRORS_ONLY set but there were no compile errors"});
-        failstep.step.dependOn(&compile.step);
-        return &failstep.step;
-    }
     // bin always needed to be computed or else the compilation will do nothing. zig build system bug?
     const bin = compile.getEmittedBin();
     return &b.addInstallFile(switch (out_mode) {

bunfig.node-test.toml

@@ -1,4 +0,0 @@
-# FIXME: move this back to test/js/node
-# https://github.com/oven-sh/bun/issues/16289
-[test]
-preload = ["./test/js/node/harness.ts", "./test/preload.ts"]

ci/linux/Dockerfile

@@ -1,18 +0,0 @@
-ARG IMAGE=debian:11
-FROM $IMAGE
-COPY ./scripts/bootstrap.sh /tmp/bootstrap.sh
-ENV CI=true
-RUN sh /tmp/bootstrap.sh && rm -rf /tmp/*
-WORKDIR /workspace/bun
-COPY bunfig.toml bunfig.toml
-COPY package.json package.json
-COPY CMakeLists.txt CMakeLists.txt
-COPY cmake/ cmake/
-COPY scripts/ scripts/
-COPY patches/ patches/
-COPY *.zig ./
-COPY src/ src/
-COPY packages/ packages/
-COPY test/ test/
-RUN bun i
-RUN bun run build:ci

ci/linux/scripts/set-hostname.sh

@@ -1,27 +0,0 @@
-#!/bin/sh
-
-# This script sets the hostname of the current machine.
-
-execute() {
-  echo "$ $@" >&2
-  if ! "$@"; then
-    echo "Command failed: $@" >&2
-    exit 1
-  fi
-}
-
-main() {
-  if [ "$#" -ne 1 ]; then
-    echo "Usage: $0 <hostname>" >&2
-    exit 1
-  fi
-
-  if [ -f "$(which hostnamectl)" ]; then
-    execute hostnamectl set-hostname "$1"
-  else
-    echo "Error: hostnamectl is not installed." >&2
-    exit 1
-  fi
-}
-
-main "$@"

ci/linux/scripts/start-tailscale.sh

@@ -1,22 +0,0 @@
-#!/bin/sh
-
-# This script starts tailscale on the current machine.
-
-execute() {
-  echo "$ $@" >&2
-  if ! "$@"; then
-    echo "Command failed: $@" >&2
-    exit 1
-  fi
-}
-
-main() {
-  if [ "$#" -ne 1 ]; then
-    echo "Usage: $0 <auth-key>" >&2
-    exit 1
-  fi
-
-  execute tailscale up --reset --ssh --accept-risk=lose-ssh --auth-key="$1"
-}
-
-main "$@"

ci/package.json

@@ -2,7 +2,7 @@
   "private": true,
   "scripts": {
     "bootstrap": "brew install gh jq cirruslabs/cli/tart cirruslabs/cli/sshpass hashicorp/tap/packer && packer init darwin",
-    "login": "token=$(gh auth token); username=$(gh api user --jq .login); echo \"Login as $username...\"; echo \"$token\" | tart login ghcr.io --username \"$username\" --password-stdin; echo \"$token\" | docker login ghcr.io --username \"$username\" --password-stdin",
+    "login": "gh auth token | tart login ghcr.io --username $(gh api user --jq .login) --password-stdin",
     "fetch:image-name": "echo ghcr.io/oven-sh/bun-vm",
     "fetch:darwin-version": "echo 1",
     "fetch:macos-version": "sw_vers -productVersion | cut -d. -f1",

cmake/CompilerFlags.cmake

@@ -176,10 +176,6 @@ if(LINUX)
     DESCRIPTION "Disable relocation read-only (RELRO)"
     -Wl,-z,norelro
   )
-  register_compiler_flags(
-    DESCRIPTION "Disable semantic interposition"
-    -fno-semantic-interposition
-  )
 endif()
 
 # --- Assertions ---

cmake/Globals.cmake

@@ -105,6 +105,14 @@ else()
   unsupported(CMAKE_HOST_SYSTEM_NAME)
 endif()
 
+if(EXISTS "/lib/ld-musl-aarch64.so.1")
+  set(IS_MUSL ON)
+elseif(EXISTS "/lib/ld-musl-x86_64.so.1")
+  set(IS_MUSL ON)
+else()
+  set(IS_MUSL OFF)
+endif()
+
 if(CMAKE_HOST_SYSTEM_PROCESSOR MATCHES "arm64|ARM64|aarch64|AARCH64")
   set(HOST_OS "aarch64")
 elseif(CMAKE_HOST_SYSTEM_PROCESSOR MATCHES "x86_64|X86_64|x64|X64|amd64|AMD64")
@@ -291,7 +299,7 @@ function(find_command)
       set_property(GLOBAL PROPERTY ${FIND_NAME} "${exe}: ${reason}" APPEND)
 
       if(version)
-        satisfies_range(${version} ${FIND_VERSION} ${variable})
+        satisfies_range(${version} ${${FIND_VERSION_VARIABLE}} ${variable})
         set(${variable} ${${variable}} PARENT_SCOPE)
       endif()
     endfunction()

cmake/Options.cmake

@@ -10,6 +10,7 @@ optionx(GITHUB_ACTIONS BOOL "If GitHub Actions is enabled" DEFAULT OFF)
 
 if(BUILDKITE)
   optionx(BUILDKITE_COMMIT STRING "The commit hash")
+  optionx(BUILDKITE_MESSAGE STRING "The commit message")
 endif()
 
 optionx(CMAKE_BUILD_TYPE "Debug|Release|RelWithDebInfo|MinSizeRel" "The build type to use" REQUIRED)
@@ -20,7 +21,7 @@ else()
   setx(RELEASE OFF)
 endif()
 
-if(CMAKE_BUILD_TYPE MATCHES "Debug")
+if(CMAKE_BUILD_TYPE MATCHES "Debug|RelWithDebInfo")
   setx(DEBUG ON)
 else()
   setx(DEBUG OFF)
@@ -48,16 +49,6 @@ else()
   message(FATAL_ERROR "Unsupported architecture: ${CMAKE_SYSTEM_PROCESSOR}")
 endif()
 
-if(LINUX)
-  if(EXISTS "/etc/alpine-release")
-    set(DEFAULT_ABI "musl")
-  else()
-    set(DEFAULT_ABI "gnu")
-  endif()
-
-  optionx(ABI "musl|gnu" "The ABI to use (e.g. musl, gnu)" DEFAULT ${DEFAULT_ABI})
-endif()
-
 if(ARCH STREQUAL "x64")
   optionx(ENABLE_BASELINE BOOL "If baseline features should be used for older CPUs (e.g. disables AVX, AVX2)" DEFAULT OFF)
 endif()
@@ -65,9 +56,22 @@ endif()
 optionx(ENABLE_LOGS BOOL "If debug logs should be enabled" DEFAULT ${DEBUG})
 optionx(ENABLE_ASSERTIONS BOOL "If debug assertions should be enabled" DEFAULT ${DEBUG})
 
-optionx(ENABLE_CANARY BOOL "If canary features should be enabled" DEFAULT ON)
+if(BUILDKITE_MESSAGE AND BUILDKITE_MESSAGE MATCHES "\\[release build\\]")
+  message(STATUS "Switched to release build, since commit message contains: \"[release build]\"")
+  set(DEFAULT_CANARY OFF)
+else()
+  set(DEFAULT_CANARY ON)
+endif()
 
-if(ENABLE_CANARY)
+optionx(ENABLE_CANARY BOOL "If canary features should be enabled" DEFAULT ${DEFAULT_CANARY})
+
+if(ENABLE_CANARY AND BUILDKITE)
+  execute_process(
+    COMMAND buildkite-agent meta-data get "canary"
+    OUTPUT_VARIABLE DEFAULT_CANARY_REVISION
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+  )
+elseif(ENABLE_CANARY)
   set(DEFAULT_CANARY_REVISION "1")
 else()
   set(DEFAULT_CANARY_REVISION "0")

cmake/targets/BuildBoringSSL.cmake

@@ -4,7 +4,7 @@ register_repository(
   REPOSITORY
     oven-sh/boringssl
   COMMIT
-    914b005ef3ece44159dca0ffad74eb42a9f6679f
+    29a2cd359458c9384694b75456026e4b57e3e567
 )
 
 register_cmake_command(

cmake/targets/BuildBun.cmake

@@ -318,13 +318,13 @@ register_command(
   TARGET
     bun-bake-codegen
   COMMENT
-    "Bundling Bake Runtime"
+    "Bundling Kit Runtime"
   COMMAND
     ${BUN_EXECUTABLE}
       run
       ${BUN_BAKE_RUNTIME_CODEGEN_SCRIPT}
         --debug=${DEBUG}
-        --codegen-root=${CODEGEN_PATH}
+        --codegen_root=${CODEGEN_PATH}
   SOURCES
     ${BUN_BAKE_RUNTIME_SOURCES}
     ${BUN_BAKE_RUNTIME_CODEGEN_SOURCES}
@@ -334,39 +334,6 @@ register_command(
     ${BUN_BAKE_RUNTIME_OUTPUTS}
 )
 
-set(BUN_BINDGEN_SCRIPT ${CWD}/src/codegen/bindgen.ts)
-
-file(GLOB_RECURSE BUN_BINDGEN_SOURCES ${CONFIGURE_DEPENDS}
-  ${CWD}/src/**/*.bind.ts
-)
-
-set(BUN_BINDGEN_CPP_OUTPUTS
-  ${CODEGEN_PATH}/GeneratedBindings.cpp
-)
-
-set(BUN_BINDGEN_ZIG_OUTPUTS
-  ${CWD}/src/bun.js/bindings/GeneratedBindings.zig
-)
-
-register_command(
-  TARGET
-    bun-binding-generator
-  COMMENT
-    "Processing \".bind.ts\" files"
-  COMMAND
-    ${BUN_EXECUTABLE}
-      run
-      ${BUN_BINDGEN_SCRIPT}
-        --debug=${DEBUG}
-        --codegen-root=${CODEGEN_PATH}
-  SOURCES
-    ${BUN_BINDGEN_SOURCES}
-    ${BUN_BINDGEN_SCRIPT}
-  OUTPUTS
-    ${BUN_BINDGEN_CPP_OUTPUTS}
-    ${BUN_BINDGEN_ZIG_OUTPUTS}
-)
-
 set(BUN_JS_SINK_SCRIPT ${CWD}/src/codegen/generate-jssink.ts)
 
 set(BUN_JS_SINK_SOURCES
@@ -418,6 +385,7 @@ set(BUN_OBJECT_LUT_OUTPUTS
   ${CODEGEN_PATH}/NodeModuleModule.lut.h
 )
 
+
 macro(WEBKIT_ADD_SOURCE_DEPENDENCIES _source _deps)
   set(_tmp)
   get_source_file_property(_tmp ${_source} OBJECT_DEPENDS)
@@ -493,7 +461,6 @@ list(APPEND BUN_ZIG_SOURCES
   ${CWD}/build.zig
   ${CWD}/root.zig
   ${CWD}/root_wasm.zig
-  ${BUN_BINDGEN_ZIG_OUTPUTS}
 )
 
 set(BUN_ZIG_GENERATED_SOURCES
@@ -515,13 +482,16 @@ endif()
 
 set(BUN_ZIG_OUTPUT ${BUILD_PATH}/bun-zig.o)
 
+
 if(CMAKE_SYSTEM_PROCESSOR MATCHES "arm|ARM|arm64|ARM64|aarch64|AARCH64")
+  set(IS_ARM64 ON)
   if(APPLE)
     set(ZIG_CPU "apple_m1")
   else()
     set(ZIG_CPU "native")
   endif()
 elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "x86_64|X86_64|x64|X64|amd64|AMD64")
+  set(IS_X86_64 ON)
   if(ENABLE_BASELINE)
     set(ZIG_CPU "nehalem")
   else()
@@ -576,7 +546,6 @@ set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS "build.zig")
 
 set(BUN_USOCKETS_SOURCE ${CWD}/packages/bun-usockets)
 
-# hand written cpp source files. Full list of "source" code (including codegen) is in BUN_CPP_SOURCES
 file(GLOB BUN_CXX_SOURCES ${CONFIGURE_DEPENDS}
   ${CWD}/src/io/*.cpp
   ${CWD}/src/bun.js/modules/*.cpp
@@ -600,8 +569,7 @@ file(GLOB BUN_C_SOURCES ${CONFIGURE_DEPENDS}
 )
 
 if(WIN32)
-  list(APPEND BUN_CXX_SOURCES ${CWD}/src/bun.js/bindings/windows/rescle.cpp)
-  list(APPEND BUN_CXX_SOURCES ${CWD}/src/bun.js/bindings/windows/rescle-binding.cpp)
+  list(APPEND BUN_C_SOURCES ${CWD}/src/bun.js/bindings/windows/musl-memmem.c)
 endif()
 
 register_repository(
@@ -634,14 +602,12 @@ register_command(
 list(APPEND BUN_CPP_SOURCES
   ${BUN_C_SOURCES}
   ${BUN_CXX_SOURCES}
-  ${BUN_ERROR_CODE_OUTPUTS}
   ${VENDOR_PATH}/picohttpparser/picohttpparser.c
   ${NODEJS_HEADERS_PATH}/include/node/node_version.h
   ${BUN_ZIG_GENERATED_CLASSES_OUTPUTS}
   ${BUN_JS_SINK_OUTPUTS}
   ${BUN_JAVASCRIPT_OUTPUTS}
   ${BUN_OBJECT_LUT_OUTPUTS}
-  ${BUN_BINDGEN_CPP_OUTPUTS}
 )
 
 if(WIN32)
@@ -651,19 +617,11 @@ if(WIN32)
     set(Bun_VERSION_WITH_TAG ${VERSION})
   endif()
   set(BUN_ICO_PATH ${CWD}/src/bun.ico)
-  configure_file(${CWD}/src/bun.ico ${CODEGEN_PATH}/bun.ico COPYONLY)
   configure_file(
     ${CWD}/src/windows-app-info.rc
     ${CODEGEN_PATH}/windows-app-info.rc
-    @ONLY
   )
-  add_custom_command(
-    OUTPUT ${CODEGEN_PATH}/windows-app-info.res
-    COMMAND rc.exe /fo ${CODEGEN_PATH}/windows-app-info.res ${CODEGEN_PATH}/windows-app-info.rc
-    DEPENDS ${CODEGEN_PATH}/windows-app-info.rc ${CODEGEN_PATH}/bun.ico
-    COMMENT "Adding Windows resource file ${CODEGEN_PATH}/windows-app-info.res with ico in ${CODEGEN_PATH}/bun.ico"
-  )
-  set(WINDOWS_RESOURCES ${CODEGEN_PATH}/windows-app-info.res)
+  list(APPEND BUN_CPP_SOURCES ${CODEGEN_PATH}/windows-app-info.rc)
 endif()
 
 # --- Executable ---
@@ -671,7 +629,7 @@ endif()
 set(BUN_CPP_OUTPUT ${BUILD_PATH}/${CMAKE_STATIC_LIBRARY_PREFIX}${bun}${CMAKE_STATIC_LIBRARY_SUFFIX})
 
 if(BUN_LINK_ONLY)
-  add_executable(${bun} ${BUN_CPP_OUTPUT} ${BUN_ZIG_OUTPUT} ${WINDOWS_RESOURCES})
+  add_executable(${bun} ${BUN_CPP_OUTPUT} ${BUN_ZIG_OUTPUT})
   set_target_properties(${bun} PROPERTIES LINKER_LANGUAGE CXX)
   target_link_libraries(${bun} PRIVATE ${BUN_CPP_OUTPUT})
 elseif(BUN_CPP_ONLY)
@@ -689,7 +647,7 @@ elseif(BUN_CPP_ONLY)
       ${BUN_CPP_OUTPUT}
   )
 else()
-  add_executable(${bun} ${BUN_CPP_SOURCES} ${WINDOWS_RESOURCES})
+  add_executable(${bun} ${BUN_CPP_SOURCES})
   target_link_libraries(${bun} PRIVATE ${BUN_ZIG_OUTPUT})
 endif()
 
@@ -803,8 +761,8 @@ if(NOT WIN32)
   )
   if(DEBUG)
     # TODO: this shouldn't be necessary long term
-    if (NOT ABI STREQUAL "musl")
-      target_compile_options(${bun} PUBLIC
+    if (NOT IS_MUSL)
+      set(ABI_PUBLIC_FLAGS
         -fsanitize=null
         -fsanitize-recover=all
         -fsanitize=bounds
@@ -815,9 +773,14 @@ if(NOT WIN32)
         -fsanitize=returns-nonnull-attribute
         -fsanitize=unreachable
       )
-      target_link_libraries(${bun} PRIVATE
+      set(ABI_PRIVATE_FLAGS
         -fsanitize=null
       )
+    else()
+      set(ABI_PUBLIC_FLAGS
+      )
+      set(ABI_PRIVATE_FLAGS
+      )
     endif()
 
     target_compile_options(${bun} PUBLIC
@@ -835,6 +798,10 @@ if(NOT WIN32)
       -Wno-unused-function
       -Wno-nullability-completeness
       -Werror
+      ${ABI_PUBLIC_FLAGS}
+    )
+    target_link_libraries(${bun} PRIVATE
+      ${ABI_PRIVATE_FLAGS}
     )
   else()
     # Leave -Werror=unused off in release builds so we avoid errors from being used in ASSERT
@@ -859,7 +826,7 @@ endif()
 
 if(WIN32)
   target_link_options(${bun} PUBLIC
-    /STACK:0x1200000,0x200000
+    /STACK:0x1200000,0x100000
     /errorlimit:0
   )
   if(RELEASE)
@@ -879,74 +846,109 @@ if(WIN32)
       /delayload:IPHLPAPI.dll
     )
   endif()
-endif()
-
-if(APPLE)
+elseif(APPLE)
   target_link_options(${bun} PUBLIC
+    -Wl,-merge_zero_fill_sections
     -dead_strip
     -dead_strip_dylibs
-    -Wl,-ld_new
-    -Wl,-no_compact_unwind
     -Wl,-stack_size,0x1200000
     -fno-keep-static-consts
     -Wl,-map,${bun}.linker-map
   )
-endif()
+else()
+  # Try to use lld-16 if available, otherwise fallback to lld
+  # Cache it so we don't have to re-run CMake to pick it up
+  if((NOT DEFINED LLD_NAME) AND (NOT CI OR BUN_LINK_ONLY))
+    find_program(LLD_EXECUTABLE_NAME lld-${LLVM_VERSION_MAJOR})
 
-if(LINUX)
-  if(NOT ABI STREQUAL "musl")
-  # on arm64
-  if(CMAKE_SYSTEM_PROCESSOR MATCHES "arm|ARM|arm64|ARM64|aarch64|AARCH64")
-    target_link_options(${bun} PUBLIC
+    if(NOT LLD_EXECUTABLE_NAME)
+      if(CI)
+        # Ensure we don't use a differing version of lld in CI vs clang
+        message(FATAL_ERROR "lld-${LLVM_VERSION_MAJOR} not found. Please make sure you have LLVM ${LLVM_VERSION_MAJOR}.x installed and set to lld-${LLVM_VERSION_MAJOR}")
+      endif()
+
+      # To make it easier for contributors, allow differing versions of lld vs clang/cmake
+      find_program(LLD_EXECUTABLE_NAME lld)
+    endif()
+
+    if(NOT LLD_EXECUTABLE_NAME)
+      message(FATAL_ERROR "LLD not found. Please make sure you have LLVM ${LLVM_VERSION_MAJOR}.x installed and lld is available in your PATH as lld-${LLVM_VERSION_MAJOR}")
+    endif()
+
+    # normalize to basename so it can be used with -fuse-ld
+    get_filename_component(LLD_NAME ${LLD_EXECUTABLE_NAME} NAME CACHE)
+    message(STATUS "Using linker: ${LLD_NAME} (${LLD_EXECUTABLE_NAME})")
+  elseif(NOT DEFINED LLD_NAME)
+    set(LLD_NAME lld-${LLVM_VERSION_MAJOR})
+  endif()
+
+  if (NOT IS_MUSL)
+  if (IS_ARM64)
+    set(ARCH_WRAP_FLAGS
+      -Wl,--wrap=fcntl64
+      -Wl,--wrap=statx
+    )
+  elseif(IS_X86_64)
+    set(ARCH_WRAP_FLAGS
+      -Wl,--wrap=fcntl
+      -Wl,--wrap=fcntl64
+      -Wl,--wrap=fstat
+      -Wl,--wrap=fstat64
+      -Wl,--wrap=fstatat
+      -Wl,--wrap=fstatat64
+      -Wl,--wrap=lstat
+      -Wl,--wrap=lstat64
+      -Wl,--wrap=mknod
+      -Wl,--wrap=mknodat
+      -Wl,--wrap=stat
+      -Wl,--wrap=stat64
+      -Wl,--wrap=statx
+    )
+  endif()
+  else()
+    set(ARCH_WRAP_FLAGS
+    )
+  endif()
+
+  if (NOT IS_MUSL)
+    set(ABI_WRAP_FLAGS
+      -Wl,--wrap=cosf
       -Wl,--wrap=exp
       -Wl,--wrap=expf
-      -Wl,--wrap=fcntl64
+      -Wl,--wrap=fmod
+      -Wl,--wrap=fmodf
       -Wl,--wrap=log
+      -Wl,--wrap=log10f
       -Wl,--wrap=log2
       -Wl,--wrap=log2f
       -Wl,--wrap=logf
       -Wl,--wrap=pow
       -Wl,--wrap=powf
+      -Wl,--wrap=sincosf
+      -Wl,--wrap=sinf
+      -Wl,--wrap=tanf
     )
   else()
-    target_link_options(${bun} PUBLIC
-      -Wl,--wrap=exp
-      -Wl,--wrap=expf
-      -Wl,--wrap=log2f
-      -Wl,--wrap=logf
-      -Wl,--wrap=powf
-    )
-  endif()
-  endif()
-
-  if(NOT ABI STREQUAL "musl")
-    target_link_options(${bun} PUBLIC
-      -static-libstdc++
-      -static-libgcc
-    )
-  else()
-    target_link_options(${bun} PUBLIC
-      -lstdc++
-      -lgcc
+    set(ABI_WRAP_FLAGS
     )
   endif()
 
   target_link_options(${bun} PUBLIC
-    --ld-path=${LLD_PROGRAM}
+    -fuse-ld=${LLD_NAME}
     -fno-pic
+    -static-libstdc++
+    -static-libgcc
     -Wl,-no-pie
     -Wl,-icf=safe
     -Wl,--as-needed
+    -Wl,--merge-zero-contents
     -Wl,--gc-sections
     -Wl,-z,stack-size=12800000
+    ${ARCH_WRAP_FLAGS}
+    ${ABI_WRAP_FLAGS}
     -Wl,--compress-debug-sections=zlib
     -Wl,-z,lazy
     -Wl,-z,norelro
-    -Wl,-z,combreloc
-    -Wl,--no-eh-frame-hdr
-    -Wl,--sort-section=name
-    -Wl,--hash-style=both
-    -Wl,--build-id=sha1  # Better for debugging than default
     -Wl,-Map=${bun}.linker-map
   )
 endif()
@@ -957,7 +959,6 @@ if(WIN32)
   set(BUN_SYMBOLS_PATH ${CWD}/src/symbols.def)
   target_link_options(${bun} PUBLIC /DEF:${BUN_SYMBOLS_PATH})
 elseif(APPLE)
-
   set(BUN_SYMBOLS_PATH ${CWD}/src/symbols.txt)
   target_link_options(${bun} PUBLIC -exported_symbols_list ${BUN_SYMBOLS_PATH})
 else()
@@ -1088,18 +1089,6 @@ endif()
 # --- Packaging ---
 
 if(NOT BUN_CPP_ONLY)
-  set(CMAKE_STRIP_FLAGS "")
-  if(APPLE)
-    # We do not build with exceptions enabled. These are generated by lolhtml
-    # and other dependencies. We build lolhtml with abort on panic, so it
-    # shouldn't be including these in the first place.
-    set(CMAKE_STRIP_FLAGS --remove-section=__TEXT,__eh_frame --remove-section=__TEXT,__unwind_info --remove-section=__TEXT,__gcc_except_tab)
-  elseif(LINUX AND NOT ABI STREQUAL "musl")
-    # When you use llvm-strip to do this, it doesn't delete it from the binary and instead keeps it as [LOAD #2 [R]]
-    # So, we must use GNU strip to do this.
-    set(CMAKE_STRIP_FLAGS -R .eh_frame -R .gcc_except_table)
-  endif()
-
   if(bunStrip)
     register_command(
       TARGET
@@ -1111,7 +1100,6 @@ if(NOT BUN_CPP_ONLY)
       COMMAND
         ${CMAKE_STRIP}
           ${bunExe}
-          ${CMAKE_STRIP_FLAGS}
           --strip-all
           --strip-debug
           --discard-all
@@ -1187,12 +1175,10 @@ if(NOT BUN_CPP_ONLY)
   endif()
 
   if(CI)
-    set(bunTriplet bun-${OS}-${ARCH})
-    if(LINUX AND ABI STREQUAL "musl")
-      set(bunTriplet ${bunTriplet}-musl)
-    endif()
     if(ENABLE_BASELINE)
-      set(bunTriplet ${bunTriplet}-baseline)
+      set(bunTriplet bun-${OS}-${ARCH}-baseline)
+    else()
+      set(bunTriplet bun-${OS}-${ARCH})
     endif()
     string(REPLACE bun ${bunTriplet} bunPath ${bun})
     set(bunFiles ${bunExe} features.json)

cmake/targets/BuildCares.cmake

@@ -4,7 +4,7 @@ register_repository(
   REPOSITORY
     c-ares/c-ares
   COMMIT
-    4f4912bce7374f787b10576851b687935f018e17
+    d1722e6e8acaf10eb73fa995798a9cd421d9f85e
 )
 
 register_cmake_command(

cmake/targets/BuildLibArchive.cmake

@@ -18,7 +18,7 @@ register_cmake_command(
     -DENABLE_INSTALL=OFF
     -DENABLE_TEST=OFF
     -DENABLE_WERROR=OFF
-    -DENABLE_BZip2=OFF
+    -DENABLE_BZIP2=OFF
     -DENABLE_CAT=OFF
     -DENABLE_EXPAT=OFF
     -DENABLE_ICONV=OFF

cmake/targets/BuildLibDeflate.cmake

@@ -4,7 +4,7 @@ register_repository(
   REPOSITORY
     ebiggers/libdeflate
   COMMIT
-    733848901289eca058804ca0737f8796875204c8
+    dc76454a39e7e83b68c3704b6e3784654f8d5ac5
 )
 
 register_cmake_command(

cmake/targets/BuildLolHtml.cmake

@@ -4,7 +4,7 @@ register_repository(
   REPOSITORY
     cloudflare/lol-html
   COMMIT
-    4f8becea13a0021c8b71abd2dcc5899384973b66
+    8d4c273ded322193d017042d1f48df2766b0f88b
 )
 
 set(LOLHTML_CWD ${VENDOR_PATH}/lolhtml/c-api)
@@ -26,13 +26,6 @@ if(RELEASE)
   list(APPEND LOLHTML_BUILD_ARGS --release)
 endif()
 
-# Windows requires unwind tables, apparently.
-if (NOT WIN32)
-  # The encoded escape sequences are intentional. They're how you delimit multiple arguments in a single environment variable.
-  # Also add rust optimization flag for smaller binary size, but not huge speed penalty.
-  set(RUSTFLAGS "-Cpanic=abort-Cdebuginfo=0-Cforce-unwind-tables=no-Copt-level=s")
-endif()
-
 register_command(
   TARGET
     lolhtml
@@ -44,13 +37,6 @@ register_command(
       ${LOLHTML_BUILD_ARGS}
   ARTIFACTS
     ${LOLHTML_LIBRARY}
-  ENVIRONMENT
-    CARGO_TERM_COLOR=always
-    CARGO_TERM_VERBOSE=true
-    CARGO_TERM_DIAGNOSTIC=true
-    CARGO_ENCODED_RUSTFLAGS=${RUSTFLAGS}
-    CARGO_HOME=${CARGO_HOME}
-    RUSTUP_HOME=${RUSTUP_HOME}
 )
 
 target_link_libraries(${bun} PRIVATE ${LOLHTML_LIBRARY})

cmake/targets/BuildLshpack.cmake

@@ -4,7 +4,7 @@ register_repository(
   REPOSITORY
     litespeedtech/ls-hpack
   COMMIT
-    32e96f10593c7cb8553cd8c9c12721100ae9e924
+    3d0f1fc1d6e66a642e7a98c55deb38aa986eb4b0
 )
 
 if(WIN32)

cmake/toolchains/linux-aarch64-musl.cmake

@@ -1,6 +0,0 @@
-set(CMAKE_SYSTEM_NAME Linux)
-set(CMAKE_SYSTEM_PROCESSOR aarch64)
-set(ABI musl)
-
-set(CMAKE_C_COMPILER_WORKS ON)
-set(CMAKE_CXX_COMPILER_WORKS ON)

cmake/toolchains/linux-aarch64.cmake

@@ -1,6 +1,5 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(CMAKE_SYSTEM_PROCESSOR aarch64)
-set(ABI gnu)
 
 set(CMAKE_C_COMPILER_WORKS ON)
 set(CMAKE_CXX_COMPILER_WORKS ON)

cmake/toolchains/linux-x64-baseline.cmake

@@ -1,7 +1,6 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(CMAKE_SYSTEM_PROCESSOR x64)
 set(ENABLE_BASELINE ON)
-set(ABI gnu)
 
 set(CMAKE_C_COMPILER_WORKS ON)
 set(CMAKE_CXX_COMPILER_WORKS ON)

cmake/toolchains/linux-x64-musl-baseline.cmake

@@ -1,7 +0,0 @@
-set(CMAKE_SYSTEM_NAME Linux)
-set(CMAKE_SYSTEM_PROCESSOR x64)
-set(ENABLE_BASELINE ON)
-set(ABI musl)
-
-set(CMAKE_C_COMPILER_WORKS ON)
-set(CMAKE_CXX_COMPILER_WORKS ON)

cmake/toolchains/linux-x64-musl.cmake

@@ -1,6 +0,0 @@
-set(CMAKE_SYSTEM_NAME Linux)
-set(CMAKE_SYSTEM_PROCESSOR x64)
-set(ABI musl)
-
-set(CMAKE_C_COMPILER_WORKS ON)
-set(CMAKE_CXX_COMPILER_WORKS ON)

cmake/toolchains/linux-x64.cmake

@@ -1,6 +1,5 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(CMAKE_SYSTEM_PROCESSOR x64)
-set(ABI gnu)
 
 set(CMAKE_C_COMPILER_WORKS ON)
 set(CMAKE_CXX_COMPILER_WORKS ON)

cmake/tools/SetupCcache.cmake

@@ -5,11 +5,6 @@ if(NOT ENABLE_CCACHE OR CACHE_STRATEGY STREQUAL "none")
   return()
 endif()
 
-if (CI AND NOT APPLE)
-  setenv(CCACHE_DISABLE 1)
-  return()
-endif()
-
 find_command(
   VARIABLE
     CCACHE_PROGRAM
@@ -43,8 +38,7 @@ setenv(CCACHE_FILECLONE 1)
 setenv(CCACHE_STATSLOG ${BUILD_PATH}/ccache.log)
 
 if(CI)
-  # FIXME: Does not work on Ubuntu 18.04
-  # setenv(CCACHE_SLOPPINESS "pch_defines,time_macros,locale,clang_index_store,gcno_cwd,include_file_ctime,include_file_mtime")
+  setenv(CCACHE_SLOPPINESS "pch_defines,time_macros,locale,clang_index_store,gcno_cwd,include_file_ctime,include_file_mtime")
 else()
   setenv(CCACHE_SLOPPINESS "pch_defines,time_macros,locale,random_seed,clang_index_store,gcno_cwd")
 endif()

cmake/tools/SetupGit.cmake

@@ -29,7 +29,7 @@ execute_process(
 )
 
 if(NOT GIT_DIFF_RESULT EQUAL 0)
-  message(WARNING "Command failed: ${GIT_DIFF_COMMAND} ${GIT_DIFF_ERROR}")
+  message(${WARNING} "Command failed: ${GIT_DIFF_COMMAND} ${GIT_DIFF_ERROR}")
   return()
 endif()
 

cmake/tools/SetupLLVM.cmake

@@ -1,18 +1,14 @@
-
-set(DEFAULT_ENABLE_LLVM ON)
-
-# if target is bun-zig, set ENABLE_LLVM to OFF
-if(TARGET bun-zig)
-  set(DEFAULT_ENABLE_LLVM OFF)
-endif()
-
-optionx(ENABLE_LLVM BOOL "If LLVM should be used for compilation" DEFAULT ${DEFAULT_ENABLE_LLVM})
+optionx(ENABLE_LLVM BOOL "If LLVM should be used for compilation" DEFAULT ON)
 
 if(NOT ENABLE_LLVM)
   return()
 endif()
 
-set(DEFAULT_LLVM_VERSION "18.1.8")
+if(CMAKE_HOST_WIN32 OR CMAKE_HOST_APPLE OR IS_MUSL)
+  set(DEFAULT_LLVM_VERSION "18.1.8")
+else()
+  set(DEFAULT_LLVM_VERSION "16.0.6")
+endif()
 
 optionx(LLVM_VERSION STRING "The version of LLVM to use" DEFAULT ${DEFAULT_LLVM_VERSION})
 
@@ -56,7 +52,6 @@ if(UNIX)
       /usr/lib/llvm-${LLVM_VERSION_MAJOR}.${LLVM_VERSION_MINOR}.${LLVM_VERSION_PATCH}/bin
       /usr/lib/llvm-${LLVM_VERSION_MAJOR}.${LLVM_VERSION_MINOR}/bin
       /usr/lib/llvm-${LLVM_VERSION_MAJOR}/bin
-      /usr/lib/llvm${LLVM_VERSION_MAJOR}/bin
     )
   endif()
 endif()
@@ -77,7 +72,7 @@ macro(find_llvm_command variable command)
     VERSION_VARIABLE LLVM_VERSION
     COMMAND ${commands}
     PATHS ${LLVM_PATHS}
-    VERSION >=${LLVM_VERSION_MAJOR}.1.0
+    VERSION ${LLVM_VERSION}
   )
   list(APPEND CMAKE_ARGS -D${variable}=${${variable}})
 endmacro()
@@ -113,23 +108,8 @@ else()
   find_llvm_command(CMAKE_CXX_COMPILER clang++)
   find_llvm_command(CMAKE_LINKER llvm-link)
   find_llvm_command(CMAKE_AR llvm-ar)
-  if (LINUX)
-    # On Linux, strip ends up being more useful for us.
-    find_command(
-      VARIABLE
-        CMAKE_STRIP
-      COMMAND
-        strip
-      REQUIRED
-        ON
-    )
-  else()
-    find_llvm_command(CMAKE_STRIP llvm-strip)
-  endif()
+  find_llvm_command(CMAKE_STRIP llvm-strip)
   find_llvm_command(CMAKE_RANLIB llvm-ranlib)
-  if(LINUX)
-    find_llvm_command(LLD_PROGRAM ld.lld)
-  endif()
   if(APPLE)
     find_llvm_command(CMAKE_DSYMUTIL dsymutil)
   endif()

cmake/tools/SetupRust.cmake

@@ -1,42 +1,15 @@
-if(DEFINED ENV{CARGO_HOME})
-  set(CARGO_HOME $ENV{CARGO_HOME})
-elseif(CMAKE_HOST_WIN32)
-  set(CARGO_HOME $ENV{USERPROFILE}/.cargo)
-  if(NOT EXISTS ${CARGO_HOME})
-    set(CARGO_HOME $ENV{PROGRAMFILES}/Rust/cargo)
-  endif()
-else()
-  set(CARGO_HOME $ENV{HOME}/.cargo)
-endif()
-
-if(DEFINED ENV{RUSTUP_HOME})
-  set(RUSTUP_HOME $ENV{RUSTUP_HOME})
-elseif(CMAKE_HOST_WIN32)
-  set(RUSTUP_HOME $ENV{USERPROFILE}/.rustup)
-  if(NOT EXISTS ${RUSTUP_HOME})
-    set(RUSTUP_HOME $ENV{PROGRAMFILES}/Rust/rustup)
-  endif()
-else()
-  set(RUSTUP_HOME $ENV{HOME}/.rustup)
-endif()
-
 find_command(
   VARIABLE
     CARGO_EXECUTABLE
   COMMAND
     cargo
   PATHS
-    ${CARGO_HOME}/bin
+    $ENV{HOME}/.cargo/bin
   REQUIRED
     OFF
 )
 
 if(EXISTS ${CARGO_EXECUTABLE})
-  if(CARGO_EXECUTABLE MATCHES "^${CARGO_HOME}")
-    setx(CARGO_HOME ${CARGO_HOME})
-    setx(RUSTUP_HOME ${RUSTUP_HOME})
-  endif()
-
   return()
 endif()
 

cmake/tools/SetupWebKit.cmake

@@ -2,15 +2,13 @@ option(WEBKIT_VERSION "The version of WebKit to use")
 option(WEBKIT_LOCAL "If a local version of WebKit should be used instead of downloading")
 
 if(NOT WEBKIT_VERSION)
-  set(WEBKIT_VERSION e1a802a2287edfe7f4046a9dd8307c8b59f5d816)
+  set(WEBKIT_VERSION 3bc4abf2d5875baf500b4687ef869987f6d19e00)
 endif()
 
-string(SUBSTRING ${WEBKIT_VERSION} 0 16 WEBKIT_VERSION_PREFIX)
-
 if(WEBKIT_LOCAL)
   set(DEFAULT_WEBKIT_PATH ${VENDOR_PATH}/WebKit/WebKitBuild/${CMAKE_BUILD_TYPE})
 else()
-  set(DEFAULT_WEBKIT_PATH ${CACHE_PATH}/webkit-${WEBKIT_VERSION_PREFIX})
+  set(DEFAULT_WEBKIT_PATH ${CACHE_PATH}/webkit-${WEBKIT_VERSION})
 endif()
 
 option(WEBKIT_PATH "The path to the WebKit directory")
@@ -30,8 +28,6 @@ if(WEBKIT_LOCAL)
       ${WEBKIT_PATH}
       ${WEBKIT_PATH}/JavaScriptCore/Headers/JavaScriptCore
       ${WEBKIT_PATH}/JavaScriptCore/PrivateHeaders
-      ${WEBKIT_PATH}/JavaScriptCore/DerivedSources/inspector
-      ${WEBKIT_PATH}/JavaScriptCore/PrivateHeaders/JavaScriptCore
       ${WEBKIT_PATH}/bmalloc/Headers
       ${WEBKIT_PATH}/WTF/Headers
     )
@@ -67,7 +63,7 @@ else()
   message(FATAL_ERROR "Unsupported architecture: ${CMAKE_SYSTEM_PROCESSOR}")
 endif()
 
-if(LINUX AND ABI STREQUAL "musl")
+if(IS_MUSL)
   set(WEBKIT_SUFFIX "-musl")
 endif()
 

cmake/tools/SetupZig.cmake

@@ -11,7 +11,7 @@ if(APPLE)
 elseif(WIN32)
   set(DEFAULT_ZIG_TARGET ${DEFAULT_ZIG_ARCH}-windows-msvc)
 elseif(LINUX)
-  if(ABI STREQUAL "musl")
+  if(IS_MUSL)
     set(DEFAULT_ZIG_TARGET ${DEFAULT_ZIG_ARCH}-linux-musl)
   else()
     set(DEFAULT_ZIG_TARGET ${DEFAULT_ZIG_ARCH}-linux-gnu)

completions/bun.bash

@@ -87,7 +87,7 @@ _bun_completions() {
     GLOBAL_OPTIONS[LONG_OPTIONS]="--use --cwd --bunfile --server-bunfile --config --disable-react-fast-refresh --disable-hmr --env-file --extension-order --jsx-factory --jsx-fragment --extension-order --jsx-factory --jsx-fragment --jsx-import-source --jsx-production --jsx-runtime --main-fields --no-summary --version --platform --public-dir --tsconfig-override --define --external --help --inject --loader --origin --port --dump-environment-variables --dump-limits --disable-bun-js";
     GLOBAL_OPTIONS[SHORT_OPTIONS]="-c -v -d -e -h -i -l -u -p";
 
-    PACKAGE_OPTIONS[ADD_OPTIONS_LONG]="--development --optional --peer";
+    PACKAGE_OPTIONS[ADD_OPTIONS_LONG]="--development --optional";
     PACKAGE_OPTIONS[ADD_OPTIONS_SHORT]="-d";
     PACKAGE_OPTIONS[REMOVE_OPTIONS_LONG]="";
     PACKAGE_OPTIONS[REMOVE_OPTIONS_SHORT]="";

completions/bun.zsh

@@ -35,7 +35,6 @@ _bun_add_completion() {
         '-D[]' \
         '--development[]' \
         '--optional[Add dependency to "optionalDependencies]' \
-        '--peer[Add dependency to "peerDependencies]' \
         '--exact[Add the exact version instead of the ^range]' &&
         ret=0
 
@@ -340,7 +339,6 @@ _bun_install_completion() {
         '--development[]' \
         '-D[]' \
         '--optional[Add dependency to "optionalDependencies]' \
-        '--peer[Add dependency to "peerDependencies]' \
         '--exact[Add the exact version instead of the ^range]' &&
         ret=0
 
@@ -673,7 +671,7 @@ _bun() {
     cmd)
         local -a scripts_list
         IFS=$'\n' scripts_list=($(SHELL=zsh bun getcompletes i))
-        scripts="scripts:scripts:((${scripts_list//:/\\\\:}))"
+        scripts="scripts:scripts:(($scripts_list))"
         IFS=$'\n' files_list=($(SHELL=zsh bun getcompletes j))
 
         main_commands=(
@@ -873,8 +871,8 @@ _bun_run_param_script_completion() {
     IFS=$'\n' scripts_list=($(SHELL=zsh bun getcompletes s))
     IFS=$'\n' bins=($(SHELL=zsh bun getcompletes b))
 
-    _alternative "scripts:scripts:((${scripts_list//:/\\\\:}))"
-    _alternative "bin:bin:((${bins//:/\\\\:}))"
+    _alternative "scripts:scripts:(($scripts_list))"
+    _alternative "bin:bin:(($bins))"
     _alternative "files:file:_files -g '*.(js|ts|jsx|tsx|wasm)'"
 }
 

dockerhub/alpine/Dockerfile

@@ -1,13 +1,30 @@
-FROM alpine:3.20 AS build
+FROM alpine:3.18 AS build
 
 # https://github.com/oven-sh/bun/releases
 ARG BUN_VERSION=latest
 
-RUN apk --no-cache add ca-certificates curl dirmngr gpg gpg-agent unzip \
+# TODO: Instead of downloading glibc from a third-party source, we should
+#      build it from source. This is a temporary solution.
+#      See: https://github.com/sgerrand/alpine-pkg-glibc
+
+# https://github.com/sgerrand/alpine-pkg-glibc/releases
+# https://github.com/sgerrand/alpine-pkg-glibc/issues/176
+ARG GLIBC_VERSION=2.34-r0
+
+# https://github.com/oven-sh/bun/issues/5545#issuecomment-1722461083
+ARG GLIBC_VERSION_AARCH64=2.26-r1
+
+RUN apk --no-cache add \
+      ca-certificates \
+      curl \
+      dirmngr \
+      gpg \
+      gpg-agent \
+      unzip \
     && arch="$(apk --print-arch)" \
     && case "${arch##*-}" in \
-      x86_64) build="x64-musl-baseline";; \
-      aarch64) build="aarch64-musl";; \
+      x86_64) build="x64-baseline";; \
+      aarch64) build="aarch64";; \
       *) echo "error: unsupported architecture: $arch"; exit 1 ;; \
     esac \
     && version="$BUN_VERSION" \
@@ -42,9 +59,37 @@ RUN apk --no-cache add ca-certificates curl dirmngr gpg gpg-agent unzip \
     && unzip "bun-linux-$build.zip" \
     && mv "bun-linux-$build/bun" /usr/local/bin/bun \
     && rm -f "bun-linux-$build.zip" SHASUMS256.txt.asc SHASUMS256.txt \
-    && chmod +x /usr/local/bin/bun
+    && chmod +x /usr/local/bin/bun \
+    && cd /tmp \
+    && case "${arch##*-}" in \
+      x86_64) curl "https://github.com/sgerrand/alpine-pkg-glibc/releases/download/${GLIBC_VERSION}/glibc-${GLIBC_VERSION}.apk" \
+        -fsSLO \
+        --compressed \
+        --retry 5 \
+        || (echo "error: failed to download: glibc v${GLIBC_VERSION}" && exit 1) \
+      && mv "glibc-${GLIBC_VERSION}.apk" glibc.apk \
+      && curl "https://github.com/sgerrand/alpine-pkg-glibc/releases/download/${GLIBC_VERSION}/glibc-bin-${GLIBC_VERSION}.apk" \
+        -fsSLO \
+        --compressed \
+        --retry 5 \
+        || (echo "error: failed to download: glibc-bin v${GLIBC_VERSION}" && exit 1) \
+      && mv "glibc-bin-${GLIBC_VERSION}.apk" glibc-bin.apk ;; \
+      aarch64) curl "https://raw.githubusercontent.com/squishyu/alpine-pkg-glibc-aarch64-bin/master/glibc-${GLIBC_VERSION_AARCH64}.apk" \
+        -fsSLO \
+        --compressed \
+        --retry 5 \
+        || (echo "error: failed to download: glibc v${GLIBC_VERSION_AARCH64}" && exit 1) \
+      && mv "glibc-${GLIBC_VERSION_AARCH64}.apk" glibc.apk \
+      && curl "https://raw.githubusercontent.com/squishyu/alpine-pkg-glibc-aarch64-bin/master/glibc-bin-${GLIBC_VERSION_AARCH64}.apk" \
+        -fsSLO \
+        --compressed \
+        --retry 5 \
+        || (echo "error: failed to download: glibc-bin v${GLIBC_VERSION_AARCH64}" && exit 1) \
+      && mv "glibc-bin-${GLIBC_VERSION_AARCH64}.apk" glibc-bin.apk ;; \
+      *) echo "error: unsupported architecture '$arch'"; exit 1 ;; \
+    esac
 
-FROM alpine:3.20
+FROM alpine:3.18
 
 # Disable the runtime transpiler cache by default inside Docker containers.
 # On ephemeral containers, the cache is not useful
@@ -62,8 +107,10 @@ COPY docker-entrypoint.sh /usr/local/bin/
 RUN --mount=type=bind,from=build,source=/tmp,target=/tmp \
     addgroup -g 1000 bun \
     && adduser -u 1000 -G bun -s /bin/sh -D bun \
+    && apk --no-cache --force-overwrite --allow-untrusted add \
+      /tmp/glibc.apk \
+      /tmp/glibc-bin.apk \
     && ln -s /usr/local/bin/bun /usr/local/bin/bunx \
-    && apk add libgcc libstdc++ \
     && which bun \
     && which bunx \
     && bun --version

docs/api/cc.md

@@ -179,16 +179,16 @@ type Flags = string | string[];
 
 These are flags like `-I` for include directories and `-D` for preprocessor definitions.
 
-#### `define: Record<string, string>`
+#### `defines: Record<string, string>`
 
-The `define` is an optional object that should be passed to the TinyCC compiler.
+The `defines` is an optional object that should be passed to the TinyCC compiler.
 
 ```ts
 type Defines = Record<string, string>;
 
 cc({
   source: "hello.c",
-  define: {
+  defines: {
     "NDEBUG": "1",
   },
 });

docs/api/fetch.md

@@ -234,7 +234,7 @@ To prefetch a DNS entry, you can use the `dns.prefetch` API. This API is useful
 ```ts
 import { dns } from "bun";
 
-dns.prefetch("bun.sh");
+dns.prefetch("bun.sh", 443);
 ```
 
 #### DNS caching

docs/api/ffi.md

@@ -297,20 +297,6 @@ setTimeout(() => {
 
 When you're done with a JSCallback, you should call `close()` to free the memory.
 
-### Experimental thread-safe callbacks
-`JSCallback` has experimental support for thread-safe callbacks. This will be needed if you pass a callback function into a different thread from it's instantiation context. You can enable it with the optional `threadsafe` option flag.
-```ts
-const searchIterator = new JSCallback(
-  (ptr, length) => /hello/.test(new CString(ptr, length)),
-  {
-    returns: "bool",
-    args: ["ptr", "usize"],
-    threadsafe: true, // Optional. Defaults to `false`
-  },
-);
-```
-Be aware that there are still cases where this does not 100% work.
-
 {% callout %}
 
 **⚡️ Performance tip** — For a slight performance boost, directly pass `JSCallback.prototype.ptr` instead of the `JSCallback` object:

docs/api/s3.md

@@ -1,678 +0,0 @@
-Production servers often read, upload, and write files to S3-compatible object storage services instead of the local filesystem. Historically, that means local filesystem APIs you use in development can't be used in production. When you use Bun, things are different.
-
-Bun provides fast, native bindings for interacting with S3-compatible object storage services. Bun's S3 API is designed to be simple and feel similar to fetch's `Response` and `Blob` APIs (like Bun's local filesystem APIs).
-
-```ts
-import { s3, write, S3Client } from "bun";
-
-// Bun.s3 reads environment variables for credentials
-// file() returns a lazy reference to a file on S3
-const metadata = s3.file("123.json");
-
-// Download from S3 as JSON
-const data = await metadata.json();
-
-// Upload to S3
-await write(metadata, JSON.stringify({ name: "John", age: 30 }));
-
-// Presign a URL (synchronous - no network request needed)
-const url = metadata.presign({
-  acl: "public-read",
-  expiresIn: 60 * 60 * 24, // 1 day
-});
-
-// Delete the file
-await metadata.delete();
-```
-
-S3 is the [de facto standard](https://en.wikipedia.org/wiki/De_facto_standard) internet filesystem. Bun's S3 API works with S3-compatible storage services like:
-
-- AWS S3
-- Cloudflare R2
-- DigitalOcean Spaces
-- MinIO
-- Backblaze B2
-- ...and any other S3-compatible storage service
-
-## Basic Usage
-
-There are several ways to interact with Bun's S3 API.
-
-### `Bun.S3Client` & `Bun.s3`
-
-`Bun.s3` is equivalent to `new Bun.S3Client()`, relying on environment variables for credentials.
-
-To explicitly set credentials, pass them to the `Bun.S3Client` constructor.
-
-```ts
-import { S3Client } from "bun";
-
-const client = new S3Client({
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // sessionToken: "..."
-  // acl: "public-read",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
-  // endpoint: "https://<region>.digitaloceanspaces.com", // DigitalOcean Spaces
-  // endpoint: "http://localhost:9000", // MinIO
-});
-
-// Bun.s3 is a global singleton that is equivalent to `new Bun.S3Client()`
-Bun.s3 = client;
-```
-
-### Working with S3 Files
-
-The **`file`** method in `S3Client` returns a **lazy reference to a file on S3**.
-
-```ts
-// A lazy reference to a file on S3
-const s3file: S3File = client.file("123.json");
-```
-
-Like `Bun.file(path)`, the `S3Client`'s `file` method is synchronous. It does zero network requests until you call a method that depends on a network request.
-
-### Reading files from S3
-
-If you've used the `fetch` API, you're familiar with the `Response` and `Blob` APIs. `S3File` extends `Blob`. The same methods that work on `Blob` also work on `S3File`.
-
-```ts
-// Read an S3File as text
-const text = await s3file.text();
-
-// Read an S3File as JSON
-const json = await s3file.json();
-
-// Read an S3File as an ArrayBuffer
-const buffer = await s3file.arrayBuffer();
-
-// Get only the first 1024 bytes
-const partial = await s3file.slice(0, 1024).text();
-
-// Stream the file
-const stream = s3file.stream();
-for await (const chunk of stream) {
-  console.log(chunk);
-}
-```
-
-#### Memory optimization
-
-Methods like `text()`, `json()`, `bytes()`, or `arrayBuffer()` avoid duplicating the string or bytes in memory when possible.
-
-If the text happens to be ASCII, Bun directly transfers the string to JavaScriptCore (the engine) without transcoding and without duplicating the string in memory. When you use `.bytes()` or `.arrayBuffer()`, it will also avoid duplicating the bytes in memory.
-
-These helper methods not only simplify the API, they also make it faster.
-
-### Writing & uploading files to S3
-
-Writing to S3 is just as simple.
-
-```ts
-// Write a string (replacing the file)
-await s3file.write("Hello World!");
-
-// Write a Buffer (replacing the file)
-await s3file.write(Buffer.from("Hello World!"));
-
-// Write a Response (replacing the file)
-await s3file.write(new Response("Hello World!"));
-
-// Write with content type
-await s3file.write(JSON.stringify({ name: "John", age: 30 }), {
-  type: "application/json",
-});
-
-// Write using a writer (streaming)
-const writer = s3file.writer({ type: "application/json" });
-writer.write("Hello");
-writer.write(" World!");
-await writer.end();
-
-// Write using Bun.write
-await Bun.write(s3file, "Hello World!");
-```
-
-### Working with large files (streams)
-
-Bun automatically handles multipart uploads for large files and provides streaming capabilities. The same API that works for local files also works for S3 files.
-
-```ts
-// Write a large file
-const bigFile = Buffer.alloc(10 * 1024 * 1024); // 10MB
-const writer = s3file.writer({
-  // Automatically retry on network errors up to 3 times
-  retry: 3,
-
-  // Queue up to 10 requests at a time
-  queueSize: 10,
-
-  // Upload in 5 MB chunks
-  partSize: 5 * 1024 * 1024,
-});
-for (let i = 0; i < 10; i++) {
-  await writer.write(bigFile);
-}
-await writer.end();
-```
-
-## Presigning URLs
-
-When your production service needs to let users upload files to your server, it's often more reliable for the user to upload directly to S3 instead of your server acting as an intermediary.
-
-To facilitate this, you can presign URLs for S3 files. This generates a URL with a signature that allows a user to securely upload that specific file to S3, without exposing your credentials or granting them unnecessary access to your bucket.
-
-```ts
-import { s3 } from "bun";
-
-// Generate a presigned URL that expires in 24 hours (default)
-const url = s3.presign("my-file.txt", {
-  expiresIn: 3600, // 1 hour
-});
-```
-
-### Setting ACLs
-
-To set an ACL (access control list) on a presigned URL, pass the `acl` option:
-
-```ts
-const url = s3file.presign({
-  acl: "public-read",
-  expiresIn: 3600,
-});
-```
-
-You can pass any of the following ACLs:
-
-| ACL                           | Explanation                                                         |
-| ----------------------------- | ------------------------------------------------------------------- |
-| `"public-read"`               | The object is readable by the public.                               |
-| `"private"`                   | The object is readable only by the bucket owner.                    |
-| `"public-read-write"`         | The object is readable and writable by the public.                  |
-| `"authenticated-read"`        | The object is readable by the bucket owner and authenticated users. |
-| `"aws-exec-read"`             | The object is readable by the AWS account that made the request.    |
-| `"bucket-owner-read"`         | The object is readable by the bucket owner.                         |
-| `"bucket-owner-full-control"` | The object is readable and writable by the bucket owner.            |
-| `"log-delivery-write"`        | The object is writable by AWS services used for log delivery.       |
-
-### Expiring URLs
-
-To set an expiration time for a presigned URL, pass the `expiresIn` option.
-
-```ts
-const url = s3file.presign({
-  // Seconds
-  expiresIn: 3600, // 1 hour
-
-  // access control list
-  acl: "public-read",
-
-  // HTTP method
-  method: "PUT",
-});
-```
-
-### `method`
-
-To set the HTTP method for a presigned URL, pass the `method` option.
-
-```ts
-const url = s3file.presign({
-  method: "PUT",
-  // method: "DELETE",
-  // method: "GET",
-  // method: "HEAD",
-  // method: "POST",
-  // method: "PUT",
-});
-```
-
-### `new Response(S3File)`
-
-To quickly redirect users to a presigned URL for an S3 file, pass an `S3File` instance to a `Response` object as the body.
-
-```ts
-const response = new Response(s3file);
-console.log(response);
-```
-
-This will automatically redirect the user to the presigned URL for the S3 file, saving you the memory, time, and bandwidth cost of downloading the file to your server and sending it back to the user.
-
-```ts
-Response (0 KB) {
-  ok: false,
-  url: "",
-  status: 302,
-  statusText: "",
-  headers: Headers {
-    "location": "https://<account-id>.r2.cloudflarestorage.com/...",
-  },
-  redirected: true,
-  bodyUsed: false
-}
-```
-
-## Support for S3-Compatible Services
-
-Bun's S3 implementation works with any S3-compatible storage service. Just specify the appropriate endpoint:
-
-### Using Bun's S3Client with AWS S3
-
-AWS S3 is the default. You can also pass a `region` option instead of an `endpoint` option for AWS S3.
-
-```ts
-import { S3Client } from "bun";
-
-// AWS S3
-const s3 = new S3Client({
-  accessKeyId: "access-key",
-  secretAccessKey: "secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // region: "us-east-1",
-});
-```
-
-### Using Bun's S3Client with Google Cloud Storage
-
-To use Bun's S3 client with [Google Cloud Storage](https://cloud.google.com/storage), set `endpoint` to `"https://storage.googleapis.com"` in the `S3Client` constructor.
-
-```ts
-import { S3Client } from "bun";
-
-// Google Cloud Storage
-const gcs = new S3Client({
-  accessKeyId: "access-key",
-  secretAccessKey: "secret-key",
-  bucket: "my-bucket",
-  endpoint: "https://storage.googleapis.com",
-});
-```
-
-### Using Bun's S3Client with Cloudflare R2
-
-To use Bun's S3 client with [Cloudflare R2](https://developers.cloudflare.com/r2/), set `endpoint` to the R2 endpoint in the `S3Client` constructor. The R2 endpoint includes your account ID.
-
-```ts
-import { S3Client } from "bun";
-
-// CloudFlare R2
-const r2 = new S3Client({
-  accessKeyId: "access-key",
-  secretAccessKey: "secret-key",
-  bucket: "my-bucket",
-  endpoint: "https://<account-id>.r2.cloudflarestorage.com",
-});
-```
-
-### Using Bun's S3Client with DigitalOcean Spaces
-
-To use Bun's S3 client with [DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/), set `endpoint` to the DigitalOcean Spaces endpoint in the `S3Client` constructor.
-
-```ts
-import { S3Client } from "bun";
-
-const spaces = new S3Client({
-  accessKeyId: "access-key",
-  secretAccessKey: "secret-key",
-  bucket: "my-bucket",
-  // region: "nyc3",
-  endpoint: "https://<region>.digitaloceanspaces.com",
-});
-```
-
-### Using Bun's S3Client with MinIO
-
-To use Bun's S3 client with [MinIO](https://min.io/), set `endpoint` to the URL that MinIO is running on in the `S3Client` constructor.
-
-```ts
-import { S3Client } from "bun";
-
-const minio = new S3Client({
-  accessKeyId: "access-key",
-  secretAccessKey: "secret-key",
-  bucket: "my-bucket",
-
-  // Make sure to use the correct endpoint URL
-  // It might not be localhost in production!
-  endpoint: "http://localhost:9000",
-});
-```
-
-## Credentials
-
-Credentials are one of the hardest parts of using S3, and we've tried to make it as easy as possible. By default, Bun reads the following environment variables for credentials.
-
-| Option name       | Environment variable   |
-| ----------------- | ---------------------- |
-| `accessKeyId`     | `S3_ACCESS_KEY_ID`     |
-| `secretAccessKey` | `S3_SECRET_ACCESS_KEY` |
-| `region`          | `S3_REGION`            |
-| `endpoint`        | `S3_ENDPOINT`          |
-| `bucket`          | `S3_BUCKET`            |
-| `sessionToken`    | `S3_SESSION_TOKEN`     |
-
-If the `S3_*` environment variable is not set, Bun will also check for the `AWS_*` environment variable, for each of the above options.
-
-| Option name       | Fallback environment variable |
-| ----------------- | ----------------------------- |
-| `accessKeyId`     | `AWS_ACCESS_KEY_ID`           |
-| `secretAccessKey` | `AWS_SECRET_ACCESS_KEY`       |
-| `region`          | `AWS_REGION`                  |
-| `endpoint`        | `AWS_ENDPOINT`                |
-| `bucket`          | `AWS_BUCKET`                  |
-| `sessionToken`    | `AWS_SESSION_TOKEN`           |
-
-These environment variables are read from [`.env` files](/docs/runtime/env) or from the process environment at initialization time (`process.env` is not used for this).
-
-These defaults are overridden by the options you pass to `s3(credentials)`, `new Bun.S3Client(credentials)`, or any of the methods that accept credentials. So if, for example, you use the same credentials for different buckets, you can set the credentials once in your `.env` file and then pass `bucket: "my-bucket"` to the `s3()` helper function without having to specify all the credentials again.
-
-### `S3Client` objects
-
-When you're not using environment variables or using multiple buckets, you can create a `S3Client` object to explicitly set credentials.
-
-```ts
-import { S3Client } from "bun";
-
-const client = new S3Client({
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // sessionToken: "..."
-  endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
-  // endpoint: "http://localhost:9000", // MinIO
-});
-
-// Write using a Response
-await file.write(new Response("Hello World!"));
-
-// Presign a URL
-const url = file.presign({
-  expiresIn: 60 * 60 * 24, // 1 day
-  acl: "public-read",
-});
-
-// Delete the file
-await file.delete();
-```
-
-### `S3Client.prototype.write`
-
-To upload or write a file to S3, call `write` on the `S3Client` instance.
-
-```ts
-const client = new Bun.S3Client({
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  endpoint: "https://s3.us-east-1.amazonaws.com",
-  bucket: "my-bucket",
-});
-await client.write("my-file.txt", "Hello World!");
-await client.write("my-file.txt", new Response("Hello World!"));
-
-// equivalent to
-// await client.file("my-file.txt").write("Hello World!");
-```
-
-### `S3Client.prototype.delete`
-
-To delete a file from S3, call `delete` on the `S3Client` instance.
-
-```ts
-const client = new Bun.S3Client({
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-});
-
-await client.delete("my-file.txt");
-// equivalent to
-// await client.file("my-file.txt").delete();
-```
-
-### `S3Client.prototype.exists`
-
-To check if a file exists in S3, call `exists` on the `S3Client` instance.
-
-```ts
-const client = new Bun.S3Client({
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-});
-
-const exists = await client.exists("my-file.txt");
-// equivalent to
-// const exists = await client.file("my-file.txt").exists();
-```
-
-## `S3File`
-
-`S3File` instances are created by calling the `S3` instance method or the `s3()` helper function. Like `Bun.file()`, `S3File` instances are lazy. They don't refer to something that necessarily exists at the time of creation. That's why all the methods that don't involve network requests are fully synchronous.
-
-```ts
-interface S3File extends Blob {
-  slice(start: number, end?: number): S3File;
-  exists(): Promise<boolean>;
-  unlink(): Promise<void>;
-  presign(options: S3Options): string;
-  text(): Promise<string>;
-  json(): Promise<any>;
-  bytes(): Promise<Uint8Array>;
-  arrayBuffer(): Promise<ArrayBuffer>;
-  stream(options: S3Options): ReadableStream;
-  write(
-    data:
-      | string
-      | Uint8Array
-      | ArrayBuffer
-      | Blob
-      | ReadableStream
-      | Response
-      | Request,
-    options?: BlobPropertyBag,
-  ): Promise<void>;
-
-  exists(options?: S3Options): Promise<boolean>;
-  unlink(options?: S3Options): Promise<void>;
-  delete(options?: S3Options): Promise<void>;
-  presign(options?: S3Options): string;
-
-  stat(options?: S3Options): Promise<S3Stat>;
-  /**
-   * Size is not synchronously available because it requires a network request.
-   *
-   * @deprecated Use `stat()` instead.
-   */
-  size: NaN;
-
-  // ... more omitted for brevity
-}
-```
-
-Like `Bun.file()`, `S3File` extends [`Blob`](https://developer.mozilla.org/en-US/docs/Web/API/Blob), so all the methods that are available on `Blob` are also available on `S3File`. The same API for reading data from a local file is also available for reading data from S3.
-
-| Method                       | Output           |
-| ---------------------------- | ---------------- |
-| `await s3File.text()`        | `string`         |
-| `await s3File.bytes()`       | `Uint8Array`     |
-| `await s3File.json()`        | `JSON`           |
-| `await s3File.stream()`      | `ReadableStream` |
-| `await s3File.arrayBuffer()` | `ArrayBuffer`    |
-
-That means using `S3File` instances with `fetch()`, `Response`, and other web APIs that accept `Blob` instances just works.
-
-### Partial reads with `slice`
-
-To read a partial range of a file, you can use the `slice` method.
-
-```ts
-const partial = s3file.slice(0, 1024);
-
-// Read the partial range as a Uint8Array
-const bytes = await partial.bytes();
-
-// Read the partial range as a string
-const text = await partial.text();
-```
-
-Internally, this works by using the HTTP `Range` header to request only the bytes you want. This `slice` method is the same as [`Blob.prototype.slice`](https://developer.mozilla.org/en-US/docs/Web/API/Blob/slice).
-
-### Deleting files from S3
-
-To delete a file from S3, you can use the `delete` method.
-
-```ts
-await s3file.delete();
-// await s3File.unlink();
-```
-
-`delete` is the same as `unlink`.
-
-## Error codes
-
-When Bun's S3 API throws an error, it will have a `code` property that matches one of the following values:
-
-- `ERR_S3_MISSING_CREDENTIALS`
-- `ERR_S3_INVALID_METHOD`
-- `ERR_S3_INVALID_PATH`
-- `ERR_S3_INVALID_ENDPOINT`
-- `ERR_S3_INVALID_SIGNATURE`
-- `ERR_S3_INVALID_SESSION_TOKEN`
-
-When the S3 Object Storage service returns an error (that is, not Bun), it will be an `S3Error` instance (an `Error` instance with the name `"S3Error"`).
-
-## `S3Client` static methods
-
-The `S3Client` class provides several static methods for interacting with S3.
-
-### `S3Client.presign` (static)
-
-To generate a presigned URL for an S3 file, you can use the `S3Client.presign` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
-};
-
-const url = S3Client.presign("my-file.txt", {
-  ...credentials,
-  expiresIn: 3600,
-});
-```
-
-This is equivalent to calling `new S3Client(credentials).presign("my-file.txt", { expiresIn: 3600 })`.
-
-### `S3Client.exists` (static)
-
-To check if an S3 file exists, you can use the `S3Client.exists` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-};
-
-const exists = await S3Client.exists("my-file.txt", credentials);
-```
-
-The same method also works on `S3File` instances.
-
-```ts
-const s3file = Bun.s3("my-file.txt", {
-  ...credentials,
-});
-const exists = await s3file.exists();
-```
-
-### `S3Client.stat` (static)
-
-To get the size, etag, and other metadata of an S3 file, you can use the `S3Client.stat` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-};
-
-const stat = await S3Client.stat("my-file.txt", credentials);
-// {
-//   etag: "\"7a30b741503c0b461cc14157e2df4ad8\"",
-//   lastModified: 2025-01-07T00:19:10.000Z,
-//   size: 1024,
-//   type: "text/plain;charset=utf-8",
-// }
-```
-
-### `S3Client.delete` (static)
-
-To delete an S3 file, you can use the `S3Client.delete` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-};
-
-await S3Client.delete("my-file.txt", credentials);
-// equivalent to
-// await new S3Client(credentials).delete("my-file.txt");
-
-// S3Client.unlink is alias of S3Client.delete
-await S3Client.unlink("my-file.txt", credentials);
-```
-
-## s3:// protocol
-
-To make it easier to use the same code for local files and S3 files, the `s3://` protocol is supported in `fetch` and `Bun.file()`.
-
-```ts
-const response = await fetch("s3://my-bucket/my-file.txt");
-const file = Bun.file("s3://my-bucket/my-file.txt");
-```
-
-You can additionally pass `s3` options to the `fetch` and `Bun.file` functions.
-
-```ts
-const response = await fetch("s3://my-bucket/my-file.txt", {
-  s3: {
-    accessKeyId: "your-access-key",
-    secretAccessKey: "your-secret-key",
-    endpoint: "https://s3.us-east-1.amazonaws.com",
-  },
-  headers: {
-    "range": "bytes=0-1023",
-  },
-});
-```
-
-### UTF-8, UTF-16, and BOM (byte order mark)
-
-Like `Response` and `Blob`, `S3File` assumes UTF-8 encoding by default.
-
-When calling one of the `text()` or `json()` methods on an `S3File`:
-
-- When a UTF-16 byte order mark (BOM) is detected, it will be treated as UTF-16. JavaScriptCore natively supports UTF-16, so it skips the UTF-8 transcoding process (and strips the BOM). This is mostly good, but it does mean if you have invalid surrogate pairs characters in your UTF-16 string, they will be passed through to JavaScriptCore (same as source code).
-- When a UTF-8 BOM is detected, it gets stripped before the string is passed to JavaScriptCore and invalid UTF-8 codepoints are replaced with the Unicode replacement character (`\uFFFD`).
-- UTF-32 is not supported.

docs/api/sqlite.md

@@ -75,14 +75,14 @@ To instead throw an error when a parameter is missing and allow binding without
 import { Database } from "bun:sqlite";
 
 const strict = new Database(
-  ":memory:",
+  ":memory:", 
   { strict: true }
 );
 
 // throws error because of the typo:
 const query = strict
   .query("SELECT $message;")
-  .all({ message: "Hello world" });
+  .all({ messag: "Hello world" });
 
 const notStrict = new Database(
   ":memory:"
@@ -90,7 +90,7 @@ const notStrict = new Database(
 // does not throw error:
 notStrict
   .query("SELECT $message;")
-  .all({ message: "Hello world" });
+  .all({ messag: "Hello world" });
 ```
 
 ### Load via ES module import
@@ -177,7 +177,7 @@ const query = db.prepare("SELECT * FROM foo WHERE bar = ?");
 
 ## WAL mode
 
-SQLite supports [write-ahead log mode](https://www.sqlite.org/wal.html) (WAL) which dramatically improves performance, especially in situations with many concurrent readers and a single writer. It's broadly recommended to enable WAL mode for most typical applications.
+SQLite supports [write-ahead log mode](https://www.sqlite.org/wal.html) (WAL) which dramatically improves performance, especially in situations with many concurrent writes. It's broadly recommended to enable WAL mode for most typical applications.
 
 To enable WAL mode, run this pragma query at the beginning of your application:
 

docs/api/utils.md

@@ -121,7 +121,7 @@ const id = randomUUIDv7();
 
 A UUID v7 is a 128-bit value that encodes the current timestamp, a random value, and a counter. The timestamp is encoded using the lowest 48 bits, and the random value and counter are encoded using the remaining bits.
 
-The `timestamp` parameter defaults to the current time in milliseconds. When the timestamp changes, the counter is reset to a pseudo-random integer wrapped to 4096. This counter is atomic and threadsafe, meaning that using `Bun.randomUUIDv7()` in many Workers within the same process running at the same timestamp will not have colliding counter values.
+The `timestamp` parameter defaults to the current time in milliseconds. When the timestamp changes, the counter is reset to a psuedo-random integer wrapped to 4096. This counter is atomic and threadsafe, meaning that using `Bun.randomUUIDv7()` in many Workers within the same process running at the same timestamp will not have colliding counter values.
 
 The final 8 bytes of the UUID are a cryptographically secure random value. It uses the same random number generator used by `crypto.randomUUID()` (which comes from BoringSSL, which in turn comes from the platform-specific system random number generator usually provided by the underlying hardware).
 
@@ -771,28 +771,3 @@ console.log(obj); // => { foo: "bar" }
 ```
 
 Internally, [`structuredClone`](https://developer.mozilla.org/en-US/docs/Web/API/structuredClone) and [`postMessage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) serialize and deserialize the same way. This exposes the underlying [HTML Structured Clone Algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm) to JavaScript as an ArrayBuffer.
-
-## `estimateShallowMemoryUsageOf` in `bun:jsc`
-
-The `estimateShallowMemoryUsageOf` function returns a best-effort estimate of the memory usage of an object in bytes, excluding the memory usage of properties or other objects it references. For accurate per-object memory usage, use `Bun.generateHeapSnapshot`.
-
-```js
-import { estimateShallowMemoryUsageOf } from "bun:jsc";
-
-const obj = { foo: "bar" };
-const usage = estimateShallowMemoryUsageOf(obj);
-console.log(usage); // => 16
-
-const buffer = Buffer.alloc(1024 * 1024);
-estimateShallowMemoryUsageOf(buffer);
-// => 1048624
-
-const req = new Request("https://bun.sh");
-estimateShallowMemoryUsageOf(req);
-// => 167
-
-const array = Array(1024).fill({ a: 1 });
-// Arrays are usually not stored contiguously in memory, so this will not return a useful value (which isn't a bug).
-estimateShallowMemoryUsageOf(array);
-// => 16
-```

docs/bundler/executables.md

@@ -279,19 +279,6 @@ $ bun build --compile --asset-naming="[name].[ext]" ./index.ts
 
 To trim down the size of the executable a little, pass `--minify` to `bun build --compile`. This uses Bun's minifier to reduce the code size. Overall though, Bun's binary is still way too big and we need to make it smaller.
 
-## Windows-specific flags
-
-When compiling a standalone executable on Windows, there are two platform-specific options that can be used to customize metadata on the generated `.exe` file:
-
-- `--windows-icon=path/to/icon.ico` to customize the executable file icon.
-- `--windows-hide-console` to disable the background terminal, which can be used for applications that do not need a TTY.
-
-{% callout %}
-
-These flags currently cannot be used when cross-compiling because they depend on Windows APIs.
-
-{% /callout %}
-
 ## Unsupported CLI arguments
 
 Currently, the `--compile` flag can only accept a single entrypoint at a time and does not support the following flags:

docs/bundler/html.md

@@ -1,110 +0,0 @@
-As of Bun v1.1.43, Bun's bundler now has first-class support for HTML. Build static sites, landing pages, and web applications with zero configuration. Just point Bun at your HTML file and it handles everything else.
-
-```html#index.html
-<!doctype html>
-<html>
-  <head>
-    <link rel="stylesheet" href="./styles.css" />
-    <script src="./app.ts" type="module"></script>
-  </head>
-  <body>
-    <img src="./logo.png" />
-  </body>
-</html>
-```
-
-One command is all you need (won't be experimental after Bun v1.2):
-
-{% codetabs %}
-
-```bash#CLI
-$ bun build --experimental-html --experimental-css ./index.html --outdir=dist
-```
-
-```ts#API
-Bun.build({
-  entrypoints: ["./index.html"],
-  outdir: "./dist",
-
-  // On by default in Bun v1.2+
-  html: true,
-  experimentalCss: true,
-});
-```
-
-{% /codetabs %}
-
-Bun automatically:
-
-- Bundles, tree-shakes, and optimizes your JavaScript, JSX and TypeScript
-- Bundles and optimizes your CSS
-- Copies & hashes images and other assets
-- Updates all references to local files or packages in your HTML
-
-## Zero Config, Maximum Performance
-
-The HTML bundler is enabled by default after Bun v1.2+. Drop in your existing HTML files and Bun will handle:
-
-- **TypeScript & JSX** - Write modern JavaScript for browsers without the setup
-- **CSS** - Bundle CSS stylesheets directly from `<link rel="stylesheet">` or `@import`
-- **Images & Assets** - Automatic copying & hashing & rewriting of assets in JavaScript, CSS, and HTML
-
-## Watch mode
-
-You can run `bun build --watch` to watch for changes and rebuild automatically.
-
-You've never seen a watch mode this fast.
-
-## Plugin API
-
-Need more control? Configure the bundler through the JavaScript API and use Bun's builtin `HTMLRewriter` to preprocess HTML.
-
-```ts
-await Bun.build({
-  entrypoints: ["./index.html"],
-  outdir: "./dist",
-  html: true,
-  experimentalCss: true,
-  minify: true,
-
-  plugins: [
-    {
-      // A plugin that makes every HTML tag lowercase
-      name: "lowercase-html-plugin",
-      setup({ onLoad }) {
-        const rewriter = new HTMLRewriter().on("*", {
-          element(element) {
-            element.tagName = element.tagName.toLowerCase();
-          },
-          text(element) {
-            element.replace(element.text.toLowerCase());
-          },
-        });
-
-        onLoad({ filter: /\.html$/ }, async args => {
-          const html = await Bun.file(args.path).text();
-
-          return {
-            // Bun's bundler will scan the HTML for <script> tags, <link rel="stylesheet"> tags, and other assets
-            // and bundle them automatically
-            contents: rewriter.transform(html),
-            loader: "html",
-          };
-        });
-      },
-    },
-  ],
-});
-```
-
-## What Gets Processed?
-
-Bun automatically handles all common web assets:
-
-- Scripts (`<script src>`) are run through Bun's JavaScript/TypeScript/JSX bundler
-- Stylesheets (`<link rel="stylesheet">`) are run through Bun's CSS parser & bundler
-- Images (`<img>`, `<picture>`) are copied and hashed
-- Media (`<video>`, `<audio>`, `<source>`) are copied and hashed
-- Any `<link>` tag with an `href` attribute pointing to a local file is rewritten to the new path, and hashed
-
-All paths are resolved relative to your HTML file, making it easy to organize your project however you want.

docs/bundler/index.md

@@ -546,113 +546,6 @@ export type ImportKind =
 
 By design, the manifest is a simple JSON object that can easily be serialized or written to disk. It is also compatible with esbuild's [`metafile`](https://esbuild.github.io/api/#metafile) format. -->
 
-### `env`
-
-Controls how environment variables are handled during bundling. Internally, this uses `define` to inject environment variables into the bundle, but makes it easier to specify the environment variables to inject.
-
-#### `env: "inline"`
-
-Injects environment variables into the bundled output by converting `process.env.FOO` references to string literals containing the actual environment variable values.
-
-{% codetabs group="a" %}
-
-```ts#JavaScript
-await Bun.build({
-  entrypoints: ['./index.tsx'],
-  outdir: './out',
-  env: "inline",
-})
-```
-
-```bash#CLI
-$ FOO=bar BAZ=123 bun build ./index.tsx --outdir ./out --env inline
-```
-
-{% /codetabs %}
-
-For the input below:
-
-```js#input.js
-console.log(process.env.FOO);
-console.log(process.env.BAZ);
-```
-
-The generated bundle will contain the following code:
-
-```js#output.js
-console.log("bar");
-console.log("123");
-```
-
-#### `env: "PUBLIC_*"` (prefix)
-
-Inlines environment variables matching the given prefix (the part before the `*` character), replacing `process.env.FOO` with the actual environment variable value. This is useful for selectively inlining environment variables for things like public-facing URLs or client-side tokens, without worrying about injecting private credentials into output bundles.
-
-{% codetabs group="a" %}
-
-```ts#JavaScript
-await Bun.build({
-  entrypoints: ['./index.tsx'],
-  outdir: './out',
-
-  // Inline all env vars that start with "ACME_PUBLIC_"
-  env: "ACME_PUBLIC_*",
-})
-```
-
-```bash#CLI
-$ FOO=bar BAZ=123 ACME_PUBLIC_URL=https://acme.com bun build ./index.tsx --outdir ./out --env 'ACME_PUBLIC_*'
-```
-
-{% /codetabs %}
-
-For example, given the following environment variables:
-
-```bash
-$ FOO=bar BAZ=123 ACME_PUBLIC_URL=https://acme.com
-```
-
-And source code:
-
-```ts#index.tsx
-console.log(process.env.FOO);
-console.log(process.env.ACME_PUBLIC_URL);
-console.log(process.env.BAZ);
-```
-
-The generated bundle will contain the following code:
-
-```js
-console.log(process.env.FOO);
-console.log("https://acme.com");
-console.log(process.env.BAZ);
-```
-
-#### `env: "disable"`
-
-Disables environment variable injection entirely.
-
-For example, given the following environment variables:
-
-```bash
-$ FOO=bar BAZ=123 ACME_PUBLIC_URL=https://acme.com
-```
-
-And source code:
-
-```ts#index.tsx
-console.log(process.env.FOO);
-console.log(process.env.ACME_PUBLIC_URL);
-console.log(process.env.BAZ);
-```
-
-The generated bundle will contain the following code:
-
-```js
-console.log(process.env.FOO);
-console.log(process.env.BAZ);
-```
-
 ### `sourcemap`
 
 Specifies the type of sourcemap to generate.
@@ -1259,7 +1152,7 @@ $ bun build ./index.tsx --outdir ./out --drop=console --drop=debugger --drop=any
 
 ### `experimentalCss`
 
-Whether to enable _experimental_ support for bundling CSS files. Defaults to `false`. In 1.2, this property will be deleted, and CSS bundling will always be enabled.
+Whether to enable _experimental_ support for bundling CSS files. Defaults to `false`.
 
 This supports bundling CSS files imported from JS, as well as CSS entrypoints.
 
@@ -1275,12 +1168,6 @@ const result = await Bun.build({
 
 {% /codetabs %}
 
-### `throw`
-
-If set to `true`, `Bun.build` will throw on build failure. See the section ["Logs and Errors"](#logs-and-errors) for more details on the error message structure.
-
-In 1.2, this will default to `true`, with the previous behavior as `throw: false`
-
 ## Outputs
 
 The `Bun.build` function returns a `Promise<BuildOutput>`, defined as:
@@ -1420,70 +1307,7 @@ Refer to [Bundler > Executables](https://bun.sh/docs/bundler/executables) for co
 
 ## Logs and errors
 
-<!-- 1.2 documentation -->
-<!-- On failure, `Bun.build` returns a rejected promise with an `AggregateError`. This can be logged to the console for pretty printing of the error list, or programmatically read with a `try`/`catch` block.
-
-```ts
-try {
-  const result = await Bun.build({
-    entrypoints: ["./index.tsx"],
-    outdir: "./out",
-  });
-} catch (e) {
-  // TypeScript does not allow annotations on the catch clause
-  const error = e as AggregateError;
-  console.error("Build Failed");
-
-  // Example: Using the built-in formatter
-  console.error(error);
-
-  // Example: Serializing the failure as a JSON string.
-  console.error(JSON.stringify(error, null, 2));
-}
-```
-
-{% callout %}
-
-Most of the time, an explicit `try`/`catch` is not needed, as Bun will neatly print uncaught exceptions. It is enough to just use a top-level `await` on the `Bun.build` call.
-
-{% /callout %}
-
-Each item in `error.errors` is an instance of `BuildMessage` or `ResolveMessage` (subclasses of Error), containing detailed information for each error.
-
-```ts
-class BuildMessage {
-  name: string;
-  position?: Position;
-  message: string;
-  level: "error" | "warning" | "info" | "debug" | "verbose";
-}
-
-class ResolveMessage extends BuildMessage {
-  code: string;
-  referrer: string;
-  specifier: string;
-  importKind: ImportKind;
-}
-```
-
-On build success, the returned object contains a `logs` property, which contains bundler warnings and info messages.
-
-```ts
-const result = await Bun.build({
-  entrypoints: ["./index.tsx"],
-  outdir: "./out",
-});
-
-if (result.logs.length > 0) {
-  console.warn("Build succeeded with warnings:");
-  for (const message of result.logs) {
-    // Bun will pretty print the message object
-    console.warn(message);
-  }
-}
-``` -->
-
-By default, `Bun.build` only throws if invalid options are provided. Read the `success` property to determine if the build was successful; the `logs` property will contain additional details.
+`Bun.build` only throws if invalid options are provided. Read the `success` property to determine if the build was successful; the `logs` property will contain additional details.
 
 ```ts
 const result = await Bun.build({
@@ -1526,27 +1350,6 @@ if (!result.success) {
 }
 ```
 
-In Bun 1.2, throwing an aggregate error like this will become the default beahavior. You can opt-into it early using the `throw: true` option.
-
-```ts
-try {
-  const result = await Bun.build({
-    entrypoints: ["./index.tsx"],
-    outdir: "./out",
-  });
-} catch (e) {
-  // TypeScript does not allow annotations on the catch clause
-  const error = e as AggregateError;
-  console.error("Build Failed");
-
-  // Example: Using the built-in formatter
-  console.error(error);
-
-  // Example: Serializing the failure as a JSON string.
-  console.error(JSON.stringify(error, null, 2));
-}
-```
-
 ## Reference
 
 ```ts
@@ -1568,23 +1371,39 @@ interface BuildConfig {
    *
    * @default "esm"
    */
-  format?: "esm" | "cjs" | "iife";
+  format?: /**
+
+     * ECMAScript Module format
+     */
+  | "esm"
+    /**
+     * CommonJS format
+     * **Experimental**
+     */
+    | "cjs"
+    /**
+     * IIFE format
+     * **Experimental**
+     */
+    | "iife";
   naming?:
     | string
     | {
         chunk?: string;
         entry?: string;
         asset?: string;
-      };
+      }; // | string;
   root?: string; // project root
   splitting?: boolean; // default true, enable code splitting
   plugins?: BunPlugin[];
+  // manifest?: boolean; // whether to return manifest
   external?: string[];
   packages?: "bundle" | "external";
   publicPath?: string;
   define?: Record<string, string>;
+  // origin?: string; // e.g. http://mydomain.com
   loader?: { [k in string]: Loader };
-  sourcemap?: "none" | "linked" | "inline" | "external" | "linked" | boolean; // default: "none", true -> "inline"
+  sourcemap?: "none" | "linked" | "inline" | "external" | "linked"; // default: "none", true -> "inline"
   /**
    * package.json `exports` conditions used when resolving imports
    *
@@ -1593,18 +1412,6 @@ interface BuildConfig {
    * https://nodejs.org/api/packages.html#exports
    */
   conditions?: Array<string> | string;
-
-  /**
-   * Controls how environment variables are handled during bundling.
-   *
-   * Can be one of:
-   * - `"inline"`: Injects environment variables into the bundled output by converting `process.env.FOO`
-   *   references to string literals containing the actual environment variable values
-   * - `"disable"`: Disables environment variable injection entirely
-   * - A string ending in `*`: Inlines environment variables that match the given prefix.
-   *   For example, `"MY_PUBLIC_*"` will only include env vars starting with "MY_PUBLIC_"
-   */
-  env?: "inline" | "disable" | `${string}*`;
   minify?:
     | boolean
     | {
@@ -1622,6 +1429,20 @@ interface BuildConfig {
    * Force emitting @__PURE__ annotations even if minify.whitespace is true.
    */
   emitDCEAnnotations?: boolean;
+  // treeshaking?: boolean;
+
+  // jsx?:
+  //   | "automatic"
+  //   | "classic"
+  //   | /* later: "preserve" */ {
+  //       runtime?: "automatic" | "classic"; // later: "preserve"
+  //       /** Only works when runtime=classic */
+  //       factory?: string; // default: "React.createElement"
+  //       /** Only works when runtime=classic */
+  //       fragment?: string; // default: "React.Fragment"
+  //       /** Only works when runtime=automatic */
+  //       importSource?: string; // default: "react"
+  //     };
 
   /**
    * Generate bytecode for the output. This can dramatically improve cold
@@ -1634,37 +1455,6 @@ interface BuildConfig {
    * @default false
    */
   bytecode?: boolean;
-  /**
-   * Add a banner to the bundled code such as "use client";
-   */
-  banner?: string;
-  /**
-   * Add a footer to the bundled code such as a comment block like
-   *
-   * `// made with bun!`
-   */
-  footer?: string;
-
-  /**
-   * **Experimental**
-   *
-   * Enable CSS support.
-   */
-  experimentalCss?: boolean;
-
-  /**
-   * Drop function calls to matching property accesses.
-   */
-  drop?: string[];
-
-  /**
-   * When set to `true`, the returned promise rejects with an AggregateError when a build failure happens.
-   * When set to `false`, the `success` property of the returned object will be `false` when a build failure happens.
-   *
-   * This defaults to `false` in Bun 1.1 and will change to `true` in Bun 1.2
-   * as most usage of `Bun.build` forgets to check for errors.
-   */
-  throw?: boolean;
 }
 
 interface BuildOutput {
@@ -1722,3 +1512,32 @@ declare class ResolveMessage {
   toString(): string;
 }
 ```
+
+<!--
+interface BuildManifest {
+  inputs: {
+    [path: string]: {
+      output: {
+        path: string;
+      };
+      imports: {
+        path: string;
+        kind: ImportKind;
+        external?: boolean;
+        asset?: boolean; // whether the import defaulted to "file" loader
+      }[];
+    };
+  };
+  outputs: {
+    [path: string]: {
+      type: "chunk" | "entrypoint" | "asset";
+      inputs: { path: string }[];
+      imports: {
+        path: string;
+        kind: ImportKind;
+        external?: boolean;
+      }[];
+      exports: string[];
+    };
+  };
+} -->

docs/bundler/loaders.md

@@ -1,6 +1,6 @@
 The Bun bundler implements a set of default loaders out of the box. As a rule of thumb, the bundler and the runtime both support the same set of file types out of the box.
 
-`.js` `.cjs` `.mjs` `.mts` `.cts` `.ts` `.tsx` `.jsx` `.toml` `.json` `.txt` `.wasm` `.node` `.html`
+`.js` `.cjs` `.mjs` `.mts` `.cts` `.ts` `.tsx` `.jsx` `.toml` `.json` `.txt` `.wasm` `.node`
 
 Bun uses the file extension to determine which built-in _loader_ should be used to parse the file. Every loader has a name, such as `js`, `tsx`, or `json`. These names are used when building [plugins](https://bun.sh/docs/bundler/plugins) that extend Bun with custom loaders.
 
@@ -203,81 +203,6 @@ When using a [standalone executable](https://bun.sh/docs/bundler/executables), t
 
 Otherwise, the database to embed is copied into the `outdir` with a hashed filename.
 
-### `html`
-
-**HTML loader**. Default for `.html` after Bun v1.2.0.
-
-To enable the html loader:
-
-- For `Bun.build`: set `html: true`
-- For `bun build`: `--experimental-html` CLI flag
-
-You most likely want to use the `html` loader in conjunction with `experimentalCss: true` or `--experimental-css`.
-
-The html loader processes HTML files and bundles any referenced assets. It will:
-
-- Bundle and hash referenced JavaScript files (`<script src="...">`)
-- Bundle and hash referenced CSS files (`<link rel="stylesheet" href="...">`)
-- Hash referenced images (`<img src="...">`)
-- Preserve external URLs (by default, anything starting with `http://` or `https://`)
-
-For example, given this HTML file:
-
-{% codetabs %}
-
-```html#src/index.html
-<!DOCTYPE html>
-<html>
-  <body>
-    <img src="./image.jpg" alt="Local image">
-    <img src="https://example.com/image.jpg" alt="External image">
-    <script type="module" src="./script.js"></script>
-  </body>
-</html>
-```
-
-{% /codetabs %}
-
-It will output a new HTML file with the bundled assets:
-
-{% codetabs %}
-
-```html#dist/output.html
-<!DOCTYPE html>
-<html>
-  <body>
-    <img src="./image-HASHED.jpg" alt="Local image">
-    <img src="https://example.com/image.jpg" alt="External image">
-    <script type="module" src="./output-ALSO-HASHED.js"></script>
-  </body>
-</html>
-```
-
-{% /codetabs %}
-
-Under the hood, it uses [`lol-html`](https://github.com/cloudflare/lol-html) to extract script and link tags as entrypoints, and other assets as external.
-
-Currently, the list of selectors is:
-
-- `audio[src]`
-- `iframe[src]`
-- `img[src]`
-- `img[srcset]`
-- `link:not([rel~='stylesheet']):not([rel~='modulepreload']):not([rel~='manifest']):not([rel~='icon']):not([rel~='apple-touch-icon'])[href]`
-- `link[as='font'][href], link[type^='font/'][href]`
-- `link[as='image'][href]`
-- `link[as='style'][href]`
-- `link[as='video'][href], link[as='audio'][href]`
-- `link[as='worker'][href]`
-- `link[rel='icon'][href], link[rel='apple-touch-icon'][href]`
-- `link[rel='manifest'][href]`
-- `link[rel='stylesheet'][href]`
-- `script[src]`
-- `source[src]`
-- `source[srcset]`
-- `video[poster]`
-- `video[src]`
-
 ### `sh` loader
 
 **Bun Shell loader**. Default for `.sh` files

docs/bundler/plugins.md

@@ -2,47 +2,11 @@ Bun provides a universal plugin API that can be used to extend both the _runtime
 
 Plugins intercept imports and perform custom loading logic: reading files, transpiling code, etc. They can be used to add support for additional file types, like `.scss` or `.yaml`. In the context of Bun's bundler, plugins can be used to implement framework-level features like CSS extraction, macros, and client-server code co-location.
 
-## Lifecycle hooks
-
-Plugins can register callbacks to be run at various points in the lifecycle of a bundle:
-
-- [`onStart()`](#onstart): Run once the bundler has started a bundle
-- [`onResolve()`](#onresolve): Run before a module is resolved
-- [`onLoad()`](#onload): Run before a module is loaded.
-- [`onBeforeParse()`](#onbeforeparse): Run zero-copy native addons in the parser thread before a file is parsed.
-
-### Reference
-
-A rough overview of the types (please refer to Bun's `bun.d.ts` for the full type definitions):
-
-```ts
-type PluginBuilder = {
-  onStart(callback: () => void): void;
-  onResolve: (
-    args: { filter: RegExp; namespace?: string },
-    callback: (args: { path: string; importer: string }) => {
-      path: string;
-      namespace?: string;
-    } | void,
-  ) => void;
-  onLoad: (
-    args: { filter: RegExp; namespace?: string },
-    defer: () => Promise<void>,
-    callback: (args: { path: string }) => {
-      loader?: Loader;
-      contents?: string;
-      exports?: Record<string, any>;
-    },
-  ) => void;
-  config: BuildConfig;
-};
-
-type Loader = "js" | "jsx" | "ts" | "tsx" | "css" | "json" | "toml";
-```
+For more complete documentation of the Plugin API, see [Runtime > Plugins](https://bun.sh/docs/runtime/plugins).
 
 ## Usage
 
-A plugin is defined as simple JavaScript object containing a `name` property and a `setup` function.
+A plugin is defined as simple JavaScript object containing a `name` property and a `setup` function. Register a plugin with Bun using the `plugin` function.
 
 ```tsx#myPlugin.ts
 import type { BunPlugin } from "bun";
@@ -58,343 +22,9 @@ const myPlugin: BunPlugin = {
 This plugin can be passed into the `plugins` array when calling `Bun.build`.
 
 ```ts
-await Bun.build({
+Bun.build({
   entrypoints: ["./app.ts"],
   outdir: "./out",
   plugins: [myPlugin],
 });
 ```
-
-## Plugin lifecycle
-
-### Namespaces
-
-`onLoad` and `onResolve` accept an optional `namespace` string. What is a namespace?
-
-Every module has a namespace. Namespaces are used to prefix the import in transpiled code; for instance, a loader with a `filter: /\.yaml$/` and `namespace: "yaml:"` will transform an import from `./myfile.yaml` into `yaml:./myfile.yaml`.
-
-The default namespace is `"file"` and it is not necessary to specify it, for instance: `import myModule from "./my-module.ts"` is the same as `import myModule from "file:./my-module.ts"`.
-
-Other common namespaces are:
-
-- `"bun"`: for Bun-specific modules (e.g. `"bun:test"`, `"bun:sqlite"`)
-- `"node"`: for Node.js modules (e.g. `"node:fs"`, `"node:path"`)
-
-### `onStart`
-
-```ts
-onStart(callback: () => void): Promise<void> | void;
-```
-
-Registers a callback to be run when the bundler starts a new bundle.
-
-```ts
-import { plugin } from "bun";
-
-plugin({
-  name: "onStart example",
-
-  setup(build) {
-    build.onStart(() => {
-      console.log("Bundle started!");
-    });
-  },
-});
-```
-
-The callback can return a `Promise`. After the bundle process has initialized, the bundler waits until all `onStart()` callbacks have completed before continuing.
-
-For example:
-
-```ts
-const result = await Bun.build({
-  entrypoints: ["./app.ts"],
-  outdir: "./dist",
-  sourcemap: "external",
-  plugins: [
-    {
-      name: "Sleep for 10 seconds",
-      setup(build) {
-        build.onStart(async () => {
-          await Bunlog.sleep(10_000);
-        });
-      },
-    },
-    {
-      name: "Log bundle time to a file",
-      setup(build) {
-        build.onStart(async () => {
-          const now = Date.now();
-          await Bun.$`echo ${now} > bundle-time.txt`;
-        });
-      },
-    },
-  ],
-});
-```
-
-In the above example, Bun will wait until the first `onStart()` (sleeping for 10 seconds) has completed, _as well as_ the second `onStart()` (writing the bundle time to a file).
-
-Note that `onStart()` callbacks (like every other lifecycle callback) do not have the ability to modify the `build.config` object. If you want to mutate `build.config`, you must do so directly in the `setup()` function.
-
-### `onResolve`
-
-```ts
-onResolve(
-  args: { filter: RegExp; namespace?: string },
-  callback: (args: { path: string; importer: string }) => {
-    path: string;
-    namespace?: string;
-  } | void,
-): void;
-```
-
-To bundle your project, Bun walks down the dependency tree of all modules in your project. For each imported module, Bun actually has to find and read that module. The "finding" part is known as "resolving" a module.
-
-The `onResolve()` plugin lifecycle callback allows you to configure how a module is resolved.
-
-The first argument to `onResolve()` is an object with a `filter` and [`namespace`](#what-is-a-namespace) property. The filter is a regular expression which is run on the import string. Effectively, these allow you to filter which modules your custom resolution logic will apply to.
-
-The second argument to `onResolve()` is a callback which is run for each module import Bun finds that matches the `filter` and `namespace` defined in the first argument.
-
-The callback receives as input the _path_ to the matching module. The callback can return a _new path_ for the module. Bun will read the contents of the _new path_ and parse it as a module.
-
-For example, redirecting all imports to `images/` to `./public/images/`:
-
-```ts
-import { plugin } from "bun";
-
-plugin({
-  name: "onResolve example",
-  setup(build) {
-    build.onResolve({ filter: /.*/, namespace: "file" }, args => {
-      if (args.path.startsWith("images/")) {
-        return {
-          path: args.path.replace("images/", "./public/images/"),
-        };
-      }
-    });
-  },
-});
-```
-
-### `onLoad`
-
-```ts
-onLoad(
-  args: { filter: RegExp; namespace?: string },
-  defer: () => Promise<void>,
-  callback: (args: { path: string, importer: string, namespace: string, kind: ImportKind  }) => {
-    loader?: Loader;
-    contents?: string;
-    exports?: Record<string, any>;
-  },
-): void;
-```
-
-After Bun's bundler has resolved a module, it needs to read the contents of the module and parse it.
-
-The `onLoad()` plugin lifecycle callback allows you to modify the _contents_ of a module before it is read and parsed by Bun.
-
-Like `onResolve()`, the first argument to `onLoad()` allows you to filter which modules this invocation of `onLoad()` will apply to.
-
-The second argument to `onLoad()` is a callback which is run for each matching module _before_ Bun loads the contents of the module into memory.
-
-This callback receives as input the _path_ to the matching module, the _importer_ of the module (the module that imported the module), the _namespace_ of the module, and the _kind_ of the module.
-
-The callback can return a new `contents` string for the module as well as a new `loader`.
-
-For example:
-
-```ts
-import { plugin } from "bun";
-
-const envPlugin: BunPlugin = {
-  name: "env plugin",
-  setup(build) {
-    build.onLoad({ filter: /env/, namespace: "file" }, args => {
-      return {
-        contents: `export default ${JSON.stringify(process.env)}`,
-        loader: "js",
-      };
-    });
-  },
-});
-
-Bun.build({
-  entrypoints: ["./app.ts"],
-  outdir: "./dist",
-  plugins: [envPlugin],
-});
-
-// import env from "env"
-// env.FOO === "bar"
-```
-
-This plugin will transform all imports of the form `import env from "env"` into a JavaScript module that exports the current environment variables.
-
-#### `.defer()`
-
-One of the arguments passed to the `onLoad` callback is a `defer` function. This function returns a `Promise` that is resolved when all _other_ modules have been loaded.
-
-This allows you to delay execution of the `onLoad` callback until all other modules have been loaded.
-
-This is useful for returning contents of a module that depends on other modules.
-
-##### Example: tracking and reporting unused exports
-
-```ts
-import { plugin } from "bun";
-
-plugin({
-  name: "track imports",
-  setup(build) {
-    const transpiler = new Bun.Transpiler();
-
-    let trackedImports: Record<string, number> = {};
-
-    // Each module that goes through this onLoad callback
-    // will record its imports in `trackedImports`
-    build.onLoad({ filter: /\.ts/ }, async ({ path }) => {
-      const contents = await Bun.file(path).arrayBuffer();
-
-      const imports = transpiler.scanImports(contents);
-
-      for (const i of imports) {
-        trackedImports[i.path] = (trackedImports[i.path] || 0) + 1;
-      }
-
-      return undefined;
-    });
-
-    build.onLoad({ filter: /stats\.json/ }, async ({ defer }) => {
-      // Wait for all files to be loaded, ensuring
-      // that every file goes through the above `onLoad()` function
-      // and their imports tracked
-      await defer();
-
-      // Emit JSON containing the stats of each import
-      return {
-        contents: `export default ${JSON.stringify(trackedImports)}`,
-        loader: "json",
-      };
-    });
-  },
-});
-```
-
-Note that the `.defer()` function currently has the limitation that it can only be called once per `onLoad` callback.
-
-## Native plugins
-
-One of the reasons why Bun's bundler is so fast is that it is written in native code and leverages multi-threading to load and parse modules in parallel.
-
-However, one limitation of plugins written in JavaScript is that JavaScript itself is single-threaded.
-
-Native plugins are written as [NAPI](/docs/node-api) modules and can be run on multiple threads. This allows native plugins to run much faster than JavaScript plugins.
-
-In addition, native plugins can skip unnecessary work such as the UTF-8 -> UTF-16 conversion needed to pass strings to JavaScript.
-
-These are the following lifecycle hooks which are available to native plugins:
-
-- [`onBeforeParse()`](#onbeforeparse): Called on any thread before a file is parsed by Bun's bundler.
-
-Native plugins are NAPI modules which expose lifecycle hooks as C ABI functions.
-
-To create a native plugin, you must export a C ABI function which matches the signature of the native lifecycle hook you want to implement.
-
-### Creating a native plugin in Rust
-
-Native plugins are NAPI modules which expose lifecycle hooks as C ABI functions.
-
-To create a native plugin, you must export a C ABI function which matches the signature of the native lifecycle hook you want to implement.
-
-```bash
-bun add -g @napi-rs/cli
-napi new
-```
-
-Then install this crate:
-
-```bash
-cargo add bun-native-plugin
-```
-
-Now, inside the `lib.rs` file, we'll use the `bun_native_plugin::bun` proc macro to define a function which
-will implement our native plugin.
-
-Here's an example implementing the `onBeforeParse` hook:
-
-```rs
-use bun_native_plugin::{define_bun_plugin, OnBeforeParse, bun, Result, anyhow, BunLoader};
-use napi_derive::napi;
-
-/// Define the plugin and its name
-define_bun_plugin!("replace-foo-with-bar");
-
-/// Here we'll implement `onBeforeParse` with code that replaces all occurrences of
-/// `foo` with `bar`.
-///
-/// We use the #[bun] macro to generate some of the boilerplate code.
-///
-/// The argument of the function (`handle: &mut OnBeforeParse`) tells
-/// the macro that this function implements the `onBeforeParse` hook.
-#[bun]
-pub fn replace_foo_with_bar(handle: &mut OnBeforeParse) -> Result<()> {
-  // Fetch the input source code.
-  let input_source_code = handle.input_source_code()?;
-
-  // Get the Loader for the file
-  let loader = handle.output_loader();
-
-
-  let output_source_code = input_source_code.replace("foo", "bar");
-
-  handle.set_output_source_code(output_source_code, BunLoader::BUN_LOADER_JSX);
-
-  Ok(())
-}
-```
-
-And to use it in Bun.build():
-
-```typescript
-import myNativeAddon from "./my-native-addon";
-Bun.build({
-  entrypoints: ["./app.tsx"],
-  plugins: [
-    {
-      name: "my-plugin",
-
-      setup(build) {
-        build.onBeforeParse(
-          {
-            namespace: "file",
-            filter: "**/*.tsx",
-          },
-          {
-            napiModule: myNativeAddon,
-            symbol: "replace_foo_with_bar",
-            // external: myNativeAddon.getSharedState()
-          },
-        );
-      },
-    },
-  ],
-});
-```
-
-### `onBeforeParse`
-
-```ts
-onBeforeParse(
-  args: { filter: RegExp; namespace?: string },
-  callback: { napiModule: NapiModule; symbol: string; external?: unknown },
-): void;
-```
-
-This lifecycle callback is run immediately before a file is parsed by Bun's bundler.
-
-As input, it receives the file's contents and can optionally return new source code.
-
-This callback can be called from any thread and so the napi module implementation must be thread-safe.

docs/bundler/vs-esbuild.md

@@ -695,7 +695,7 @@ In Bun's CLI, simple boolean flags like `--minify` do not accept an argument. Ot
 - In Bun, `minify` can be a boolean or an object.
 
   ```ts
-  await Bun.build({
+  Bun.build({
     entrypoints: ['./index.tsx'],
     // enable all minification
     minify: true

docs/cli/add.md

@@ -33,14 +33,6 @@ To add a package as an optional dependency (`"optionalDependencies"`):
 $ bun add --optional lodash
 ```
 
-## `--peer`
-
-To add a package as a peer dependency (`"peerDependencies"`):
-
-```bash
-$ bun add --peer @types/bun
-```
-
 ## `--exact`
 
 {% callout %}

docs/cli/bun-install.md

@@ -47,9 +47,6 @@ registry = "https://registry.yarnpkg.com/"
 # Install for production? This is the equivalent to the "--production" CLI argument
 production = false
 
-# Save a text-based lockfile? This is equivalent to the "--save-text-lockfile" CLI argument
-saveTextLockfile = false
-
 # Disallow changes to lockfile? This is the equivalent to the "--frozen-lockfile" CLI argument
 frozenLockfile = false
 
@@ -57,15 +54,12 @@ frozenLockfile = false
 dryRun = true
 
 # Install optionalDependencies (default: true)
-# Setting this to false is equivalent to the `--omit=optional` CLI argument
 optional = true
 
 # Install local devDependencies (default: true)
-# Setting this to false is equivalent to the `--omit=dev` CLI argument
 dev = true
 
 # Install peerDependencies (default: true)
-# Setting this to false is equivalent to the `--omit=peer` CLI argument
 peer = true
 
 # Max number of concurrent lifecycle scripts (default: (cpu count or GOMAXPROCS) x2)
@@ -114,7 +108,6 @@ export interface Install {
   scopes: Scopes;
   registry: Registry;
   production: boolean;
-  saveTextLockfile: boolean;
   frozenLockfile: boolean;
   dryRun: boolean;
   optional: boolean;

docs/cli/filter.md

@@ -1,51 +1,4 @@
-The `--filter` (or `-F`) flag is used for selecting packages by pattern in a monorepo. Patterns can be used to match package names or package paths, with full glob syntax support.
-
-Currently `--filter` is supported by `bun install` and `bun outdated`, and can also be used to run scripts for multiple packages at once.
-
-## Matching
-
-### Package Name `--filter <pattern>`
-
-Name patterns select packages based on the package name, as specified in `package.json`. For example, if you have packages `pkg-a`, `pkg-b` and `other`, you can match all packages with `*`, only `pkg-a` and `pkg-b` with `pkg*`, and a specific package by providing the full name of the package.
-
-### Package Path `--filter ./<glob>`
-
-Path patterns are specified by starting the pattern with `./`, and will select all packages in directories that match the pattern. For example, to match all packages in subdirectories of `packages`, you can use `--filter './packages/**'`. To match a package located in `packages/foo`, use `--filter ./packages/foo`.
-
-## `bun install` and `bun outdated`
-
-Both `bun install` and `bun outdated` support the `--filter` flag.
-
-`bun install` by default will install dependencies for all packages in the monorepo. To install dependencies for specific packages, use `--filter`.
-
-Given a monorepo with workspaces `pkg-a`, `pkg-b`, and `pkg-c` under `./packages`:
-
-```bash
-# Install dependencies for all workspaces except `pkg-c`
-$ bun install --filter '!pkg-c'
-
-# Install dependencies for packages in `./packages` (`pkg-a`, `pkg-b`, `pkg-c`)
-$ bun install --filter './packages/*'
-
-# Save as above, but exclude the root package.json
-$ bun install --filter --filter '!./' --filter './packages/*'
-```
-
-Similarly, `bun outdated` will display outdated dependencies for all packages in the monorepo, and `--filter` can be used to restrict the command to a subset of the packages:
-
-```bash
-# Display outdated dependencies for workspaces starting with `pkg-`
-$ bun outdated --filter 'pkg-*'
-
-# Display outdated dependencies for only the root package.json
-$ bun outdated --filter './'
-```
-
-For more information on both these commands, see [`bun install`](https://bun.sh/docs/cli/install) and [`bun outdated`](https://bun.sh/docs/cli/outdated).
-
-## Running scripts with `--filter`
-
-Use the `--filter` flag to execute scripts in multiple packages at once:
+Use the `--filter` flag to execute lifecycle scripts in multiple packages at once:
 
 ```bash
 bun --filter <pattern> <script>
@@ -71,7 +24,19 @@ bun --filter '*' dev
 Both commands will be run in parallel, and you will see a nice terminal UI showing their respective outputs:
 ![Terminal Output](https://github.com/oven-sh/bun/assets/48869301/2a103e42-9921-4c33-948f-a1ad6e6bac71)
 
-### Running scripts in workspaces
+## Matching
+
+`--filter` accepts a pattern to match specific packages, either by name or by path. Patterns have full support for glob syntax.
+
+### Package Name `--filter <pattern>`
+
+Name patterns select packages based on the package name, as specified in `package.json`. For example, if you have packages `pkga`, `pkgb` and `other`, you can match all packages with `*`, only `pkga` and `pkgb` with `pkg*`, and a specific package by providing the full name of the package.
+
+### Package Path `--filter ./<glob>`
+
+Path patterns are specified by starting the pattern with `./`, and will select all packages in directories that match the pattern. For example, to match all packages in subdirectories of `packages`, you can use `--filter './packages/**'`. To match a package located in `pkgs/foo`, use `--filter ./pkgs/foo`.
+
+## Workspaces
 
 Filters respect your [workspace configuration](https://bun.sh/docs/install/workspaces): If you have a `package.json` file that specifies which packages are part of the workspace,
 `--filter` will be restricted to only these packages. Also, in a workspace you can use `--filter` to run scripts in packages that are located anywhere in the workspace:
@@ -85,6 +50,8 @@ Filters respect your [workspace configuration](https://bun.sh/docs/install/works
 bun run --filter foo myscript
 ```
 
-### Dependency Order
+## Dependency Order
 
 Bun will respect package dependency order when running scripts. Say you have a package `foo` that depends on another package `bar` in your workspace, and both packages have a `build` script. When you run `bun --filter '*' build`, you will notice that `foo` will only start running once `bar` is done.
+
+### Cyclic Dependencies

docs/cli/install.md

@@ -81,20 +81,6 @@ Bun supports `"workspaces"` in package.json. For complete documentation refer to
 }
 ```
 
-## Installing dependencies for specific packages
-
-In a monorepo, you can install the dependencies for a subset of packages using the `--filter` flag.
-
-```bash
-# Install dependencies for all workspaces except `pkg-c`
-$ bun install --filter '!pkg-c'
-
-# Install dependencies for only `pkg-a` in `./packages/pkg-a`
-$ bun install --filter './packages/pkg-a'
-```
-
-For more information on filtering with `bun install`, refer to [Package Manager > Filtering](https://bun.sh/docs/cli/install#bun-install-and-bun-outdated)
-
 ## Overrides and resolutions
 
 Bun supports npm's `"overrides"` and Yarn's `"resolutions"` in `package.json`. These are mechanisms for specifying a version range for _metadependencies_—the dependencies of your dependencies. Refer to [Package manager > Overrides and resolutions](https://bun.sh/docs/install/overrides) for complete documentation.
@@ -144,20 +130,6 @@ $ bun install --frozen-lockfile
 
 For more information on Bun's binary lockfile `bun.lockb`, refer to [Package manager > Lockfile](https://bun.sh/docs/install/lockfile).
 
-## Omitting dependencies
-
-To omit dev, peer, or optional dependencies use the `--omit` flag.
-
-```bash
-# Exclude "devDependencies" from the installation. This will apply to the
-# root package and workspaces if they exist. Transitive dependencies will
-# not have "devDependencies".
-$ bun install --omit dev
-
-# Install only dependencies from "dependencies"
-$ bun install --omit=dev --omit=peer --omit=optional
-```
-
 ## Dry run
 
 To perform a dry run (i.e. don't actually install anything):
@@ -177,8 +149,7 @@ Bun supports installing dependencies from Git, GitHub, and local or remotely-hos
     "lodash": "git+ssh://github.com/lodash/lodash.git#4.17.21",
     "moment": "git@github.com:moment/moment.git",
     "zod": "github:colinhacks/zod",
-    "react": "https://registry.npmjs.org/react/-/react-18.2.0.tgz",
-    "bun-types": "npm:@types/bun"
+    "react": "https://registry.npmjs.org/react/-/react-18.2.0.tgz"
   }
 }
 ```
@@ -202,9 +173,6 @@ peer = true
 # equivalent to `--production` flag
 production = false
 
-# equivalent to `--save-text-lockfile` flag
-saveTextLockfile = false
-
 # equivalent to `--frozen-lockfile` flag
 frozenLockfile = false
 

docs/cli/outdated.md

@@ -59,5 +59,3 @@ If you want to do the same, but exclude the `./apps/api` workspace:
 ```sh
 $ bun outdated --filter './apps/*' --filter '!./apps/api'
 ```
-
-Refer to [Package Manager > Filtering](https://bun.sh/docs/cli/filter#bun-install-and-bun-outdated) for more information on `--filter`.

docs/cli/run.md

@@ -153,7 +153,7 @@ $ bun run --bun vite
 
 ### Filtering
 
-In monorepos containing multiple packages, you can use the `--filter` argument to execute scripts in many packages at once.
+in monorepos containing multiple packages, you can use the `--filter` argument to execute scripts in many packages at once.
 
 Use `bun run --filter <name_pattern> <script>` to execute `<script>` in all packages whose name matches `<name_pattern>`.
 For example, if you have subdirectories containing packages named `foo`, `bar` and `baz`, running
@@ -164,7 +164,7 @@ bun run --filter 'ba*' <script>
 
 will execute `<script>` in both `bar` and `baz`, but not in `foo`.
 
-Find more details in the docs page for [filter](https://bun.sh/docs/cli/filter#running-scripts-with-filter).
+Find more details in the docs page for [filter](https://bun.sh/docs/cli/filter).
 
 ## `bun run -` to pipe code from stdin
 

docs/cli/test.md

@@ -55,51 +55,6 @@ $ bun test ./test/specific-file.test.ts
 
 The test runner runs all tests in a single process. It loads all `--preload` scripts (see [Lifecycle](https://bun.sh/docs/test/lifecycle) for details), then runs all tests. If a test fails, the test runner will exit with a non-zero exit code.
 
-## CI/CD integration
-
-`bun test` supports a variety of CI/CD integrations.
-
-### GitHub Actions
-
-`bun test` automatically detects if it's running inside GitHub Actions and will emit GitHub Actions annotations to the console directly.
-
-No configuration is needed, other than installing `bun` in the workflow and running `bun test`.
-
-#### How to install `bun` in a GitHub Actions workflow
-
-To use `bun test` in a GitHub Actions workflow, add the following step:
-
-```yaml
-jobs:
-  build:
-    name: build-app
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Install bun
-        uses: oven-sh/setup-bun@v2
-      - name: Install dependencies # (assuming your project has dependencies)
-        run: bun install # You can use npm/yarn/pnpm instead if you prefer
-      - name: Run tests
-        run: bun test
-```
-
-From there, you'll get GitHub Actions annotations.
-
-### JUnit XML reports (GitLab, etc.)
-
-To use `bun test` with a JUnit XML reporter, you can use the `--reporter=junit` in combination with `--reporter-outfile`.
-
-```sh
-$ bun test --reporter=junit --reporter-outfile=./bun.xml
-```
-
-This will continue to output to stdout/stderr as usual, and also write a JUnit
-XML report to the given path at the very end of the test run.
-
-JUnit XML is a popular format for reporting test results in CI/CD pipelines.
-
 ## Timeouts
 
 Use the `--timeout` flag to specify a _per-test_ timeout in milliseconds. If a test times out, it will be marked as failed. The default value is `5000`.
@@ -126,7 +81,7 @@ Use the `--bail` flag to abort the test run early after a pre-determined number
 $ bun test --bail
 
 # bail after 10 failure
-$ bun test --bail=10
+$ bun test --bail 10
 ```
 
 ## Watch mode

docs/guides/ecosystem/nextjs.md

@@ -15,14 +15,6 @@ $ bun create next-app
 Creating a new Next.js app in /path/to/my-app.
 ```
 
-You can specify a starter template using the `--example` flag.
-
-```sh
-$ bun create next-app --example with-supabase
-✔ What is your project named? … my-app
-...
-```
-
 ---
 
 To start the dev server with Bun, run `bun --bun run dev` from the project root.

docs/guides/http/cluster.md

@@ -63,4 +63,4 @@ process.on("exit", kill);
 
 ---
 
-Bun has also implemented the `node:cluster` module, but this is a faster, simple, and limited alternative.
+At the time of writing, Bun hasn't implemented the `node:cluster` module yet, but this is a faster, simple, and limited alternative. We will also implement `node:cluster` in the future.

docs/guides/install/add-optional.md

@@ -2,7 +2,7 @@
 name: Add an optional dependency
 ---
 
-To add an npm package as an optional dependency, use the `--optional` flag.
+To add an npm package as a peer dependency, use the `--optional` flag.
 
 ```sh
 $ bun add zod --optional

docs/guides/install/registry-scope.md

@@ -2,9 +2,7 @@
 name: Configure a private registry for an organization scope with bun install
 ---
 
-Private registries can be configured using either [`.npmrc`](https://bun.sh/docs/install/npmrc) or [`bunfig.toml`](https://bun.sh/docs/runtime/bunfig#install-registry). While both are supported, we recommend using **bunfig.toml** for enhanced flexibility and Bun-specific options.
-
-To configure a registry for a particular npm scope:
+Bun does not read `.npmrc` files; instead private registries are configured via `bunfig.toml`. To configure a registry for a particular npm scope:
 
 ```toml#bunfig.toml
 [install.scopes]

docs/guides/runtime/set-env.md

@@ -16,7 +16,7 @@ Set these variables in a `.env` file.
 Bun reads the following files automatically (listed in order of increasing precedence).
 
 - `.env`
-- `.env.production`, `.env.development`, `.env.test` (depending on value of `NODE_ENV`)
+- `.env.production` or `.env.development` (depending on value of `NODE_ENV`)
 - `.env.local`
 
 ```txt#.env

docs/guides/test/bail.md

@@ -14,7 +14,7 @@ To bail after a certain threshold of failures, optionally specify a number after
 
 ```sh
 # bail after 10 failures
-$ bun test --bail=10
+$ bun test --bail 10
 ```
 
 ---

docs/guides/test/migrate-from-jest.md

@@ -30,6 +30,7 @@ Bun implements the vast majority of Jest's matchers, but compatibility isn't 100
 
 Some notable missing features:
 
+- `expect().toMatchInlineSnapshot()`
 - `expect().toHaveReturned()`
 
 ---
@@ -56,7 +57,7 @@ Replace `bail` in your Jest config with the `--bail` CLI flag.
 ``` -->
 
 ```sh
-$ bun test --bail=3
+$ bun test --bail 3
 ```
 
 ---

docs/guides/test/snapshot.md

@@ -4,6 +4,10 @@ name: Use snapshot testing in `bun test`
 
 Bun's test runner supports Jest-style snapshot testing via `.toMatchSnapshot()`.
 
+{% callout %}
+The `.toMatchInlineSnapshot()` method is not yet supported.
+{% /callout %}
+
 ```ts#snap.test.ts
 import { test, expect } from "bun:test";
 
@@ -92,4 +96,4 @@ Ran 1 tests across 1 files. [102.00ms]
 
 ---
 
-See [Docs > Test Runner > Snapshots](https://bun.sh/docs/test/snapshots) for complete documentation on snapshots with the Bun test runner.
+See [Docs > Test Runner > Snapshots](https://bun.sh/docs/test/mocks) for complete documentation on mocking with the Bun test runner.

docs/guides/test/svelte-test.md

@@ -1,120 +0,0 @@
----
-name: "import, require, and test Svelte components with bun test"
----
-
-Bun's [Plugin API](/docs/runtime/plugins) lets you add custom loaders to your project. The `test.preload` option in `bunfig.toml` lets you configure your loader to start before your tests run.
-
-Firstly, install `@testing-library/svelte`, `svelte`, and `@happy-dom/global-registrator`.
-
-```bash
-$ bun add @testing-library/svelte svelte@4 @happy-dom/global-registrator
-```
-
-Then, save this plugin in your project.
-
-```ts#svelte-loader.js
-import { plugin } from "bun";
-import { compile } from "svelte/compiler";
-import { readFileSync } from "fs";
-import { beforeEach, afterEach } from "bun:test";
-import { GlobalRegistrator } from "@happy-dom/global-registrator";
-
-beforeEach(async () => {
-  await GlobalRegistrator.register();
-});
-
-afterEach(async () => {
-  await GlobalRegistrator.unregister();
-});
-
-plugin({
-  name: "svelte loader",
-  setup(builder) {
-    builder.onLoad({ filter: /\.svelte(\?[^.]+)?$/ }, ({ path }) => {
-      try {
-        const source = readFileSync(
-          path.substring(
-            0,
-            path.includes("?") ? path.indexOf("?") : path.length
-          ),
-          "utf-8"
-        );
-
-        const result = compile(source, {
-          filename: path,
-          generate: "client",
-          dev: false,
-        });
-
-        return {
-          contents: result.js.code,
-          loader: "js",
-        };
-      } catch (err) {
-        throw new Error(`Failed to compile Svelte component: ${err.message}`);
-      }
-    });
-  },
-});
-
-```
-
----
-
-Add this to `bunfig.toml` to tell Bun to preload the plugin, so it loads before your tests run.
-
-```toml#bunfig.toml
-[test]
-# Tell Bun to load this plugin before your tests run
-preload = ["./svelte-loader.js"]
-
-# This also works:
-# test.preload = ["./svelte-loader.js"]
-```
-
----
-
-Add an example `.svelte` file in your project.
-
-```html#Counter.svelte
-<script>
-  export let initialCount = 0;
-  let count = initialCount;
-</script>
-
-<button on:click={() => (count += 1)}>+1</button>
-```
-
----
-
-Now you can `import` or `require` `*.svelte` files in your tests, and it will load the Svelte component as a JavaScript module.
-
-```ts#hello-svelte.test.ts
-import { test, expect } from "bun:test";
-import { render, fireEvent } from "@testing-library/svelte";
-import Counter from "./Counter.svelte";
-
-test("Counter increments when clicked", async () => {
-  const { getByText, component } = render(Counter);
-  const button = getByText("+1");
-
-  // Initial state
-  expect(component.$$.ctx[0]).toBe(0); // initialCount is the first prop
-
-  // Click the increment button
-  await fireEvent.click(button);
-
-  // Check the new state
-  expect(component.$$.ctx[0]).toBe(1);
-});
-```
-
----
-
-Use `bun test` to run your tests.
-
-```bash
-$ bun test
-```
-
----

docs/guides/test/testing-library.md

@@ -49,7 +49,7 @@ Next, add these preload scripts to your `bunfig.toml` (you can also have everyth
 
 ```toml#bunfig.toml
 [test]
-preload = ["./happydom.ts", "./testing-library.ts"]
+preload = ["happydom.ts", "testing-library.ts"]
 ```
 ---
 
@@ -84,4 +84,4 @@ test('Can use Testing Library', () => {
 
 ---
 
-Refer to the [Testing Library docs](https://testing-library.com/), [Happy DOM repo](https://github.com/capricorn86/happy-dom) and [Docs > Test runner > DOM](https://bun.sh/docs/test/dom) for complete documentation on writing browser tests with Bun.
+Refer to the [Testing Library docs](https://testing-library.com/), [Happy DOM repo](https://github.com/capricorn86/happy-dom) and [Docs > Test runner > DOM](https://bun.sh/docs/test/dom) for complete documentation on writing browser tests with Bun.

docs/guides/test/todo-tests.md

@@ -44,17 +44,10 @@ test.todo("unimplemented feature", () => {
 
 ---
 
-If an implementation is provided, it will not be run unless the `--todo` flag is passed. If the `--todo` flag is passed, the test will be executed and _expected to fail_ by test runner! If a todo test passes, the `bun test` run will return a non-zero exit code to signal the failure.
+If an implementation is provided, it will be executed and _expected to fail_ by test runner! If a todo test passes, the `bun test` run will return a non-zero exit code to signal the failure.
 
 ```sh
-$ bun test --todo
-my.test.ts:
-✗ unimplemented feature
-  ^ this test is marked as todo but passes. Remove `.todo` or check that test is correct.
-
- 0 pass
- 1 fail
- 1 expect() calls
+$ bun test
 $ echo $?
 1 # this is the exit code of the previous command
 ```

docs/guides/test/update-snapshots.md

@@ -4,6 +4,10 @@ name: Update snapshots in `bun test`
 
 Bun's test runner supports Jest-style snapshot testing via `.toMatchSnapshot()`.
 
+{% callout %}
+The `.toMatchInlineSnapshot()` method is not yet supported.
+{% /callout %}
+
 ```ts#snap.test.ts
 import { test, expect } from "bun:test";
 
@@ -43,4 +47,4 @@ Ran 1 tests across 1 files. [102.00ms]
 
 ---
 
-See [Docs > Test Runner > Snapshots](https://bun.sh/docs/test/snapshots) for complete documentation on snapshots with the Bun test runner.
+See [Docs > Test Runner > Snapshots](https://bun.sh/docs/test/mocks) for complete documentation on mocking with the Bun test runner.

docs/guides/write-file/unlink.md

@@ -2,10 +2,22 @@
 name: Delete a file
 ---
 
-To delete a file in Bun, use the `delete` method.
+To synchronously delete a file with Bun, use the `unlinkSync` function from the [`node:fs`](https://nodejs.org/api/fs.html#fs_fs_unlink_path_callback) module. (Currently, there is no `Bun` API for deleting files.)
 
 ```ts
-import { file } from "bun";
+import { unlinkSync } from "node:fs";
 
-await file("./path-to-file.txt").delete();
+const path = "/path/to/file.txt";
+unlinkSync(path);
+```
+
+---
+
+To remove a file asynchronously, use the `unlink` function from the [`node:fs/promises`](https://nodejs.org/api/fs.html#fs_fspromises_unlink_path) module.
+
+```ts
+import { unlink } from "node:fs/promises";
+
+const path = "/path/to/file.txt";
+await unlink(path);
 ```

docs/install/cache.md

@@ -1,4 +1,4 @@
-All packages downloaded from the registry are stored in a global cache at `~/.bun/install/cache`, or the path defined by the environment variable `BUN_INSTALL_CACHE_DIR`. They are stored in subdirectories named like `${name}@${version}`, so multiple versions of a package can be cached.
+All packages downloaded from the registry are stored in a global cache at `~/.bun/install/cache`. They are stored in subdirectories named like `${name}@${version}`, so multiple versions of a package can be cached.
 
 {% details summary="Configuring cache behavior (bunfig.toml)" %}