Merge remote-tracking branch 'origin/main' into dave/eradicate-c-api

* Support `socketPath` in node:http request

* fix dashes

---------

Co-authored-by: Jarred Sumner <709451+Jarred-Sumner@users.noreply.github.com>
Co-authored-by: dave caruso <me@paperdave.net>

.gitattributes

@@ -42,3 +42,6 @@ docs/**/* linguist-documentation
 test/**/* linguist-documentation
 bench/**/* linguist-documentation
 examples/**/* linguist-documentation
+
+src/deps/*.c linguist-vendored
+src/deps/brotli/** linguist-vendored

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

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

.github/actions/setup-bun/action.yml

@@ -0,0 +1,50 @@
+name: Setup Bun
+description: An internal version of the 'oven-sh/setup-bun' action.
+
+inputs:
+  bun-version:
+    type: string
+    description: "The version of bun to install: 'latest', 'canary', 'bun-v1.0.0', etc."
+    default: latest
+    required: false
+  baseline:
+    type: boolean
+    description: "Whether to use the baseline version of bun."
+    default: false
+    required: false
+  download-url:
+    type: string
+    description: "The base URL to download bun from."
+    default: "https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases"
+    required: false
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Bun
+      shell: bash
+      run: |
+        case "$(uname -s)" in
+          Linux*)  os=linux;;
+          Darwin*) os=darwin;;
+          *)       os=windows;;
+        esac
+        case "$(uname -m)" in
+          arm64 | aarch64)  arch=arm64;;
+          *)                arch=x64;;
+        esac
+        case "${{ inputs.baseline }}" in
+          true | 1) target="bun-${os}-${arch}-baseline";;
+          *)        target="bun-${os}-${arch}";;
+        esac
+        case "${{ inputs.bun-version }}" in
+          latest) release="latest";;
+          canary) release="canary";;
+          *)      release="bun-v${{ inputs.bun-version }}";;
+        esac
+        curl -LO "${{ inputs.download-url }}/${release}/${target}.zip"
+        unzip ${target}.zip
+        mkdir -p ${{ runner.temp }}/.bun/bin
+        mv ${target}/bun* ${{ runner.temp }}/.bun/bin/
+        chmod +x ${{ runner.temp }}/.bun/bin/*
+        echo "${{ runner.temp }}/.bun/bin" >> ${GITHUB_PATH}

.github/workflows/bun-linux-aarch64.yml

@@ -9,6 +9,7 @@ on:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-aarch64.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -17,11 +18,11 @@ on:
       - "build.zig"
       - "Makefile"
       - "Dockerfile"
-      - ".github/workflows/bun-linux-aarch64.yml"
   pull_request:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-aarch64.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -30,7 +31,6 @@ on:
       - "build.zig"
       - "Makefile"
       - "Dockerfile"
-      - ".github/workflows/bun-linux-aarch64.yml"
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
@@ -51,14 +51,14 @@ jobs:
             runner: linux-arm64
             build_machine_arch: aarch64
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: false
           ref: ${{github.sha}}
           clean: true
       - run: |
           bash ./scripts/update-submodules.sh
-      - uses: docker/setup-buildx-action@v2
+      - uses: docker/setup-buildx-action@v3
         id: buildx
         with:
           install: true
@@ -66,7 +66,7 @@ jobs:
         run: |
           rm -rf ${{runner.temp}}/release
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
@@ -74,7 +74,7 @@ jobs:
       - run: |
           mkdir -p /tmp/.buildx-cache-${{matrix.tag}}
       - name: Build and push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
@@ -113,14 +113,16 @@ jobs:
 
           zip -r bun-${{matrix.tag}}-profile.zip bun-${{matrix.tag}}-profile
           zip -r bun-${{matrix.tag}}.zip bun-${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}-profile
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1

.github/workflows/bun-linux-build.yml

@@ -9,6 +9,7 @@ on:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-build.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -21,6 +22,7 @@ on:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-build.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -47,7 +49,7 @@ jobs:
             tag: linux-x64
             arch: x86_64
             build_arch: amd64
-            runner: big-ubuntu
+            runner: namespace-profile-bun-linux-x64
             build_machine_arch: x86_64
             assertions: "OFF"
             zig_optimize: "ReleaseFast"
@@ -56,7 +58,7 @@ jobs:
             tag: linux-x64-baseline
             arch: x86_64
             build_arch: amd64
-            runner: big-ubuntu
+            runner: namespace-profile-bun-linux-x64
             build_machine_arch: x86_64
             assertions: "OFF"
             zig_optimize: "ReleaseFast"
@@ -86,28 +88,20 @@ jobs:
           submodules: recursive
           ref: ${{github.sha}}
           clean: true
-      - uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
       - name: Run
         run: |
           rm -rf ${{runner.temp}}/release
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-      - run: |
-          mkdir -p /tmp/.buildx-cache-${{matrix.tag}}
       - name: Build and push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
-          cache-from: type=local,src=/tmp/.buildx-cache-${{matrix.tag}}
-          cache-to: type=local,dest=/tmp/.buildx-cache-${{matrix.tag}}
           build-args: |
             ARCH=${{matrix.arch}}
             BUILDARCH=${{matrix.build_arch}}
@@ -116,12 +110,6 @@ jobs:
             GIT_SHA=${{github.sha}}
             ASSERTIONS=${{matrix.assertions}}
             ZIG_OPTIMIZE=${{matrix.zig_optimize}}
-            SCCACHE_BUCKET=bun
-            SCCACHE_REGION=auto
-            SCCACHE_S3_USE_SSL=true
-            SCCACHE_ENDPOINT=${{ secrets.CACHE_S3_ENDPOINT }}
-            AWS_ACCESS_KEY_ID=${{ secrets.CACHE_S3_ACCESS_KEY_ID }}
-            AWS_SECRET_ACCESS_KEY=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}
           platforms: linux/${{matrix.build_arch}}
           target: ${{matrix.target}}
           outputs: type=local,dest=${{runner.temp}}/release
@@ -154,22 +142,16 @@ jobs:
 
           zip -r bun-${{matrix.tag}}-profile.zip bun-${{matrix.tag}}-profile
           zip -r bun-${{matrix.tag}}.zip bun-${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}-profile
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}.zip
-      - uses: actions/upload-artifact@v3
-        with:
-          name: bun-obj-${{matrix.tag}}
-          path: ${{runner.temp}}/release/bun-obj
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}-dependencies
-          path: ${{runner.temp}}/release/bun-dependencies
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -208,7 +190,7 @@ jobs:
             [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
   linux-test:
     name: Tests ${{matrix.tag}}
-    runs-on: ubuntu-latest
+    runs-on: namespace-profile-bun-linux-x64
     needs: [linux]
     if: github.event_name == 'pull_request'
     timeout-minutes: 20
@@ -234,7 +216,7 @@ jobs:
           clean: true
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: bun-${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -259,6 +241,8 @@ jobs:
           bun install --cwd=test --verbose
           bun install --cwd=packages/bun-internal-test --verbose
 
+          bun install --cwd=test/js/third_party/prisma --verbose
+
       # This is disabled because the cores are ~5.5gb each
       # so it is easy to hit 50gb coredump downloads. Only enable if you need to retrive one
 
@@ -273,6 +257,7 @@ jobs:
         name: Test (node runner)
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}
@@ -281,11 +266,12 @@ jobs:
           ulimit -c
 
           node packages/bun-internal-test/src/runner.node.mjs || true
-      - uses: actions/upload-artifact@v3
-        if: steps.test.outputs.failing_tests != ''
-        with:
-          name: cores
-          path: /cores
+      # - uses: actions/upload-artifact@v4
+      #   if: steps.test.outputs.failing_tests != ''
+      #   with:
+      #     name: cores
+      #     path: /cores
+      #     if-no-files-found: "error"
       - uses: sarisia/actions-status-discord@v1
         if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
         with:

.github/workflows/bun-mac-aarch64.yml

@@ -37,7 +37,7 @@ on:
 jobs:
   macOS-zig:
     name: macOS Zig Object
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     if: github.repository_owner == 'oven-sh'
     strategy:
       matrix:
@@ -51,21 +51,20 @@ jobs:
       #   run: git submodule update --init --recursive --depth=1 --progress --force
 
       - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         id: buildx
         with:
           install: true
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
-        if: runner.arch == 'X64'
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
@@ -84,10 +83,11 @@ jobs:
           outputs: type=local,dest=${{runner.temp}}/release
 
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
 
   macOS-dependencies:
     name: macOS Dependencies
@@ -102,7 +102,7 @@ jobs:
             tag: bun-darwin-aarch64
             obj: bun-obj-darwin-aarch64
             artifact: bun-obj-darwin-aarch64
-            runner: macos-arm64
+            runner: macos-13-xlarge
     steps:
       - uses: actions/checkout@v4
       - name: Checkout submodules
@@ -114,13 +114,20 @@ jobs:
           HOMEBREW_NO_AUTO_UPDATE: 1
           HOMEBREW_NO_INSTALL_CLEANUP: 1
         run: |
-          brew install sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
+          brew install go sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
           echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
           # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
           echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
           echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
           brew link --overwrite llvm@$LLVM_VERSION
 
+          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-aarch64.zip"
+          unzip bun-darwin-aarch64.zip
+          mkdir -p ${{ runner.temp }}/.bun/bin
+          mv bun-darwin-aarch64/bun ${{ runner.temp }}/.bun/bin/bun
+          chmod +x ${{ runner.temp }}/.bun/bin/bun
+          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
+
       - name: Hash submodule versions
         run: |
           print_data() {
@@ -134,7 +141,7 @@ jobs:
 
       - name: Cache submodule dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
@@ -152,16 +159,17 @@ jobs:
       - name: Cache submodule dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
       - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
+          if-no-files-found: "error"
 
   macOS-cpp:
     name: macOS C++
@@ -176,7 +184,7 @@ jobs:
             tag: bun-darwin-aarch64
             obj: bun-obj-darwin-aarch64
             artifact: bun-obj-darwin-aarch64
-            runner: macos-arm64
+            runner: macos-13-xlarge
     steps:
       - uses: actions/checkout@v4
       - name: Checkout submodules
@@ -188,13 +196,20 @@ jobs:
           HOMEBREW_NO_AUTO_UPDATE: 1
           HOMEBREW_NO_INSTALL_CLEANUP: 1
         run: |
-          brew install sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
+          brew install go sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
           echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
           # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
           echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
           echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
           brew link --overwrite llvm@$LLVM_VERSION
 
+          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-aarch64.zip"
+          unzip bun-darwin-aarch64.zip
+          mkdir -p ${{ runner.temp }}/.bun/bin
+          mv bun-darwin-aarch64/bun ${{ runner.temp }}/.bun/bin/bun
+          chmod +x ${{ runner.temp }}/.bun/bin/bun
+          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
+
       # TODO: replace with sccache
       - name: ccache
         uses: hendrikmuhs/ccache-action@v1.2
@@ -221,10 +236,11 @@ jobs:
           bash compile-cpp-only.sh -v
 
       - name: Upload C++
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
+          if-no-files-found: "error"
   macOS-link:
     name: macOS Link
     runs-on: ${{ matrix.runner }}
@@ -241,7 +257,7 @@ jobs:
             obj: bun-obj-darwin-aarch64
             package: bun-darwin-aarch64
             artifact: bun-obj-darwin-aarch64
-            runner: macos-arm64
+            runner: macos-13-xlarge
     steps:
       - uses: actions/checkout@v4
         with:
@@ -271,19 +287,19 @@ jobs:
           echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
 
       - name: Download C++
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj
 
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.obj }}
           path: ${{ runner.temp }}/release
 
       - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
@@ -316,14 +332,16 @@ jobs:
 
           zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
           zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}-profile
           path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -376,16 +394,16 @@ jobs:
       matrix:
         include:
           - tag: bun-darwin-aarch64
-            runner: macos-arm64
+            runner: macos-13-xlarge
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -412,6 +430,7 @@ jobs:
         name: Test (node runner)
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}

.github/workflows/bun-mac-x64-baseline.yml

@@ -37,7 +37,7 @@ on:
 jobs:
   macos-object-files:
     name: macOS Object
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     if: github.repository_owner == 'oven-sh'
     strategy:
       matrix:
@@ -53,31 +53,17 @@ jobs:
           #   tag: bun-obj-darwin-aarch64
     steps:
       - uses: actions/checkout@v4
-
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
-
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
-          # This doesnt seem to work
-          # cache-from: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # cache-to: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # This was used before, but also does not really work
-          cache-from: type=local,src=/tmp/.buildx-cache-${{matrix.tag}}
-          cache-to: type=local,dest=/tmp/.buildx-cache-${{matrix.tag}}
           build-args: |
             BUILDARCH=${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
             BUILD_MACHINE_ARCH=${{ runner.arch == 'X64' && 'x86_64' || 'aarch64' }}
@@ -85,22 +71,15 @@ jobs:
             CPU_TARGET=${{ matrix.cpu }}
             TRIPLET=${{ matrix.arch }}-macos-none
             GIT_SHA=${{ github.sha }}
-
-            SCCACHE_BUCKET=bun
-            SCCACHE_REGION=auto
-            SCCACHE_S3_USE_SSL=true
-            SCCACHE_ENDPOINT=${{ secrets.CACHE_S3_ENDPOINT }}
-            AWS_ACCESS_KEY_ID=${{ secrets.CACHE_S3_ACCESS_KEY_ID }}
-            AWS_SECRET_ACCESS_KEY=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}
           platforms: linux/${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
           target: build_release_obj
           outputs: type=local,dest=${{runner.temp}}/release
-
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
   macOS-dependencies:
     name: macOS Dependencies
     runs-on: ${{ matrix.runner }}
@@ -113,7 +92,7 @@ jobs:
             arch: x86_64
             tag: bun-darwin-x64-baseline
             obj: bun-obj-darwin-x64-baseline
-            runner: macos-12
+            runner: macos-12-large
             artifact: bun-obj-darwin-x64-baseline
     steps:
       - uses: actions/checkout@v4
@@ -146,7 +125,7 @@ jobs:
 
       - name: Cache submodule dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
@@ -164,16 +143,17 @@ jobs:
       - name: Cache submodule dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
       - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
+          if-no-files-found: "error"
 
   macOS-cpp:
     name: macOS C++
@@ -187,7 +167,7 @@ jobs:
             arch: x86_64
             tag: bun-darwin-x64-baseline
             obj: bun-obj-darwin-x64-baseline
-            runner: macos-12
+            runner: macos-12-large
             artifact: bun-obj-darwin-x64-baseline
     steps:
       - uses: actions/checkout@v4
@@ -240,10 +220,11 @@ jobs:
           bash compile-cpp-only.sh -v
 
       - name: Upload C++
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
+          if-no-files-found: "error"
   macOS:
     name: macOS Link
     runs-on: ${{ matrix.runner }}
@@ -259,10 +240,10 @@ jobs:
             tag: bun-darwin-x64-baseline
             obj: bun-obj-darwin-x64-baseline
             package: bun-darwin-x64
-            runner: macos-12
+            runner: macos-12-large
             artifact: bun-obj-darwin-x64-baseline
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Checkout submodules
         run: git submodule update --init --recursive --depth=1 --progress --force
 
@@ -286,19 +267,19 @@ jobs:
           echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
 
       - name: Download C++
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj
 
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.obj }}
           path: ${{ runner.temp }}/release
 
       - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
@@ -331,14 +312,16 @@ jobs:
 
           zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
           zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}-profile
           path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -379,7 +362,8 @@ jobs:
     name: macOS Test
     runs-on: ${{ matrix.runner }}
     needs: [macOS]
-    if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
+    # if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
+    if: false
     permissions:
       pull-requests: write
     timeout-minutes: 30
@@ -391,16 +375,16 @@ jobs:
       matrix:
         include:
           - tag: bun-darwin-x64-baseline
-            runner: macos-12
+            runner: macos-12-large
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -427,6 +411,7 @@ jobs:
         name: Test (node runner)
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}

.github/workflows/bun-mac-x64.yml

@@ -37,7 +37,7 @@ on:
 jobs:
   macOS-zig:
     name: macOS Zig Object
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     if: github.repository_owner == 'oven-sh'
     strategy:
       matrix:
@@ -50,31 +50,17 @@ jobs:
             tag: bun-obj-darwin-x64
     steps:
       - uses: actions/checkout@v4
-
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
-
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
-          # This doesnt seem to work
-          # cache-from: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # cache-to: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # This was used before, but also does not really work
-          cache-from: type=local,src=/tmp/.buildx-cache-${{matrix.tag}}
-          cache-to: type=local,dest=/tmp/.buildx-cache-${{matrix.tag}}
           build-args: |
             BUILDARCH=${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
             BUILD_MACHINE_ARCH=${{ runner.arch == 'X64' && 'x86_64' || 'aarch64' }}
@@ -82,22 +68,15 @@ jobs:
             CPU_TARGET=${{ matrix.cpu }}
             TRIPLET=${{ matrix.arch }}-macos-none
             GIT_SHA=${{ github.sha }}
-
-            SCCACHE_BUCKET=bun
-            SCCACHE_REGION=auto
-            SCCACHE_S3_USE_SSL=true
-            SCCACHE_ENDPOINT=${{ secrets.CACHE_S3_ENDPOINT }}
-            AWS_ACCESS_KEY_ID=${{ secrets.CACHE_S3_ACCESS_KEY_ID }}
-            AWS_SECRET_ACCESS_KEY=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}
           platforms: linux/${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
           target: build_release_obj
           outputs: type=local,dest=${{runner.temp}}/release
-
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
 
   macOS-dependencies:
     name: macOS Dependencies
@@ -111,7 +90,7 @@ jobs:
             arch: x86_64
             tag: bun-darwin-x64
             obj: bun-obj-darwin-x64
-            runner: macos-12
+            runner: macos-12-large
             artifact: bun-obj-darwin-x64
     steps:
       - uses: actions/checkout@v4
@@ -144,7 +123,7 @@ jobs:
 
       - name: Cache submodule dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
@@ -162,16 +141,17 @@ jobs:
       - name: Cache submodule dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
       - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
+          if-no-files-found: "error"
 
   macOS-cpp:
     name: macOS C++
@@ -185,7 +165,7 @@ jobs:
             arch: x86_64
             tag: bun-darwin-x64
             obj: bun-obj-darwin-x64
-            runner: macos-12
+            runner: macos-12-large
             artifact: bun-obj-darwin-x64
     steps:
       - uses: actions/checkout@v4
@@ -238,10 +218,11 @@ jobs:
           bash compile-cpp-only.sh -v
 
       - name: Upload C++
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
+          if-no-files-found: "error"
   macOS:
     name: macOS Link
     runs-on: ${{ matrix.runner }}
@@ -257,10 +238,10 @@ jobs:
             tag: bun-darwin-x64
             obj: bun-obj-darwin-x64
             package: bun-darwin-x64
-            runner: macos-12
+            runner: macos-12-large
             artifact: bun-obj-darwin-x64
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Checkout submodules
         run: git submodule update --init --recursive --depth=1 --progress --force
 
@@ -284,19 +265,19 @@ jobs:
           echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
 
       - name: Download C++
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj
 
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.obj }}
           path: ${{ runner.temp }}/release
 
       - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
@@ -329,14 +310,16 @@ jobs:
 
           zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
           zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}-profile
           path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -389,16 +372,16 @@ jobs:
       matrix:
         include:
           - tag: bun-darwin-x64
-            runner: macos-12
+            runner: macos-12-large
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -426,6 +409,7 @@ jobs:
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
+          TMPDIR: ${{runner.temp}}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}
         run: |

.github/workflows/bun-release.yml

@@ -51,7 +51,7 @@ jobs:
         working-directory: packages/bun-release
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup GPG
         uses: crazy-max/ghaction-import-gpg@v5
         with:
@@ -60,7 +60,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v1
         with:
-          bun-version: latest
+          bun-version: "1.0.21"
       - name: Install Dependencies
         run: bun install
       - name: Sign Release
@@ -81,11 +81,11 @@ jobs:
         working-directory: packages/bun-release
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Bun
         uses: oven-sh/setup-bun@v1
         with:
-          bun-version: latest
+          bun-version: "1.0.21"
       - name: Install Dependencies
         run: bun install
       - name: Release
@@ -105,15 +105,21 @@ jobs:
         working-directory: packages/bun-types
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
           node-version: latest
       - name: Setup Bun
+        if: ${{ env.BUN_VERSION != 'canary' }}
         uses: oven-sh/setup-bun@v1
         with:
-          bun-version: latest
+          bun-version: "1.0.21"
+      - name: Setup Bun
+        if: ${{ env.BUN_VERSION == 'canary' }}
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: "canary" # Must be 'canary' so tag is correct
       - name: Install Dependencies
         run: bun install
       - name: Setup Tag
@@ -131,14 +137,14 @@ jobs:
         if: ${{ env.BUN_VERSION == 'canary' }}
         uses: JS-DevTools/npm-publish@v1
         with:
-          package: packages/bun-types/dist/package.json
+          package: packages/bun-types/package.json
           token: ${{ secrets.NPM_TOKEN }}
           tag: canary
       - name: Release (latest)
         if: ${{ env.BUN_LATEST == 'true' }}
         uses: JS-DevTools/npm-publish@v1
         with:
-          package: packages/bun-types/dist/package.json
+          package: packages/bun-types/package.json
           token: ${{ secrets.NPM_TOKEN }}
   docker:
     name: Release to Dockerhub
@@ -164,12 +170,12 @@ jobs:
             suffix: -distroless
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Docker emulator
         uses: docker/setup-qemu-action@v2
       - id: buildx
         name: Setup Docker buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         with:
           platforms: linux/amd64,linux/arm64
       - id: metadata
@@ -186,12 +192,12 @@ jobs:
             type=match,pattern=(bun-v)?(canary|\d+.\d+),group=2,value=${{ env.BUN_VERSION }},suffix=${{ matrix.suffix }}
             type=match,pattern=(bun-v)?(canary|\d+),group=2,value=${{ env.BUN_VERSION }},suffix=${{ matrix.suffix }}
       - name: Login to Docker
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
       - name: Push to Docker
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: ./dockerhub/${{ matrix.dir || matrix.variant }}
           platforms: linux/amd64,linux/arm64
@@ -210,7 +216,7 @@ jobs:
     if: ${{ github.event_name == 'release' || github.event.inputs.use-homebrew == 'true' }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           repository: oven-sh/homebrew-bun
           token: ${{ secrets.ROBOBUN_TOKEN }}
@@ -246,11 +252,11 @@ jobs:
         working-directory: packages/bun-release
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Bun
         uses: oven-sh/setup-bun@v1
         with:
-          bun-version: latest
+          bun-version: "1.0.21"
       - name: Install Dependencies
         run: bun install
       - name: Release

.github/workflows/bun-types-tests.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install bun
         uses: oven-sh/setup-bun@v1

.github/workflows/bun-windows.yml

@@ -1,7 +1,7 @@
-name: bun-windows-x64
+name: bun-windows
 
 concurrency:
-  group: bun-windows-x64-${{ github.ref }}
+  group: bun-windows-${{ github.ref }}
   cancel-in-progress: true
 
 env:
@@ -9,7 +9,7 @@ env:
   LLVM_VERSION: 16.0.6
   BUN_DOWNLOAD_URL_BASE: https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/latest
 
-  tag: bun-windows-x64
+  tag: bun-windows
   # TODO: wire this up to workflow_dispatch.
   # github's expression syntax makes this hard to set a default to true
   canary: true
@@ -53,19 +53,20 @@ jobs:
         cpu: [haswell, nehalem]
         arch: [x86_64]
     name: Zig Build
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     timeout-minutes: 60
     if: github.repository_owner == 'oven-sh'
     steps:
+      - run: git config --global core.autocrlf false && git config --global core.eol lf
       - uses: actions/checkout@v4
       - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         id: buildx
         with:
           install: true
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
@@ -78,8 +79,7 @@ jobs:
           echo "canary_revision=$(GITHUB_TOKEN="${{ secrets.GITHUB_TOKEN }}" bash ./scripts/calculate-canary-revision.sh --raw)" >> $GITHUB_OUTPUT
 
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
-        if: runner.arch == 'X64'
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
@@ -101,10 +101,11 @@ jobs:
           outputs: type=local,dest=${{runner.temp}}/release
 
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.tag }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
 
   windows-dependencies:
     name: Dependencies
@@ -116,6 +117,7 @@ jobs:
         cpu: [haswell, nehalem]
         arch: [x86_64]
     steps:
+      - run: git config --global core.autocrlf false && git config --global core.eol lf
       - name: Checkout
         uses: actions/checkout@v4
       - name: Clone Submodules
@@ -127,7 +129,8 @@ jobs:
             git submodule | Where-Object { $_ -notmatch 'WebKit' }
             clang --version
             rustc --version
-            Get-Content -Path (Get-ChildItem -Path 'scripts/build*.sh', 'scripts/all-dependencies.sh' | Sort-Object -Property Name).FullName | Out-String
+            Get-Content -Path (Get-ChildItem -Path 'scripts/build*.ps1', 'scripts/all-dependencies.ps1', 'scripts/env.ps1' | Sort-Object -Property Name).FullName | Out-String
+            echo 1
           })"
           $hash = ( -join ((New-Object -TypeName System.Security.Cryptography.SHA1CryptoServiceProvider).ComputeHash([System.Text.Encoding]::UTF8.GetBytes($data)) | ForEach-Object { $_.ToString("x2") } )).Substring(0, 10)
           echo "sha=${hash}" >> $env:GITHUB_OUTPUT
@@ -135,10 +138,10 @@ jobs:
 
       - name: Try fetch dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: bun-deps
-          key: bun-deps-${{ env.tag }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-${{ steps.submodule-versions.outputs.sha }}
+          key: bun-deps-${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-${{ steps.submodule-versions.outputs.sha }}
 
       - name: Install LLVM ${{ env.LLVM_VERSION }}
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
@@ -162,24 +165,34 @@ jobs:
           .\scripts\all-dependencies.ps1
 
       - name: Upload Dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.tag }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-deps/
+          if-no-files-found: "error"
 
       - name: Cache Dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
+  # TODO(@paperdave): stop relying on this and use bun.exe to build itself.
+  # we cant do that now because there isn't a tagged release to use.
+  #
+  # and at the time of writing, the minimum canary required to work is not
+  # yet released as it is the one *this* commit.
   windows-codegen:
     name: Codegen
     runs-on: ubuntu-latest
     timeout-minutes: 10
     if: github.repository_owner == 'oven-sh'
+    strategy:
+      fail-fast: false
+      matrix:
+        arch: [x86_64]
     steps:
       - uses: actions/checkout@v4
       - run: |
@@ -192,10 +205,11 @@ jobs:
         if: ${{ env.canary == 'true' }}
         run: |
           echo "canary_revision=$(GITHUB_TOKEN="${{ secrets.GITHUB_TOKEN }}" bash ./scripts/calculate-canary-revision.sh --raw)" > build-codegen-win32-x64/.canary_revision
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.tag }}-codegen
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
           path: build-codegen-win32-x64/
+          if-no-files-found: "error"
 
   windows-cpp:
     name: C++ Build
@@ -209,15 +223,16 @@ jobs:
         cpu: [haswell, nehalem]
         arch: [x86_64]
     steps:
+      - run: git config --global core.autocrlf false && git config --global core.eol lf
       - uses: actions/checkout@v4
       - uses: KyleMayes/install-llvm-action@1a3da29f56261a1e1f937ec88f0856a9b8321d7e
         with:
           version: ${{ env.LLVM_VERSION }}
       - run: choco install -y ninja
       - name: Download Codegen
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
-          name: ${{ env.tag }}-codegen
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
           path: build
       - name: Build C++
         run: |
@@ -250,10 +265,11 @@ jobs:
           if ($LASTEXITCODE -ne 0) { throw "CMake configuration failed" }
           .\compile-cpp-only.ps1 -v
           if ($LASTEXITCODE -ne 0) { throw "C++ compilation failed" }
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.tag }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: build/bun-cpp-objects.a
+          if-no-files-found: "error"
 
   windows-link:
     strategy:
@@ -263,35 +279,36 @@ jobs:
         arch: [x86_64]
     name: Link
     needs: [windows-dependencies, windows-codegen, windows-cpp, windows-zig]
-    runs-on: windows-latest
+    runs-on: windows-small
     if: github.repository_owner == 'oven-sh'
     timeout-minutes: 30
     permissions: write-all
     steps:
+      - run: git config --global core.autocrlf false && git config --global core.eol lf
       - uses: actions/checkout@v4
       - uses: KyleMayes/install-llvm-action@1a3da29f56261a1e1f937ec88f0856a9b8321d7e
         with:
           version: ${{ env.LLVM_VERSION }}
       - run: choco install -y ninja
       - name: Download Codegen
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
-          name: ${{ env.tag }}-codegen
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
           path: build
       - name: Download Dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
-          name: ${{ env.tag }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-deps
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
-          name: ${{ env.tag }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-zig
       - name: Download C++ Objects
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
-          name: ${{ env.tag }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-cpp
       - name: Link
         run: |
@@ -313,13 +330,25 @@ jobs:
           if ($LASTEXITCODE -ne 0) { throw "Link failed!" }
       - name: Package
         run: |
-          $Dist = mkdir -Force "${{ env.tag }}"
+          $Dist = mkdir -Force "${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}"
           cp -r build\bun.exe "$Dist\bun.exe"
-          Compress-Archive $Dist ${{ env.tag }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip
-      - uses: actions/upload-artifact@v3
+          Compress-Archive "$Dist" "${Dist}.zip"
+          $Dist = "$Dist-profile"
+          MkDir -Force "$Dist"
+          cp -r build\bun.exe "$Dist\bun.exe"
+          cp -r build\bun.pdb "$Dist\bun.pdb"
+          Compress-Archive "$Dist" "$Dist.zip"
+
+      - uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.tag }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
-          path: ${{ env.tag }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
+          path: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
+          path: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -336,7 +365,7 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           name: "Canary (${{github.sha}})"
           tag: "canary"
-          artifacts: "${{env.tag}}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip"
+          artifacts: "${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip,${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile.zip"
       - uses: sarisia/actions-status-discord@v1
         if: failure() && github.repository_owner == 'oven-sh' && github.event_name == 'pull_request'
         with:
@@ -346,13 +375,129 @@ jobs:
           noprefix: true
           nocontext: true
           description: |
-            Pull Request
             ### [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
 
             @${{ github.actor }}
 
-            Build failed on ${{ env.tag }}:
+            Build failed on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
 
-            **[View build output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
+            **[Build Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})** | [Commit](https://github.com/oven-sh/bun/commits/${{github.sha}})
+  windows-test:
+    name: Test
+    runs-on: windows-small
+    needs: [windows-link]
+    if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
+    permissions:
+      pull-requests: write
+    timeout-minutes: 180
+    outputs:
+      failing_tests: ${{ steps.test.outputs.failing_tests }}
+      failing_tests_count: ${{ steps.test.outputs.failing_tests_count }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # TODO: test baseline, disabled due to noise
+        cpu: [haswell]
+        arch: [x86_64]
+    steps:
+      - run: git config --global core.autocrlf false && git config --global core.eol lf
+      - id: checkout
+        name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: false
+      - id: download
+        name: Download Release
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
+          path: ${{runner.temp}}/release
+      - name: Install Bun
+        run: |
+          cd ${{runner.temp}}/release
+          unzip ${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile.zip
+          cd ${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
+          pwd >> $env:GITHUB_PATH
+      - name: Install Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Install dependencies
+        run: |
+          # bun install --verbose
+          # bun install --cwd=test --verbose
+          # bun install --cwd=packages/bun-internal-test --verbose
 
-            [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
+          npm install
+          cd test && npm install
+          cd ../packages/bun-internal-test && npm install
+          cd ../..
+      - id: test
+        name: Run tests
+        env:
+          SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
+          TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
+          TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
+        run: |
+          try {
+            $ErrorActionPreference = "SilentlyContinue"
+            $null = node packages/bun-internal-test/src/runner.node.mjs ${{runner.temp}}/release/${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile/bun.exe || $true
+          } catch {}
+          $ErrorActionPreference = "Stop"
+      - uses: sarisia/actions-status-discord@v1
+        if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
+        with:
+          title: ""
+          webhook: ${{ secrets.DISCORD_WEBHOOK_WINTEST }}
+          status: "failure"
+          noprefix: true
+          nocontext: true
+          description: |
+            ### ❌🪟 [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
+
+            @${{ github.actor }}, there are **${{ steps.test.outputs.failing_test_count }} failing tests** on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
+
+            ${{ steps.test.outputs.failing_tests }}
+
+            [Full Test Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})
+      - uses: sarisia/actions-status-discord@v1
+        if: always() && steps.test.outputs.regressing_tests != '' && github.event_name == 'pull_request'
+        with:
+          title: ""
+          webhook: ${{ secrets.DISCORD_WEBHOOK }}
+          status: "failure"
+          noprefix: true
+          nocontext: true
+          description: |
+            ### ❌🪟 [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
+
+            @${{ github.actor }}, there are **${{ steps.test.outputs.regressing_test_count }} test regressions** on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
+
+            ${{ steps.test.outputs.regressing_tests }}
+
+            [Full Test Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})
+      - name: Comment on PR
+        if: always() && steps.test.outputs.regressing_tests != '' && github.event_name == 'pull_request'
+        uses: thollander/actions-comment-pull-request@v2
+        with:
+          comment_tag: test-windows-${{ matrix.arch }}-${{ matrix.cpu }}
+          message: |
+            ### ❌🪟 @${{ github.actor }}, there are **${{ steps.test.outputs.regressing_test_count }} test regressions** on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
+
+            ${{ steps.test.outputs.regressing_tests }}
+
+            [Full Test Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})
+      - name: Uncomment on PR
+        if: steps.test.outputs.regressing_tests == '' && github.event_name == 'pull_request'
+        uses: thollander/actions-comment-pull-request@v2
+        with:
+          comment_tag: test-windows-${{ matrix.arch }}-${{ matrix.cpu }}
+          mode: upsert
+          create_if_not_exists: false
+          message: |
+            ✅🪟 Test regressions on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }} have been resolved.
+      - id: fail
+        name: Fail the build
+        if: steps.test.outputs.regressing_tests != '' && github.event_name == 'pull_request'
+        run: exit 1

.github/workflows/format.yml

@@ -1,5 +1,8 @@
 name: autofix.ci # Must be named this for autofix.ci to work
 
+permissions:
+  contents: read
+
 on:
   workflow_dispatch:
   pull_request:
@@ -10,26 +13,24 @@ on:
 env:
   ZIG_VERSION: 0.12.0-dev.1828+225fe6ddb
 
-permissions:
-  contents: read
-
 jobs:
   format:
     name: format
-    runs-on: ubuntu-latest
+    runs-on: ${{ vars.RUNNER_LINUX_X64 || 'ubuntu-latest' }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
         with:
           sparse-checkout: |
+            .github
             src
             packages
             test
             bench
       - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
+        uses: ./.github/actions/setup-bun
         with:
-          bun-version: latest
+          bun-version: "1.0.21"
       - name: Setup Zig
         uses: goto-bus-stop/setup-zig@c7b6cdd3adba8f8b96984640ff172c37c93f73ee
         with:

.gitignore

@@ -1,164 +1,168 @@
-.DS_Store
-zig-cache
-packages/*/*.wasm
-*.o
-*.a
-profile.json
-
-node_modules
-.envrc
-.swcrc
-yarn.lock
-dist
-*.tmp
-*.log
-*.out.js
-*.out.refresh.js
-**/package-lock.json
-build
-*.wat
-zig-out
-pnpm-lock.yaml
-README.md.template
-src/deps/zig-clap/example
-src/deps/zig-clap/README.md
-src/deps/zig-clap/.github
-src/deps/zig-clap/.gitattributes
-out
-outdir
-
-.trace
-cover
-coverage
-coverv
-*.trace
-github
-out.*
-out
-.parcel-cache
-esbuilddir
-*.bun
-parceldist
-esbuilddir
-outdir/
-outcss
-.next
-txt.js
-.idea
-.vscode/cpp*
-.vscode/clang*
-
-node_modules_*
-*.jsb
-*.zip
-bun-zigld
-bun-singlehtreaded
-bun-nomimalloc
-bun-mimalloc
-examples/lotta-modules/bun-yday
-examples/lotta-modules/bun-old
-examples/lotta-modules/bun-nofscache
-
-src/node-fallbacks/out/*
-src/node-fallbacks/node_modules
-sign.json
-release/
-*.dmg
-sign.*.json
-packages/debug-*
-packages/bun-cli/postinstall.js
-packages/bun-*/bun
-packages/bun-*/bun-profile
-packages/bun-*/debug-bun
-packages/bun-*/*.o
-packages/bun-cli/postinstall.js
-
-packages/bun-cli/bin/*
-bun-test-scratch
-misctools/fetch
-
-src/deps/libiconv
-src/deps/openssl
-src/tests.zig
-*.blob
-src/deps/s2n-tls
-.npm
-.npm.gz
-
-bun-binary
-
-src/deps/PLCrashReporter/
-
-*.dSYM
-*.crash
-misctools/sha
-packages/bun-wasm/*.mjs
-packages/bun-wasm/*.cjs
-packages/bun-wasm/*.map
-packages/bun-wasm/*.js
-packages/bun-wasm/*.d.ts
-packages/bun-wasm/*.d.cts
-packages/bun-wasm/*.d.mts
-*.bc
-
-src/fallback.version
-src/runtime.version
-*.sqlite
-*.database
-*.db
-misctools/machbench
-*.big
-.eslintcache
-
-/bun-webkit
-
-src/deps/c-ares/build
-src/bun.js/bindings-obj
-src/bun.js/debug-bindings-obj
-
-failing-tests.txt
-test.txt
-myscript.sh
-
-cold-jsc-start
-cold-jsc-start.d
-
-/test.ts
-/test.js
-
-src/js/out/modules*
-src/js/out/functions*
-src/js/out/tmp
-src/js/out/DebugPath.h
-
-make-dev-stats.csv
-
-.uuid
-tsconfig.tsbuildinfo
-
-test/js/bun/glob/fixtures
-*.lib
-*.pdb
-CMakeFiles
-build.ninja
-.ninja_deps
-.ninja_log
-CMakeCache.txt
-cmake_install.cmake
-compile_commands.json
-
-*.lib
-x64
-**/*.vcxproj*
-**/*.sln*
-**/*.dir
-**/*.pdb
-
-/.webkit-cache
-/.cache
-/src/deps/libuv
-/build-*/
-
-.vs
-
-**/.verdaccio-db.json
+.DS_Store
+zig-cache
+packages/*/*.wasm
+*.o
+*.a
+profile.json
+
+.env
+node_modules
+.envrc
+.swcrc
+yarn.lock
+dist
+*.tmp
+*.log
+*.out.js
+*.out.refresh.js
+**/package-lock.json
+build
+*.wat
+zig-out
+pnpm-lock.yaml
+README.md.template
+src/deps/zig-clap/example
+src/deps/zig-clap/README.md
+src/deps/zig-clap/.github
+src/deps/zig-clap/.gitattributes
+out
+outdir
+
+.trace
+cover
+coverage
+coverv
+*.trace
+github
+out.*
+out
+.parcel-cache
+esbuilddir
+*.bun
+parceldist
+esbuilddir
+outdir/
+outcss
+.next
+txt.js
+.idea
+.vscode/cpp*
+.vscode/clang*
+
+node_modules_*
+*.jsb
+*.zip
+bun-zigld
+bun-singlehtreaded
+bun-nomimalloc
+bun-mimalloc
+examples/lotta-modules/bun-yday
+examples/lotta-modules/bun-old
+examples/lotta-modules/bun-nofscache
+
+src/node-fallbacks/out/*
+src/node-fallbacks/node_modules
+sign.json
+release/
+*.dmg
+sign.*.json
+packages/debug-*
+packages/bun-cli/postinstall.js
+packages/bun-*/bun
+packages/bun-*/bun-profile
+packages/bun-*/debug-bun
+packages/bun-*/*.o
+packages/bun-cli/postinstall.js
+
+packages/bun-cli/bin/*
+bun-test-scratch
+misctools/fetch
+
+src/deps/libiconv
+src/deps/openssl
+src/tests.zig
+*.blob
+src/deps/s2n-tls
+.npm
+.npm.gz
+
+bun-binary
+
+src/deps/PLCrashReporter/
+
+*.dSYM
+*.crash
+misctools/sha
+packages/bun-wasm/*.mjs
+packages/bun-wasm/*.cjs
+packages/bun-wasm/*.map
+packages/bun-wasm/*.js
+packages/bun-wasm/*.d.ts
+packages/bun-wasm/*.d.cts
+packages/bun-wasm/*.d.mts
+*.bc
+
+src/fallback.version
+src/runtime.version
+*.sqlite
+*.database
+*.db
+misctools/machbench
+*.big
+.eslintcache
+
+/bun-webkit
+
+src/deps/c-ares/build
+src/bun.js/bindings-obj
+src/bun.js/debug-bindings-obj
+
+failing-tests.txt
+test.txt
+myscript.sh
+
+cold-jsc-start
+cold-jsc-start.d
+
+/testdir
+/test.ts
+/test.js
+
+src/js/out/modules*
+src/js/out/functions*
+src/js/out/tmp
+src/js/out/DebugPath.h
+
+make-dev-stats.csv
+
+.uuid
+tsconfig.tsbuildinfo
+
+test/js/bun/glob/fixtures
+*.lib
+*.pdb
+CMakeFiles
+build.ninja
+.ninja_deps
+.ninja_log
+CMakeCache.txt
+cmake_install.cmake
+compile_commands.json
+
+*.lib
+x64
+**/*.vcxproj*
+**/*.sln*
+**/*.dir
+**/*.pdb
+
+/.webkit-cache
+/.cache
+/src/deps/libuv
+/build-*/
+
+.vs
+
+**/.verdaccio-db.json
+/test-report.md
+/test-report.json

.gitmodules

@@ -82,4 +82,4 @@ url = https://github.com/litespeedtech/ls-hpack.git
 ignore = dirty
 depth = 1
 shallow = true
-fetchRecurseSubmodules = false
+fetchRecurseSubmodules = false

.prettierignore

@@ -1,13 +1,5 @@
-src/fallback.html
 src/bun.js/WebKit
-src/js/out
-src/*.out.js
-src/*out.*.js
 src/deps
-src/test/fixtures
-src/react-refresh.js
 test/snapshots
-test/snapshots-no-hmr
-test/js/deno/*.test.ts
-test/js/deno/**/*.test.ts
-bench/react-hello-world/react-hello-world.node.js
+test/js/deno
+src/react-refresh.js

.prettierrc

@@ -0,0 +1,15 @@
+{
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "trailingComma": "all",
+  "useTabs": false,
+  "quoteProps": "preserve",
+  "overrides": [
+    {
+      "files": ["*.md"],
+      "options": {
+        "printWidth": 80
+      }
+    }
+  ]
+}

.prettierrc.cjs

@@ -1,15 +0,0 @@
-module.exports = {
-  arrowParens: "avoid",
-  printWidth: 120,
-  trailingComma: "all",
-  useTabs: false,
-  quoteProps: "preserve",
-  overrides: [
-    {
-      files: ["*.md"],
-      options: {
-        printWidth: 80,
-      },
-    },
-  ],
-};

.vscode/c_cpp_properties.json

@@ -3,6 +3,7 @@
     {
       "name": "Debug",
       "forcedInclude": ["${workspaceFolder}/src/bun.js/bindings/root.h"],
+      "compileCommands": "${workspaceFolder}/build/compile_commands.json",
       "includePath": [
         "${workspaceFolder}/build/bun-webkit/include",
         "${workspaceFolder}/build/codegen",

.vscode/extensions.json

@@ -1,10 +1,33 @@
 {
   "recommendations": [
+    // Zig
     "ziglang.vscode-zig",
-    "esbenp.prettier-vscode",
+
+    // C/C++
+    "clang.clangd",
+    "ms-vscode.cmake-tools",
     "xaver.clang-format",
     "vadimcn.vscode-lldb",
-    "bierner.comment-tagged-templates",
-    "ms-vscode.cpptools"
+
+    // JavaScript
+    "oven.bun-vscode",
+    "esbenp.prettier-vscode",
+
+    // TypeScript
+    "better-ts-errors.better-ts-errors",
+    "MylesMurphy.prettify-ts",
+
+    // Markdown
+    "bierner.markdown-preview-github-styles",
+    "bierner.markdown-emoji",
+    "bierner.emojisense",
+    "bierner.markdown-checkbox",
+    "bierner.jsdoc-markdown-highlighting",
+
+    // TOML
+    "tamasfe.even-better-toml",
+
+    // Other
+    "bierner.comment-tagged-templates"
   ]
 }

.vscode/settings.json

@@ -1,47 +1,89 @@
 {
-  "git.autoRepositoryDetection": "openEditors",
+  // Editor
+  "editor.tabSize": 2,
+  "editor.insertSpaces": true,
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file",
+
+  // Search
   "search.quickOpen.includeSymbols": false,
   "search.seedWithNearestWord": true,
   "search.smartCase": true,
   "search.exclude": {
     "node_modules": true,
-    "src/bun.js/WebKit": true,
     ".git": true,
+    "src/bun.js/WebKit": true,
     "src/deps/*/**": true
   },
   "search.followSymlinks": false,
   "search.useIgnoreFiles": true,
+
+  // Git
+  "git.autoRepositoryDetection": "openEditors",
+  "git.ignoreSubmodules": true,
+  "git.ignoreLimitWarning": true,
+
+  // Zig
+  "zig.initialSetupDone": true,
   "zig.buildOnSave": false,
-  "zig.formattingProvider": "zls",
   "zig.buildOption": "build",
   "zig.buildFilePath": "${workspaceFolder}/build.zig",
-  "zig.initialSetupDone": true,
-  "editor.formatOnSave": true,
+  "zig.path": "${workspaceFolder}/.cache/zig/zig.exe",
+  "zig.formattingProvider": "zls",
+  "zig.zls.enableInlayHints": false,
   "[zig]": {
     "editor.tabSize": 4,
     "editor.useTabStops": false,
     "editor.defaultFormatter": "ziglang.vscode-zig"
   },
-  "[ts]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
+
+  // C++
+  "lldb.verboseLogging": false,
+  "cmake.configureOnOpen": false,
+  "C_Cpp.errorSquiggles": "enabled",  
+  "[cpp]": {
+    "editor.defaultFormatter": "xaver.clang-format"
   },
-  "[js]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  "[c]": {
+    "editor.defaultFormatter": "xaver.clang-format"
   },
-  "zig.zls.enableInlayHints": false,
-  "git.ignoreSubmodules": true,
-  "[jsx]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  "[h]": {
+    "editor.defaultFormatter": "xaver.clang-format"
   },
-  "[tsx]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[yaml]": {},
-  "[markdown]": {
-    "editor.unicodeHighlight.ambiguousCharacters": false,
-    "editor.unicodeHighlight.invisibleCharacters": false,
-    "diffEditor.ignoreTrimWhitespace": false,
+
+  // JavaScript
+  "prettier.enable": true,
+  "eslint.workingDirectories": ["${workspaceFolder}/packages/bun-types"],
+  "[javascript]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+
+  // TypeScript
+  "typescript.tsdk": "${workspaceFolder}/node_modules/typescript/lib",
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+
+  // JSON
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+  
+  // Markdown
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.unicodeHighlight.ambiguousCharacters": true,
+    "editor.unicodeHighlight.invisibleCharacters": true,
+    "diffEditor.ignoreTrimWhitespace": false,
     "editor.wordWrap": "on",
     "editor.quickSuggestions": {
       "comments": "off",
@@ -49,7 +91,18 @@
       "other": "off"
     }
   },
-  "lldb.verboseLogging": false,
+
+  // TOML
+  "[toml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+
+  // YAML
+  "[yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+
+  // Files
   "files.exclude": {
     "**/.git": true,
     "**/.svn": true,
@@ -59,7 +112,6 @@
     "**/Thumbs.db": true,
     "**/*.xcworkspacedata": true,
     "**/*.xcscheme": true,
-    "**/*.pem": true,
     "**/*.xcodeproj": true,
     "src/bun.js/WebKit": true,
     "src/deps/libarchive": true,
@@ -74,7 +126,10 @@
     "src/deps/tinycc": true,
     "src/deps/zstd": true,
     "**/*.i": true,
-    "packages/bun-uws/fuzzing/seed-corpus/**/*": true
+    "packages/bun-uws/fuzzing/seed-corpus": true
+  },
+  "files.associations": {
+    "*.idl": "cpp"
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,
@@ -94,136 +149,4 @@
     "WebKit/WebKitBuild": true,
     "WebKit/WebInspectorUI": true
   },
-  "[cpp]": {
-    "editor.defaultFormatter": "xaver.clang-format"
-  },
-  "[h]": {
-    "editor.defaultFormatter": "xaver.clang-format"
-  },
-  "[c]": {
-    "editor.defaultFormatter": "xaver.clang-format"
-  },
-  "files.associations": {
-    "*.lock": "yarnlock",
-    "*.idl": "cpp",
-    "memory": "cpp",
-    "iostream": "cpp",
-    "algorithm": "cpp",
-    "random": "cpp",
-    "ios": "cpp",
-    "filesystem": "cpp",
-    "__locale": "cpp",
-    "type_traits": "cpp",
-    "__mutex_base": "cpp",
-    "__string": "cpp",
-    "string": "cpp",
-    "string_view": "cpp",
-    "typeinfo": "cpp",
-    "__config": "cpp",
-    "__nullptr": "cpp",
-    "exception": "cpp",
-    "__bit_reference": "cpp",
-    "atomic": "cpp",
-    "utility": "cpp",
-    "sstream": "cpp",
-    "__functional_base": "cpp",
-    "new": "cpp",
-    "__debug": "cpp",
-    "__errc": "cpp",
-    "__hash_table": "cpp",
-    "__node_handle": "cpp",
-    "__split_buffer": "cpp",
-    "__threading_support": "cpp",
-    "__tuple": "cpp",
-    "array": "cpp",
-    "bit": "cpp",
-    "bitset": "cpp",
-    "cctype": "cpp",
-    "chrono": "cpp",
-    "clocale": "cpp",
-    "cmath": "cpp",
-    "complex": "cpp",
-    "condition_variable": "cpp",
-    "cstdarg": "cpp",
-    "cstddef": "cpp",
-    "cstdint": "cpp",
-    "cstdio": "cpp",
-    "cstdlib": "cpp",
-    "cstring": "cpp",
-    "ctime": "cpp",
-    "cwchar": "cpp",
-    "cwctype": "cpp",
-    "deque": "cpp",
-    "fstream": "cpp",
-    "functional": "cpp",
-    "initializer_list": "cpp",
-    "iomanip": "cpp",
-    "iosfwd": "cpp",
-    "istream": "cpp",
-    "iterator": "cpp",
-    "limits": "cpp",
-    "locale": "cpp",
-    "mutex": "cpp",
-    "optional": "cpp",
-    "ostream": "cpp",
-    "ratio": "cpp",
-    "stack": "cpp",
-    "stdexcept": "cpp",
-    "streambuf": "cpp",
-    "system_error": "cpp",
-    "thread": "cpp",
-    "tuple": "cpp",
-    "unordered_map": "cpp",
-    "unordered_set": "cpp",
-    "vector": "cpp",
-    "__bits": "cpp",
-    "__tree": "cpp",
-    "map": "cpp",
-    "numeric": "cpp",
-    "set": "cpp",
-    "__memory": "cpp",
-    "memory_resource": "cpp",
-    "*.tcc": "cpp",
-    "list": "cpp",
-    "shared_mutex": "cpp",
-    "cinttypes": "cpp",
-    "variant": "cpp",
-    "sysctl.h": "c",
-    "queue": "cpp",
-    "compare": "cpp",
-    "concepts": "cpp",
-    "typeindex": "cpp",
-    "__verbose_abort": "cpp",
-    "__std_stream": "cpp",
-    "any": "cpp",
-    "charconv": "cpp",
-    "csignal": "cpp",
-    "format": "cpp",
-    "forward_list": "cpp",
-    "future": "cpp",
-    "regex": "cpp",
-    "span": "cpp",
-    "valarray": "cpp",
-    "codecvt": "cpp",
-    "xtr1common": "cpp",
-    "stop_token": "cpp",
-    "xfacet": "cpp",
-    "xhash": "cpp",
-    "xiosbase": "cpp",
-    "xlocale": "cpp",
-    "xlocbuf": "cpp",
-    "xlocinfo": "cpp",
-    "xlocmes": "cpp",
-    "xlocmon": "cpp",
-    "xlocnum": "cpp",
-    "xloctime": "cpp",
-    "xmemory": "cpp",
-    "xstring": "cpp",
-    "xtree": "cpp",
-    "xutility": "cpp"
-  },
-  "C_Cpp.errorSquiggles": "enabled",
-  "eslint.workingDirectories": ["packages/bun-types"],
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "cmake.configureOnOpen": false
 }

.vscode/tasks.json

@@ -2,10 +2,51 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "Rebuild Debug",
-      "command": "ninja",
-      "args": ["-Cbuild"],
       "type": "process",
-    }
+      "label": "Install Dependencies",
+      "command": "scripts/all-dependencies.sh",
+      "windows": {
+        "command": "scripts/all-dependencies.ps1"
+      },
+      "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,
+      },
+    },
   ]
 }

Dockerfile

@@ -290,7 +290,6 @@ ENV CCACHE_DIR=/ccache
 
 COPY Makefile ${BUN_DIR}/Makefile
 COPY src/deps/zstd ${BUN_DIR}/src/deps/zstd
-COPY .prettierrc.cjs ${BUN_DIR}/.prettierrc.cjs
 
 WORKDIR $BUN_DIR
 
@@ -378,9 +377,9 @@ RUN --mount=type=cache,target=/ccache  mkdir ${BUN_DIR}/build \
 
 FROM bun-base-with-zig as bun-codegen-for-zig
 
-COPY package.json bun.lockb Makefile .gitmodules .prettierrc.cjs ${BUN_DIR}/
+COPY package.json bun.lockb Makefile .gitmodules ${BUN_DIR}/
 COPY src/runtime ${BUN_DIR}/src/runtime
-COPY src/runtime.js src/runtime.footer*.js src/react-refresh.js ${BUN_DIR}/src/
+COPY src/runtime.js src/runtime.bun.js ${BUN_DIR}/src/
 COPY packages/bun-error ${BUN_DIR}/packages/bun-error
 COPY src/fallback.ts ${BUN_DIR}/src/fallback.ts
 COPY src/api ${BUN_DIR}/src/api

Makefile

@@ -673,7 +673,7 @@ assert-deps:
 	@echo "You have the dependencies installed! Woo"
 
 # the following allows you to run `make submodule` to update or init submodules. but we will exclude webkit
-# unless you explicity clone it yourself (a huge download)
+# unless you explicitly clone it yourself (a huge download)
 SUBMODULE_NAMES=$(shell cat .gitmodules | grep 'path = ' | awk '{print $$3}')
 ifeq ("$(wildcard src/bun.js/WebKit/.git)", "")
 	SUBMODULE_NAMES := $(filter-out src/bun.js/WebKit, $(SUBMODULE_NAMES))
@@ -823,7 +823,6 @@ fmt: fmt-cpp fmt-zig
 api:
 	./node_modules/.bin/peechy --schema src/api/schema.peechy --esm src/api/schema.js --ts src/api/schema.d.ts --zig src/api/schema.zig
 	$(ZIG) fmt src/api/schema.zig
-	$(PRETTIER) --config=.prettierrc.cjs --write src/api/schema.js src/api/schema.d.ts
 
 .PHONY: node-fallbacks
 node-fallbacks:
@@ -836,17 +835,7 @@ fallback_decoder:
 
 .PHONY: runtime_js
 runtime_js:
-	@NODE_ENV=production $(ESBUILD) --define:process.env.NODE_ENV=\"production\" --target=esnext  --bundle src/runtime/index.ts --format=iife --platform=browser --global-name=BUN_RUNTIME --minify --external:/bun:* > src/runtime.out.js; cat src/runtime.footer.js >> src/runtime.out.js
-	@NODE_ENV=production $(ESBUILD) --define:process.env.NODE_ENV=\"production\" --target=esnext  --bundle src/runtime/index-with-refresh.ts --format=iife --platform=browser --global-name=BUN_RUNTIME --minify --external:/bun:* > src/runtime.out.refresh.js; cat src/runtime.footer.with-refresh.js >> src/runtime.out.refresh.js
-	@NODE_ENV=production $(ESBUILD) --define:process.env.NODE_ENV=\"production\" --target=esnext  --bundle src/runtime/index-without-hmr.ts --format=iife --platform=node --global-name=BUN_RUNTIME --minify --external:/bun:* > src/runtime.node.pre.out.js; cat src/runtime.node.pre.out.js src/runtime.footer.node.js > src/runtime.node.out.js
-	@NODE_ENV=production $(ESBUILD) --define:process.env.NODE_ENV=\"production\" --target=esnext  --bundle src/runtime/index-without-hmr.ts --format=iife --platform=node --global-name=BUN_RUNTIME --minify --external:/bun:* > src/runtime.bun.pre.out.js; cat src/runtime.bun.pre.out.js src/runtime.footer.bun.js > src/runtime.bun.out.js
-
-.PHONY: runtime_js_dev
-runtime_js_dev:
-	@NODE_ENV=development $(ESBUILD) --define:process.env.NODE_ENV="development" --target=esnext  --bundle src/runtime/index.ts --format=iife --platform=browser --global-name=BUN_RUNTIME --external:/bun:* > src/runtime.out.js; cat src/runtime.footer.js >> src/runtime.out.js
-	@NODE_ENV=development $(ESBUILD) --define:process.env.NODE_ENV="development" --target=esnext  --bundle src/runtime/index-with-refresh.ts --format=iife --platform=browser --global-name=BUN_RUNTIME --external:/bun:* > src/runtime.out.refresh.js; cat src/runtime.footer.with-refresh.js >> src/runtime.out.refresh.js
-	@NODE_ENV=development $(ESBUILD) --define:process.env.NODE_ENV="development" --target=esnext  --bundle src/runtime/index-without-hmr.ts --format=iife --platform=node --global-name=BUN_RUNTIME --external:/bun:* > src/runtime.node.pre.out.js; cat src/runtime.node.pre.out.js src/runtime.footer.node.js > src/runtime.node.out.js
-	@NODE_ENV=development $(ESBUILD) --define:process.env.NODE_ENV="development" --target=esnext  --bundle src/runtime/index-without-hmr.ts --format=iife --platform=node --global-name=BUN_RUNTIME --external:/bun:* > src/runtime.bun.pre.out.js; cat src/runtime.bun.pre.out.js src/runtime.footer.bun.js > src/runtime.bun.out.js
+	@NODE_ENV=production $(ESBUILD) --define:process.env.NODE_ENV=\"production\" --target=esnext --bundle src/runtime.bun.js --format=esm --platform=node --minify --external:/bun:* > src/runtime.out.js
 
 .PHONY: bun_error
 bun_error:
@@ -1733,7 +1722,7 @@ sizegen:
 # Linux uses bundled SQLite3
 ifeq ($(OS_NAME),linux)
 sqlite:
-	$(CC) $(EMIT_LLVM_FOR_RELEASE) $(CFLAGS) $(INCLUDE_DIRS) -DSQLITE_ENABLE_COLUMN_METADATA= -DSQLITE_MAX_VARIABLE_NUMBER=250000 -DSQLITE_ENABLE_RTREE=1 -DSQLITE_ENABLE_FTS3=1 -DSQLITE_ENABLE_FTS3_PARENTHESIS=1 -DSQLITE_ENABLE_FTS5=1 -DSQLITE_ENABLE_JSON1=1 $(SRC_DIR)/sqlite/sqlite3.c -c -o $(SQLITE_OBJECT)
+	$(CC) $(EMIT_LLVM_FOR_RELEASE) $(CFLAGS) $(INCLUDE_DIRS) -DSQLITE_ENABLE_COLUMN_METADATA= -DSQLITE_MAX_VARIABLE_NUMBER=250000 -DSQLITE_ENABLE_RTREE=1 -DSQLITE_ENABLE_FTS3=1 -DSQLITE_ENABLE_FTS3_PARENTHESIS=1 -DSQLITE_ENABLE_FTS5=1 -DSQLITE_ENABLE_JSON1=1 -DSQLITE_ENABLE_MATH_FUNCTIONS=1 $(SRC_DIR)/sqlite/sqlite3.c -c -o $(SQLITE_OBJECT)
 endif
 
 picohttp:

README.md

@@ -24,9 +24,9 @@
 
 ## What is Bun?
 
-> **​​Bun is under active development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
+> **Bun is under active development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
 
-Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun​`.
+Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun`.
 
 At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-in replacement for Node.js. It's written in Zig and powered by JavaScriptCore under the hood, dramatically reducing startup times and memory usage.
 
@@ -34,12 +34,12 @@ At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-i
 bun run index.tsx             # TS and JSX supported out-of-the-box
 ```
 
-​​The `bun​` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager. Instead of 1,000 node_modules for development, you only need `bun`. Bun's built-in tools are significantly faster than existing options and usable in existing Node.js projects with little to no changes.
+The `bun` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager. Instead of 1,000 node_modules for development, you only need `bun`. Bun's built-in tools are significantly faster than existing options and usable in existing Node.js projects with little to no changes.
 
 ```bash
 bun test                      # run tests
 bun run start                 # run the `start` script in `package.json`
-bun install <pkg>​             # install a package
+bun install <pkg>             # install a package
 bunx cowsay 'Hello, world!'   # execute a package
 ```
 

bench/emitter/realworld_stream.mjs

@@ -1,7 +1,7 @@
 import { bench, run } from "mitata";
 import { groupForEmitter } from "./implementations.mjs";
 
-// Psuedo RNG is derived from https://stackoverflow.com/a/424445
+// Pseudo RNG is derived from https://stackoverflow.com/a/424445
 let rngState = 123456789;
 function nextInt() {
   const m = 0x80000000; // 2**31;

bench/glob/braces.mjs

@@ -0,0 +1,37 @@
+import braces from "braces";
+import { group, bench, run } from "mitata";
+
+// const iterations = 1000;
+const iterations = 100;
+
+const simplePattern = "foo.{js,jsx,ts,tsx}";
+const complexPattern = "{a,b,HI{c,e,LMAO{d,f}Q}} wow {a,b}";
+const veryComplexPattern = "{a,b,HI{c,e,LMAO{d,f}Q}}{1,2,{3,4},5}";
+
+console.log(braces(complexPattern, { expand: true }));
+function benchPattern(pattern, name) {
+  group({ name: `${name} pattern: "${pattern}"`, summary: true }, () => {
+    if (typeof Bun !== "undefined")
+      bench("Bun", () => {
+        for (let i = 0; i < iterations; i++) {
+          Bun.$.braces(pattern);
+        }
+      });
+
+    bench("micromatch/braces", () => {
+      for (let i = 0; i < iterations; i++) {
+        braces(pattern, { expand: true });
+      }
+    });
+  });
+}
+
+benchPattern(simplePattern, "simple");
+benchPattern(complexPattern, "complex");
+benchPattern(veryComplexPattern, "very complex pattern");
+
+await run({
+  avg: true,
+  min_max: true,
+  percentiles: true,
+});

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

@@ -25,7 +25,7 @@ pub var all_timestamps: [RUN_COUNT + 1]usize = undefined;
 // 1. file path
 // 2. Byte offset in file
 // 3. ms update interval
-var color_buf: [8096 + SIMULATE_LONG_FILE.len]u8 = undefined;
+var color_buf: [8192 + SIMULATE_LONG_FILE.len]u8 = undefined;
 
 pub fn main() anyerror!void {
     var allocator = std.heap.c_allocator;

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

@@ -25,7 +25,7 @@ pub var all_timestamps: [RUN_COUNT + 1]usize = undefined;
 // 1. file path
 // 2. Byte offset in file
 // 3. ms update interval
-var color_buf: [8096 + SIMULATE_LONG_FILE.len]u8 = undefined;
+var color_buf: [8192 + SIMULATE_LONG_FILE.len]u8 = undefined;
 
 pub fn main() anyerror!void {
     var allocator = std.heap.c_allocator;

bench/hot-module-reloading/css-stress-test/timings/bun-cli@0.0.34.32ms.darwin-x64.json

@@ -7,280 +7,166 @@
     "version": "0.0.34"
   },
   "timestamps": [
-    16336202536562, 16336202536908, 16336202537294, 16336202537705,
-    16336202538114, 16336202538534, 16336202538941, 16336202539323,
-    16336202539742, 16336202540159, 16336202540877, 16336202541310,
-    16336202541749, 16336202542159, 16336202542565, 16336202542996,
-    16336202543333, 16336202543761, 16336202544159, 16336202544534,
-    16336202544944, 16336202545345, 16336202545744, 16336202546159,
-    16336202546573, 16336202546986, 16336202547399, 16336202547781,
-    16336202548202, 16336202548564, 16336202548949, 16336202549329,
-    16336202549762, 16336202550168, 16336202550534, 16336202550887,
-    16336202551305, 16336202551659, 16336202552060, 16336202552449,
-    16336202552854, 16336202553270, 16336202553609, 16336202554034,
-    16336202554437, 16336202554783, 16336202555191, 16336202555623,
-    16336202556034, 16336202556449, 16336202556890, 16336202557283,
-    16336202557669, 16336202558084, 16336202558496, 16336202558863,
-    16336202559271, 16336202559659, 16336202560051, 16336202560452,
-    16336202560873, 16336202561290, 16336202561659, 16336202562035,
-    16336202562440, 16336202562862, 16336202563284, 16336202563659,
-    16336202564034, 16336202564444, 16336202564853, 16336202565245,
-    16336202565659, 16336202566034, 16336202566455, 16336202566873,
-    16336202567284, 16336202567659, 16336202568034, 16336202568386,
-    16336202568790, 16336202569204, 16336202569620, 16336202570384,
-    16336202570768, 16336202571188, 16336202571551, 16336202572327,
-    16336202572717, 16336202573116, 16336202573541, 16336202573959,
-    16336202574319, 16336202574682, 16336202575040, 16336202575375,
-    16336202577001, 16336202577342, 16336202577680, 16336202578066,
-    16336202578451, 16336202579166, 16336202579534, 16336202579960,
-    16336202580370, 16336202580789, 16336202581159, 16336202581576,
-    16336202581949, 16336202582294, 16336202583087, 16336202583496,
-    16336202583858, 16336202584203, 16336202584606, 16336202585034,
-    16336202585386, 16336202585788, 16336202586211, 16336202586604,
-    16336202587034, 16336202587459, 16336202587869, 16336202588295,
-    16336202588668, 16336202589092, 16336202589452, 16336202589831,
-    16336202590197, 16336202590608, 16336202591034, 16336202591460,
-    16336202591880, 16336202592295, 16336202592727, 16336202593172,
-    16336202593567, 16336202593994, 16336202594397, 16336202594795,
-    16336202595224, 16336202595659, 16336202596058, 16336202596463,
-    16336202596890, 16336202597322, 16336202597732, 16336202598159,
-    16336202598534, 16336202598951, 16336202599365, 16336202599785,
-    16336202600159, 16336202600593, 16336202601005, 16336202601402,
-    16336202601807, 16336202602214, 16336202602556, 16336202602895,
-    16336202603307, 16336202603661, 16336202604075, 16336202604491,
-    16336202604853, 16336202605268, 16336202605670, 16336202606034,
-    16336202606393, 16336202606748, 16336202607170, 16336202607568,
-    16336202607982, 16336202608411, 16336202608836, 16336202609197,
-    16336202609596, 16336202609965, 16336202610333, 16336202610740,
-    16336202611159, 16336202611573, 16336202611975, 16336202612317,
-    16336202612691, 16336202613060, 16336202613474, 16336202613903,
-    16336202614341, 16336202614707, 16336202615094, 16336202615534,
-    16336202615883, 16336202616296, 16336202616671, 16336202617034,
-    16336202617391, 16336202617727, 16336202618159, 16336202618534,
-    16336202618937, 16336202619360, 16336202619770, 16336202620179,
-    16336202620716, 16336202621143, 16336202621534, 16336202622303,
-    16336202622659, 16336202623085, 16336202623498, 16336202623850,
-    16336202624220, 16336202624606, 16336202625034, 16336202625387,
-    16336202625805, 16336202626210, 16336202626599, 16336202627034,
-    16336202627386, 16336202627748, 16336202628159, 16336202628534,
-    16336202628954, 16336202629373, 16336202629809, 16336202630197,
-    16336202630535, 16336202630916, 16336202631290, 16336202631666,
-    16336202632034, 16336202632369, 16336202633152, 16336202633534,
-    16336202633883, 16336202634309, 16336202634717, 16336202635106,
-    16336202635871, 16336202636253, 16336202636671, 16336202637070,
-    16336202637434, 16336202637798, 16336202638184, 16336202638539,
-    16336202638938, 16336202639307, 16336202639666, 16336202640095,
-    16336202640534, 16336202640962, 16336202641307, 16336202641659,
-    16336202642087, 16336202642521, 16336202642886, 16336202643309,
-    16336202643662, 16336202644067, 16336202644491, 16336202644853,
-    16336202645226, 16336202645659, 16336202646074, 16336202646497,
-    16336202646890, 16336202647311, 16336202647749, 16336202648169,
-    16336202648976, 16336202649378, 16336202649810, 16336202650165,
-    16336202650534, 16336202650875, 16336202651250, 16336202651659,
-    16336202652093, 16336202652516, 16336202652921, 16336202653332,
-    16336202653722, 16336202654142, 16336202654534, 16336202654880,
-    16336202655221, 16336202655562, 16336202655997, 16336202656378,
-    16336202656811, 16336202657161, 16336202657588, 16336202657944,
-    16336202658360, 16336202658708, 16336202659089, 16336202659428,
-    16336202659849, 16336202660273, 16336202660685, 16336202661105,
-    16336202661534, 16336202661873, 16336202662228, 16336202662658,
-    16336202663438, 16336202663843, 16336202664219, 16336202664646,
-    16336202665050, 16336202665487, 16336202665838, 16336202666211,
-    16336202666573, 16336202666927, 16336202667334, 16336202667746,
-    16336202668158, 16336202668563, 16336202668980, 16336202669406,
-    16336202669753, 16336202670192, 16336202670554, 16336202670903,
-    16336202671324, 16336202671734, 16336202672159, 16336202672573,
-    16336202672982, 16336202673346, 16336202673680, 16336202674087,
-    16336202674499, 16336202674909, 16336202675260, 16336202676110,
-    16336202676535, 16336202676913, 16336202677312, 16336202677658,
-    16336202678044, 16336202678413, 16336202678793, 16336202679208,
-    16336202679604, 16336202680034, 16336202680385, 16336202680799,
-    16336202681213, 16336202681595, 16336202682004, 16336202682346,
-    16336202682726, 16336202683158, 16336202683586, 16336202683990,
-    16336202684323, 16336202684742, 16336202685175, 16336202685578,
-    16336202685979, 16336202686805, 16336202687206, 16336202687614,
-    16336202688038, 16336202688473, 16336202688848, 16336202689221,
-    16336202689559, 16336202689971, 16336202690368, 16336202690776,
-    16336202691159, 16336202691585, 16336202692010, 16336202692373,
-    16336202692780, 16336202693179, 16336202693580, 16336202693991,
-    16336202694324, 16336202694727, 16336202695159, 16336202695588,
-    16336202695991, 16336202696335, 16336202697160, 16336202697542,
-    16336202697929, 16336202698323, 16336202698674, 16336202699060,
-    16336202699492, 16336202699835, 16336202700238, 16336202700658,
-    16336202701059, 16336202701420, 16336202701815, 16336202702229,
-    16336202702659, 16336202703857, 16336202704256, 16336202704659,
-    16336202705497, 16336202706309, 16336202706660, 16336202707085,
-    16336202707511, 16336202707866, 16336202708210, 16336202708552,
-    16336202708925, 16336202709287, 16336202709670, 16336202710045,
-    16336202710402, 16336202710802, 16336202711167, 16336202711533,
-    16336202712249, 16336202712660, 16336202713088, 16336202713519,
-    16336202713936, 16336202714355, 16336202714740, 16336202715160,
-    16336202715533, 16336202715878, 16336202716290, 16336202716708,
-    16336202717102, 16336202718290, 16336202718699, 16336202719052,
-    16336202719388, 16336202719808, 16336202720225, 16336202720659,
-    16336202721052, 16336202721414, 16336202721828, 16336202722925,
-    16336202723664, 16336202724063, 16336202724405, 16336202726003,
-    16336202726736, 16336202727158, 16336202727543, 16336202727930,
-    16336202728336, 16336202728703, 16336202729061, 16336202729483,
-    16336202729832, 16336202730222, 16336202730659, 16336202731084,
-    16336202731500, 16336202731911, 16336202732326, 16336202733158,
-    16336202733585, 16336202734001, 16336202734691, 16336202735042,
-    16336202735442, 16336202735863, 16336202736255, 16336202736671,
-    16336202737043, 16336202737884, 16336202738671, 16336202739110,
-    16336202739533, 16336202739886, 16336202740283, 16336202740706,
-    16336202741143, 16336202741534, 16336202741942, 16336202742352,
-    16336202742697, 16336202743103, 16336202743940, 16336202745172,
-    16336202745542, 16336202745937, 16336202746339, 16336202746758,
-    16336202747531, 16336202747877, 16336202748232, 16336202748658,
-    16336202749055, 16336202749468, 16336202749859, 16336202750416,
-    16336202750839, 16336202751178, 16336202751572, 16336202752002,
-    16336202752419, 16336202753269, 16336202753678, 16336202754086,
-    16336202754432, 16336202754835, 16336202755260, 16336202755683,
-    16336202756059, 16336202756402, 16336202756837, 16336202758084,
-    16336202758507, 16336202758879, 16336202759270, 16336202759674,
-    16336202760044, 16336202760400, 16336202760801, 16336202761659,
-    16336202762053, 16336202762397, 16336202763199, 16336202763547,
-    16336202763948, 16336202764714, 16336202765113, 16336202765947,
-    16336202766329, 16336202766664, 16336202767085, 16336202768233,
-    16336202769056, 16336202769758, 16336202770178, 16336202770585,
-    16336202770929, 16336202771325, 16336202772158, 16336202772594,
-    16336202773033, 16336202773403, 16336202773801, 16336202774179,
-    16336202774555, 16336202774989, 16336202775393, 16336202775809,
-    16336202776209, 16336202776618, 16336202777033, 16336202777421,
-    16336202777845, 16336202778246, 16336202778658, 16336202779055,
-    16336202779411, 16336202779761, 16336202780175, 16336202780594,
-    16336202781002, 16336202781848, 16336202782658, 16336202783033,
-    16336202783857, 16336202784211, 16336202784557, 16336202784972,
-    16336202785377, 16336202785810, 16336202786172, 16336202786934,
-    16336202787343, 16336202787765, 16336202788201, 16336202788563,
-    16336202788970, 16336202789329, 16336202789672, 16336202790055,
-    16336202790456, 16336202790802, 16336202791580, 16336202791920,
-    16336202792326, 16336202793158, 16336202793953, 16336202794368,
-    16336202795187, 16336202795622, 16336202796033, 16336202796393,
-    16336202796777, 16336202797173, 16336202797540, 16336202797975,
-    16336202798317, 16336202798739, 16336202799158, 16336202799567,
-    16336202799966, 16336202800378, 16336202800803, 16336202801232,
-    16336202801658, 16336202802033, 16336202802374, 16336202802759,
-    16336202803158, 16336202803533, 16336202803947, 16336202804354,
-    16336202804729, 16336202805158, 16336202805534, 16336202805950,
-    16336202806390, 16336202806805, 16336202807219, 16336202807643,
-    16336202808033, 16336202808377, 16336202808790, 16336202809211,
-    16336202809560, 16336202809920, 16336202810355, 16336202810758,
-    16336202811187, 16336202811596, 16336202811943, 16336202812348,
-    16336202812710, 16336202813060, 16336202813398, 16336202813791,
-    16336202814158, 16336202814533, 16336202814878, 16336202815246,
-    16336202815658, 16336202816079, 16336202816851, 16336202817202,
-    16336202817540, 16336202817905, 16336202818244, 16336202818663,
-    16336202819068, 16336202819418, 16336202819777, 16336202820193,
-    16336202820599, 16336202821033, 16336202821395, 16336202821745,
-    16336202822158, 16336202822590, 16336202822996, 16336202823396,
-    16336202823804, 16336202824210, 16336202824581, 16336202824991,
-    16336202825406, 16336202825806, 16336202826210, 16336202826598,
-    16336202827033, 16336202827446, 16336202827839, 16336202828201,
-    16336202828577, 16336202828968, 16336202829362, 16336202829709,
-    16336202830096, 16336202830533, 16336202830917, 16336202831290,
-    16336202831699, 16336202832035, 16336202832406, 16336202832804,
-    16336202833200, 16336202833604, 16336202834033, 16336202834386,
-    16336202834759, 16336202835190, 16336202835621, 16336202836033,
-    16336202836405, 16336202837191, 16336202837613, 16336202838033,
-    16336202838374, 16336202838798, 16336202839200, 16336202839603,
-    16336202840034, 16336202840389, 16336202840783, 16336202841200,
-    16336202841617, 16336202842034, 16336202842390, 16336202842737,
-    16336202843158, 16336202843585, 16336202843923, 16336202844313,
-    16336202844724, 16336202845158, 16336202845576, 16336202845939,
-    16336202846368, 16336202846728, 16336202847158, 16336202847568,
-    16336202847911, 16336202848291, 16336202848695, 16336202849103,
-    16336202849533, 16336202849942, 16336202850368, 16336202850747,
-    16336202851158, 16336202851549, 16336202851978, 16336202852383,
-    16336202852725, 16336202853158, 16336202853554, 16336202853961,
-    16336202854308, 16336202854704, 16336202855060, 16336202855418,
-    16336202855776, 16336202856203, 16336202856617, 16336202857036,
-    16336202857455, 16336202857884, 16336202858262, 16336202858658,
-    16336202859071, 16336202859847, 16336202860237, 16336202860658,
-    16336202861037, 16336202861452, 16336202861869, 16336202862218,
-    16336202862590, 16336202863001, 16336202863422, 16336202863857,
-    16336202864219, 16336202864658, 16336202865047, 16336202865404,
-    16336202865789, 16336202866210, 16336202866624, 16336202867033,
-    16336202867380, 16336202867797, 16336202868227, 16336202868658,
-    16336202869083, 16336202869500, 16336202869906, 16336202870246,
-    16336202870658, 16336202871086, 16336202871441, 16336202871820,
-    16336202872204, 16336202872546, 16336202872943, 16336202873380,
-    16336202873811, 16336202874213, 16336202874566, 16336202874918,
-    16336202875261, 16336202875655, 16336202876047, 16336202876771,
-    16336202877202, 16336202877612, 16336202878033, 16336202878412,
-    16336202878846, 16336202879241, 16336202879658, 16336202880072,
-    16336202880508, 16336202880901, 16336202881308, 16336202881725,
-    16336202882158, 16336202882579, 16336202882945, 16336202883286,
-    16336202883657, 16336202884048, 16336202884404, 16336202884752,
-    16336202885158, 16336202885533, 16336202885938, 16336202886364,
-    16336202886759, 16336202887175, 16336202887585, 16336202887929,
-    16336202888345, 16336202888743, 16336202889157, 16336202889570,
-    16336202889970, 16336202890382, 16336202890761, 16336202891187,
-    16336202891600, 16336202892033, 16336202892454, 16336202892794,
-    16336202893178, 16336202893533, 16336202893903, 16336202894264,
-    16336202894668, 16336202895049, 16336202895400, 16336202895774,
-    16336202896157, 16336202896537, 16336202896883, 16336202897232,
-    16336202897658, 16336202898065, 16336202898493, 16336202898884,
-    16336202899251, 16336202899673, 16336202900047, 16336202900467,
-    16336202900883, 16336202901300, 16336202901676, 16336202902068,
-    16336202902479, 16336202902902, 16336202903260, 16336202903675,
-    16336202904094, 16336202904476, 16336202904824, 16336202905158,
-    16336202905533, 16336202905934, 16336202906289, 16336202906717,
-    16336202907158, 16336202907547, 16336202907904, 16336202908294,
-    16336202908717, 16336202909157, 16336202909582, 16336202910005,
-    16336202910399, 16336202910800, 16336202911220, 16336202911657,
-    16336202912064, 16336202912405, 16336202912779, 16336202913158,
-    16336202913553, 16336202913966, 16336202914376, 16336202914719,
-    16336202915091, 16336202915515, 16336202915887, 16336202916293,
-    16336202916649, 16336202917438, 16336202917869, 16336202918221,
-    16336202919053, 16336202919425, 16336202919833, 16336202920234,
-    16336202920658, 16336202921033, 16336202921433, 16336202921801,
-    16336202922161, 16336202922589, 16336202923017, 16336202923418,
-    16336202923804, 16336202924199, 16336202924593, 16336202925033,
-    16336202925449, 16336202925818, 16336202926223, 16336202926662,
-    16336202927431, 16336202927812, 16336202928227, 16336202928658,
-    16336202929061, 16336202929473, 16336202929891, 16336202930241,
-    16336202930657, 16336202931057, 16336202931396, 16336202931811,
-    16336202932225, 16336202932657, 16336202933058, 16336202933445,
-    16336202933790, 16336202934157, 16336202934562, 16336202934988,
-    16336202935391, 16336202935777, 16336202936160, 16336202936562,
-    16336202936986, 16336202937396, 16336202937751, 16336202938158,
-    16336202938578, 16336202938985, 16336202939396, 16336202939752,
-    16336202940157, 16336202940585
+    16336202536562, 16336202536908, 16336202537294, 16336202537705, 16336202538114, 16336202538534, 16336202538941,
+    16336202539323, 16336202539742, 16336202540159, 16336202540877, 16336202541310, 16336202541749, 16336202542159,
+    16336202542565, 16336202542996, 16336202543333, 16336202543761, 16336202544159, 16336202544534, 16336202544944,
+    16336202545345, 16336202545744, 16336202546159, 16336202546573, 16336202546986, 16336202547399, 16336202547781,
+    16336202548202, 16336202548564, 16336202548949, 16336202549329, 16336202549762, 16336202550168, 16336202550534,
+    16336202550887, 16336202551305, 16336202551659, 16336202552060, 16336202552449, 16336202552854, 16336202553270,
+    16336202553609, 16336202554034, 16336202554437, 16336202554783, 16336202555191, 16336202555623, 16336202556034,
+    16336202556449, 16336202556890, 16336202557283, 16336202557669, 16336202558084, 16336202558496, 16336202558863,
+    16336202559271, 16336202559659, 16336202560051, 16336202560452, 16336202560873, 16336202561290, 16336202561659,
+    16336202562035, 16336202562440, 16336202562862, 16336202563284, 16336202563659, 16336202564034, 16336202564444,
+    16336202564853, 16336202565245, 16336202565659, 16336202566034, 16336202566455, 16336202566873, 16336202567284,
+    16336202567659, 16336202568034, 16336202568386, 16336202568790, 16336202569204, 16336202569620, 16336202570384,
+    16336202570768, 16336202571188, 16336202571551, 16336202572327, 16336202572717, 16336202573116, 16336202573541,
+    16336202573959, 16336202574319, 16336202574682, 16336202575040, 16336202575375, 16336202577001, 16336202577342,
+    16336202577680, 16336202578066, 16336202578451, 16336202579166, 16336202579534, 16336202579960, 16336202580370,
+    16336202580789, 16336202581159, 16336202581576, 16336202581949, 16336202582294, 16336202583087, 16336202583496,
+    16336202583858, 16336202584203, 16336202584606, 16336202585034, 16336202585386, 16336202585788, 16336202586211,
+    16336202586604, 16336202587034, 16336202587459, 16336202587869, 16336202588295, 16336202588668, 16336202589092,
+    16336202589452, 16336202589831, 16336202590197, 16336202590608, 16336202591034, 16336202591460, 16336202591880,
+    16336202592295, 16336202592727, 16336202593172, 16336202593567, 16336202593994, 16336202594397, 16336202594795,
+    16336202595224, 16336202595659, 16336202596058, 16336202596463, 16336202596890, 16336202597322, 16336202597732,
+    16336202598159, 16336202598534, 16336202598951, 16336202599365, 16336202599785, 16336202600159, 16336202600593,
+    16336202601005, 16336202601402, 16336202601807, 16336202602214, 16336202602556, 16336202602895, 16336202603307,
+    16336202603661, 16336202604075, 16336202604491, 16336202604853, 16336202605268, 16336202605670, 16336202606034,
+    16336202606393, 16336202606748, 16336202607170, 16336202607568, 16336202607982, 16336202608411, 16336202608836,
+    16336202609197, 16336202609596, 16336202609965, 16336202610333, 16336202610740, 16336202611159, 16336202611573,
+    16336202611975, 16336202612317, 16336202612691, 16336202613060, 16336202613474, 16336202613903, 16336202614341,
+    16336202614707, 16336202615094, 16336202615534, 16336202615883, 16336202616296, 16336202616671, 16336202617034,
+    16336202617391, 16336202617727, 16336202618159, 16336202618534, 16336202618937, 16336202619360, 16336202619770,
+    16336202620179, 16336202620716, 16336202621143, 16336202621534, 16336202622303, 16336202622659, 16336202623085,
+    16336202623498, 16336202623850, 16336202624220, 16336202624606, 16336202625034, 16336202625387, 16336202625805,
+    16336202626210, 16336202626599, 16336202627034, 16336202627386, 16336202627748, 16336202628159, 16336202628534,
+    16336202628954, 16336202629373, 16336202629809, 16336202630197, 16336202630535, 16336202630916, 16336202631290,
+    16336202631666, 16336202632034, 16336202632369, 16336202633152, 16336202633534, 16336202633883, 16336202634309,
+    16336202634717, 16336202635106, 16336202635871, 16336202636253, 16336202636671, 16336202637070, 16336202637434,
+    16336202637798, 16336202638184, 16336202638539, 16336202638938, 16336202639307, 16336202639666, 16336202640095,
+    16336202640534, 16336202640962, 16336202641307, 16336202641659, 16336202642087, 16336202642521, 16336202642886,
+    16336202643309, 16336202643662, 16336202644067, 16336202644491, 16336202644853, 16336202645226, 16336202645659,
+    16336202646074, 16336202646497, 16336202646890, 16336202647311, 16336202647749, 16336202648169, 16336202648976,
+    16336202649378, 16336202649810, 16336202650165, 16336202650534, 16336202650875, 16336202651250, 16336202651659,
+    16336202652093, 16336202652516, 16336202652921, 16336202653332, 16336202653722, 16336202654142, 16336202654534,
+    16336202654880, 16336202655221, 16336202655562, 16336202655997, 16336202656378, 16336202656811, 16336202657161,
+    16336202657588, 16336202657944, 16336202658360, 16336202658708, 16336202659089, 16336202659428, 16336202659849,
+    16336202660273, 16336202660685, 16336202661105, 16336202661534, 16336202661873, 16336202662228, 16336202662658,
+    16336202663438, 16336202663843, 16336202664219, 16336202664646, 16336202665050, 16336202665487, 16336202665838,
+    16336202666211, 16336202666573, 16336202666927, 16336202667334, 16336202667746, 16336202668158, 16336202668563,
+    16336202668980, 16336202669406, 16336202669753, 16336202670192, 16336202670554, 16336202670903, 16336202671324,
+    16336202671734, 16336202672159, 16336202672573, 16336202672982, 16336202673346, 16336202673680, 16336202674087,
+    16336202674499, 16336202674909, 16336202675260, 16336202676110, 16336202676535, 16336202676913, 16336202677312,
+    16336202677658, 16336202678044, 16336202678413, 16336202678793, 16336202679208, 16336202679604, 16336202680034,
+    16336202680385, 16336202680799, 16336202681213, 16336202681595, 16336202682004, 16336202682346, 16336202682726,
+    16336202683158, 16336202683586, 16336202683990, 16336202684323, 16336202684742, 16336202685175, 16336202685578,
+    16336202685979, 16336202686805, 16336202687206, 16336202687614, 16336202688038, 16336202688473, 16336202688848,
+    16336202689221, 16336202689559, 16336202689971, 16336202690368, 16336202690776, 16336202691159, 16336202691585,
+    16336202692010, 16336202692373, 16336202692780, 16336202693179, 16336202693580, 16336202693991, 16336202694324,
+    16336202694727, 16336202695159, 16336202695588, 16336202695991, 16336202696335, 16336202697160, 16336202697542,
+    16336202697929, 16336202698323, 16336202698674, 16336202699060, 16336202699492, 16336202699835, 16336202700238,
+    16336202700658, 16336202701059, 16336202701420, 16336202701815, 16336202702229, 16336202702659, 16336202703857,
+    16336202704256, 16336202704659, 16336202705497, 16336202706309, 16336202706660, 16336202707085, 16336202707511,
+    16336202707866, 16336202708210, 16336202708552, 16336202708925, 16336202709287, 16336202709670, 16336202710045,
+    16336202710402, 16336202710802, 16336202711167, 16336202711533, 16336202712249, 16336202712660, 16336202713088,
+    16336202713519, 16336202713936, 16336202714355, 16336202714740, 16336202715160, 16336202715533, 16336202715878,
+    16336202716290, 16336202716708, 16336202717102, 16336202718290, 16336202718699, 16336202719052, 16336202719388,
+    16336202719808, 16336202720225, 16336202720659, 16336202721052, 16336202721414, 16336202721828, 16336202722925,
+    16336202723664, 16336202724063, 16336202724405, 16336202726003, 16336202726736, 16336202727158, 16336202727543,
+    16336202727930, 16336202728336, 16336202728703, 16336202729061, 16336202729483, 16336202729832, 16336202730222,
+    16336202730659, 16336202731084, 16336202731500, 16336202731911, 16336202732326, 16336202733158, 16336202733585,
+    16336202734001, 16336202734691, 16336202735042, 16336202735442, 16336202735863, 16336202736255, 16336202736671,
+    16336202737043, 16336202737884, 16336202738671, 16336202739110, 16336202739533, 16336202739886, 16336202740283,
+    16336202740706, 16336202741143, 16336202741534, 16336202741942, 16336202742352, 16336202742697, 16336202743103,
+    16336202743940, 16336202745172, 16336202745542, 16336202745937, 16336202746339, 16336202746758, 16336202747531,
+    16336202747877, 16336202748232, 16336202748658, 16336202749055, 16336202749468, 16336202749859, 16336202750416,
+    16336202750839, 16336202751178, 16336202751572, 16336202752002, 16336202752419, 16336202753269, 16336202753678,
+    16336202754086, 16336202754432, 16336202754835, 16336202755260, 16336202755683, 16336202756059, 16336202756402,
+    16336202756837, 16336202758084, 16336202758507, 16336202758879, 16336202759270, 16336202759674, 16336202760044,
+    16336202760400, 16336202760801, 16336202761659, 16336202762053, 16336202762397, 16336202763199, 16336202763547,
+    16336202763948, 16336202764714, 16336202765113, 16336202765947, 16336202766329, 16336202766664, 16336202767085,
+    16336202768233, 16336202769056, 16336202769758, 16336202770178, 16336202770585, 16336202770929, 16336202771325,
+    16336202772158, 16336202772594, 16336202773033, 16336202773403, 16336202773801, 16336202774179, 16336202774555,
+    16336202774989, 16336202775393, 16336202775809, 16336202776209, 16336202776618, 16336202777033, 16336202777421,
+    16336202777845, 16336202778246, 16336202778658, 16336202779055, 16336202779411, 16336202779761, 16336202780175,
+    16336202780594, 16336202781002, 16336202781848, 16336202782658, 16336202783033, 16336202783857, 16336202784211,
+    16336202784557, 16336202784972, 16336202785377, 16336202785810, 16336202786172, 16336202786934, 16336202787343,
+    16336202787765, 16336202788201, 16336202788563, 16336202788970, 16336202789329, 16336202789672, 16336202790055,
+    16336202790456, 16336202790802, 16336202791580, 16336202791920, 16336202792326, 16336202793158, 16336202793953,
+    16336202794368, 16336202795187, 16336202795622, 16336202796033, 16336202796393, 16336202796777, 16336202797173,
+    16336202797540, 16336202797975, 16336202798317, 16336202798739, 16336202799158, 16336202799567, 16336202799966,
+    16336202800378, 16336202800803, 16336202801232, 16336202801658, 16336202802033, 16336202802374, 16336202802759,
+    16336202803158, 16336202803533, 16336202803947, 16336202804354, 16336202804729, 16336202805158, 16336202805534,
+    16336202805950, 16336202806390, 16336202806805, 16336202807219, 16336202807643, 16336202808033, 16336202808377,
+    16336202808790, 16336202809211, 16336202809560, 16336202809920, 16336202810355, 16336202810758, 16336202811187,
+    16336202811596, 16336202811943, 16336202812348, 16336202812710, 16336202813060, 16336202813398, 16336202813791,
+    16336202814158, 16336202814533, 16336202814878, 16336202815246, 16336202815658, 16336202816079, 16336202816851,
+    16336202817202, 16336202817540, 16336202817905, 16336202818244, 16336202818663, 16336202819068, 16336202819418,
+    16336202819777, 16336202820193, 16336202820599, 16336202821033, 16336202821395, 16336202821745, 16336202822158,
+    16336202822590, 16336202822996, 16336202823396, 16336202823804, 16336202824210, 16336202824581, 16336202824991,
+    16336202825406, 16336202825806, 16336202826210, 16336202826598, 16336202827033, 16336202827446, 16336202827839,
+    16336202828201, 16336202828577, 16336202828968, 16336202829362, 16336202829709, 16336202830096, 16336202830533,
+    16336202830917, 16336202831290, 16336202831699, 16336202832035, 16336202832406, 16336202832804, 16336202833200,
+    16336202833604, 16336202834033, 16336202834386, 16336202834759, 16336202835190, 16336202835621, 16336202836033,
+    16336202836405, 16336202837191, 16336202837613, 16336202838033, 16336202838374, 16336202838798, 16336202839200,
+    16336202839603, 16336202840034, 16336202840389, 16336202840783, 16336202841200, 16336202841617, 16336202842034,
+    16336202842390, 16336202842737, 16336202843158, 16336202843585, 16336202843923, 16336202844313, 16336202844724,
+    16336202845158, 16336202845576, 16336202845939, 16336202846368, 16336202846728, 16336202847158, 16336202847568,
+    16336202847911, 16336202848291, 16336202848695, 16336202849103, 16336202849533, 16336202849942, 16336202850368,
+    16336202850747, 16336202851158, 16336202851549, 16336202851978, 16336202852383, 16336202852725, 16336202853158,
+    16336202853554, 16336202853961, 16336202854308, 16336202854704, 16336202855060, 16336202855418, 16336202855776,
+    16336202856203, 16336202856617, 16336202857036, 16336202857455, 16336202857884, 16336202858262, 16336202858658,
+    16336202859071, 16336202859847, 16336202860237, 16336202860658, 16336202861037, 16336202861452, 16336202861869,
+    16336202862218, 16336202862590, 16336202863001, 16336202863422, 16336202863857, 16336202864219, 16336202864658,
+    16336202865047, 16336202865404, 16336202865789, 16336202866210, 16336202866624, 16336202867033, 16336202867380,
+    16336202867797, 16336202868227, 16336202868658, 16336202869083, 16336202869500, 16336202869906, 16336202870246,
+    16336202870658, 16336202871086, 16336202871441, 16336202871820, 16336202872204, 16336202872546, 16336202872943,
+    16336202873380, 16336202873811, 16336202874213, 16336202874566, 16336202874918, 16336202875261, 16336202875655,
+    16336202876047, 16336202876771, 16336202877202, 16336202877612, 16336202878033, 16336202878412, 16336202878846,
+    16336202879241, 16336202879658, 16336202880072, 16336202880508, 16336202880901, 16336202881308, 16336202881725,
+    16336202882158, 16336202882579, 16336202882945, 16336202883286, 16336202883657, 16336202884048, 16336202884404,
+    16336202884752, 16336202885158, 16336202885533, 16336202885938, 16336202886364, 16336202886759, 16336202887175,
+    16336202887585, 16336202887929, 16336202888345, 16336202888743, 16336202889157, 16336202889570, 16336202889970,
+    16336202890382, 16336202890761, 16336202891187, 16336202891600, 16336202892033, 16336202892454, 16336202892794,
+    16336202893178, 16336202893533, 16336202893903, 16336202894264, 16336202894668, 16336202895049, 16336202895400,
+    16336202895774, 16336202896157, 16336202896537, 16336202896883, 16336202897232, 16336202897658, 16336202898065,
+    16336202898493, 16336202898884, 16336202899251, 16336202899673, 16336202900047, 16336202900467, 16336202900883,
+    16336202901300, 16336202901676, 16336202902068, 16336202902479, 16336202902902, 16336202903260, 16336202903675,
+    16336202904094, 16336202904476, 16336202904824, 16336202905158, 16336202905533, 16336202905934, 16336202906289,
+    16336202906717, 16336202907158, 16336202907547, 16336202907904, 16336202908294, 16336202908717, 16336202909157,
+    16336202909582, 16336202910005, 16336202910399, 16336202910800, 16336202911220, 16336202911657, 16336202912064,
+    16336202912405, 16336202912779, 16336202913158, 16336202913553, 16336202913966, 16336202914376, 16336202914719,
+    16336202915091, 16336202915515, 16336202915887, 16336202916293, 16336202916649, 16336202917438, 16336202917869,
+    16336202918221, 16336202919053, 16336202919425, 16336202919833, 16336202920234, 16336202920658, 16336202921033,
+    16336202921433, 16336202921801, 16336202922161, 16336202922589, 16336202923017, 16336202923418, 16336202923804,
+    16336202924199, 16336202924593, 16336202925033, 16336202925449, 16336202925818, 16336202926223, 16336202926662,
+    16336202927431, 16336202927812, 16336202928227, 16336202928658, 16336202929061, 16336202929473, 16336202929891,
+    16336202930241, 16336202930657, 16336202931057, 16336202931396, 16336202931811, 16336202932225, 16336202932657,
+    16336202933058, 16336202933445, 16336202933790, 16336202934157, 16336202934562, 16336202934988, 16336202935391,
+    16336202935777, 16336202936160, 16336202936562, 16336202936986, 16336202937396, 16336202937751, 16336202938158,
+    16336202938578, 16336202938985, 16336202939396, 16336202939752, 16336202940157, 16336202940585
   ],
   "frameTimes": [
-    346, 411, 420, 382, 417, 433, 410, 431, 428, 375, 401, 415, 413, 382, 362,
-    380, 406, 353, 354, 389, 416, 425, 346, 432, 415, 393, 415, 367, 388, 401,
-    417, 376, 422, 375, 410, 392, 375, 418, 375, 352, 414, 764, 420, 776, 399,
-    418, 363, 335, 341, 386, 715, 426, 419, 417, 345, 409, 345, 428, 402, 393,
-    425, 426, 424, 379, 411, 426, 415, 445, 427, 398, 435, 405, 432, 427, 417,
-    420, 434, 397, 407, 339, 354, 416, 415, 364, 355, 398, 429, 361, 369, 407,
-    414, 342, 369, 429, 366, 440, 413, 363, 336, 375, 423, 409, 427, 769, 426,
-    352, 386, 353, 405, 435, 362, 375, 419, 388, 381, 376, 335, 382, 426, 389,
-    382, 399, 364, 355, 369, 429, 428, 352, 434, 423, 405, 362, 433, 423, 421,
-    420, 402, 355, 341, 409, 423, 411, 420, 346, 341, 381, 350, 356, 348, 339,
-    424, 420, 339, 430, 405, 427, 437, 373, 354, 412, 405, 426, 439, 349, 410,
-    414, 364, 407, 410, 850, 378, 346, 369, 415, 430, 414, 382, 342, 432, 404,
-    419, 403, 826, 408, 435, 373, 412, 408, 426, 363, 399, 411, 403, 429, 344,
-    382, 394, 386, 343, 420, 361, 414, 1198, 403, 812, 425, 355, 342, 362, 375,
-    400, 366, 411, 431, 419, 420, 345, 418, 1188, 353, 420, 434, 362, 1097, 399,
-    1598, 422, 387, 367, 422, 390, 425, 411, 832, 416, 351, 421, 416, 841, 439,
-    353, 423, 391, 410, 406, 1232, 395, 419, 346, 426, 413, 557, 339, 430, 850,
-    408, 403, 423, 343, 1247, 372, 404, 356, 858, 344, 348, 766, 834, 335, 1148,
-    702, 407, 396, 436, 370, 378, 434, 416, 409, 388, 401, 397, 350, 419, 846,
-    375, 354, 415, 433, 762, 422, 362, 359, 383, 346, 340, 832, 415, 435, 360,
-    396, 435, 422, 409, 412, 429, 375, 385, 375, 407, 429, 416, 415, 424, 344,
-    421, 360, 403, 409, 405, 350, 393, 375, 368, 421, 351, 365, 419, 350, 416,
-    434, 350, 432, 400, 406, 410, 400, 388, 413, 362, 391, 347, 437, 373, 336,
-    398, 404, 353, 431, 412, 786, 420, 424, 403, 355, 417, 417, 347, 427, 390,
-    434, 363, 360, 410, 380, 408, 409, 379, 391, 405, 433, 407, 396, 358, 427,
-    419, 429, 396, 776, 421, 415, 349, 411, 435, 439, 357, 421, 409, 417, 431,
-    417, 340, 428, 379, 342, 437, 402, 352, 394, 724, 410, 379, 395, 414, 393,
-    417, 421, 341, 391, 348, 375, 426, 416, 344, 398, 413, 412, 426, 433, 340,
-    355, 361, 381, 374, 380, 349, 407, 391, 422, 420, 417, 392, 423, 415, 382,
-    334, 401, 428, 389, 390, 440, 423, 401, 437, 341, 379, 413, 343, 424, 406,
-    789, 352, 372, 401, 375, 368, 428, 401, 395, 440, 369, 439, 381, 431, 412,
-    350, 400, 415, 432, 387, 367, 426, 386, 402, 410, 407, 407, 356, 428
+    346, 411, 420, 382, 417, 433, 410, 431, 428, 375, 401, 415, 413, 382, 362, 380, 406, 353, 354, 389, 416, 425, 346,
+    432, 415, 393, 415, 367, 388, 401, 417, 376, 422, 375, 410, 392, 375, 418, 375, 352, 414, 764, 420, 776, 399, 418,
+    363, 335, 341, 386, 715, 426, 419, 417, 345, 409, 345, 428, 402, 393, 425, 426, 424, 379, 411, 426, 415, 445, 427,
+    398, 435, 405, 432, 427, 417, 420, 434, 397, 407, 339, 354, 416, 415, 364, 355, 398, 429, 361, 369, 407, 414, 342,
+    369, 429, 366, 440, 413, 363, 336, 375, 423, 409, 427, 769, 426, 352, 386, 353, 405, 435, 362, 375, 419, 388, 381,
+    376, 335, 382, 426, 389, 382, 399, 364, 355, 369, 429, 428, 352, 434, 423, 405, 362, 433, 423, 421, 420, 402, 355,
+    341, 409, 423, 411, 420, 346, 341, 381, 350, 356, 348, 339, 424, 420, 339, 430, 405, 427, 437, 373, 354, 412, 405,
+    426, 439, 349, 410, 414, 364, 407, 410, 850, 378, 346, 369, 415, 430, 414, 382, 342, 432, 404, 419, 403, 826, 408,
+    435, 373, 412, 408, 426, 363, 399, 411, 403, 429, 344, 382, 394, 386, 343, 420, 361, 414, 1198, 403, 812, 425, 355,
+    342, 362, 375, 400, 366, 411, 431, 419, 420, 345, 418, 1188, 353, 420, 434, 362, 1097, 399, 1598, 422, 387, 367,
+    422, 390, 425, 411, 832, 416, 351, 421, 416, 841, 439, 353, 423, 391, 410, 406, 1232, 395, 419, 346, 426, 413, 557,
+    339, 430, 850, 408, 403, 423, 343, 1247, 372, 404, 356, 858, 344, 348, 766, 834, 335, 1148, 702, 407, 396, 436, 370,
+    378, 434, 416, 409, 388, 401, 397, 350, 419, 846, 375, 354, 415, 433, 762, 422, 362, 359, 383, 346, 340, 832, 415,
+    435, 360, 396, 435, 422, 409, 412, 429, 375, 385, 375, 407, 429, 416, 415, 424, 344, 421, 360, 403, 409, 405, 350,
+    393, 375, 368, 421, 351, 365, 419, 350, 416, 434, 350, 432, 400, 406, 410, 400, 388, 413, 362, 391, 347, 437, 373,
+    336, 398, 404, 353, 431, 412, 786, 420, 424, 403, 355, 417, 417, 347, 427, 390, 434, 363, 360, 410, 380, 408, 409,
+    379, 391, 405, 433, 407, 396, 358, 427, 419, 429, 396, 776, 421, 415, 349, 411, 435, 439, 357, 421, 409, 417, 431,
+    417, 340, 428, 379, 342, 437, 402, 352, 394, 724, 410, 379, 395, 414, 393, 417, 421, 341, 391, 348, 375, 426, 416,
+    344, 398, 413, 412, 426, 433, 340, 355, 361, 381, 374, 380, 349, 407, 391, 422, 420, 417, 392, 423, 415, 382, 334,
+    401, 428, 389, 390, 440, 423, 401, 437, 341, 379, 413, 343, 424, 406, 789, 352, 372, 401, 375, 368, 428, 401, 395,
+    440, 369, 439, 381, 431, 412, 350, 400, 415, 432, 387, 367, 426, 386, 402, 410, 407, 407, 356, 428
   ],
   "percentileMs": {
     "50": 40.7,

bench/package.json

@@ -5,11 +5,15 @@
     "@babel/preset-react": "^7.16.7",
     "@swc/core": "^1.2.133",
     "benchmark": "^2.1.4",
+    "braces": "^3.0.2",
     "esbuild": "^0.14.12",
     "eventemitter3": "^5.0.0",
+    "execa": "^8.0.1",
     "fast-glob": "3.3.1",
     "fdir": "^6.1.0",
-    "mitata": "^0.1.6"
+    "mitata": "^0.1.6",
+    "string-width": "7.1.0",
+    "zx": "^7.2.3"
   },
   "scripts": {
     "ffi": "cd ffi && bun run deps && bun run build && bun run bench",
@@ -21,6 +25,5 @@
   },
   "devDependencies": {
     "fast-deep-equal": "^3.1.3"
-  },
-  "prettier": "../.prettierrc.cjs"
+  }
 }

bench/snippets/buffer-concat.mjs

@@ -0,0 +1,54 @@
+import { bench, run } from "./runner.mjs";
+
+for (let size of [32, 2048, 1024 * 16, 1024 * 1024 * 2, 1024 * 1024 * 16]) {
+  const first = Buffer.allocUnsafe(size);
+  const second = Buffer.allocUnsafe(size);
+  const third = Buffer.allocUnsafe(size);
+  first.fill(1);
+  second.fill(2);
+  third.fill(3);
+
+  const check = true;
+
+  const buffers = [first, second, third];
+
+  const fmt =
+    size > 1024 * 1024
+      ? new Intl.NumberFormat(undefined, { unit: "megabyte", style: "unit" })
+      : size > 1024
+        ? new Intl.NumberFormat(undefined, { unit: "kilobyte", style: "unit" })
+        : new Intl.NumberFormat(undefined, { unit: "byte", style: "unit" });
+
+  bench(
+    `Buffer.concat(${fmt.format(
+      Number((size > 1024 * 1024 ? size / 1024 / 1024 : size > 1024 ? size / 1024 : size).toFixed(2)),
+    )} x 3)`,
+    () => {
+      const result = Buffer.concat(buffers);
+      if (check) {
+        if (result.byteLength != size * 3) throw new Error("Wrong length");
+        if (result[0] != 1) throw new Error("Wrong first byte");
+        if (result[size] != 2) throw new Error("Wrong second byte");
+        if (result[size * 2] != 3) throw new Error("Wrong third byte");
+
+        result[0] = 10;
+        if (first[0] != 1) throw new Error("First buffer was modified");
+
+        result[size] = 20;
+        if (second[0] != 2) throw new Error("Second buffer was modified");
+
+        result[size * 2] = 30;
+        if (third[0] != 3) throw new Error("Third buffer was modified");
+      }
+    },
+  );
+}
+
+const chunk = Buffer.alloc(16);
+chunk.fill("3");
+const array = Array.from({ length: 100 }, () => chunk);
+bench("Buffer.concat 100 tiny chunks", () => {
+  return Buffer.concat(array);
+});
+
+await run();

bench/snippets/headers.mjs

@@ -1,9 +1,9 @@
 import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 
 // pure JS implementation will optimze this out
-// bench("new Headers", function () {
-//   return new Headers();
-// });
+bench("new Headers", function () {
+  return new Headers();
+});
 
 var big = new Headers({
   "Content-Type": "text/plain",
@@ -17,17 +17,128 @@ var big = new Headers({
   "X-Yet-Another-Custom-Headz": "Hello Worlda",
 });
 
-// bench("Header.get", function () {
-//   return big.get("Content-Type");
-// });
+bench("new Headers([])", () => {
+  return new Headers([]);
+});
 
-// bench("Header.set (standard)", function () {
-//   return big.set("Content-Type", "text/html");
-// });
+bench("new Headers({})", () => {
+  return new Headers({});
+});
 
-// bench("Header.set (non-standard)", function () {
-//   return big.set("X-My-Custom", "text/html123");
-// });
+bench("new Headers(object)", () => {
+  return new Headers({
+    "Content-Type": "text/plain",
+    "Content-Length": "123",
+    "User-Agent": "node-fetch/1.0",
+  });
+});
+
+bench("new Headers(hugeObject)", () => {
+  return new Headers({
+    "Accept": "123",
+    "Accept-Charset": "123",
+    "Accept-Language": "123",
+    "Accept-Encoding": "123",
+    "Accept-Ranges": "123",
+    "Access-Control-Allow-Credentials": "123",
+    "Access-Control-Allow-Headers": "123",
+    "Access-Control-Allow-Methods": "123",
+    "Access-Control-Allow-Origin": "123",
+    "Access-Control-Expose-Headers": "123",
+    "Access-Control-Max-Age": "123",
+    "Access-Control-Request-Headers": "123",
+    "Access-Control-Request-Method": "123",
+    "Age": "123",
+    "Authorization": "123",
+    "Cache-Control": "123",
+    "Connection": "123",
+    "Content-Disposition": "123",
+    "Content-Encoding": "123",
+    "Content-Language": "123",
+    "Content-Length": "123",
+    "Content-Location": "123",
+    "Content-Security-Policy": "123",
+    "Content-Security-Policy-Report-Only": "123",
+    "Content-Type": "123",
+    "Content-Range": "123",
+    "Cookie": "123",
+    "Cookie2": "123",
+    "Cross-Origin-Embedder-Policy": "123",
+    "Cross-Origin-Embedder-Policy-Report-Only": "123",
+    "Cross-Origin-Opener-Policy": "123",
+    "Cross-Origin-Opener-Policy-Report-Only": "123",
+    "Cross-Origin-Resource-Policy": "123",
+    "Date": "123",
+    "DNT": "123",
+    "Default-Style": "123",
+    "ETag": "123",
+    "Expect": "123",
+    "Expires": "123",
+    "Host": "123",
+    "If-Match": "123",
+    "If-Modified-Since": "123",
+    "If-None-Match": "123",
+    "If-Range": "123",
+    "If-Unmodified-Since": "123",
+    "Keep-Alive": "123",
+    "Last-Event-ID": "123",
+    "Last-Modified": "123",
+    "Link": "123",
+    "Location": "123",
+    "Origin": "123",
+    "Ping-From": "123",
+    "Ping-To": "123",
+    "Purpose": "123",
+    "Pragma": "123",
+    "Proxy-Authorization": "123",
+    "Range": "123",
+    "Referer": "123",
+    "Referrer-Policy": "123",
+    "Refresh": "123",
+    "Report-To": "123",
+    "Sec-Fetch-Dest": "123",
+    "Sec-Fetch-Mode": "123",
+    "Sec-WebSocket-Accept": "123",
+    "Sec-WebSocket-Extensions": "123",
+    "Sec-WebSocket-Key": "123",
+    "Sec-WebSocket-Protocol": "123",
+    "Sec-WebSocket-Version": "123",
+    "Server-Timing": "123",
+    "Service-Worker": "123",
+    "Service-Worker-Allowed": "123",
+    "Service-Worker-Navigation-Preload": "123",
+    "Set-Cookie": "123",
+    "Set-Cookie2": "123",
+    "SourceMap": "123",
+    "TE": "123",
+    "Timing-Allow-Origin": "123",
+    "Trailer": "123",
+    "Transfer-Encoding": "123",
+    "Upgrade": "123",
+    "Upgrade-Insecure-Requests": "123",
+    "User-Agent": "123",
+    "Vary": "123",
+    "Via": "123",
+    "X-Content-Type-Options": "123",
+    "X-DNS-Prefetch-Control": "123",
+    "X-Frame-Options": "123",
+    "X-SourceMap": "123",
+    "X-XSS-Protection": "123",
+    "X-Temp-Tablet": "123",
+  });
+});
+
+bench("Header.get", function () {
+  return big.get("Content-Type");
+});
+
+bench("Header.set (standard)", function () {
+  return big.set("Content-Type", "text/html");
+});
+
+bench("Header.set (non-standard)", function () {
+  return big.set("X-My-Custom", "text/html123");
+});
 
 if (big.toJSON)
   bench("Headers.toJSON", function () {
@@ -42,4 +153,4 @@ bench("Object.fromEntries(headers)", function () {
   return Object.fromEntries(big);
 });
 
-run();
+await run();

bench/snippets/native-overhead.mjs

@@ -5,6 +5,11 @@ 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/snippets/shell-spawn.mjs

@@ -0,0 +1,37 @@
+import { $ as zx } from "zx";
+import { $ as execa$ } from "execa";
+import { bench, run, group } from "./runner.mjs";
+
+const execa = execa$({ stdio: "ignore", cwd: import.meta.dirname });
+
+group("echo hi", () => {
+  if (typeof Bun !== "undefined")
+    bench("$`echo hi`", async () => {
+      await Bun.$`echo hi`.quiet();
+    });
+
+  bench("execa`echo hi`", async () => {
+    await execa`echo hi`;
+  });
+
+  bench("zx`echo hi`", async () => {
+    await zx`echo hi`.quiet();
+  });
+});
+
+group("ls .", () => {
+  if (typeof Bun !== "undefined")
+    bench("$`ls .`", async () => {
+      await Bun.$`ls .`.quiet();
+    });
+
+  bench("execa`ls .`", async () => {
+    await execa`ls .`;
+  });
+
+  bench("zx`ls .`", async () => {
+    await zx`ls .`.quiet();
+  });
+});
+
+await run();

bench/snippets/string-width.mjs

@@ -0,0 +1,41 @@
+import { bench, run } from "./runner.mjs";
+import npmStringWidth from "string-width";
+
+const bunStringWidth = globalThis?.Bun?.stringWidth;
+
+const stringWidth = bunStringWidth || npmStringWidth;
+const formatter = new Intl.NumberFormat();
+const format = n => {
+  return formatter.format(n);
+};
+
+const inputs = [
+  ["hello", "ascii"],
+  ["[31mhello", "ascii+ansi"],
+  ["hello😀", "ascii+emoji"],
+  ["[31m😀😀", "ansi+emoji"],
+  ["😀hello😀[31m😀😀😀", "ansi+emoji+ascii"],
+];
+
+const repeatCounts = [1, 10, 100, 1000, 5000];
+
+const maxInputLength = Math.max(...inputs.map(([input]) => input.repeat(Math.max(...repeatCounts)).length));
+
+for (const [input, textLabel] of inputs) {
+  for (let repeatCount of repeatCounts) {
+    const label = bunStringWidth ? "Bun.stringWidth" : "npm/string-width";
+
+    const str = input.repeat(repeatCount);
+    const name = `${label} ${format(str.length).padStart(format(maxInputLength).length, " ")} chars ${textLabel}`;
+
+    bench(name, () => {
+      stringWidth(str);
+    });
+
+    if (bunStringWidth && bunStringWidth(str) !== npmStringWidth(str)) {
+      throw new Error("string-width mismatch");
+    }
+  }
+}
+
+await run();

bench/snippets/urlsearchparams.mjs

@@ -0,0 +1,113 @@
+import { bench, run } from "./runner.mjs";
+
+// bench("new URLSearchParams({})", () => {
+//   return new URLSearchParams({});
+// });
+
+bench("new URLSearchParams(obj)", () => {
+  return new URLSearchParams({
+    "Content-Type": "text/plain",
+    "Content-Length": "123",
+    "User-Agent": "node-fetch/1.0",
+    "Accept-Encoding": "gzip,deflate",
+    "Content-Length": "0",
+    "Content-Range": "bytes 0-9/10",
+  });
+});
+
+bench("new URLSearchParams(absurdlyHugeObject)", () => {
+  return new URLSearchParams({
+    "Accept": "123",
+    "Accept-Charset": "123",
+    "Accept-Language": "123",
+    "Accept-Encoding": "123",
+    "Accept-Ranges": "123",
+    "Access-Control-Allow-Credentials": "123",
+    "Access-Control-Allow-Headers": "123",
+    "Access-Control-Allow-Methods": "123",
+    "Access-Control-Allow-Origin": "123",
+    "Access-Control-Expose-Headers": "123",
+    "Access-Control-Max-Age": "123",
+    "Access-Control-Request-Headers": "123",
+    "Access-Control-Request-Method": "123",
+    "Age": "123",
+    "Authorization": "123",
+    "Cache-Control": "123",
+    "Connection": "123",
+    "Content-Disposition": "123",
+    "Content-Encoding": "123",
+    "Content-Language": "123",
+    "Content-Length": "123",
+    "Content-Location": "123",
+    "Content-Security-Policy": "123",
+    "Content-Security-Policy-Report-Only": "123",
+    "Content-Type": "123",
+    "Content-Range": "123",
+    "Cookie": "123",
+    "Cookie2": "123",
+    "Cross-Origin-Embedder-Policy": "123",
+    "Cross-Origin-Embedder-Policy-Report-Only": "123",
+    "Cross-Origin-Opener-Policy": "123",
+    "Cross-Origin-Opener-Policy-Report-Only": "123",
+    "Cross-Origin-Resource-Policy": "123",
+    "Date": "123",
+    "DNT": "123",
+    "Default-Style": "123",
+    "ETag": "123",
+    "Expect": "123",
+    "Expires": "123",
+    "Host": "123",
+    "If-Match": "123",
+    "If-Modified-Since": "123",
+    "If-None-Match": "123",
+    "If-Range": "123",
+    "If-Unmodified-Since": "123",
+    "Keep-Alive": "123",
+    "Last-Event-ID": "123",
+    "Last-Modified": "123",
+    "Link": "123",
+    "Location": "123",
+    "Origin": "123",
+    "Ping-From": "123",
+    "Ping-To": "123",
+    "Purpose": "123",
+    "Pragma": "123",
+    "Proxy-Authorization": "123",
+    "Range": "123",
+    "Referer": "123",
+    "Referrer-Policy": "123",
+    "Refresh": "123",
+    "Report-To": "123",
+    "Sec-Fetch-Dest": "123",
+    "Sec-Fetch-Mode": "123",
+    "Sec-WebSocket-Accept": "123",
+    "Sec-WebSocket-Extensions": "123",
+    "Sec-WebSocket-Key": "123",
+    "Sec-WebSocket-Protocol": "123",
+    "Sec-WebSocket-Version": "123",
+    "Server-Timing": "123",
+    "Service-Worker": "123",
+    "Service-Worker-Allowed": "123",
+    "Service-Worker-Navigation-Preload": "123",
+    "Set-Cookie": "123",
+    "Set-Cookie2": "123",
+    "SourceMap": "123",
+    "TE": "123",
+    "Timing-Allow-Origin": "123",
+    "Trailer": "123",
+    "Transfer-Encoding": "123",
+    "Upgrade": "123",
+    "Upgrade-Insecure-Requests": "123",
+    "User-Agent": "123",
+    "Vary": "123",
+    "Via": "123",
+    "X-Content-Type-Options": "123",
+    "X-DNS-Prefetch-Control": "123",
+    "X-Frame-Options": "123",
+    "X-SourceMap": "123",
+    "X-XSS-Protection": "123",
+    "X-Temp-Tablet": "123",
+  });
+});
+
+await run();

build.zig

@@ -73,11 +73,13 @@ const BunBuildOptions = struct {
     bindgen: bool = false,
     sizegen: bool = false,
     base_path: [:0]const u8 = "",
+    tracy_callstack_depth: u16,
 
     runtime_js_version: u64 = 0,
     fallback_html_version: u64 = 0,
 
     tinycc: bool = true,
+    project: [:0]const u8 = "",
 
     pub fn updateRuntime(this: *BunBuildOptions) anyerror!void {
         if (std.fs.cwd().openFile("src/runtime.out.js", .{ .mode = .read_only })) |file| {
@@ -191,16 +193,30 @@ pub fn build_(b: *Build) !void {
     const bin_label = if (optimize == std.builtin.OptimizeMode.Debug) "packages/debug-bun-" else "packages/bun-";
 
     var triplet_buf: [64]u8 = undefined;
-    var os_tagname = @tagName(target.getOs().tag);
 
     const arch: std.Target.Cpu.Arch = target.getCpuArch();
 
-    if (std.mem.eql(u8, os_tagname, "macos")) {
-        os_tagname = "darwin";
-        target.os_version_min = std.zig.CrossTarget.OsVersion{ .semver = .{ .major = 11, .minor = 0, .patch = 0 } };
-    } else if (target.isLinux()) {
-        target.setGnuLibCVersion(2, 27, 0);
+    var os_tagname = @tagName(target.getOs().tag);
+
+    switch (target.getOs().tag) {
+        .macos => {
+            os_tagname = "darwin";
+            target.os_version_min = std.zig.CrossTarget.OsVersion{ .semver = .{ .major = 11, .minor = 0, .patch = 0 } };
+        },
+        .windows => {
+            target.os_version_min = std.zig.CrossTarget.OsVersion{
+                // Windows 1809
+                // Minimum version for a syscall related to bun.sys.renameat
+                // if you update this please update install.ps1
+                .windows = .win10_rs5,
+            };
+        },
+        .linux => {
+            target.setGnuLibCVersion(2, 27, 0);
+        },
+        else => {},
     }
+
     @memcpy(triplet_buf[0..].ptr, os_tagname);
     const osname = triplet_buf[0..os_tagname.len];
     triplet_buf[osname.len] = '-';
@@ -312,6 +328,7 @@ pub fn build_(b: *Build) !void {
             .baseline = is_baseline,
             .bindgen = false,
             .base_path = try b.allocator.dupeZ(u8, b.pathFromRoot(".")),
+            .tracy_callstack_depth = b.option(u16, "tracy_callstack_depth", "") orelse 10,
         };
     };
 
@@ -328,10 +345,12 @@ pub fn build_(b: *Build) !void {
             obj.target.cpu_model = .{ .explicit = &std.Target.x86.cpu.x86_64_v2 };
         } else if (arch.isX86()) {
             obj.target.cpu_model = .{ .explicit = &std.Target.x86.cpu.haswell };
-        } else if (arch.isAARCH64() and target.isDarwin()) {
-            obj.target.cpu_model = .{ .explicit = &std.Target.aarch64.cpu.apple_m1 };
-        } else if (arch.isAARCH64() and target.isLinux()) {
-            obj.target.cpu_model = .{ .explicit = &std.Target.aarch64.cpu.generic };
+        } else if (arch.isAARCH64()) {
+            if (target.isDarwin()) {
+                obj.target.cpu_model = .{ .explicit = &std.Target.aarch64.cpu.apple_m1 };
+            } else {
+                obj.target.cpu_model = .{ .explicit = &std.Target.aarch64.cpu.generic };
+            }
         }
 
         try default_build_options.updateRuntime();
@@ -360,6 +379,7 @@ pub fn build_(b: *Build) !void {
             actual_build_options.sizegen = true;
         }
 
+        actual_build_options.project = "bun";
         obj.addOptions("build_options", actual_build_options.step(b));
 
         // Generated Code
@@ -571,6 +591,7 @@ pub fn build_(b: *Build) !void {
         \\For more info, see https://bun.sh/docs/project/contributing
         \\
     });
+
     b.default_step.dependOn(&mistake_message.step);
 }
 

bunfig.toml

@@ -6,3 +6,4 @@
 #
 # Instead, we can only scan the test directory for Bun's runtime tests
 root = "test"
+preload = "./test/preload.ts"

dockerhub/alpine/Dockerfile

@@ -96,18 +96,16 @@ FROM alpine:3.18
 ARG BUN_RUNTIME_TRANSPILER_CACHE_PATH=0
 ENV BUN_RUNTIME_TRANSPILER_CACHE_PATH=${BUN_RUNTIME_TRANSPILER_CACHE_PATH}
 
-COPY --from=build /tmp/glibc.apk /tmp/
-COPY --from=build /tmp/glibc-bin.apk /tmp/
 COPY --from=build /usr/local/bin/bun /usr/local/bin/
 COPY docker-entrypoint.sh /usr/local/bin/
 
-RUN addgroup -g 1000 bun \
+# Temporarily use the `build`-stage /tmp folder to access the glibc APKs:
+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 \
-    && rm /tmp/glibc.apk \
-    && rm /tmp/glibc-bin.apk \
     && ln -s /usr/local/bin/bun /usr/local/bin/bunx \
     && which bun \
     && which bunx \

docs/api/binary-data.md

@@ -65,19 +65,19 @@ Below we create a new `DataView` and set the first byte to 5.
 
 ```ts
 const buf = new ArrayBuffer(4);
-// [0x0, 0x0, 0x0, 0x0]
+// [0b00000000, 0b00000000, 0b00000000, 0b00000000]
 
 const dv = new DataView(buf);
 dv.setUint8(0, 3); // write value 3 at byte offset 0
 dv.getUint8(0); // => 3
-// [0x11, 0x0, 0x0, 0x0]
+// [0b00000011, 0b00000000, 0b00000000, 0b00000000]
 ```
 
 Now let's write a `Uint16` at byte offset `1`. This requires two bytes. We're using the value `513`, which is `2 * 256 + 1`; in bytes, that's `00000010 00000001`.
 
 ```ts
 dv.setUint16(1, 513);
-// [0x11, 0x10, 0x1, 0x0]
+// [0b00000011, 0b00000010, 0b00000001, 0b00000000]
 
 console.log(dv.getUint16(1)); // => 513
 ```

docs/api/file-io.md

@@ -249,6 +249,42 @@ writer.unref();
 writer.ref();
 ```
 
+## Directories
+
+Bun's implementation of `node:fs` is fast, and we haven't implemented a Bun-specific API for reading directories just yet. For now, you should use `node:fs` for working with directories in Bun.
+
+### Reading directories (readdir)
+
+To read a directory in Bun, use `readdir` from `node:fs`.
+
+```ts
+import { readdir } from "node:fs/promises";
+
+// read all the files in the current directory
+const files = await readdir(import.meta.dir);
+```
+
+#### Reading directories recursively
+
+To recursively read a directory in Bun, use `readdir` with `recursive: true`.
+
+```ts
+import { readdir } from "node:fs/promises";
+
+// read all the files in the current directory, recursively
+const files = await readdir("../", { recursive: true });
+```
+
+### Creating directories (mkdir)
+
+To recursively create a directory, use `mkdir` in `node:fs`:
+
+```ts
+import { mkdir } from "node:fs/promises";
+
+await mkdir("path/to/dir", { recursive: true });
+```
+
 ## Benchmarks
 
 The following is a 3-line implementation of the Linux `cat` command.

docs/api/file-system-router.md

@@ -46,7 +46,7 @@ router.match("/settings?foo=bar");
   kind: "dynamic",
   name: "/settings",
   pathname: "/settings?foo=bar",
-  src: "https://mydomain.com/_next/static/pages/settings.tsx"
+  src: "https://mydomain.com/_next/static/pages/settings.tsx",
   query: {
     foo: "bar"
   }
@@ -64,7 +64,7 @@ router.match("/blog/my-cool-post");
   kind: "dynamic",
   name: "/blog/[slug]",
   pathname: "/blog/my-cool-post",
-  src: "https://mydomain.com/_next/static/pages/blog/[slug].tsx"
+  src: "https://mydomain.com/_next/static/pages/blog/[slug].tsx",
   params: {
     slug: "my-cool-post"
   }

docs/api/glob.md

@@ -7,7 +7,7 @@ Bun includes a fast native implementation of file globbing.
 ```ts
 import { Glob } from "bun";
 
-const glob = new Glob("*.ts");
+const glob = new Glob("**/*.ts");
 
 // Scans the current working directory and each of its sub-directories recursively
 for await (const file of glob.scan(".")) {

docs/api/import-meta.md

@@ -23,6 +23,11 @@ import.meta.resolveSync("zod")
 
 ---
 
+- `import.meta.dirname`
+- An alias to `import.meta.dir`, for Node.js compatibility
+
+---
+
 - `import.meta.file`
 - The name of the current file, e.g. `index.tsx`
 
@@ -33,6 +38,16 @@ import.meta.resolveSync("zod")
 
 ---
 
+- `import.meta.filename`
+- An alias to `import.meta.path`, for Node.js compatibility
+
+---
+
+- `import.meta.url`
+- A string url to the current file, e.g. `file:///path/to/project/index.tx`
+
+---
+
 - `import.meta.main`
 - `boolean` Indicates whether the current file is the entrypoint to the current `bun` process. Is the file being directly executed by `bun run` or is it being imported?
 

docs/api/sqlite.md

@@ -57,6 +57,23 @@ import { Database } from "bun:sqlite";
 const db = new Database("mydb.sqlite", { create: true });
 ```
 
+### Load via ES module import
+
+You can also use an import attribute to load a database.
+
+```ts
+import db from "./mydb.sqlite" with {"type": "sqlite"};
+
+console.log(db.query("select * from users LIMIT 1").get());
+```
+
+This is equivalent to the following:
+
+```ts
+import { Database } from "bun:sqlite";
+const db = new Database("./mydb.sqlite");
+```
+
 ### `.close()`
 
 To close a database:

docs/api/streams.md

@@ -56,6 +56,45 @@ const stream = new ReadableStream({
 
 When using a direct `ReadableStream`, all chunk queueing is handled by the destination. The consumer of the stream receives exactly what is passed to `controller.write()`, without any encoding or modification.
 
+## Async generator streams
+
+Bun also supports async generator functions as a source for `Response` and `Request`. This is an easy way to create a `ReadableStream` that fetches data from an asynchronous source.
+
+```ts
+const response = new Response(async function* () {
+  yield "hello";
+  yield "world";
+}());
+
+await response.text(); // "helloworld"
+```
+
+You can also use `[Symbol.asyncIterator]` directly.
+
+```ts
+const response = new Response({
+  [Symbol.asyncIterator]: async function* () {
+    yield "hello";
+    yield "world";
+  },
+});
+
+await response.text(); // "helloworld"
+```
+
+If you need more granular control over the stream, `yield` will return the direct ReadableStream controller.
+
+```ts
+const response = new Response({
+  [Symbol.asyncIterator]: async function* () {
+    const controller = yield "hello";
+    await controller.end();
+  },
+});
+
+await response.text(); // "hello"
+```
+
 ## `Bun.ArrayBufferSink`
 
 The `Bun.ArrayBufferSink` class is a fast incremental writer for constructing an `ArrayBuffer` of unknown size.

docs/api/transpiler.md

@@ -50,7 +50,7 @@ export default jsx(
 To override the default loader specified in the `new Bun.Transpiler()` constructor, pass a second argument to `.transformSync()`.
 
 ```ts
-await transpiler.transform("<div>hi!</div>", "tsx");
+transpiler.transformSync("<div>hi!</div>", "tsx");
 ```
 
 {% details summary="Nitty gritty" %}

docs/api/utils.md

@@ -261,6 +261,146 @@ This function is optimized for large input. On an M1X, it processes 480 MB/s -
 20 GB/s, depending on how much data is being escaped and whether there is non-ascii
 text. Non-string types will be converted to a string before escaping.
 
+## `Bun.stringWidth()` ~6,756x faster `string-width` alternative
+
+Get the column count of a string as it would be displayed in a terminal.
+Supports ANSI escape codes, emoji, and wide characters.
+
+Example usage:
+
+```ts
+Bun.stringWidth("hello"); // => 5
+Bun.stringWidth("\u001b[31mhello\u001b[0m"); // => 5
+Bun.stringWidth("\u001b[31mhello\u001b[0m", { countAnsiEscapeCodes: true }); // => 12
+```
+
+This is useful for:
+- Aligning text in a terminal
+- Quickly checking if a string contains ANSI escape codes
+- Measuring the width of a string in a terminal
+
+This API is designed to match the popular "string-width" package, so that
+existing code can be easily ported to Bun and vice versa.
+
+[In this benchmark](https://github.com/oven-sh/bun/blob/5147c0ba7379d85d4d1ed0714b84d6544af917eb/bench/snippets/string-width.mjs#L13), `Bun.stringWidth` is a ~6,756x faster than the `string-width` npm package for input larger than about 500 characters. Big thanks to [sindresorhus](https://github.com/sindresorhus) for their work on `string-width`!
+
+```ts
+❯ bun string-width.mjs
+cpu: 13th Gen Intel(R) Core(TM) i9-13900
+runtime: bun 1.0.29 (x64-linux)
+
+benchmark                                          time (avg)             (min … max)       p75       p99      p995
+------------------------------------------------------------------------------------- -----------------------------
+Bun.stringWidth     500 chars ascii              37.09 ns/iter   (36.77 ns … 41.11 ns)  37.07 ns  38.84 ns  38.99 ns
+
+❯ node string-width.mjs
+
+benchmark                                          time (avg)             (min … max)       p75       p99      p995
+------------------------------------------------------------------------------------- -----------------------------
+npm/string-width    500 chars ascii             249,710 ns/iter (239,970 ns … 293,180 ns) 250,930 ns  276,700 ns 281,450 ns
+```
+
+To make `Bun.stringWidth` fast, we've implemented it in Zig using optimized SIMD instructions, accounting for Latin1, UTF-16, and UTF-8 encodings. It passes `string-width`'s tests.
+
+{% details summary="View full benchmark" %}
+
+As a reminder, 1 nanosecond (ns) is 1 billionth of a second. Here's a quick reference for converting between units:
+
+| Unit | 1 Millisecond |
+| ---- | ------------- |
+| ns   | 1,000,000     |
+| µs   | 1,000         |
+| ms   | 1             |
+
+```js
+❯ bun string-width.mjs
+cpu: 13th Gen Intel(R) Core(TM) i9-13900
+runtime: bun 1.0.29 (x64-linux)
+
+benchmark                                          time (avg)             (min … max)       p75       p99      p995
+------------------------------------------------------------------------------------- -----------------------------
+Bun.stringWidth      5 chars ascii              16.45 ns/iter   (16.27 ns … 19.71 ns)  16.48 ns  16.93 ns  17.21 ns
+Bun.stringWidth     50 chars ascii              19.42 ns/iter   (18.61 ns … 27.85 ns)  19.35 ns   21.7 ns  22.31 ns
+Bun.stringWidth    500 chars ascii              37.09 ns/iter   (36.77 ns … 41.11 ns)  37.07 ns  38.84 ns  38.99 ns
+Bun.stringWidth  5,000 chars ascii              216.9 ns/iter  (215.8 ns … 228.54 ns) 216.23 ns 228.52 ns 228.53 ns
+Bun.stringWidth 25,000 chars ascii               1.01 µs/iter     (1.01 µs … 1.01 µs)   1.01 µs   1.01 µs   1.01 µs
+Bun.stringWidth      7 chars ascii+emoji         54.2 ns/iter   (53.36 ns … 58.19 ns)  54.23 ns  57.55 ns  57.94 ns
+Bun.stringWidth     70 chars ascii+emoji       354.26 ns/iter (350.51 ns … 363.96 ns) 355.93 ns 363.11 ns 363.96 ns
+Bun.stringWidth    700 chars ascii+emoji          3.3 µs/iter      (3.27 µs … 3.4 µs)    3.3 µs    3.4 µs    3.4 µs
+Bun.stringWidth  7,000 chars ascii+emoji        32.69 µs/iter   (32.22 µs … 45.27 µs)   32.7 µs  34.57 µs  34.68 µs
+Bun.stringWidth 35,000 chars ascii+emoji       163.35 µs/iter (161.17 µs … 170.79 µs) 163.82 µs 169.66 µs 169.93 µs
+Bun.stringWidth      8 chars ansi+emoji         66.15 ns/iter   (65.17 ns … 69.97 ns)  66.12 ns   69.8 ns  69.87 ns
+Bun.stringWidth     80 chars ansi+emoji        492.95 ns/iter  (488.05 ns … 499.5 ns)  494.8 ns 498.58 ns  499.5 ns
+Bun.stringWidth    800 chars ansi+emoji          4.73 µs/iter     (4.71 µs … 4.88 µs)   4.72 µs   4.88 µs   4.88 µs
+Bun.stringWidth  8,000 chars ansi+emoji         47.02 µs/iter   (46.37 µs … 67.44 µs)  46.96 µs  49.57 µs  49.63 µs
+Bun.stringWidth 40,000 chars ansi+emoji        234.45 µs/iter (231.78 µs … 240.98 µs) 234.92 µs 236.34 µs 236.62 µs
+Bun.stringWidth     19 chars ansi+emoji+ascii  135.46 ns/iter (133.67 ns … 143.26 ns) 135.32 ns 142.55 ns 142.77 ns
+Bun.stringWidth    190 chars ansi+emoji+ascii    1.17 µs/iter     (1.16 µs … 1.17 µs)   1.17 µs   1.17 µs   1.17 µs
+Bun.stringWidth  1,900 chars ansi+emoji+ascii   11.45 µs/iter   (11.26 µs … 20.41 µs)  11.45 µs  12.08 µs  12.11 µs
+Bun.stringWidth 19,000 chars ansi+emoji+ascii  114.06 µs/iter (112.86 µs … 120.06 µs) 114.25 µs 115.86 µs 116.15 µs
+Bun.stringWidth 95,000 chars ansi+emoji+ascii  572.69 µs/iter (565.52 µs … 607.22 µs) 572.45 µs 604.86 µs 605.21 µs
+```
+
+```ts
+❯ node string-width.mjs
+cpu: 13th Gen Intel(R) Core(TM) i9-13900
+runtime: node v21.4.0 (x64-linux)
+
+benchmark                                           time (avg)             (min … max)       p75       p99      p995
+-------------------------------------------------------------------------------------- -----------------------------
+npm/string-width      5 chars ascii               3.19 µs/iter     (3.13 µs … 3.48 µs)   3.25 µs   3.48 µs   3.48 µs
+npm/string-width     50 chars ascii              20.09 µs/iter  (18.93 µs … 435.06 µs)  19.49 µs  21.89 µs  22.59 µs
+npm/string-width    500 chars ascii             249.71 µs/iter (239.97 µs … 293.18 µs) 250.93 µs  276.7 µs 281.45 µs
+npm/string-width  5,000 chars ascii               6.69 ms/iter     (6.58 ms … 6.76 ms)   6.72 ms   6.76 ms   6.76 ms
+npm/string-width 25,000 chars ascii             139.57 ms/iter (137.17 ms … 143.28 ms) 140.49 ms 143.28 ms 143.28 ms
+npm/string-width      7 chars ascii+emoji          3.7 µs/iter     (3.62 µs … 3.94 µs)   3.73 µs   3.94 µs   3.94 µs
+npm/string-width     70 chars ascii+emoji        23.93 µs/iter   (22.44 µs … 331.2 µs)  23.15 µs  25.98 µs   30.2 µs
+npm/string-width    700 chars ascii+emoji       251.65 µs/iter (237.78 µs … 444.69 µs) 252.92 µs 325.89 µs 354.08 µs
+npm/string-width  7,000 chars ascii+emoji         4.95 ms/iter     (4.82 ms … 5.19 ms)      5 ms   5.04 ms   5.19 ms
+npm/string-width 35,000 chars ascii+emoji        96.93 ms/iter  (94.39 ms … 102.58 ms)  97.68 ms 102.58 ms 102.58 ms
+npm/string-width      8 chars ansi+emoji          3.92 µs/iter     (3.45 µs … 4.57 µs)   4.09 µs   4.57 µs   4.57 µs
+npm/string-width     80 chars ansi+emoji         24.46 µs/iter     (22.87 µs … 4.2 ms)  23.54 µs  25.89 µs  27.41 µs
+npm/string-width    800 chars ansi+emoji        259.62 µs/iter (246.76 µs … 480.12 µs) 258.65 µs 349.84 µs 372.55 µs
+npm/string-width  8,000 chars ansi+emoji          5.46 ms/iter     (5.41 ms … 5.57 ms)   5.48 ms   5.55 ms   5.57 ms
+npm/string-width 40,000 chars ansi+emoji        108.91 ms/iter  (107.55 ms … 109.5 ms) 109.25 ms  109.5 ms  109.5 ms
+npm/string-width     19 chars ansi+emoji+ascii    6.53 µs/iter     (6.35 µs … 6.75 µs)   6.54 µs   6.75 µs   6.75 µs
+npm/string-width    190 chars ansi+emoji+ascii   55.52 µs/iter  (52.59 µs … 352.73 µs)  54.19 µs  80.77 µs 167.21 µs
+npm/string-width  1,900 chars ansi+emoji+ascii  701.71 µs/iter (653.94 µs … 893.78 µs)  715.3 µs 855.37 µs  872.9 µs
+npm/string-width 19,000 chars ansi+emoji+ascii   27.19 ms/iter   (26.89 ms … 27.41 ms)  27.28 ms  27.41 ms  27.41 ms
+npm/string-width 95,000 chars ansi+emoji+ascii     3.68 s/iter        (3.66 s … 3.7 s)    3.69 s     3.7 s     3.7 s
+```
+
+{% /details %}
+
+
+TypeScript definition:
+
+```ts
+namespace Bun {
+  export function stringWidth(
+    /**
+     * The string to measure
+     */
+    input: string,
+    options?: {
+      /**
+       * If `true`, count ANSI escape codes as part of the string width. If `false`, ANSI escape codes are ignored when calculating the string width.
+       *
+       * @default false
+       */
+      countAnsiEscapeCodes?: boolean;
+      /**
+       * When it's ambiugous and `true`, count emoji as 1 characters wide. If `false`, emoji are counted as 2 character wide.
+       *
+       * @default true
+       */
+      ambiguousIsNarrow?: boolean;
+    },
+  ): number;
+}
+```
+
+
 <!-- ## `Bun.enableANSIColors()` -->
 
 ## `Bun.fileURLToPath()`

docs/api/websockets.md

@@ -182,12 +182,12 @@ const server = Bun.serve<{ username: string }>({
     open(ws) {
       const msg = `${ws.data.username} has entered the chat`;
       ws.subscribe("the-group-chat");
-      ws.publish("the-group-chat", msg);
+      server.publish("the-group-chat", msg);
     },
     message(ws, message) {
       // this is a group chat
       // so the server re-broadcasts incoming message to everyone
-      ws.publish("the-group-chat", `${ws.data.username}: ${message}`);
+      server.publish("the-group-chat", `${ws.data.username}: ${message}`);
     },
     close(ws) {
       const msg = `${ws.data.username} has left the chat`;
@@ -245,6 +245,34 @@ The `.send(message)` method of `ServerWebSocket` returns a `number` indicating t
 
 This gives you better control over backpressure in your server.
 
+### Timeouts and limits
+
+By default, Bun will close a WebSocket connection if it is idle for 120 seconds. This can be configured with the `idleTimeout` parameter.
+
+```ts
+Bun.serve({
+  fetch(req, server) {}, // upgrade logic
+  websocket: {
+    idleTimeout: 60, // 60 seconds
+
+    // ...
+  },
+});
+```
+
+Bun will also close a WebSocket connection if it receives a message that is larger than 16 MB. This can be configured with the `maxPayloadLength` parameter.
+
+```ts
+Bun.serve({
+  fetch(req, server) {}, // upgrade logic
+  websocket: {
+    maxPayloadLength: 1024 * 1024, // 1 MB
+
+    // ...
+  },
+});
+```
+
 ## Connect to a `Websocket` server
 
 Bun implements the `WebSocket` class. To create a WebSocket client that connects to a `ws://` or `wss://` server, create an instance of `WebSocket`, as you would in the browser.
@@ -296,6 +324,14 @@ namespace Bun {
       close?: (ws: ServerWebSocket) => void;
       error?: (ws: ServerWebSocket, error: Error) => void;
       drain?: (ws: ServerWebSocket) => void;
+
+      maxPayloadLength?: number; // default: 16 * 1024 * 1024 = 16 MB
+      idleTimeout?: number; // default: 120 (seconds)
+      backpressureLimit?: number; // default: 1024 * 1024 = 1 MB
+      closeOnBackpressureLimit?: boolean; // default: false
+      sendPings?: boolean; // default: true
+      publishToSelf?: boolean; // default: false
+
       perMessageDeflate?:
         | boolean
         | {

docs/bundler/executables.md

@@ -32,6 +32,45 @@ All imported files and packages are bundled into the executable, along with a co
 
 {% /callout %}
 
+## Deploying to production
+
+Compiled executables reduce memory usage and improve Bun's start time.
+
+Normally, Bun reads and transpiles JavaScript and TypeScript files on `import` and `require`. This is part of what makes so much of Bun "just work", but it's not free. It costs time and memory to read files from disk, resolve file paths, parse, transpile, and print source code. 
+
+With compiled executables, you can move that cost from runtime to build-time.
+
+When deploying to production, we recommend the following:
+
+```sh
+bun build --compile --minify --sourcemap ./path/to/my/app.ts --outfile myapp
+```
+
+**What do these flags do?**
+
+The `--minify` argument optimizes the size of the transpiled output code. If you have a large application, this can save megabytes of space. For smaller applications, it might still improve start time a little.
+
+The `--sourcemap` argument embeds a sourcemap compressed with zstd, so that errors & stacktraces point to their original locations instead of the transpiled location. Bun will automatically decompress & resolve the sourcemap when an error occurs.
+
+## SQLite
+
+You can use `bun:sqlite` imports with `bun build --compile`.
+
+By default, the database is resolved relative to the current working directory of the process.
+
+```js
+import db from './my.db' with {type: "sqlite"};
+
+console.log(db.query("select * from users LIMIT 1").get());
+```
+
+That means if the executable is located at `/usr/bin/hello`, the user's terminal is located at `/home/me/Desktop`, it will look for `/home/me/Desktop/my.db`.
+
+```
+$ cd /home/me/Desktop
+$ ./hello
+```
+
 ## Embedding files
 
 Standalone executables support embedding files.
@@ -55,6 +94,30 @@ You may need to specify a `--loader` for it to be treated as a `"file"` loader (
 
 Embedded files can be read using `Bun.file`'s functions or the Node.js `fs.readFile` function (in `"node:fs"`).
 
+### Embedding SQLite databases
+
+If your application wants to embed a SQLite database, set `type: "sqlite"` in the import attribute and the `embed` attribute to `"true"`.
+
+```js
+import myEmbeddedDb from "./my.db" with {type: "sqlite", embed: "true"};
+
+console.log(myEmbeddedDb.query("select * from users LIMIT 1").get());
+```
+
+This database is read-write, but all changes are lost when the executable exits (since it's stored in memory).
+
+### Embedding N-API Addons
+
+As of Bun v1.0.23, you can embed `.node` files into executables.
+
+```js
+const addon = require("./addon.node");
+
+console.log(addon.hello());
+```
+
+Unfortunately, if you're using `@mapbox/node-pre-gyp` or other similar tools, you'll need to make sure the `.node` file is directly required or it won't bundle correctly.
+
 ## Minification
 
 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.

docs/bundler/index.md

@@ -43,7 +43,7 @@ Let's build our first bundle. You have the following two files, which implement
 import * as ReactDOM from 'react-dom/client';
 import {Component} from "./Component"
 
-const root = ReactDOM.createRoot(document.getElementById('root'));
+const root = ReactDOM.createRoot(document.getElementById('root')!);
 root.render(<Component message="Sup!" />)
 ```
 
@@ -155,7 +155,7 @@ Like the Bun runtime, the bundler supports an array of file types out of the box
 
 ---
 
-- `.js` `.cjs` `.mjs` `.mts` `.cts` `.ts` `.tsx`
+- `.js` `.jsx`, `.cjs` `.mjs` `.mts` `.cts` `.ts` `.tsx`
 - Uses Bun's built-in transpiler to parse the file and transpile TypeScript/JSX syntax to vanilla JavaScript. The bundler executes a set of default transforms, including dead code elimination, tree shaking, and environment variable inlining. At the moment Bun does not attempt to down-convert syntax; if you use recently ECMAScript syntax, that will be reflected in the bundled code.
 
 ---
@@ -276,15 +276,15 @@ const result = await Bun.build({
   entrypoints: ["./index.ts"],
 });
 
-for (const result of result.outputs) {
+for (const res of result.outputs) {
   // Can be consumed as blobs
-  await result.text();
+  await res.text();
 
   // Bun will set Content-Type and Etag headers
-  new Response(result);
+  new Response(res);
 
   // Can be written manually, but you should use `outdir` in this case.
-  Bun.write(path.join("out", result.path), result);
+  Bun.write(path.join("out", res.path), res);
 }
 ```
 

docs/bundler/loaders.md

@@ -171,6 +171,41 @@ console.log(addon);
 
 In the bundler, `.node` files are handled using the [`file`](#file) loader.
 
+### `sqlite`
+
+**SQLite loader**. `with { "type": "sqlite" }` import attribute
+
+In the runtime and bundler, SQLite databases can be directly imported. This will load the database using [`bun:sqlite`](/docs/api/sqlite.md).
+
+```ts
+import db from "./my.db" with {type: "sqlite"};
+```
+
+This is only supported when the `target` is `bun`.
+
+By default, the database is external to the bundle (so that you can potentially use a database loaded elsewhere), so the database file on-disk won't be bundled into the final output.
+
+You can change this behavior with the `"embed"` attribute:
+
+```ts
+// embed the database into the bundle
+import db from "./my.db" with {type: "sqlite", embed: "true"};
+```
+
+When using a [standalone executable](/docs/bundler/executables), the database is embedded into the single-file executable.
+
+Otherwise, the database to embed is copied into the `outdir` with a hashed filename.
+
+### `bunshell` loader
+
+**Bun Shell loader**. Default for `.bun.sh` files
+
+This loader is used to parse [Bun Shell](/docs/runtime/shell) scripts. It's only supported when starting bun itself, so it's not available in the bundler or in the runtime.
+
+```sh
+$ bun run ./script.bun.sh
+```
+
 ### `file`
 
 **File loader**. Default for all unrecognized file types.

docs/cli/bundler.md

@@ -1,116 +0,0 @@
-Bundling is currently an important mechanism for building complex web apps.
-
-Modern apps typically consist of a large number of files and package dependencies. Despite the fact that modern browsers support [ES Module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) imports, it's still too slow to fetch each file via individual HTTP requests. _Bundling_ is the process of concatenating several source files into a single large file that can be loaded in a single request.
-
-{% callout %}
-**On bundling** — Despite recent advances like [`modulepreload`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/modulepreload) and [HTTP/3](https://en.wikipedia.org/wiki/HTTP/3), bundling is still the most performant approach.
-{% /callout %}
-
-## Bundling your app
-
-Bun's approach to bundling is a little different from other bundlers. Start by passing your app's entrypoint to `bun bun`.
-
-```bash
-$ bun bun ./app.js
-```
-
-Your entrypoint can be any `js|jsx|ts|tsx|html` file. With this file as a starting point, Bun will construct a graph of imported files and packages, transpile everything, and generate a file called `node_modules.bun`.
-
-## What is `.bun`?
-
-{% callout %}
-**Note** — [This format may change soon](https://github.com/oven-sh/bun/issues/121)
-{% /callout %}
-
-A `.bun` file contains the pre-transpiled source code of your application, plus a bunch of binary-encoded metadata about your application's structure. as a contains:
-
-- all the bundled source code
-- all the bundled source code metadata
-- project metadata & configuration
-
-Here are some of the questions `.bun` files answer:
-
-- when I import `react/index.js`, where in the `.bun` is the code for that? (not resolving, just the code)
-- what modules of a package are used?
-- what framework is used? (e.g., Next.js)
-- where is the routes directory?
-- how big is each imported dependency?
-- what is the hash of the bundle’s contents? (for etags)
-- what is the name & version of every npm package exported in this bundle?
-- what modules from which packages are used in this project? ("project" is defined as all the entry points used to generate the .bun)
-
-All in one file.
-
-It’s a little like a build cache, but designed for reuse across builds.
-
-{% details summary="Position-independent code" %}
-
-From a design perspective, the most important part of the `.bun` format is how code is organized. Each module is exported by a hash like this:
-
-```js
-// preact/dist/preact.module.js
-export var $eb6819b = $$m({
-  "preact/dist/preact.module.js": (module, exports) => {
-    let n, l, u, i, t, o, r, f, e = {}, c = [], s = /acit|ex(?:s|g|n|p|$)|rph|grid|ows|mnc|ntw|ine[ch]|zoo|^ord|itera/i;
-    // ... rest of code
-```
-
-This makes bundled modules [position-independent](https://en.wikipedia.org/wiki/Position-independent_code). In theory, one could import only the exact modules in-use without reparsing code and without generating a new bundle. One bundle can dynamically become many bundles comprising only the modules in use on the webpage. Thanks to the metadata with the byte offsets, a web server can send each module to browsers [zero-copy](https://en.wikipedia.org/wiki/Zero-copy) using [sendfile](https://man7.org/linux/man-pages/man2/sendfile.2.html). Bun itself is not quite this smart yet, but these optimizations would be useful in production and potentially very useful for React Server Components.
-
-To see the schema inside, have a look at [`JavascriptBundleContainer`](./src/api/schema.d.ts#:~:text=export%20interface-,JavascriptBundleContainer,-%7B). You can find JavaScript bindings to read the metadata in [src/api/schema.js](./src/api/schema.js). This is not really an API yet. It’s missing the part where it gets the binary data from the bottom of the file. Someday, I want this to be usable by other tools too.
-{% /details %}
-
-## Where is the code?
-
-`.bun` files are marked as executable.
-
-To print out the code, run `./node_modules.bun` in your terminal or run `bun ./path-to-node_modules.bun`.
-
-Here is a copy-pastable example:
-
-```bash
-$ ./node_modules.bun > node_modules.js
-```
-
-This works because every `.bun` file starts with this:
-
-```
-#!/usr/bin/env bun
-```
-
-To deploy to production with Bun, you’ll want to get the code from the `.bun` file and stick that somewhere your web server can find it (or if you’re using Vercel or a Rails app, in a `public` folder).
-
-Note that `.bun` is a binary file format, so just opening it in VSCode or vim might render strangely.
-
-## Advanced
-
-By default, `bun bun` only bundles external dependencies that are `import`ed or `require`d in either app code or another external dependency. An "external dependency" is defined as, "A JavaScript-like file that has `/node_modules/` in the resolved file path and a corresponding `package.json`".
-
-To force Bun to bundle packages which are not located in a `node_modules` folder (i.e., the final, resolved path following all symlinks), add a `bun` section to the root project’s `package.json` with `alwaysBundle` set to an array of package names to always bundle. Here’s an example:
-
-```json
-{
-  "name": "my-package-name-in-here",
-  "bun": {
-    "alwaysBundle": ["@mybigcompany/my-workspace-package"]
-  }
-}
-```
-
-Bundled dependencies are not eligible for Hot Module Reloading. The code is served to browsers & Bun.js verbatim. But, in the future, it may be sectioned off into only parts of the bundle being used. That’s possible in the current version of the `.bun` file (so long as you know which files are necessary), but it’s not implemented yet. Longer-term, it will include all `import` and `export` of each module inside.
-
-## What is the module ID hash?
-
-The `$eb6819b` hash used here:
-
-```js
-export var $eb6819b = $$m({
-```
-
-Is generated like this:
-
-1. Murmur3 32-bit hash of `package.name@package.version`. This is the hash uniquely identifying the npm package.
-2. Wyhash 64 of the `package.hash` + `package_path`. `package_path` means "relative to the root of the npm package, where is the module imported?". For example, if you imported `react/jsx-dev-runtime.js`, the `package_path` is `jsx-dev-runtime.js`. `react-dom/cjs/react-dom.development.js` would be `cjs/react-dom.development.js`
-3. Truncate the hash generated above to a `u32`
-
-The implementation details of this module ID hash will vary between versions of Bun. The important part is the metadata contains the module IDs, the package paths, and the package hashes, so it shouldn’t really matter in practice if other tooling wants to make use of any of this.

docs/cli/bunx.md

@@ -63,6 +63,12 @@ $ bunx --bun my-cli # good
 $ bunx my-cli --bun # bad
 ```
 
+To force bun to always be used with a script, use a shebang.
+
+```
+#!/usr/bin/env bun
+```
+
 <!-- ## Environment variables
 
 Bun automatically loads environment variables from `.env` files before running a file, script, or executable. The following files are checked, in order:

docs/cli/init.md

@@ -35,6 +35,6 @@ It creates:
 
 If you pass `-y` or `--yes`, it will assume you want to continue without asking questions.
 
-At the end, it runs `bun install` to install `bun-types`.
+At the end, it runs `bun install` to install `@types/bun`.
 
 {% /details %}

docs/cli/install.md

@@ -195,7 +195,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install bun
         uses: oven-sh/setup-bun@v1
       - name: Install dependencies

docs/cli/link.md

@@ -36,11 +36,3 @@ In addition, the `--save` flag can be used to add `cool-pkg` to the `dependencie
     }
   }
 ```
-
-To _unregister_ a local package, navigate to the package's root directory and run `bun unlink`.
-
-```bash
-$ cd /path/to/cool-pkg
-$ bun unlink
-bun unlink v1.x (7416672e)
-```

docs/cli/test.md

@@ -103,7 +103,7 @@ Bun supports the following lifecycle hooks:
 | `afterEach`  | Runs after each test.       |
 | `afterAll`   | Runs once after all tests.  |
 
-These hooks can be define inside test files, or in a separate file that is preloaded with the `--preload` flag.
+These hooks can be defined inside test files, or in a separate file that is preloaded with the `--preload` flag.
 
 ```ts
 $ bun test --preload ./setup.ts
@@ -113,17 +113,13 @@ See [Test > Lifecycle](/docs/test/lifecycle) for complete documentation.
 
 ## Mocks
 
-{% callout %}
-Module mocking (`jest.mock()`) is not yet supported. Track support for it [here](https://github.com/oven-sh/bun/issues/5394).
-{% /callout %}
-
 Create mock functions with the `mock` function. Mocks are automatically reset between tests.
 
 ```ts
 import { test, expect, mock } from "bun:test";
 const random = mock(() => Math.random());
 
-test("random", async () => {
+test("random", () => {
   const val = random();
   expect(val).toBeGreaterThan(0);
   expect(random).toHaveBeenCalled();
@@ -151,7 +147,7 @@ Snapshots are supported by `bun test`.
 // example usage of toMatchSnapshot
 import { test, expect } from "bun:test";
 
-test("snapshot", async () => {
+test("snapshot", () => {
   expect({ a: 1 }).toMatchSnapshot();
 });
 ```

docs/cli/unlink.md

@@ -0,0 +1,7 @@
+Use `bun unlink` in the root directory to unregister a local package.
+
+```bash
+$ cd /path/to/cool-pkg
+$ bun unlink
+bun unlink v1.x (7416672e)
+```

docs/guides/binary/dataview-to-string.md

@@ -1,5 +1,5 @@
 ---
-name: Convert a Uint8Array to a string
+name: Convert a DataView to a string
 ---
 
 If a [`DataView`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView) contains ASCII-encoded text, you can convert it to a string using the [`TextDecoder`](https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder) class.

docs/guides/ecosystem/prisma.md

@@ -21,7 +21,8 @@ $ bun init
 Then install the Prisma CLI (`prisma`) and Prisma Client (`@prisma/client`) as dependencies.
 
 ```bash
-$ bun add prisma @prisma/client
+$ bun add -d prisma
+$ bun add @prisma/client
 ```
 
 ---

docs/guides/http/fetch-unix.md

@@ -0,0 +1,33 @@
+---
+name: Send an HTTP request over a unix domain socket with fetch
+---
+
+In Bun, the `unix` option in `fetch()` lets you send HTTP requests over a [unix domain socket](https://en.wikipedia.org/wiki/Unix_domain_socket).
+
+```ts
+const unix = "/var/run/docker.sock";
+
+const response = await fetch("http://localhost/info", { unix });
+
+const body = await response.json();
+console.log(body); // { ... }
+```
+
+---
+
+The `unix` option is a string that specifies the local file path to a unix domain socket. The `fetch()` function will use the socket to send the request to the server instead of using a TCP network connection. `https` is also supported by using the `https://` protocol in the URL instead of `http://`.
+
+To send a `POST` request to an API endpoint over a unix domain socket:
+
+```ts
+const response = await fetch("https://hostname/a/path", {
+  unix: "/var/run/path/to/unix.sock",
+  method: "POST",
+  body: JSON.stringify({ message: "Hello from Bun!" }),
+  headers: {
+    "Content-Type": "application/json",
+  },
+});
+
+const body = await response.json();
+```

docs/guides/http/server.md

@@ -0,0 +1,46 @@
+---
+name: Common HTTP server usage
+---
+
+This starts an HTTP server listening on port `3000`. It demonstrates basic routing with a number of common responses and also handles POST data from standard forms or as JSON.
+
+See [`Bun.serve`](/docs/api/http) for details.
+
+```ts
+const server = Bun.serve({
+  async fetch (req) {
+    const path = new URL(req.url).pathname;
+
+    // respond with text/html
+    if (path === "/") return new Response("Welcome to Bun!");
+
+    // redirect
+    if (path === "/abc") return Response.redirect("/source", 301);
+
+    // send back a file (in this case, *this* file)
+    if (path === "/source") return new Response(Bun.file(import.meta.file));
+
+    // respond with JSON
+    if (path === "/api") return Response.json({ some: "buns", for: "you" });
+
+    // receive JSON data to a POST request
+    if (req.method === "POST" && path === "/api/post") {
+      const data = await req.json();
+      console.log("Received JSON:", data);
+      return Response.json({ success: true, data });
+    }
+
+    // receive POST data from a form
+    if (req.method === "POST" && path === "/form") {
+      const data = await req.formData();
+      console.log(data.get("someField"));
+      return new Response("Success");
+    }
+
+    // 404s
+    return new Response("Page not found", { status: 404 });
+  }
+})
+
+console.log(`Listening on ${server.url}`);
+```

docs/guides/http/simple.md

@@ -14,5 +14,6 @@ const server = Bun.serve({
   },
 });
 
-console.log(`Listening on localhost: ${server.port}`);
+console.log(`Listening on ${server.url}`);
+
 ```

docs/guides/install/trusted.md

@@ -5,7 +5,7 @@ name: Add a trusted dependency
 Unlike other npm clients, Bun does not execute arbitrary lifecycle scripts for installed dependencies, such as `postinstall` and `node-gyp` builds. These scripts represent a potential security risk, as they can execute arbitrary code on your machine.
 
 {% callout %}
-Soon, Bun will include a built-in allow-list that automatically allows lifecycle scripts to be run by popular packages that are known to be safe. This is still under development.
+Bun includes a default allowlist of popular packages containing `postinstall` scripts that are known to be safe. You can see this list [here](https://github.com/oven-sh/bun/blob/main/src/install/default-trusted-dependencies.txt).
 {% /callout %}
 
 ---

docs/guides/process/argv.md

@@ -19,4 +19,39 @@ $ bun run cli.tsx --flag1 --flag2 value
 
 ---
 
-To parse `argv` into a more useful format, consider using [minimist](https://github.com/minimistjs/minimist) or [commander](https://github.com/tj/commander.js).
+To parse `argv` into a more useful format, `util.parseArgs` would be helpful.
+
+Example:
+
+```ts#cli.ts
+import { parseArgs } from "util";
+
+const { values, positionals } = parseArgs({
+  args: Bun.argv,
+  options: {
+    flag1: {
+      type: 'boolean',
+    },
+    flag2: {
+      type: 'string',
+    },
+  },
+  strict: true,
+  allowPositionals: true,
+});
+
+console.log(values);
+console.log(positionals);
+```
+
+then it outputs
+
+```
+$ bun run cli.tsx --flag1 --flag2 value
+{
+  flag1: true,
+  flag2: "value",
+}
+[ "/path/to/bun", "/path/to/cli.ts" ]
+```
+

docs/guides/runtime/cicd.md

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       # ...
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 +     - uses: oven-sh/setup-bun@v1
 
       # run any `bun` or `bunx` command

docs/guides/runtime/shell.md

@@ -0,0 +1,40 @@
+---
+name: Run a Shell Command
+---
+
+Bun Shell is a cross-platform bash-like shell built in to Bun.
+
+It provides a simple way to run shell commands in JavaScript and TypeScript. To get started, import the `$` function from the `bun` package and use it to run shell commands.
+
+```ts#foo.ts
+import { $ } from "bun";
+
+await $`echo Hello, world!`; // => "Hello, world!"
+```
+
+---
+
+The `$` function is a tagged template literal that runs the command and returns a promise that resolves with the command's output.
+
+```ts#foo.ts
+import { $ } from "bun";
+
+const output = await $`ls -l`.text();
+console.log(output);
+```
+
+---
+
+To get each line of the output as an array, use the `lines` method.
+
+```ts#foo.ts
+import { $ } from "bun";
+
+for await (const line of $`ls -l`.lines()) {
+  console.log(line);
+}
+```
+
+---
+
+See [Docs > API > Shell](/api/shell) for complete documentation.

docs/guides/runtime/typescript.md

@@ -15,13 +15,13 @@ Below is the full set of recommended `compilerOptions` for a Bun project. With t
 ```jsonc
 {
   "compilerOptions": {
-    // enable latest features
+    // Enable latest features
     "lib": ["ESNext"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",
-    "jsx": "react-jsx", // support JSX
-    "allowJs": true, // allow importing `.js` from `.ts`
+    "jsx": "react-jsx",
+    "allowJs": true,
 
     // Bundler mode
     "moduleResolution": "bundler",
@@ -32,12 +32,11 @@ Below is the full set of recommended `compilerOptions` for a Bun project. With t
     // Best practices
     "strict": true,
     "skipLibCheck": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
 
     // Some stricter flags
-    "useUnknownInCatchVariables": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
     "noPropertyAccessFromIndexSignature": true
   }
 }

docs/guides/streams/to-json.md

@@ -1,5 +1,5 @@
 ---
-name: Convert a ReadableStream to a JSON
+name: Convert a ReadableStream to JSON
 ---
 
 Bun provides a number of convenience functions for reading the contents of a [`ReadableStream`](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream) into different formats.

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

@@ -93,7 +93,7 @@ $ bun test --timeout 10000
 
 Many other flags become irrelevant or obsolete when using `bun test`.
 
-- `transform` — Buns supports TypeScript & JSX. Other file types can be configured with [Plugins](/docs/runtime/plugins).
+- `transform` — Bun supports TypeScript & JSX. Other file types can be configured with [Plugins](/docs/runtime/plugins).
 - `extensionsToTreatAsEsm`
 - `haste` — Bun uses it's own internal source maps
 - `watchman`, `watchPlugins`, `watchPathIgnorePatterns` — use `--watch` to run tests in watch mode

docs/guides/util/hash-a-password.md

@@ -13,7 +13,7 @@ const hash = await Bun.password.hash(password);
 
 ---
 
-By default this uses the [Argon2id](https://en.wikipedia.org/wiki/Argon2) algorithm. Pass a second argument to `Bun.hash.password()` to use a different algorithm or configure the hashing parameters.
+By default, this uses the [Argon2id](https://en.wikipedia.org/wiki/Argon2) algorithm. Pass a second argument to `Bun.password.hash()` to use a different algorithm or configure the hashing parameters.
 
 ```ts
 const password = "super-secure-pa$$word";
@@ -39,7 +39,7 @@ const bcryptHash = await Bun.password.hash(password, {
 
 ---
 
-To verify a password, use `Bun.password.verify()`. The algorithm and its parameters are stored in the hash itself, so there's no need to re-specify any configuration.
+Use `Bun.password.verify()` to verify a password. The algorithm and its parameters are stored in the hash itself, so re-specifying configuration is unnecessary.
 
 ```ts
 const password = "super-secure-pa$$word";

docs/guides/util/which-path-to-executable-bin.md

@@ -0,0 +1,15 @@
+---
+name: Get the path to an executable bin file
+---
+
+`Bun.which` is a utility function to find the absolute path of an executable file. It is similar to the `which` command in Unix-like systems.
+
+```ts#foo.ts
+Bun.which("sh"); // => "/bin/sh"
+Bun.which("notfound"); // => null
+Bun.which("bun"); // => "/home/user/.bun/bin/bun"
+```
+
+---
+
+See [Docs > API > Utils](/api/utils#bun-which) for complete documentation.

docs/guides/websocket/pubsub.md

@@ -20,11 +20,11 @@ const server = Bun.serve<{ username: string }>({
     open(ws) {
       const msg = `${ws.data.username} has entered the chat`;
       ws.subscribe("the-group-chat");
-      ws.publish("the-group-chat", msg);
+      server.publish("the-group-chat", msg);
     },
     message(ws, message) {
       // the server re-broadcasts incoming messages to everyone
-      ws.publish("the-group-chat", `${ws.data.username}: ${message}`);
+      server.publish("the-group-chat", `${ws.data.username}: ${message}`);
     },
     close(ws) {
       const msg = `${ws.data.username} has left the chat`;

docs/index.md

@@ -1,4 +1,4 @@
-Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun​`.
+Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun`.
 
 At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-in replacement for Node.js. It's written in Zig and powered by JavaScriptCore under the hood, dramatically reducing startup times and memory usage.
 
@@ -6,18 +6,18 @@ At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-i
 $ bun run index.tsx  # TS and JSX supported out of the box
 ```
 
-​​The `bun​` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager, all significantly faster than existing tools and usable in existing Node.js projects with little to no changes necessary.
+The `bun` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager, all significantly faster than existing tools and usable in existing Node.js projects with little to no changes necessary.
 
 ```bash
 $ bun run start                 # run the `start` script
-$ bun install <pkg>​             # install a package
+$ bun install <pkg>             # install a package
 $ bun build ./index.tsx         # bundle a project for browsers
 $ bun test                      # run tests
 $ bunx cowsay 'Hello, world!'   # execute a package
 ```
 
 {% callout type="note" %}
-**​​Bun is still under development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
+**Bun is still under development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
 {% /callout %}
 
 Get started with one of the quick links below, or read on to learn more about Bun.

docs/install/cache.md

@@ -1,6 +1,6 @@
 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" %}
+{% details summary="Configuring cache behavior" (bunfig.toml) %}
 
 ```toml
 [install.cache]

docs/installation.md

@@ -22,8 +22,7 @@ $ npm install -g bun # the last `npm` command you'll ever need
 ```
 
 ```bash#Homebrew
-$ brew tap oven-sh/bun # for macOS and Linux
-$ brew install bun
+$ brew install oven-sh/bun/bun # for macOS and Linux
 ```
 
 ```bash#Docker
@@ -39,15 +38,29 @@ $ proto install bun
 
 ### Windows
 
+{% callout %}
+Bun requires a minimum of Windows 10 version 1809
+{% /callout %}
+
 Bun provides a _limited, experimental_ native build for Windows. It is recommended to use Bun within [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/install) and follow the above instructions. To help catch bugs, the experimental build enables many debugging assertions, which will make the binary slower than what the stable version will be.
 
-To install, paste this into your terminal (Powershell or `cmd.exe`):
+To install, paste this into a terminal:
 
-```powershell
+{% codetabs %}
+
+```powershell#PowerShell/cmd.exe
 # WARNING: No stability is guaranteed on the experimental Windows builds
-powershell -c "iwr bun.sh/install.ps1|iex"
+powershell -c "irm bun.sh/install.ps1|iex"
 ```
 
+```powershell#Scoop
+# WARNING: No stability is guaranteed on the experimental Windows builds
+scoop bucket add versions
+scoop install bun-canary
+```
+
+{% /codetabs %}
+
 For support and discussion, please join the [#windows channel on our Discord](http://bun.sh/discord).
 
 ## Docker
@@ -219,6 +232,10 @@ If you need to remove Bun from your system, use the following commands.
 $ rm -rf ~/.bun # for macOS, Linux, and WSL
 ```
 
+```bash#Windows
+$ Remove-Item ~\.bun -Recurse
+```
+
 ```bash#NPM
 $ npm uninstall -g bun
 ```

docs/nav.ts

@@ -116,6 +116,9 @@ export default {
     page("runtime/nodejs-apis", "Node.js compatibility", {
       description: `Bun aims for full Node.js compatibility. This page tracks the current compatibility status.`,
     }),
+    page("bundler/executables", "Single-file executable", {
+      description: "Compile a TypeScript or JavaScript file to a standalone executable",
+    }),
     page("runtime/plugins", "Plugins", {
       description: `Implement custom loaders and module resolution logic with Bun's plugin system.`,
     }),
@@ -204,9 +207,6 @@ export default {
     page("bundler/plugins", "Plugins", {
       description: `Implement custom loaders and module resolution logic with Bun's plugin system.`,
     }),
-    page("bundler/executables", "Executables", {
-      description: "Compile a TypeScript or JavaScript file to a standalone executable",
-    }),
     page("bundler/macros", "Macros", {
       description: `Run JavaScript functions at bundle-time and inline the results into your bundle`,
     }),
@@ -309,6 +309,9 @@ export default {
     page("api/globals", "Globals", {
       description: `Bun implements a range of Web APIs, Node.js APIs, and Bun-native APIs that are available in the global scope.`,
     }), // "`Bun.write`"),
+    page("runtime/shell", "$ Shell", {
+      description: `Bun's cross-platform shell-scripting API makes shell scripting with JavaScript fun`,
+    }), // "`Bun.$`"),
     page("api/spawn", "Child processes", {
       description: `Spawn sync and async child processes with easily configurable input and output streams.`,
     }), // "`Bun.spawn`"),
@@ -366,6 +369,9 @@ export default {
     page("project/contributing", "Contributing", {
       description: "Learn how to contribute to Bun and get your local development environment up and running.",
     }),
+    page("project/building-windows", "Building Windows", {
+      description: "Learn how to setup a development environment for contributing to the Windows build of Bun.",
+    }),
     page("project/licensing", "License", {
       description: `Bun is a MIT-licensed project with a large number of statically-linked dependencies with various licenses.`,
     }),

docs/project/building-windows.md

@@ -1,13 +1,15 @@
-The following document is not yet complete, please join the [#windows channel on our Discord](http://bun.sh/discord) for help.
+This document describes the build process for Windows. If you run into problems, please join the [#windows channel on our Discord](http://bun.sh/discord) for help.
+
+It is strongly recommended to use [PowerShell 7 (`pwsh.exe`)](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4) instead of the default `powershell.exe`.
 
 ## Prerequisites
 
+<!--
 {% details summary="Extra notes for Bun Core Team Members" %}
 
 Here are the extra steps I ran on my fresh windows machine (some of these are a little opiniated)
 
-- Change user to a local account (set username to `window` and empty password)
-  - (Empty password will disable the password and auto-login on boot)
+- Change user to a local account (set username to `window` and 'bun!')
 - Set Windows Terminal as default terminal
 - Install latest version of Powershell
 - Display scale to 100%
@@ -30,17 +32,11 @@ Here are the extra steps I ran on my fresh windows machine (some of these are a
 
 I recommend using VSCode through SSH instead of Tunnels or the Tailscale extension, it seems to be more reliable.
 
-{% /details %}
-
-Make sure to use powershell with the proper shell environment loaded. To do so, you can run:
-
-```ps1
-.\scripts\env.ps1
-```
+{% /details %} -->
 
 ### Enable Scripts
 
-By default, scripts are blocked.
+By default, running unverified scripts are blocked.
 
 ```ps1
 Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
@@ -48,8 +44,14 @@ Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
 
 ### System Dependencies
 
+- Bun 1.1 or later. We use Bun to run it's own code generators.
+
+```ps1
+irm bun.sh/install.ps1 | iex
+```
+
 - [Visual Studio](https://visualstudio.microsoft.com) with the "Desktop Development with C++" workload.
-  - Install Git and CMake from here, if not already installed.
+  - Install Git and CMake from this installer, if not already installed.
 
 After Visual Studio, you need the following:
 
@@ -59,25 +61,31 @@ After Visual Studio, you need the following:
 - NASM
 - Perl
 - Ruby
-- Node.js (until bun is stable enough on windows)
+- Node.js
 
-[Scoop](https://scoop.sh) can be used to install these easily.
+{% callout %}
+The Zig compiler is automatically downloaded, installed, and updated by the building process.
+{% /callout %}
+
+[Scoop](https://scoop.sh) can be used to install these remaining tools easily:
+
+```ps1
+irm https://get.scoop.sh | iex
 
-```bash
 scoop install nodejs-lts go rust nasm ruby perl
 scoop llvm@16.0.4 # scoop bug if you install llvm and the rest at the same time
 ```
 
-If you intend on building WebKit locally (optional), you should install some more packages:
+If you intend on building WebKit locally (optional), you should install these packages:
 
-```bash
+```ps1
 scoop install make cygwin python
 ```
 
-From here on out, it is **expected you use a Developer PowerShell Terminal with `.\scripts\env.ps1 sourced**. This script is available in the Bun repository and can be loaded by executing it.
+From here on out, it is **expected you use a PowerShell Terminal with `.\scripts\env.ps1` sourced**. This script is available in the Bun repository and can be loaded by executing it:
 
 ```ps1
-$ .\scripts\env.ps1
+.\scripts\env.ps1
 ```
 
 To verify, you can check for an MSVC-only command line such as `mt.exe`
@@ -86,55 +94,55 @@ To verify, you can check for an MSVC-only command line such as `mt.exe`
 Get-Command mt
 ```
 
-### Zig
-
-Bun pins a version of Zig. As the compiler is still in development, breaking changes happen often that will break the build. It is recommended to use [Zigup](https://github.com/marler8997/zigup/releases) as it can quickly switch to any version by name, but you can also [manually download Zig](https://ziglang.org/download/).
-
-```bash
-$ zigup 0.12.0-dev.1604+caae40c21
-```
-
 {% callout %}
-We last updated Zig on **October 26th, 2023**
+It is not recommended to install `ninja` / `cmake` into your global path, because you may run into a situation where you try to build bun without .\scripts\env.ps1 sourced.
 {% /callout %}
 
-### Codegen
-
-On Unix platforms, we depend on an existing build of Bun to generate code for itself. Since the Windows build is not stable enough for this to run the code generators, you currently need to use another computer or WSL to generate this:
-
-```bash
-$ wsl --install # run twice if it doesnt install
-# in the linux environment
-$ sudo apt install unzip
-$ curl -fsSL https://bun.sh/install | bash
-```
-
-Whenever codegen-related things are updated, please re-run
-
-```ps1
-$ .\scripts\codegen.ps1
-```
-
 ## Building
 
 ```ps1
-npm install
+bun install
 
 .\scripts\env.ps1
-.\scripts\update-submodules.ps1
-.\scripts\all-dependencies.ps1
-.\scripts\codegen.ps1
+.\scripts\update-submodules.ps1 # this syncs git submodule state
+.\scripts\all-dependencies.ps1 # this builds all dependencies
+.\scripts\make-old-js.ps1 # runs some old code generators
 
-cd build # this was created by the codegen.ps1 script in the prerequisites
+# Configure build environment
+cmake -Bbuild -GNinja -DCMAKE_BUILD_TYPE=Debug
 
-cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Debug
-ninja
+# Build bun
+ninja -Cbuild
 ```
 
 If this was successful, you should have a `bun-debug.exe` in the `build` folder.
 
 ```ps1
-.\bun-debug.exe --version
+.\build\bun-debug.exe --revision
+```
+
+You should add this to `$Env:PATH`. The simplest way to do so is to open the start menu, type "Path", and then navigate the environment variables menu to add `C:\.....\bun\build` to the user environment variable `PATH`. You should then restart your editor (if it does not update still, log out and log back in).
+
+## Extra paths
+
+- WebKit is extracted to `build/bun-webkit`
+- Zig is extracted to `.cache/zig/zig.exe`
+
+## Tests
+
+You can run the test suite either using `bun test`, or by using the wrapper script `packages\bun-internal-test`. The internal test package is a wrapper cli to run every test file in a separate instance of bun.exe, to prevent a crash in the test runner from stopping the entire suite.
+
+```ps1
+# Setup
+bun i --cwd packages\bun-internal-test
+
+# Run the entire test suite with reporter
+# the package.json script "test" uses "build/bun-debug.exe" by default
+bun run test
+
+# Run an individual test file:
+bun-debug test node\fs
+bun-debug test "C:\bun\test\js\bun\resolve\import-meta.test.js"
 ```
 
 ## Troubleshooting

docs/project/contributing.md

@@ -4,16 +4,16 @@ If you are using Windows, you must use a WSL environment as Bun does not yet com
 
 ## Install Dependencies
 
-Using your system's package manager, install the Bun's dependencies:
+Using your system's package manager, install Bun's dependencies:
 
 {% codetabs %}
 
 ```bash#macOS (Homebrew)
-$ brew install automake ccache cmake coreutils gnu-sed go libiconv libtool ninja pkg-config rust
+$ brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby
 ```
 
 ```bash#Ubuntu/Debian
-$ sudo apt install cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
+$ sudo apt install curl wget lsb-release software-properties-common cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
 ```
 
 ```bash#Arch
@@ -21,7 +21,7 @@ $ sudo pacman -S base-devel ccache cmake git go libiconv libtool make ninja pkg-
 ```
 
 ```bash#Fedora
-$ sudo dnf install cargo ccache cmake git golang libtool ninja-build pkg-config rustc libatomic-static libstdc++-static sed unzip which libicu-devel
+$ sudo dnf install cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
 ```
 
 {% /codetabs %}
@@ -105,6 +105,8 @@ $ export PATH="$PATH:/usr/lib/llvm16/bin"
 
 {% /codetabs %}
 
+> ⚠️ Ubuntu distributions may require installation of the C++ standard library independently. See the [troubleshooting section](#span-file-not-found-on-ubuntu) for more information.
+
 ## Building Bun
 
 After cloning the repository, run the following command to run the first build. This may take a while as it will clone submodules and build dependencies.
@@ -252,6 +254,16 @@ fatal error: 'span' file not found
          ^~~~~~
 ```
 
+The issue may manifest when initially running `bun setup` as Clang being unable to compile a simple program:
+
+```
+The C++ compiler
+
+  "/usr/bin/clang++-16"
+
+is not able to compile a simple test program.
+```
+
 To fix the error, we need to update the GCC version to 11. To do this, we'll need to check if the latest version is available in the distribution's official repositories or use a third-party repository that provides GCC 11 packages. Here are general steps:
 
 ```bash

docs/project/licensing.md

@@ -30,6 +30,13 @@ Bun statically links these libraries:
 
 ---
 
+---
+
+- [`brotli`](https://github.com/google/brotli)
+- MIT
+
+---
+
 - [`libarchive`](https://github.com/libarchive/libarchive)
 - [several licenses](https://github.com/libarchive/libarchive/blob/master/COPYING)
 

docs/quickstart.md

@@ -45,18 +45,25 @@ console.log(`Listening on http://localhost:${server.port} ...`);
 {% details summary="Seeing TypeScript errors on `Bun`?" %}
 If you used `bun init`, Bun will have automatically installed Bun's TypeScript declarations and configured your `tsconfig.json`. If you're trying out Bun in an existing project, you may see a type error on the `Bun` global.
 
-To fix this, first install `bun-types` as a dev dependency.
+To fix this, first install `@types/bun` as a dev dependency.
 
 ```sh
-$ bun add -d bun-types
+$ bun add -d @types/bun
 ```
 
-Then add the following line to your `compilerOptions` in `tsconfig.json`.
+Then add the following to your `compilerOptions` in `tsconfig.json`:
 
-```json-diff#tsconfig.json
+```json#tsconfig.json
 {
   "compilerOptions": {
-+   "types": ["bun-types"]
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleDetection": "force",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
   }
 }
 ```
@@ -85,7 +92,7 @@ Bun can also execute `"scripts"` from your `package.json`. Add the following scr
 +     "start": "bun run index.ts"
 +   },
     "devDependencies": {
-      "bun-types": "^0.7.0"
+      "@types/bun": "^1.0.0"
     }
   }
 ```
@@ -117,12 +124,12 @@ Update `index.ts` to use `figlet` in the `fetch` handler.
 + import figlet from "figlet";
 
   const server = Bun.serve({
-    fetch() {
+    port: 3000,
+    fetch(req) {
 +     const body = figlet.textSync("Bun!");
 +     return new Response(body);
 -     return new Response("Bun!");
     },
-    port: 3000,
   });
 ```
 

docs/runtime/bun-apis.md

@@ -30,17 +30,20 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - File I/O
-- [`Bun.file`](/docs/api/file-io#reading-files-bun-file) [`Bun.write`](/docs/api/file-io#writing-files-bun-write)
+- [`Bun.file`](/docs/api/file-io#reading-files-bun-file)
+  [`Bun.write`](/docs/api/file-io#writing-files-bun-write)
 
 ---
 
 - Child processes
-- [`Bun.spawn`](/docs/api/spawn#spawn-a-process-bun-spawn) [`Bun.spawnSync`](/docs/api/spawn#blocking-api-bun-spawnsync)
+- [`Bun.spawn`](/docs/api/spawn#spawn-a-process-bun-spawn)
+  [`Bun.spawnSync`](/docs/api/spawn#blocking-api-bun-spawnsync)
 
 ---
 
 - TCP
-- [`Bun.listen`](/docs/api/tcp#start-a-server-bun-listen) [`Bun.connect`](/docs/api/tcp#start-a-server-bun-listen)
+- [`Bun.listen`](/docs/api/tcp#start-a-server-bun-listen)
+  [`Bun.connect`](/docs/api/tcp#start-a-server-bun-listen)
 
 ---
 
@@ -60,7 +63,8 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - Hashing
-- [`Bun.hash`](/docs/api/hashing#bun-hash) [`Bun.CryptoHasher`](/docs/api/hashing#bun-cryptohasher)
+- [`Bun.hash`](/docs/api/hashing#bun-hash)
+  [`Bun.CryptoHasher`](/docs/api/hashing#bun-cryptohasher)
 
 ---
 
@@ -100,6 +104,26 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - Utilities
-- [`Bun.version`](/docs/api/utils#bun-version) [`Bun.revision`](/docs/api/utils#bun-revision) [`Bun.env`](/docs/api/utils#bun-env) [`Bun.main`](/docs/api/utils#bun-main) [`Bun.sleep()`](/docs/api/utils#bun-sleep) [`Bun.sleepSync()`](/docs/api/utils#bun-sleepsync) [`Bun.which()`](/docs/api/utils#bun-which) [`Bun.peek()`](/docs/api/utils#bun-peek) [`Bun.openInEditor()`](/docs/api/utils#bun-openineditor) [`Bun.deepEquals()`](/docs/api/utils#bun-deepequals) [`Bun.escapeHTML()`](/docs/api/utils#bun-escapehtml) [`Bun.fileURLToPath()`](/docs/api/utils#bun-fileurltopath) [`Bun.pathToFileURL()`](/docs/api/utils#bun-pathtofileurl) [`Bun.gzipSync()`](/docs/api/utils#bun-gzipsync) [`Bun.gunzipSync()`](/docs/api/utils#bun-gunzipsync) [`Bun.deflateSync()`](/docs/api/utils#bun-deflatesync) [`Bun.inflateSync()`](/docs/api/utils#bun-inflatesync) [`Bun.inspect()`](/docs/api/utils#bun-inspect) [`Bun.nanoseconds()`](/docs/api/utils#bun-nanoseconds) [`Bun.readableStreamTo*()`](/docs/api/utils#bun-readablestreamto) [`Bun.resolveSync()`](/docs/api/utils#bun-resolvesync)
+- [`Bun.version`](/docs/api/utils#bun-version)
+  [`Bun.revision`](/docs/api/utils#bun-revision)
+  [`Bun.env`](/docs/api/utils#bun-env)
+  [`Bun.main`](/docs/api/utils#bun-main)
+  [`Bun.sleep()`](/docs/api/utils#bun-sleep)
+  [`Bun.sleepSync()`](/docs/api/utils#bun-sleepsync)
+  [`Bun.which()`](/docs/api/utils#bun-which)
+  [`Bun.peek()`](/docs/api/utils#bun-peek)
+  [`Bun.openInEditor()`](/docs/api/utils#bun-openineditor)
+  [`Bun.deepEquals()`](/docs/api/utils#bun-deepequals)
+  [`Bun.escapeHTML()`](/docs/api/utils#bun-escapehtml)
+  [`Bun.fileURLToPath()`](/docs/api/utils#bun-fileurltopath)
+  [`Bun.pathToFileURL()`](/docs/api/utils#bun-pathtofileurl)
+  [`Bun.gzipSync()`](/docs/api/utils#bun-gzipsync)
+  [`Bun.gunzipSync()`](/docs/api/utils#bun-gunzipsync)
+  [`Bun.deflateSync()`](/docs/api/utils#bun-deflatesync)
+  [`Bun.inflateSync()`](/docs/api/utils#bun-inflatesync)
+  [`Bun.inspect()`](/docs/api/utils#bun-inspect)
+  [`Bun.nanoseconds()`](/docs/api/utils#bun-nanoseconds)
+  [`Bun.readableStreamTo*()`](/docs/api/utils#bun-readablestreamto)
+  [`Bun.resolveSync()`](/docs/api/utils#bun-resolvesync)
 
 {% /table %}

docs/runtime/bunfig.md

@@ -298,7 +298,7 @@ Valid values are:
 ---
 
 - `"fallback"`
-- Check local `node_modules` first, the auto-install any packages that aren't found. You can enable this from the CLI with `bun -i`.
+- Check local `node_modules` first, then auto-install any packages that aren't found. You can enable this from the CLI with `bun -i`.
 
 {% /table %}
 

docs/runtime/loaders.md

@@ -80,6 +80,17 @@ $ bun run ./my-wasm-app.whatever
 **Note** — WASI support is based on [wasi-js](https://github.com/sagemathinc/cowasm/tree/main/core/wasi-js). Currently, it only supports WASI binaries that use the `wasi_snapshot_preview1` or `wasi_unstable` APIs. Bun's implementation is not fully optimized for performance; this will become more of a priority as WASM grows in popularity.
 {% /callout %}
 
+## SQLite
+
+You can import sqlite databases directly into your code. Bun will automatically load the database and return a `Database` object.
+
+```ts
+import db from "./my.db" with {type: "sqlite"};
+console.log(db.query("select * from users LIMIT 1").get());
+```
+
+This uses [`bun:sqlite`](/docs/api/sqlite).
+
 ## Custom loaders
 
 Support for additional file types can be implemented with plugins. Refer to [Runtime > Plugins](/docs/bundler/plugins) for full documentation.

docs/runtime/nodejs-apis.md

@@ -6,7 +6,7 @@ This page is updated regularly to reflect compatibility status of the latest ver
 
 ### [`node:assert`](https://nodejs.org/api/assert.html)
 
-🟡 Missing `doesNotMatch`
+🟢 Fully implemented.
 
 ### [`node:async_hooks`](https://nodejs.org/api/async_hooks.html)
 
@@ -52,11 +52,11 @@ Some methods are not optimized yet.
 
 ### [`node:events`](https://nodejs.org/api/events.html)
 
-🟡 Missing `on` `addAbortListener` `getMaxListeners`
+🟡 Missing `addAbortListener` `events.getMaxListeners`
 
 ### [`node:fs`](https://nodejs.org/api/fs.html)
 
-🟡 Missing `Dir` `fdatasync` `fdatasyncSync` `openAsBlob` `opendir` `opendirSync` `statfs` `statfsSync`. `fs.promises.open` incorrectly returns a file descriptor instead of a `FileHandle`.
+🟡 Missing `Dir` `openAsBlob` `opendir` `opendirSync` `statfs` `statfsSync`
 
 ### [`node:http`](https://nodejs.org/api/http.html)
 
@@ -76,11 +76,11 @@ Some methods are not optimized yet.
 
 ### [`node:module`](https://nodejs.org/api/module.html)
 
-🟢 Missing `runMain` `syncBuiltinESMExports`, `Module#load()`. Attempts to override or patch the module cache will fail.
+🟡 Missing `runMain` `syncBuiltinESMExports`, `Module#load()`. Attempts to override or patch the module cache will fail.
 
 ### [`node:net`](https://nodejs.org/api/net.html)
 
-🟡 Missing `BlockList` `SocketAddress` `Stream` `getDefaultAutoSelectFamily` `getDefaultAutoSelectFamilyAttemptTimeout` `setDefaultAutoSelectFamily` `setDefaultAutoSelectFamilyAttemptTimeout` `Server#ref()` `Server#unref()` `Socket#ref()` `Socket#unref()`.
+🟡 Missing `BlockList` `SocketAddress` `Stream` `getDefaultAutoSelectFamily` `getDefaultAutoSelectFamilyAttemptTimeout` `setDefaultAutoSelectFamily` `setDefaultAutoSelectFamilyAttemptTimeout`
 
 ### [`node:os`](https://nodejs.org/api/os.html)
 
@@ -92,7 +92,7 @@ Some methods are not optimized yet.
 
 ### [`node:perf_hooks`](https://nodejs.org/api/perf_hooks.html)
 
-🟡 Only `perf_hooks.performance.now()` and `perf_hooks.performance.timeOrigin` are implemented. Missing `Performance` `PerformanceMark` `PerformanceMeasure` `PerformanceObserverEntryList` `PerformanceResourceTiming` `createHistogram` `monitorEventLoopDelay`. It's recommended to use `performance` global instead of `perf_hooks.performance`.
+🟡 Missing `createHistogram` `monitorEventLoopDelay`. It's recommended to use `performance` global instead of `perf_hooks.performance`.
 
 ### [`node:process`](https://nodejs.org/api/process.html)
 
@@ -116,7 +116,7 @@ Some methods are not optimized yet.
 
 ### [`node:stream`](https://nodejs.org/api/stream.html)
 
-🟡 Missing `getDefaultHighWaterMark` `setDefaultHighWaterMark`
+🟡 Missing `getDefaultHighWaterMark` `setDefaultHighWaterMark` `toWeb`
 
 ### [`node:string_decoder`](https://nodejs.org/api/string_decoder.html)
 
@@ -148,7 +148,7 @@ Some methods are not optimized yet.
 
 ### [`node:url`](https://nodejs.org/api/url.html)
 
-🟡 Missing `domainToASCII` `domainToUnicode`. It's recommended to use `URL` and `URLSearchParams` globals instead.
+🟢 Fully implemented.
 
 ### [`node:util`](https://nodejs.org/api/util.html)
 
@@ -168,7 +168,7 @@ Some methods are not optimized yet.
 
 ### [`node:worker_threads`](https://nodejs.org/api/worker_threads.html)
 
-🟡 `Worker` doesn't support the following options: `eval` `argv` `execArgv` `stdin` `stdout` `stderr` `trackedUnmanagedFds` `resourceLimits`. Missing `markAsUntransferable` `moveMessagePortToContext` `getHeapSnapshot`.
+🟡 `Worker` doesn't support the following options: `eval` `stdin` `stdout` `stderr` `trackedUnmanagedFds` `resourceLimits`. Missing `markAsUntransferable` `moveMessagePortToContext` `getHeapSnapshot`.
 
 ### [`node:zlib`](https://nodejs.org/api/zlib.html)
 
@@ -312,23 +312,23 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`PerformanceEntry`](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceEntry)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`PerformanceMark`](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceMark)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`PerformanceMeasure`](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceMeasure)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`PerformanceObserver`](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`PerformanceObserverEntryList`](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserverEntryList)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`PerformanceResourceTiming`](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming)
 
@@ -340,7 +340,7 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`process`](https://nodejs.org/api/process.html)
 
-🟡 Missing `domain` `hasUncaughtExceptionCaptureCallback` `initgroups` `report` `resourceUsage` `setUncaughtExceptionCaptureCallback` `setegid` `seteuid` `setgid` `setgroups` `setuid` `allowedNodeEnvironmentFlags` `getActiveResourcesInfo` `setActiveResourcesInfo` `moduleLoadList` `setSourceMapsEnabled` `channel`. `process.binding` is partially implemented.
+🟡 Missing `domain` `hasUncaughtExceptionCaptureCallback` `initgroups` `resourceUsage` `setUncaughtExceptionCaptureCallback` `setegid` `seteuid` `setgid` `setgroups` `setuid` `allowedNodeEnvironmentFlags` `getActiveResourcesInfo` `setActiveResourcesInfo` `moduleLoadList` `setSourceMapsEnabled` `channel`. `process.binding` is partially implemented.
 
 ### [`queueMicrotask()`](https://developer.mozilla.org/en-US/docs/Web/API/queueMicrotask)
 
@@ -356,11 +356,11 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`ReadableStreamBYOBReader`](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamBYOBReader)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`ReadableStreamBYOBRequest`](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamBYOBRequest)
 
-🔴 Not implemented.
+🟢 Fully implemented.
 
 ### [`ReadableStreamDefaultController`](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultController)
 
@@ -432,7 +432,7 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`URL`](https://developer.mozilla.org/en-US/docs/Web/API/URL)
 
-🟢 Fully implemented.
+🟡 `URL.createObjectURL` is missing. See [Issue #3925](https://github.com/oven-sh/bun/issues/3925)
 
 ### [`URLSearchParams`](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams)
 

docs/runtime/plugins.md

@@ -67,13 +67,12 @@ plugin({
   name: "YAML",
   async setup(build) {
     const { load } = await import("js-yaml");
-    const { readFileSync } = await import("fs");
 
     // when a .yaml file is imported...
-    build.onLoad({ filter: /\.(yaml|yml)$/ }, (args) => {
+    build.onLoad({ filter: /\.(yaml|yml)$/ }, async (args) => {
 
       // read and parse the file
-      const text = readFileSync(args.path, "utf8");
+      const text = await Bun.file(args.path).text();
       const exports = load(text) as Record<string, any>;
 
       // and returns it as a module
@@ -184,13 +183,12 @@ plugin({
   name: "svelte loader",
   async setup(build) {
     const { compile } = await import("svelte/compiler");
-    const { readFileSync } = await import("fs");
 
     // when a .svelte file is imported...
-    build.onLoad({ filter: /\.svelte$/ }, ({ path }) => {
+    build.onLoad({ filter: /\.svelte$/ }, async ({ path }) => {
 
       // read and compile it with the Svelte compiler
-      const file = readFileSync(path, "utf8");
+      const file = await Bun.file(path).text();
       const contents = compile(file, {
         filename: path,
         generate: "ssr",
@@ -216,7 +214,7 @@ With this plugin, Svelte components can now be directly imported and consumed.
 import "./sveltePlugin.ts";
 import MySvelteComponent from "./component.svelte";
 
-console.log(mySvelteComponent.render());
+console.log(MySvelteComponent.render());
 ```
 
 ## Virtual Modules
@@ -239,7 +237,7 @@ plugin({
 
   setup(build) {
     build.module(
-      // The specifier, which can be any string
+      // The specifier, which can be any string - except a built-in, such as "buffer"
       "my-transpiled-virtual-module",
       // The callback to run when the module is imported or required for the first time
       () => {

docs/runtime/shell.md

@@ -0,0 +1,426 @@
+Bun Shell makes shell scripting with JavaScript & TypeScript fun. It's a cross-platform bash-like shell with seamless JavaScript interop.
+
+{% callout type="note" %}
+**Alpha-quality software**: Bun Shell is an unstable API still under development. If you have feature requests or run into bugs, please open an issue. There may be breaking changes in the future.
+{% /callout %}
+
+Quickstart:
+
+```js
+import { $ } from "bun";
+
+const response = await fetch("https://example.com");
+
+// Use Response as stdin.
+await $`echo < ${response} > wc -c`; // 120
+```
+
+## Features:
+
+- **Cross-platform**: works on Windows, Linux & macOS. Instead of `rimraf` or `cross-env`', you can use Bun Shell without installing extra dependencies. Common shell commands like `ls`, `cd`, `rm` are implemented natively.
+- **Familiar**: Bun Shell is a bash-like shell, supporting redirection, pipes, environment variables and more.
+- **Globs**: Glob patterns are supported natively, including `**`, `*`, `{expansion}`, and more.
+- **Template literals**: Template literals are used to execute shell commands. This allows for easy interpolation of variables and expressions.
+- **Safety**: Bun Shell escapes all strings by default, preventing shell injection attacks.
+- **JavaScript interop**: Use `Response`, `ArrayBuffer`, `Blob`, `Bun.file(path)` and other JavaScript objects as stdin, stdout, and stderr.
+
+## Getting started
+
+The simplest shell command is `echo`. To run it, use the `$` template literal tag:
+
+```js
+import { $ } from "bun";
+
+await $`echo "Hello World!"`; // Hello World!
+```
+
+By default, shell commands print to stdout. To quiet the output, call `.quiet()`:
+
+```js
+import { $ } from "bun";
+
+await $`echo "Hello World!"`.quiet(); // No output
+```
+
+What if you want to access the output of the command as text? Use `.text()`:
+
+```js
+import { $ } from "bun";
+
+// .text() automatically calls .quiet() for you
+const welcome = await $`echo "Hello World!"`.text();
+
+console.log(welcome); // Hello World!\n
+```
+
+To get stdout, stderr, and the exit code, use await or `.run`:
+
+```js
+import { $ } from "bun";
+
+const { stdout, stderr, exitCode } = await $`echo "Hello World!"`.quiet();
+
+console.log(stdout); // Buffer(6) [ 72, 101, 108, 108, 111, 32 ]
+console.log(stderr); // Buffer(0) []
+console.log(exitCode); // 0
+```
+
+## Redirection
+
+A command's _input_ or _output_ may be _redirected_ using the typical Bash operators:
+- `<`           redirect stdin 
+- `>` or `1>`   redirect stdout
+- `2>`          redirect stderr
+- `&>`          redirect both stdout and stderr
+- `>>` or `1>>` redirect stdout, _appending_ to the destination, instead of overwriting
+- `2>>`         redirect stderr, _appending_ to the destination, instead of overwriting
+- `&>>`         redirect both stdout and stderr, _appending_ to the destination, instead of overwriting
+- `1>&2`        redirect stdout to stderr (all writes to stdout will instead be in stderr)
+- `2>&1`        redirect stderr to stdout (all writes to stderr will instead be in stdout)
+
+Bun Shell also supports redirecting from and to JavaScript objects.
+
+### Example: Redirect output to JavaScript objects (`>`)
+
+To redirect stdout to a JavaScript object, use the `>` operator:
+
+```js
+import { $ } from "bun";
+
+const buffer = Buffer.alloc(100);
+const result = await $`echo "Hello World!" > ${buffer}`;
+
+console.log(result.exitCode); // 0
+console.log(buffer.toString()); // Hello World!\n
+```
+
+The following JavaScript objects are supported for redirection to:
+
+- `Buffer`, `Uint8Array`, `Uint16Array`, `Uint32Array`, `Int8Array`, `Int16Array`, `Int32Array`, `Float32Array`, `Float64Array`, `ArrayBuffer`, `SharedArrayBuffer` (writes to the underlying buffer)
+- `Bun.file(path)`, `Bun.file(fd)` (writes to the file)
+
+### Example: Redirect input from JavaScript objects (`<`)
+
+To redirect the output from JavaScript objects to stdin, use the `<` operator:
+
+```js
+import { $, file } from "bun";
+
+const response = new Response("hello i am a response body");
+
+const result = await $`cat < ${response}`.text();
+
+console.log(result); // hello i am a response body
+```
+
+The following JavaScript objects are supported for redirection from:
+
+- `Buffer`, `Uint8Array`, `Uint16Array`, `Uint32Array`, `Int8Array`, `Int16Array`, `Int32Array`, `Float32Array`, `Float64Array`, `ArrayBuffer`, `SharedArrayBuffer` (reads from the underlying buffer)
+- `Bun.file(path)`, `Bun.file(fd)` (reads from the file)
+- `Response` (reads from the body)
+
+### Example: Redirect stdin -> file
+
+```js
+import { $ } from "bun"
+
+await $`cat < myfile.txt`
+```
+
+### Example: Redirect stdout -> file
+
+```js
+import { $ } from "bun"
+
+await $`echo bun! > greeting.txt`
+```
+
+### Example: Redirect stderr -> file
+
+```js
+import { $ } from "bun"
+
+await $`bun run index.ts 2> errors.txt`
+```
+
+
+### Example: Redirect stdout -> stderr
+
+```js
+import { $ } from "bun"
+
+// redirects stderr to stdout, so all output
+// will be available on stdout
+await $`bun run ./index.ts 2>&1`
+```
+
+### Example: Redirect stderr -> stdout
+
+```js
+import { $ } from "bun"
+
+// redirects stdout to stderr, so all output
+// will be available on stderr
+await $`bun run ./index.ts 1>&2`
+```
+
+## Piping (`|`)
+
+Like in bash, you can pipe the output of one command to another:
+
+```js
+import { $ } from "bun";
+
+const result = await $`echo "Hello World!" | wc -w`.text();
+
+console.log(result); // 2\n
+```
+
+You can also pipe with JavaScript objects:
+
+```js
+import { $ } from "bun";
+
+const response = new Response("hello i am a response body");
+
+const result = await $`cat < ${response} | wc -w`.text();
+
+console.log(result); // 6\n
+```
+
+## Environment variables
+
+Environment variables can be set like in bash:
+
+```js
+import { $ } from "bun";
+
+await $`FOO=foo bun -e 'console.log(process.env.FOO)'`; // foo\n
+```
+
+You can use string interpolation to set environment variables:
+
+```js
+import { $ } from "bun";
+
+const foo = "bar123";
+
+await $`FOO=${foo + "456"} bun -e 'console.log(process.env.FOO)'`; // bar123456\n
+```
+
+Input is escaped by default, preventing shell injection attacks:
+
+```js
+import { $ } from "bun";
+
+const foo = "bar123; rm -rf /tmp";
+
+await $`FOO=${foo} bun -e 'console.log(process.env.FOO)'`; // bar123; rm -rf /tmp\n
+```
+
+### Changing the environment variables
+
+By default, `process.env` is used as the environment variables for all commands.
+
+You can change the environment variables for a single command by calling `.env()`:
+
+```js
+import { $ } from "bun";
+
+await $`echo $FOO`.env({ ...process.env, FOO: "bar" }); // bar
+```
+
+You can change the default environment variables for all commands by calling `$.env`:
+
+```js
+import { $ } from "bun";
+
+$.env({ FOO: "bar" });
+
+// the globally-set $FOO
+await $`echo $FOO`; // bar
+
+// the locally-set $FOO
+await $`echo $FOO`.env({ FOO: "baz" }); // baz
+```
+
+You can reset the environment variables to the default by calling `$.env()` with no arguments:
+
+```js
+import { $ } from "bun";
+
+$.env({ FOO: "bar" });
+
+// the globally-set $FOO
+await $`echo $FOO`; // bar
+
+// the locally-set $FOO
+await $`echo $FOO`.env(undefined); // ""
+```
+
+### Changing the working directory
+
+You can change the working directory of a command by passing a string to `.cwd()`:
+
+```js
+import { $ } from "bun";
+
+await $`pwd`.cwd("/tmp"); // /tmp
+```
+
+You can change the default working directory for all commands by calling `$.cwd`:
+
+```js
+import { $ } from "bun";
+
+$.cwd("/tmp");
+
+// the globally-set working directory
+await $`pwd`; // /tmp
+
+// the locally-set working directory
+await $`pwd`.cwd("/"); // /
+```
+
+## Reading output
+
+To read the output of a command as a string, use `.text()`:
+
+```js
+import { $ } from "bun";
+
+const result = await $`echo "Hello World!"`.text();
+
+console.log(result); // Hello World!\n
+```
+
+### Reading output as JSON
+
+To read the output of a command as JSON, use `.json()`:
+
+```js
+import { $ } from "bun";
+
+const result = await $`echo '{"foo": "bar"}'`.json();
+
+console.log(result); // { foo: "bar" }
+```
+
+### Reading output line-by-line
+
+To read the output of a command line-by-line, use `.lines()`:
+
+```js
+import { $ } from "bun";
+
+for await (let line of $`echo "Hello World!"`.lines()) {
+  console.log(line); // Hello World!
+}
+```
+
+You can also use `.lines()` on a completed command:
+
+```js
+import { $ } from "bun";
+
+const search = "bun";
+
+for await (let line of $`cat list.txt | grep ${search}`.lines()) {
+  console.log(line);
+}
+```
+
+### Reading output as a Blob
+
+To read the output of a command as a Blob, use `.blob()`:
+
+```js
+import { $ } from "bun";
+
+const result = await $`echo "Hello World!"`.blob();
+
+console.log(result); // Blob(13) { size: 13, type: "text/plain" }
+```
+
+## Builtin Commands
+
+For cross-platform compatibility, Bun Shell implements a set of builtin commands, in addition to reading commands from the PATH environment variable.
+
+- `cd`: change the working directory
+- `ls`: list files in a directory
+- `rm`: remove files and directories
+- `echo`: print text
+- `pwd`: print the working directory
+- `bun`: run bun in bun
+
+**Partially** implemented:
+
+- `mv`: move files and directories (missing cross-device support)
+
+**Not** implemented yet, but planned:
+
+- `mkdir`: create directories
+- `cp`: copy files and directories
+- `cat`: concatenate files
+
+## Utilities
+
+Bun Shell also implements a set of utilities for working with shells.
+
+### `$.braces` (brace expansion)
+
+This function implements simple [brace expansion](https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html) for shell commands:
+
+```js
+import { $ } from "bun";
+
+await $.braces(`echo {1,2,3}`);
+// => ["echo 1", "echo 2", "echo 3"]
+```
+
+### `$.escape` (escape strings)
+
+Exposes Bun Shell's escaping logic as a function:
+
+```js
+import { $ } from "bun";
+
+console.log($.escape('$(foo) `bar` "baz"'))
+// => \$(foo) \`bar\` \"baz\"
+```
+
+If you do not want your string to be escaped, wrap it in a `{ raw: 'str' }` object:
+
+```js
+import { $ } from "bun";
+
+await $`echo ${{ raw: '$(foo) `bar` "baz"' }}`
+// => bun: command not found: foo
+// => bun: command not found: bar
+// => baz
+```
+
+## .bun.sh file loader
+
+For simple shell scripts, instead of `sh`, you can use Bun Shell to run shell scripts.
+
+To do that, run any file with bun that ends with `.bun.sh`:
+
+```sh
+$ echo "echo Hello World!" > script.bun.sh
+$ bun ./script.bun.sh
+> Hello World!
+```
+
+On Windows, Bun Shell is used automatically to run `.sh` files when using Bun:
+
+```sh
+$ echo "echo Hello World!" > script.sh
+# On windows, .bun.sh is not needed, just .sh
+$ bun ./script.sh
+> Hello World!
+```
+
+## Credits
+
+Large parts of this API were inspired by [zx](https://github.com/google/zx), [dax](https://github.com/dsherret/dax), and [bnx](https://github.com/wobsoriano/bnx). Thank you to the authors of those projects.

docs/test/coverage.md

@@ -52,7 +52,7 @@ It is possible to specify a coverage threshold in `bunfig.toml`. If your test su
 coverageThreshold = 0.9
 
 # to set different thresholds for lines and functions
-coverageThreshold = { line = 0.9, function = 0.9 }
+coverageThreshold = { lines = 0.9, functions = 0.9 }
 ```
 
 ### Sourcemaps

docs/test/time.md

@@ -60,7 +60,7 @@ test("unlike in jest", () => {
 To reset the system time, pass no arguments to `setSystemTime`:
 
 ```ts
-import { setSystemTime, beforeAll } from "bun:test";
+import { setSystemTime, expect, test } from "bun:test";
 
 test("it was 2020, for a moment.", () => {
   // Set it to something!

docs/test/writing.md

@@ -109,7 +109,7 @@ $ bun test --todo
 
 ## `test.only`
 
-To run a particular test or suite of tests use `test.only()` or `describe.only()`. Once declared, running `bun test --only` will only execute tests/suites that have been marked with `.only()`.
+To run a particular test or suite of tests use `test.only()` or `describe.only()`. Once declared, running `bun test --only` will only execute tests/suites that have been marked with `.only()`. Running `bun test` without the `--only` option with `test.only()` declared will result in all tests in the given suite being executed _up to_ the test with `.only()`. `describe.only()` functions the same in both execution scenarios.
 
 ```ts
 import { test, describe } from "bun:test";
@@ -135,6 +135,12 @@ The following command will only execute tests #2 and #3.
 $ bun test --only
 ```
 
+The following command will only execute tests #1, #2 and #3.
+
+```sh
+$ bun test
+```
+
 ## `test.if`
 
 To run a test conditionally, use `test.if()`. The test will run if the condition is truthy. This is particularly useful for tests that should only run on specific architectures or operating systems.
@@ -160,6 +166,69 @@ test.skipIf(macOS)("runs on non-macOS", () => {
 });
 ```
 
+## `test.each`
+
+To return a function for multiple cases in a table of tests, use `test.each`.
+
+```ts
+const cases = [[1, 2, 3], [3, 4, 5]];
+
+test.each(cases)("%p + %p should be %p", (a, b, expected) => {
+    // runs once for each test case provided
+})
+```
+
+There are a number of options available for formatting the case label depending on its type.
+
+{% table %}
+
+---
+
+- `%p`
+- [`pretty-format`](https://www.npmjs.com/package/pretty-format)
+
+---
+
+- `%s`
+- String
+
+---
+
+- `%d`
+- Number
+
+---
+
+- `%i`
+- Integer
+
+---
+
+- `%f`
+- Floating point
+
+---
+
+- `%j`
+- JSON
+
+---
+
+- `%o`
+- Object
+
+---
+
+- `%#`
+- Index of the test case
+
+---
+
+- `%%`
+- Single percent sign (`%`)
+
+{% /table %}
+
 ## Matchers
 
 Bun implements the following matchers. Full Jest compatibility is on the roadmap; track progress [here](https://github.com/oven-sh/bun/issues/1825).
@@ -238,7 +307,7 @@ Bun implements the following matchers. Full Jest compatibility is on the roadmap
 
 ---
 
-- ❌
+- ✅
 - [`.extend`](https://jestjs.io/docs/expect#expectextendmatchers)
 
 ---
@@ -258,7 +327,7 @@ Bun implements the following matchers. Full Jest compatibility is on the roadmap
 
 ---
 
-- ❌
+- ✅
 - [`.assertions()`](https://jestjs.io/docs/expect#expectassertionsnumber)
 
 ---
@@ -268,7 +337,7 @@ Bun implements the following matchers. Full Jest compatibility is on the roadmap
 
 ---
 
-- ❌
+- ✅
 - [`.hasAssertions()`](https://jestjs.io/docs/expect#expecthasassertions)
 
 ---

docs/troubleshooting.md

@@ -16,9 +16,9 @@ If you see an error like this:
 
 ![image](https://user-images.githubusercontent.com/709451/141210854-89434678-d21b-42f4-b65a-7df3b785f7b9.png)
 
-It usually means the max number of open file descriptors is being explicitly set to a low number. By default, Bun requests the max number of file descriptors available (which on macOS, is something like 32,000). But, if you previously ran into ulimit issues with, e.g., Chokidar, someone on The Internet may have advised you to run `ulimit -n 8096`.
+It usually means the max number of open file descriptors is being explicitly set to a low number. By default, Bun requests the max number of file descriptors available (which on macOS, is something like 32,000). But, if you previously ran into ulimit issues with, e.g., Chokidar, someone on The Internet may have advised you to run `ulimit -n 8192`.
 
-That advice unfortunately **lowers** the hard limit to `8096`. This can be a problem in large repositories or projects with lots of dependencies. Chokidar (and other watchers) don’t seem to call `setrlimit`, which means they’re reliant on the (much lower) soft limit.
+That advice unfortunately **lowers** the hard limit to `8192`. This can be a problem in large repositories or projects with lots of dependencies. Chokidar (and other watchers) don’t seem to call `setrlimit`, which means they’re reliant on the (much lower) soft limit.
 
 To fix this issue:
 

docs/typescript.md

@@ -17,13 +17,13 @@ Bun supports things like top-level await, JSX, and extensioned `.ts` imports, wh
 ```jsonc
 {
   "compilerOptions": {
-    // enable latest features
+    // Enable latest features
     "lib": ["ESNext"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",
-    "jsx": "react-jsx", // support JSX
-    "allowJs": true, // allow importing `.js` from `.ts`
+    "jsx": "react-jsx",
+    "allowJs": true,
 
     // Bundler mode
     "moduleResolution": "bundler",
@@ -34,18 +34,17 @@ Bun supports things like top-level await, JSX, and extensioned `.ts` imports, wh
     // Best practices
     "strict": true,
     "skipLibCheck": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
 
     // Some stricter flags
-    "useUnknownInCatchVariables": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
     "noPropertyAccessFromIndexSignature": true
   }
 }
 ```
 
-If you run `bun init` in a new directory, this `tsconfig.json` will be generated for you.
+If you run `bun init` in a new directory, this `tsconfig.json` will be generated for you. (The stricter flags are disabled by default.)
 
 ```sh
 $ bun init