implement bun pm pack (#13723)

Co-authored-by: Jarred Sumner <jarred@jarredsumner.com>
Co-authored-by: dylan-conway <dylan-conway@users.noreply.github.com>

.buildkite/scripts/build-bun.sh

@@ -52,4 +52,11 @@ for name in bun bun-profile; do
   run_command mv "$name" "$dir/$name"
   run_command zip -r "$dir.zip" "$dir"
   source "$cwd/.buildkite/scripts/upload-artifact.sh" "$dir.zip"
+  # temporary disable this so CI can run
+  # this is failing because $name is now in $dir/$name and if changed to $dir/$name we get ENOENT reading "bun:internal-for-testing"
+  # if [ "$name" == "bun-profile" ]; then
+  #   export BUN_FEATURE_FLAG_INTERNAL_FOR_TESTING="1"
+  #   run_command "./$name" -e "require('fs').writeFileSync('./features.json', JSON.stringify(require('bun:internal-for-testing').crash_handler.getFeatureData()))"
+  #   source "$cwd/.buildkite/scripts/upload-artifact.sh" "features.json"
+  # fi
 done

.buildkite/scripts/build-cpp.sh

@@ -1,9 +1,11 @@
 #!/bin/bash
 
 set -eo pipefail
-source "$(dirname "$0")/env.sh"
 export FORCE_UPDATE_SUBMODULES=1
-source "$(realpath $(dirname "$0")/../../scripts/update-submodules.sh)"
+
+# env.sh calls update_submodules.sh
+source "$(dirname "$0")/env.sh"
+
 { set +x; } 2>/dev/null
 
 function run_command() {

.buildkite/scripts/build-zig.sh

@@ -1,43 +1,53 @@
 #!/bin/bash
 
-set -eo pipefail
+set -euo pipefail
+
+export CMAKE_FLAGS=""
 source "$(dirname "$0")/env.sh"
 
+if [[ -n "$CMAKE_FLAGS" ]]; then
+  echo "CMAKE_FLAGS should not be empty"
+  exit 1
+fi
+
 function assert_target() {
   local arch="${2-$(uname -m)}"
   case "$(echo "$arch" | tr '[:upper:]' '[:lower:]')" in
-    x64 | x86_64 | amd64)
-      export ZIG_ARCH="x86_64"
-      if [[ "$BUILDKITE_STEP_KEY" == *"baseline"* ]]; then
-        export ZIG_CPU_TARGET="nehalem"
-      else
-        export ZIG_CPU_TARGET="haswell"
-      fi
-      ;;
-    aarch64 | arm64)
-      export ZIG_ARCH="aarch64"
-      export ZIG_CPU_TARGET="native"
-      ;;
-    *)
-      echo "error: Unsupported architecture: $arch" 1>&2
-      exit 1
-      ;;
+  x64 | x86_64 | amd64)
+    export ZIG_ARCH="x86_64"
+    if [[ "$BUILDKITE_STEP_KEY" == *"baseline"* ]]; then
+      export ZIG_CPU_TARGET="nehalem"
+    else
+      export ZIG_CPU_TARGET="haswell"
+    fi
+    ;;
+  aarch64 | arm64)
+    export ZIG_ARCH="aarch64"
+    export ZIG_CPU_TARGET="native"
+    ;;
+  *)
+    echo "error: Unsupported architecture: $arch" 1>&2
+    exit 1
+    ;;
   esac
   local os="${1-$(uname -s)}"
   case "$(echo "$os" | tr '[:upper:]' '[:lower:]')" in
-    linux)
-      export ZIG_OS="linux"
-      export ZIG_TARGET="$ZIG_ARCH-linux-gnu" ;;
-    darwin)
-      export ZIG_OS="macos"
-      export ZIG_TARGET="$ZIG_ARCH-macos-none" ;;
-    windows)
-      export ZIG_OS="windows"
-      export ZIG_TARGET="$ZIG_ARCH-windows-msvc" ;;
-    *)
-      echo "error: Unsupported operating system: $os" 1>&2
-      exit 1
-      ;;
+  linux)
+    export ZIG_OS="linux"
+    export ZIG_TARGET="$ZIG_ARCH-linux-gnu"
+    ;;
+  darwin)
+    export ZIG_OS="macos"
+    export ZIG_TARGET="$ZIG_ARCH-macos-none"
+    ;;
+  windows)
+    export ZIG_OS="windows"
+    export ZIG_TARGET="$ZIG_ARCH-windows-msvc"
+    ;;
+  *)
+    echo "error: Unsupported operating system: $os" 1>&2
+    exit 1
+    ;;
   esac
 }
 
@@ -63,8 +73,7 @@ cd build
 # in buildkite this script to compile for windows is run on a macos machine
 # so the cmake windows detection for this logic is not ran
 ZIG_OPTIMIZE="ReleaseFast"
-if [[ "$ZIG_OS" == "windows" ]]
-then
+if [[ "$ZIG_OS" == "windows" ]]; then
   ZIG_OPTIMIZE="ReleaseSafe"
 fi
 

.buildkite/scripts/download-artifact.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
 
-set -eo pipefail
+set -euo pipefail
 
 function assert_buildkite_agent() {
-  if ! command -v buildkite-agent &> /dev/null; then
+  if ! command -v buildkite-agent &>/dev/null; then
     echo "error: Cannot find buildkite-agent, please install it:"
     echo "https://buildkite.com/docs/agent/v3/install"
     exit 1
@@ -11,25 +11,38 @@ function assert_buildkite_agent() {
 }
 
 function download_buildkite_artifact() {
-  local path="$1"; shift
+  # Check if at least one argument is provided
+  if [ $# -eq 0 ]; then
+    echo "error: No path provided for artifact download"
+    exit 1
+  fi
+
+  local path="$1"
+  shift
   local split="0"
   local args=()
-  while true; do
-    if [ -z "$1" ]; then
-      break
-    fi
+
+  while [ $# -gt 0 ]; do
     case "$1" in
-      --split) split="1"; shift ;;
-      *) args+=("$1"); shift ;;
+    --split)
+      split="1"
+      shift
+      ;;
+    *)
+      args+=("$1")
+      shift
+      ;;
     esac
   done
+
   if [ "$split" == "1" ]; then
-    run_command buildkite-agent artifact download "$path.*" . "${args[@]}"
-    run_command cat $path.?? > "$path"
-    run_command rm -f $path.??
+    run_command buildkite-agent artifact download "$path.*" . "${args[@]:-}"
+    run_command cat "$path".?? >"$path"
+    run_command rm -f "$path".??
   else
-    run_command buildkite-agent artifact download "$path" . "${args[@]}"
+    run_command buildkite-agent artifact download "$path" . "${args[@]:-}"
   fi
+
   if [[ "$path" != *"*"* ]] && [ ! -f "$path" ]; then
     echo "error: Could not find artifact: $path"
     exit 1

.buildkite/scripts/env.sh

@@ -1,32 +1,55 @@
 #!/bin/bash
 
-set -eo pipefail
+set -euo pipefail
+
+BUILDKITE_REPO=${BUILDKITE_REPO:-}
+BUILDKITE_CLEAN_CHECKOUT=${BUILDKITE_CLEAN_CHECKOUT:-}
+BUILDKITE_BRANCH=${BUILDKITE_BRANCH:-}
+CCACHE_DIR=${CCACHE_DIR:-}
+SCCACHE_DIR=${SCCACHE_DIR:-}
+ZIG_LOCAL_CACHE_DIR=${ZIG_LOCAL_CACHE_DIR:-}
+ZIG_GLOBAL_CACHE_DIR=${ZIG_GLOBAL_CACHE_DIR:-}
+BUN_DEPS_CACHE_DIR=${BUN_DEPS_CACHE_DIR:-}
+BUN_DEPS_CACHE_DIR=${BUN_DEPS_CACHE_DIR:-}
+BUILDKITE_STEP_KEY=${BUILDKITE_STEP_KEY:-}
+
+ROOT_DIR="$(realpath "$(dirname "$0")/../../")"
+
+# Fail if we cannot find the root directory
+if [ ! -d "$ROOT_DIR" ]; then
+  echo "error: Cannot find root directory: '$ROOT_DIR'" 1>&2
+  exit 1
+fi
 
 function assert_os() {
   local os="$(uname -s)"
   case "$os" in
-    Linux)
-      echo "linux" ;;
-    Darwin)
-      echo "darwin" ;;
-    *)
-      echo "error: Unsupported operating system: $os" 1>&2
-      exit 1
-      ;;
+  Linux)
+    echo "linux"
+    ;;
+  Darwin)
+    echo "darwin"
+    ;;
+  *)
+    echo "error: Unsupported operating system: $os" 1>&2
+    exit 1
+    ;;
   esac
 }
 
 function assert_arch() {
   local arch="$(uname -m)"
   case "$arch" in
-    aarch64 | arm64)
-      echo "aarch64" ;;
-    x86_64 | amd64)
-      echo "x64" ;;
-    *)
-      echo "error: Unknown architecture: $arch" 1>&2
-      exit 1
-      ;;
+  aarch64 | arm64)
+    echo "aarch64"
+    ;;
+  x86_64 | amd64)
+    echo "x64"
+    ;;
+  *)
+    echo "error: Unknown architecture: $arch" 1>&2
+    exit 1
+    ;;
   esac
 }
 
@@ -63,7 +86,7 @@ function assert_build() {
 }
 
 function assert_buildkite_agent() {
-  if ! command -v buildkite-agent &> /dev/null; then
+  if (! command -v buildkite-agent &>/dev/null); then
     echo "error: Cannot find buildkite-agent, please install it:"
     echo "https://buildkite.com/docs/agent/v3/install"
     exit 1
@@ -71,15 +94,26 @@ function assert_buildkite_agent() {
 }
 
 function export_environment() {
-  source "$(realpath $(dirname "$0")/../../scripts/env.sh)"
-  source "$(realpath $(dirname "$0")/../../scripts/update-submodules.sh)"
+  source "${ROOT_DIR}/scripts/env.sh"
+  source "${ROOT_DIR}/scripts/update-submodules.sh"
+
   { set +x; } 2>/dev/null
   export GIT_SHA="$BUILDKITE_COMMIT"
-  export CCACHE_DIR="$HOME/.cache/ccache/$BUILDKITE_STEP_KEY"
-  export SCCACHE_DIR="$HOME/.cache/sccache/$BUILDKITE_STEP_KEY"
-  export ZIG_LOCAL_CACHE_DIR="$HOME/.cache/zig-cache/$BUILDKITE_STEP_KEY"
-  export ZIG_GLOBAL_CACHE_DIR="$HOME/.cache/zig-cache/$BUILDKITE_STEP_KEY"
-  export BUN_DEPS_CACHE_DIR="$HOME/.cache/bun-deps/$BUILDKITE_STEP_KEY"
+  if [ "$BUILDKITE_CLEAN_CHECKOUT" == "true" ] || [ "$BUILDKITE_BRANCH" == "main" ]; then
+    local tmpdir="$(mktemp -d 2>/dev/null || mktemp -d -t 'new')"
+    export CCACHE_DIR="$tmpdir/.cache/ccache"
+    export SCCACHE_DIR="$tmpdir/.cache/sccache"
+    export ZIG_LOCAL_CACHE_DIR="$tmpdir/.cache/zig-cache"
+    export ZIG_GLOBAL_CACHE_DIR="$tmpdir/.cache/zig-cache"
+    export BUN_DEPS_CACHE_DIR="$tmpdir/.cache/bun-deps"
+    export CCACHE_RECACHE="1"
+  else
+    export CCACHE_DIR="$HOME/.cache/ccache/$BUILDKITE_STEP_KEY"
+    export SCCACHE_DIR="$HOME/.cache/sccache/$BUILDKITE_STEP_KEY"
+    export ZIG_LOCAL_CACHE_DIR="$HOME/.cache/zig-cache/$BUILDKITE_STEP_KEY"
+    export ZIG_GLOBAL_CACHE_DIR="$HOME/.cache/zig-cache/$BUILDKITE_STEP_KEY"
+    export BUN_DEPS_CACHE_DIR="$HOME/.cache/bun-deps/$BUILDKITE_STEP_KEY"
+  fi
   if [ "$(assert_os)" == "linux" ]; then
     export USE_LTO="ON"
   fi
@@ -90,30 +124,21 @@ function export_environment() {
   else
     export CPU_TARGET="haswell"
   fi
-  if $(buildkite-agent meta-data exists release &> /dev/null); then
+  if $(buildkite-agent meta-data exists release &>/dev/null); then
     export CMAKE_BUILD_TYPE="$(buildkite-agent meta-data get release)"
   else
     export CMAKE_BUILD_TYPE="Release"
   fi
-  if $(buildkite-agent meta-data exists canary &> /dev/null); then
+  if $(buildkite-agent meta-data exists canary &>/dev/null); then
     export CANARY="$(buildkite-agent meta-data get canary)"
   else
     export CANARY="1"
   fi
-  if $(buildkite-agent meta-data exists assertions &> /dev/null); then
+  if $(buildkite-agent meta-data exists assertions &>/dev/null); then
     export USE_DEBUG_JSC="$(buildkite-agent meta-data get assertions)"
   else
     export USE_DEBUG_JSC="OFF"
   fi
-  if [ "$BUILDKITE_CLEAN_CHECKOUT" == "true" || "$BUILDKITE_BRANCH" == "main" ]; then
-    rm -rf "$CCACHE_DIR"
-    rm -rf "$SCCACHE_DIR"
-    rm -rf "$ZIG_LOCAL_CACHE_DIR"
-    rm -rf "$ZIG_GLOBAL_CACHE_DIR"
-    rm -rf "$BUN_DEPS_CACHE_DIR"
-    mkdir -p "$BUN_DEPS_CACHE_DIR"
-    export CCACHE_RECACHE="1"
-  fi
 }
 
 assert_build

.buildkite/scripts/upload-artifact.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
 
-set -eo pipefail
+set -euo pipefail
 
 function assert_buildkite_agent() {
-  if ! command -v buildkite-agent &> /dev/null; then
+  if ! command -v buildkite-agent &>/dev/null; then
     echo "error: Cannot find buildkite-agent, please install it:"
     echo "https://buildkite.com/docs/agent/v3/install"
     exit 1
@@ -11,7 +11,7 @@ function assert_buildkite_agent() {
 }
 
 function assert_split() {
-  if ! command -v split &> /dev/null; then
+  if ! command -v split &>/dev/null; then
     echo "error: Cannot find split, please install it:"
     echo "https://www.gnu.org/software/coreutils/split"
     exit 1
@@ -19,16 +19,27 @@ function assert_split() {
 }
 
 function upload_buildkite_artifact() {
-  local path="$1"; shift
+  if [ -z "${1:-}" ]; then
+    return
+  fi
+
+  local path="$1"
+  shift
   local split="0"
-  local args=()
+  local args=() # Initialize args as an empty array
   while true; do
-    if [ -z "$1" ]; then
+    if [ -z "${1:-}" ]; then
       break
     fi
     case "$1" in
-      --split) split="1"; shift ;;
-      *) args+=("$1"); shift ;;
+    --split)
+      split="1"
+      shift
+      ;;
+    *)
+      args+=("$1")
+      shift
+      ;;
     esac
   done
   if [ ! -f "$path" ]; then
@@ -38,9 +49,15 @@ function upload_buildkite_artifact() {
   if [ "$split" == "1" ]; then
     run_command rm -f "$path."*
     run_command split -b 50MB -d "$path" "$path."
-    run_command buildkite-agent artifact upload "$path.*" "${args[@]}"
+    if [ "${args[@]:-}" != "" ]; then
+      run_command buildkite-agent artifact upload "$path.*" "${args[@]}"
+    else
+      run_command buildkite-agent artifact upload "$path.*"
+    fi
+  elif [ "${args[@]:-}" != "" ]; then
+    run_command buildkite-agent artifact upload "$path" "${args[@]:-}"
   else
-    run_command buildkite-agent artifact upload "$path" "${args[@]}"
+    run_command buildkite-agent artifact upload "$path"
   fi
 }
 

.gitattributes

@@ -7,6 +7,7 @@
 *.cpp text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.cc text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.yml text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.toml text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.zig text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.rs text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.h text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
@@ -45,3 +46,6 @@ examples/**/* linguist-documentation
 
 src/deps/*.c linguist-vendored
 src/deps/brotli/** linguist-vendored
+
+test/js/node/test/fixtures linguist-vendored
+test/js/node/test/common linguist-vendored

.github/ISSUE_TEMPLATE/7-install-crash-report.yml

@@ -2,11 +2,18 @@ name: bun install crash report
 description: Report a crash in bun install
 labels:
   - npm
+  - crash
 body:
   - type: markdown
     attributes:
       value: |
         **Thank you so much** for submitting a crash report. You're helping us make Bun more reliable for everyone!
+  - type: textarea
+    id: package_json
+    attributes:
+      label: `package.json` file
+      description: Can you upload your `package.json` file? This helps us reproduce the crash.
+      render: json
   - type: textarea
     id: repro
     attributes:

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

@@ -42,7 +42,7 @@ runs:
           canary) release="canary";;
           *)      release="bun-v${{ inputs.bun-version }}";;
         esac
-        curl -LO "${{ inputs.download-url }}/${release}/${target}.zip"
+        curl -LO "${{ inputs.download-url }}/${release}/${target}.zip" --retry 5
         unzip ${target}.zip
         mkdir -p ${{ runner.temp }}/.bun/bin
         mv ${target}/bun* ${{ runner.temp }}/.bun/bin/

.github/workflows/format.yml

@@ -0,0 +1,61 @@
+name: Format
+
+permissions:
+  contents: write
+
+concurrency:
+  group: format-${{ github.workflow }}-${{ github.event_name == 'workflow_dispatch' && inputs.run-id  || github.ref }}
+  cancel-in-progress: true
+
+on:
+  workflow_dispatch:
+    inputs:
+      run-id:
+        type: string
+        description: The workflow ID to download artifacts (skips the build step)
+  pull_request:
+
+jobs:
+  format:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            .prettierrc-ci
+            .github
+            .vscode
+            src
+            scripts
+            packages
+            test
+            bench
+            package.json
+            bun.lockb
+            .clang-format
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "1.1.25"
+      - name: Setup Zig
+        uses: mlugg/setup-zig@v1
+        with:
+          version: 0.13.0
+      - name: Install Dependencies
+        run: |
+          bun install
+      - name: Format
+        run: |
+          bun fmt
+      - name: Format Zig
+        run: |
+          bun fmt:zig
+      - name: Format Cpp
+        run: |
+          bun fmt:cpp
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: Apply formatting changes

.github/workflows/labeled.yml

@@ -7,6 +7,42 @@ on:
     types: [labeled]
 
 jobs:
+  # on-bug:
+  #   runs-on: ubuntu-latest
+  #   if: github.event.label.name == 'bug' || github.event.label.name == 'crash'
+  #   permissions:
+  #     issues: write
+  #   steps:
+  #     - name: Checkout
+  #       uses: actions/checkout@v4
+  #       with:
+  #         sparse-checkout: |
+  #           scripts
+  #           .github
+  #           CMakeLists.txt
+  #     - name: Setup Bun
+  #       uses: ./.github/actions/setup-bun
+  #       with:
+  #         bun-version: "1.1.24"
+  #     - name: "categorize bug"
+  #       id: add-labels
+  #       env:
+  #         GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+  #         GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
+  #         ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+  #       shell: bash
+  #       run: |
+  #         echo '{"dependencies": { "@anthropic-ai/sdk": "latest" }}' > scripts/package.json && bun install --cwd=./scripts
+  #         LABELS=$(bun scripts/label-issue.ts)
+  #         echo "labels=$LABELS" >> $GITHUB_OUTPUT
+  #     - name: Add labels
+  #       uses: actions-cool/issues-helper@v3
+  #       if: steps.add-labels.outputs.labels != ''
+  #       with:
+  #         actions: "add-labels"
+  #         token: ${{ secrets.GITHUB_TOKEN }}
+  #         issue-number: ${{ github.event.issue.number }}
+  #         labels: ${{ steps.add-labels.outputs.labels }}
   on-labeled:
     runs-on: ubuntu-latest
     if: github.event.label.name == 'crash' || github.event.label.name == 'needs repro'

.github/workflows/release.yml

@@ -88,6 +88,9 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          # To workaround issue
+          ref: main
       - name: Setup Bun
         uses: ./.github/actions/setup-bun
         with:

.github/workflows/run-format.yml

@@ -14,22 +14,26 @@ jobs:
   format:
     name: Format
     runs-on: ubuntu-latest
-    if: ${{ github.ref != 'refs/heads/main' }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
         with:
           sparse-checkout: |
+            .prettierrc-ci
             .github
+            .vscode
             src
             scripts
             packages
             test
             bench
+            package.json
+            bun.lockb
+            .clang-format
       - name: Setup Bun
         uses: ./.github/actions/setup-bun
         with:
-          bun-version: "1.1.20"
+          bun-version: "1.1.25"
       - name: Setup Zig
         uses: mlugg/setup-zig@v1
         with:
@@ -43,9 +47,9 @@ jobs:
       - name: Format Zig
         run: |
           bun fmt:zig
-      - name: Generate submodule versions
+      - name: Format Cpp
         run: |
-          bash ./scripts/write-versions.sh
+          bun fmt:cpp
       - name: Commit
         uses: stefanzweifel/git-auto-commit-action@v5
         with:

.github/workflows/run-lint-cpp.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Bun
         uses: ./.github/actions/setup-bun
         with:
-          bun-version: latest
+          bun-version: 1.1.23
       - name: Install Dependencies
         env:
           HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1

.prettierignore

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

.prettierrc-ci

@@ -0,0 +1,31 @@
+{
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "trailingComma": "all",
+  "useTabs": false,
+  "quoteProps": "preserve",
+  "plugins": [
+    "prettier-plugin-organize-imports"
+  ],
+  "overrides": [
+    {
+      "files": [
+        ".vscode/*.json"
+      ],
+      "options": {
+        "parser": "jsonc",
+        "quoteProps": "preserve",
+        "singleQuote": false,
+        "trailingComma": "all"
+      }
+    },
+    {
+      "files": [
+        "*.md"
+      ],
+      "options": {
+        "printWidth": 80
+      }
+    }
+  ]
+}

.vscode/settings.json

@@ -15,6 +15,9 @@
     "src/bun.js/WebKit": true,
     "src/deps/*/**": true,
     "test/node.js/upstream": true,
+    // This will fill up your whole search history.
+    "test/js/node/test/fixtures": true,
+    "test/js/node/test/common": true,
   },
   "search.followSymlinks": false,
   "search.useIgnoreFiles": true,
@@ -58,6 +61,7 @@
   "[h]": {
     "editor.defaultFormatter": "xaver.clang-format",
   },
+  "clangd.arguments": ["-header-insertion=never"],
 
   // JavaScript
   "prettier.enable": true,
@@ -135,6 +139,7 @@
   },
   "files.associations": {
     "*.idl": "cpp",
+    "array": "cpp",
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,

CMakeLists.txt

@@ -3,8 +3,8 @@ cmake_policy(SET CMP0091 NEW)
 cmake_policy(SET CMP0067 NEW)
 
 set(CMAKE_POLICY_DEFAULT_CMP0069 NEW)
-set(Bun_VERSION "1.1.23")
-set(WEBKIT_TAG a060f087c2232fb20d82c321d21e074e735d3261)
+set(Bun_VERSION "1.1.27")
+set(WEBKIT_TAG 147ed53838e21525677492c27099567a6cd19c6b)
 
 set(BUN_WORKDIR "${CMAKE_CURRENT_BINARY_DIR}")
 message(STATUS "Configuring Bun ${Bun_VERSION} in ${BUN_WORKDIR}")
@@ -29,7 +29,10 @@ cmake_path(APPEND LOCAL_ZIG_CACHE_DIR "local")
 cmake_path(APPEND GLOBAL_ZIG_CACHE_DIR "global")
 
 # Used in process.version, process.versions.node, napi, and elsewhere
-set(REPORTED_NODEJS_VERSION "22.3.0")
+set(REPORTED_NODEJS_VERSION "22.6.0")
+
+# Used in process.versions.modules and compared while loading V8 modules
+set(REPORTED_NODEJS_ABI_VERSION "127")
 
 # WebKit uses -std=gnu++20 on non-macOS non-Windows
 # If we do not set this, it will crash at startup on the first memory allocation.
@@ -664,6 +667,7 @@ file(GLOB BUN_CPP ${CONFIGURE_DEPENDS}
     "${BUN_SRC}/bun.js/bindings/sqlite/*.cpp"
     "${BUN_SRC}/bun.js/bindings/webcrypto/*.cpp"
     "${BUN_SRC}/bun.js/bindings/webcrypto/*/*.cpp"
+    "${BUN_SRC}/bun.js/bindings/v8/*.cpp"
     "${BUN_SRC}/deps/picohttpparser/picohttpparser.c"
 )
 list(APPEND BUN_RAW_SOURCES ${BUN_CPP})
@@ -824,6 +828,7 @@ if(NOT NO_CODEGEN)
         "${BUN_SRC}/js/thirdparty/*.ts"
         "${BUN_SRC}/js/internal/*.js"
         "${BUN_SRC}/js/internal/*.ts"
+        "${BUN_SRC}/js/internal/cluster/*.ts"
         "${BUN_SRC}/js/internal/util/*.js"
         "${BUN_SRC}/js/internal/fs/*.ts"
         "${BUN_SRC}/js/node/*.js"
@@ -1030,7 +1035,6 @@ add_compile_definitions(
     "LIBUS_USE_BORINGSSL=1"
     "WITH_BORINGSSL=1"
     "STATICALLY_LINKED_WITH_JavaScriptCore=1"
-    "STATICALLY_LINKED_WITH_WTF=1"
     "STATICALLY_LINKED_WITH_BMALLOC=1"
     "BUILDING_WITH_CMAKE=1"
     "JSC_OBJC_API_ENABLED=0"
@@ -1041,6 +1045,7 @@ add_compile_definitions(
     "BUILDING_JSCONLY__"
     "BUN_DYNAMIC_JS_LOAD_PATH=\"${BUN_WORKDIR}/js\""
     "REPORTED_NODEJS_VERSION=\"${REPORTED_NODEJS_VERSION}\""
+    "REPORTED_NODEJS_ABI_VERSION=${REPORTED_NODEJS_ABI_VERSION}"
 )
 
 if(NOT ASSERT_ENABLED)
@@ -1373,19 +1378,6 @@ if(CMAKE_BUILD_TYPE STREQUAL "Release" AND NOT WIN32 AND NOT ASSERT_ENABLED)
     )
 endif()
 
-if(WIN32)
-    # Kill all instances of bun before linking.
-    # This is necessary because the file is locked by the process.
-    add_custom_command(
-        TARGET ${bun}
-        PRE_LINK
-        COMMAND
-        "powershell"
-        "/C"
-        "Stop-Process -Name '${bun}' -Force -ErrorAction SilentlyContinue; exit 0"
-    )
-endif()
-
 # --- Dependencies ---
 if(USE_CUSTOM_ZLIB)
     include_directories(${BUN_DEPS_DIR}/zlib)
@@ -1628,12 +1620,14 @@ endif()
 
 if(BUN_TIDY_ONLY)
     find_program(CLANG_TIDY_EXE NAMES "clang-tidy")
-    set(CLANG_TIDY_COMMAND "${CLANG_TIDY_EXE}" "-checks=-*,clang-analyzer-*,-clang-analyzer-webkit.UncountedLambdaCapturesChecker" "--fix" "--fix-errors" "--format-style=webkit" "--warnings-as-errors=*")
+
+    # webkit ones are disabled disabled because it's noisy, e.g. for JavaScriptCore/Lookup.h
+    set(CLANG_TIDY_COMMAND "${CLANG_TIDY_EXE}" "-checks=-*,clang-analyzer-*,-clang-analyzer-webkit.UncountedLambdaCapturesChecker,-clang-analyzer-optin.core.EnumCastOutOfRange,-clang-analyzer-webkit.RefCntblBaseVirtualDtor" "--fix" "--fix-errors" "--format-style=webkit" "--warnings-as-errors=*")
     set_target_properties(${bun} PROPERTIES CXX_CLANG_TIDY "${CLANG_TIDY_COMMAND}")
 endif()
 
 if(BUN_TIDY_ONLY_EXTRA)
     find_program(CLANG_TIDY_EXE NAMES "clang-tidy")
-    set(CLANG_TIDY_COMMAND "${CLANG_TIDY_EXE}" "-checks=-*,clang-analyzer-*,performance-*,-clang-analyzer-webkit.UncountedLambdaCapturesChecker" "--fix" "--fix-errors" "--format-style=webkit" "--warnings-as-errors=*")
+    set(CLANG_TIDY_COMMAND "${CLANG_TIDY_EXE}" "-checks=-*,clang-analyzer-*,performance-*,-clang-analyzer-webkit.UncountedLambdaCapturesChecker,-clang-analyzer-optin.core.EnumCastOutOfRange,-clang-analyzer-webkit.RefCntblBaseVirtualDtor" "--fix" "--fix-errors" "--format-style=webkit" "--warnings-as-errors=*")
     set_target_properties(${bun} PROPERTIES CXX_CLANG_TIDY "${CLANG_TIDY_COMMAND}")
 endif()

CONTRIBUTING.md

@@ -63,7 +63,7 @@ Bun requires LLVM 16 (`clang` is part of LLVM). This version requirement is to m
 {% codetabs %}
 
 ```bash#macOS (Homebrew)
-$ brew install llvm@16
+$ brew install llvm@18
 ```
 
 ```bash#Ubuntu/Debian

LATEST

@@ -1 +1 @@
-1.1.22
+1.1.26

Makefile

@@ -366,7 +366,7 @@ ifeq ($(OS_NAME),linux)
 endif
 
 ifeq ($(OS_NAME),darwin)
-MACOS_MIN_FLAG=-mmacosx-version-min=$(MIN_MACOS_VERSION)
+MACOS_MIN_FLAG=-mmacos-version-min=$(MIN_MACOS_VERSION)
 POSIX_PKG_MANAGER=brew
 INCLUDE_DIRS += $(MAC_INCLUDE_DIRS)
 endif

README.md

@@ -24,8 +24,6 @@
 
 ## 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 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.
@@ -87,16 +85,19 @@ bun upgrade --canary
 ## Quick links
 
 - Intro
+
   - [What is Bun?](https://bun.sh/docs/index)
   - [Installation](https://bun.sh/docs/installation)
   - [Quickstart](https://bun.sh/docs/quickstart)
   - [TypeScript](https://bun.sh/docs/typescript)
 
 - Templating
+
   - [`bun init`](https://bun.sh/docs/cli/init)
   - [`bun create`](https://bun.sh/docs/cli/bun-create)
 
 - Runtime
+
   - [`bun run`](https://bun.sh/docs/cli/run)
   - [File types](https://bun.sh/docs/runtime/loaders)
   - [TypeScript](https://bun.sh/docs/runtime/typescript)
@@ -115,6 +116,7 @@ bun upgrade --canary
   - [Framework API](https://bun.sh/docs/runtime/framework)
 
 - Package manager
+
   - [`bun install`](https://bun.sh/docs/cli/install)
   - [`bun add`](https://bun.sh/docs/cli/add)
   - [`bun remove`](https://bun.sh/docs/cli/remove)
@@ -130,6 +132,7 @@ bun upgrade --canary
   - [Overrides and resolutions](https://bun.sh/docs/install/overrides)
 
 - Bundler
+
   - [`Bun.build`](https://bun.sh/docs/bundler)
   - [Loaders](https://bun.sh/docs/bundler/loaders)
   - [Plugins](https://bun.sh/docs/bundler/plugins)
@@ -137,6 +140,7 @@ bun upgrade --canary
   - [vs esbuild](https://bun.sh/docs/bundler/vs-esbuild)
 
 - Test runner
+
   - [`bun test`](https://bun.sh/docs/cli/test)
   - [Writing tests](https://bun.sh/docs/test/writing)
   - [Watch mode](https://bun.sh/docs/test/hot)
@@ -148,9 +152,11 @@ bun upgrade --canary
   - [Code coverage](https://bun.sh/docs/test/coverage)
 
 - Package runner
+
   - [`bunx`](https://bun.sh/docs/cli/bunx)
 
 - API
+
   - [HTTP server](https://bun.sh/docs/api/http)
   - [WebSockets](https://bun.sh/docs/api/websockets)
   - [Workers](https://bun.sh/docs/api/workers)
@@ -183,9 +189,10 @@ bun upgrade --canary
   - [Building Windows](https://bun.sh/docs/project/building-windows)
   - [License](https://bun.sh/docs/project/licensing)
 
-## Guides 
+## Guides
+
+- Binary
 
-- Binary 
   - [Convert a Blob to a DataView](https://bun.sh/guides/binary/blob-to-dataview)
   - [Convert a Blob to a ReadableStream](https://bun.sh/guides/binary/blob-to-stream)
   - [Convert a Blob to a string](https://bun.sh/guides/binary/blob-to-string)
@@ -209,7 +216,8 @@ bun upgrade --canary
   - [Convert an ArrayBuffer to a Uint8Array](https://bun.sh/guides/binary/arraybuffer-to-typedarray)
   - [Convert an ArrayBuffer to an array of numbers](https://bun.sh/guides/binary/arraybuffer-to-array)
 
-- Ecosystem 
+- Ecosystem
+
   - [Build a frontend using Vite and Bun](https://bun.sh/guides/ecosystem/vite)
   - [Build an app with Astro and Bun](https://bun.sh/guides/ecosystem/astro)
   - [Build an app with Next.js and Bun](https://bun.sh/guides/ecosystem/nextjs)
@@ -236,7 +244,8 @@ bun upgrade --canary
   - [Use React and JSX](https://bun.sh/guides/ecosystem/react)
   - [Add Sentry to a Bun app](https://bun.sh/guides/ecosystem/sentry)
 
-- HTTP 
+- HTTP
+
   - [Common HTTP server usage](https://bun.sh/guides/http/server)
   - [Configure TLS on an HTTP server](https://bun.sh/guides/http/tls)
   - [fetch with unix domain sockets in Bun](https://bun.sh/guides/http/fetch-unix)
@@ -250,7 +259,8 @@ bun upgrade --canary
   - [Upload files via HTTP using FormData](https://bun.sh/guides/http/file-uploads)
   - [Write a simple HTTP server](https://bun.sh/guides/http/simple)
 
-- Install 
+- Install
+
   - [Add a dependency](https://bun.sh/guides/install/add)
   - [Add a development dependency](https://bun.sh/guides/install/add-dev)
   - [Add a Git dependency](https://bun.sh/guides/install/add-git)
@@ -268,7 +278,8 @@ bun upgrade --canary
   - [Using bun install with an Azure Artifacts npm registry](https://bun.sh/guides/install/azure-artifacts)
   - [Using bun install with Artifactory](https://bun.sh/guides/install/jfrog-artifactory)
 
-- Process 
+- Process
+
   - [Get the process uptime in nanoseconds](https://bun.sh/guides/process/nanoseconds)
   - [Listen for CTRL+C](https://bun.sh/guides/process/ctrl-c)
   - [Listen to OS signals](https://bun.sh/guides/process/os-signals)
@@ -279,7 +290,8 @@ bun upgrade --canary
   - [Spawn a child process](https://bun.sh/guides/process/spawn)
   - [Spawn a child process and communicate using IPC](https://bun.sh/guides/process/ipc)
 
-- Read file 
+- Read file
+
   - [Check if a file exists](https://bun.sh/guides/read-file/exists)
   - [Get the MIME type of a file](https://bun.sh/guides/read-file/mime)
   - [Read a file as a ReadableStream](https://bun.sh/guides/read-file/stream)
@@ -290,7 +302,8 @@ bun upgrade --canary
   - [Read a JSON file](https://bun.sh/guides/read-file/json)
   - [Watch a directory for changes](https://bun.sh/guides/read-file/watch)
 
-- Runtime 
+- Runtime
+
   - [Debugging Bun with the VS Code extension](https://bun.sh/guides/runtime/vscode-debugger)
   - [Debugging Bun with the web debugger](https://bun.sh/guides/runtime/web-debugger)
   - [Define and replace static globals & constants](https://bun.sh/guides/runtime/define-constant)
@@ -305,7 +318,8 @@ bun upgrade --canary
   - [Set a time zone in Bun](https://bun.sh/guides/runtime/timezone)
   - [Set environment variables](https://bun.sh/guides/runtime/set-env)
 
-- Streams 
+- Streams
+
   - [Convert a Node.js Readable to a Blob](https://bun.sh/guides/streams/node-readable-to-blob)
   - [Convert a Node.js Readable to a string](https://bun.sh/guides/streams/node-readable-to-string)
   - [Convert a Node.js Readable to an ArrayBuffer](https://bun.sh/guides/streams/node-readable-to-arraybuffer)
@@ -318,7 +332,8 @@ bun upgrade --canary
   - [Convert a ReadableStream to an ArrayBuffer](https://bun.sh/guides/streams/to-arraybuffer)
   - [Convert a ReadableStream to JSON](https://bun.sh/guides/streams/to-json)
 
-- Test 
+- Test
+
   - [Bail early with the Bun test runner](https://bun.sh/guides/test/bail)
   - [Generate code coverage reports with the Bun test runner](https://bun.sh/guides/test/coverage)
   - [Mark a test as a "todo" with the Bun test runner](https://bun.sh/guides/test/todo-tests)
@@ -336,7 +351,8 @@ bun upgrade --canary
   - [Use snapshot testing in `bun test`](https://bun.sh/guides/test/snapshot)
   - [Write browser DOM tests with Bun and happy-dom](https://bun.sh/guides/test/happy-dom)
 
-- Util 
+- Util
+
   - [Check if the current file is the entrypoint](https://bun.sh/guides/util/entrypoint)
   - [Check if two objects are deeply equal](https://bun.sh/guides/util/deep-equals)
   - [Compress and decompress data with DEFLATE](https://bun.sh/guides/util/deflate)
@@ -355,13 +371,14 @@ bun upgrade --canary
   - [Hash a password](https://bun.sh/guides/util/hash-a-password)
   - [Sleep for a fixed number of milliseconds](https://bun.sh/guides/util/sleep)
 
-- WebSocket 
+- WebSocket
+
   - [Build a publish-subscribe WebSocket server](https://bun.sh/guides/websocket/pubsub)
   - [Build a simple WebSocket server](https://bun.sh/guides/websocket/simple)
   - [Enable compression for WebSocket messages](https://bun.sh/guides/websocket/compression)
   - [Set per-socket contextual data on a WebSocket](https://bun.sh/guides/websocket/context)
 
-- Write file 
+- Write file
   - [Append content to a file](https://bun.sh/guides/write-file/append)
   - [Copy a file to another location](https://bun.sh/guides/write-file/file-cp)
   - [Delete a file](https://bun.sh/guides/write-file/unlink)

bench/async/bun.js

@@ -1,4 +1,4 @@
-import { run, bench } from "mitata";
+import { bench, run } from "mitata";
 
 bench("sync", () => {});
 bench("async", async () => {});

bench/async/deno.js

@@ -1,4 +1,4 @@
-import { run, bench } from "../node_modules/mitata/src/cli.mjs";
+import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 
 bench("sync", () => {});
 bench("async", async () => {});

bench/async/node.mjs

@@ -1,4 +1,4 @@
-import { run, bench } from "mitata";
+import { bench, run } from "mitata";
 
 bench("sync", () => {});
 bench("async", async () => {});

bench/copyfile/node.mitata.mjs

@@ -1,5 +1,5 @@
-import { copyFileSync, writeFileSync, readFileSync, statSync } from "node:fs";
 import { bench, run } from "mitata";
+import { copyFileSync, statSync, writeFileSync } from "node:fs";
 
 function runner(ready) {
   for (let size of [1, 10, 100, 1000, 10000, 100000, 1000000, 10000000]) {

bench/deepEqual/map.js

@@ -0,0 +1,27 @@
+import { expect } from "bun:test";
+import { bench, run } from "mitata";
+
+const MAP_SIZE = 10_000;
+
+function* genPairs(count) {
+  for (let i = 0; i < MAP_SIZE; i++) {
+    yield ["k" + i, "v" + i];
+  }
+}
+
+class CustomMap extends Map {
+  abc = 123;
+  constructor(iterable) {
+    super(iterable);
+  }
+}
+
+const a = new Map(genPairs());
+const b = new Map(genPairs());
+bench("deepEqual Map", () => expect(a).toEqual(b));
+
+const x = new CustomMap(genPairs());
+const y = new CustomMap(genPairs());
+bench("deepEqual CustomMap", () => expect(x).toEqual(y));
+
+await run();

bench/deepEqual/set.js

@@ -0,0 +1,27 @@
+import { expect } from "bun:test";
+import { bench, run } from "mitata";
+
+const SET_SIZE = 10_000;
+
+function* genValues(count) {
+  for (let i = 0; i < SET_SIZE; i++) {
+    yield "v" + i;
+  }
+}
+
+class CustomSet extends Set {
+  abc = 123;
+  constructor(iterable) {
+    super(iterable);
+  }
+}
+
+const a = new Set(genValues());
+const b = new Set(genValues());
+bench("deepEqual Set", () => expect(a).toEqual(b));
+
+const x = new CustomSet(genValues());
+const y = new CustomSet(genValues());
+bench("deepEqual CustomSet", () => expect(x).toEqual(y));
+
+await run();

bench/emitter/implementations.mjs

@@ -1,4 +1,3 @@
-import EventEmitter3 from "eventemitter3";
 import { group } from "mitata";
 import EventEmitterNative from "node:events";
 

bench/expect-to-equal/expect-to-equal.test.js

@@ -1,5 +1,5 @@
 // bun:test automatically rewrites this import to bun:test when run in bun
-import { test, expect } from "@jest/globals";
+import { expect, test } from "@jest/globals";
 
 const N = parseInt(process.env.RUN_COUNT || "10000", 10);
 if (!Number.isSafeInteger(N)) {

bench/expect-to-equal/expect-to-equal.vitest.test.js

@@ -1,4 +1,4 @@
-import { test, expect } from "vitest";
+import { expect, test } from "vitest";
 
 const N = parseInt(process.env.RUN_COUNT || "10000", 10);
 if (!Number.isSafeInteger(N)) {

bench/ffi/bun.js

@@ -1,5 +1,5 @@
-import { ptr, dlopen, CString, toBuffer } from "bun:ffi";
-import { run, bench, group } from "mitata";
+import { CString, dlopen, ptr } from "bun:ffi";
+import { bench, group, run } from "mitata";
 
 const { napiNoop, napiHash, napiString } = require(import.meta.dir + "/src/ffi_napi_bench.node");
 

bench/ffi/deno.js

@@ -1,4 +1,4 @@
-import { run, bench, group } from "../node_modules/mitata/src/cli.mjs";
+import { bench, group, run } from "../node_modules/mitata/src/cli.mjs";
 
 const extension = "darwin" !== Deno.build.os ? "so" : "dylib";
 const path = new URL("src/target/release/libffi_napi_bench." + extension, import.meta.url).pathname;

bench/ffi/node.mjs

@@ -1,4 +1,4 @@
-import { run, bench, group } from "mitata";
+import { bench, group, run } from "mitata";
 import { createRequire } from "node:module";
 
 const require = createRequire(import.meta.url);

bench/glob/braces.mjs

@@ -1,5 +1,5 @@
 import braces from "braces";
-import { group, bench, run } from "mitata";
+import { bench, group, run } from "mitata";
 
 // const iterations = 1000;
 const iterations = 100;

bench/glob/scan.mjs

@@ -1,6 +1,6 @@
-import { run, bench, group } from "mitata";
 import fg from "fast-glob";
 import { fdir } from "fdir";
+import { bench, group, run } from "mitata";
 
 const normalPattern = "*.ts";
 const recursivePattern = "**/*.ts";

bench/gzip/bun.js

@@ -1,5 +1,5 @@
-import { run, bench, group } from "mitata";
-import { gzipSync, gunzipSync } from "bun";
+import { gunzipSync, gzipSync } from "bun";
+import { bench, group, run } from "mitata";
 
 const data = await Bun.file(require.resolve("@babel/standalone/babel.min.js")).arrayBuffer();
 

bench/gzip/deno.js

@@ -1,4 +1,4 @@
-import { run, bench } from "../node_modules/mitata/src/cli.mjs";
+import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 
 const data = new TextEncoder().encode("Hello World!".repeat(9999));
 

bench/gzip/node.mjs

@@ -1,7 +1,7 @@
-import { run, bench } from "mitata";
-import { gzipSync, gunzipSync } from "zlib";
-import { createRequire } from "module";
 import { readFileSync } from "fs";
+import { bench, run } from "mitata";
+import { createRequire } from "module";
+import { gunzipSync, gzipSync } from "zlib";
 
 const require = createRequire(import.meta.url);
 const data = readFileSync(require.resolve("@babel/standalone/babel.min.js"));

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

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

bench/install/app/entry.server.tsx

@@ -4,11 +4,11 @@
  * For more information, see https://remix.run/docs/en/main/file-conventions/entry.server
  */
 
-import { PassThrough } from "node:stream";
 import type { EntryContext } from "@remix-run/node";
 import { Response } from "@remix-run/node";
 import { RemixServer } from "@remix-run/react";
 import isbot from "isbot";
+import { PassThrough } from "node:stream";
 import { renderToPipeableStream } from "react-dom/server";
 
 const ABORT_DELAY = 5_000;

bench/modules/node_os/bun.js

@@ -1,21 +1,21 @@
 import { bench, run } from "mitata";
 import {
+  arch,
   cpus,
   endianness,
-  arch,
-  uptime,
-  networkInterfaces,
-  getPriority,
-  totalmem,
   freemem,
+  getPriority,
   homedir,
   hostname,
   loadavg,
+  networkInterfaces,
   platform,
   release,
   setPriority,
   tmpdir,
+  totalmem,
   type,
+  uptime,
   userInfo,
   version,
 } from "node:os";

bench/modules/node_os/node.mjs

@@ -1,21 +1,21 @@
 import { bench, run } from "mitata";
 import {
+  arch,
   cpus,
   endianness,
-  arch,
-  uptime,
-  networkInterfaces,
-  getPriority,
-  totalmem,
   freemem,
+  getPriority,
   homedir,
   hostname,
   loadavg,
+  networkInterfaces,
   platform,
   release,
   setPriority,
   tmpdir,
+  totalmem,
   type,
+  uptime,
   userInfo,
   version,
 } from "node:os";

bench/react-hello-world/react-hello-world.deno.jsx

@@ -1,5 +1,5 @@
-import { renderToReadableStream } from "https://esm.run/react-dom/server";
 import * as React from "https://esm.run/react";
+import { renderToReadableStream } from "https://esm.run/react-dom/server";
 
 const App = () => (
   <html>

bench/react-hello-world/react-hello-world.node.jsx

@@ -1,6 +1,6 @@
 // react-ssr.tsx
-import { renderToPipeableStream } from "react-dom/server.node";
 import React from "react";
+import { renderToPipeableStream } from "react-dom/server.node";
 const http = require("http");
 const App = () => (
   <html>

bench/scanner/remix-route.ts

@@ -1,5 +1,5 @@
+import type { ActionFunction, LoaderFunction } from "remix";
 import { useParams } from "remix";
-import type { LoaderFunction, ActionFunction } from "remix";
 
 export const loader: LoaderFunction = async ({ params }) => {
   console.log(params.postId);

bench/snippets/assert.mjs

@@ -1,5 +1,5 @@
-import { bench, group, run } from "./runner.mjs";
 import * as assert from "assert";
+import { bench, run } from "./runner.mjs";
 
 bench("deepEqual", () => {
   assert.deepEqual({ foo: "123", bar: "baz" }, { foo: "123", bar: "baz" });

bench/snippets/buffer-create.mjs

@@ -1,7 +1,7 @@
 // @runtime bun,node,deno
-import { bench, run } from "./runner.mjs";
-import process from "node:process";
 import { Buffer } from "node:buffer";
+import process from "node:process";
+import { bench, run } from "./runner.mjs";
 
 const N = parseInt(process.env.RUN_COUNTER ?? "10000", 10);
 var isBuffer = new Buffer(0);

bench/snippets/buffer-to-string.mjs

@@ -1,6 +1,6 @@
-import { bench, run } from "./runner.mjs";
 import { Buffer } from "node:buffer";
 import crypto from "node:crypto";
+import { bench, run } from "./runner.mjs";
 
 const bigBuffer = Buffer.from("hello world".repeat(10000));
 const converted = bigBuffer.toString("base64");

bench/snippets/concat.js

@@ -1,6 +1,6 @@
-import { bench, group, run } from "./runner.mjs";
-import { readFileSync } from "fs";
 import { allocUnsafe } from "bun";
+import { readFileSync } from "fs";
+import { bench, group, run } from "./runner.mjs";
 
 function polyfill(chunks) {
   var size = 0;

bench/snippets/crypto.mjs

@@ -1,6 +1,6 @@
 // so it can run in environments without node module resolution
-import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 import crypto from "node:crypto";
+import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 var foo = new Uint8Array(65536);
 bench("crypto.getRandomValues(65536)", () => {
   crypto.getRandomValues(foo);

bench/snippets/deep-equals.js

@@ -1,5 +1,5 @@
-import { bench, group, run } from "./runner.mjs";
 import fastDeepEquals from "fast-deep-equal/es6/index";
+import { bench, group, run } from "./runner.mjs";
 // const Date = globalThis.Date;
 
 function func1() {}

bench/snippets/dns.ts

@@ -1,5 +1,5 @@
 import { dns } from "bun";
-import { bench, run, group } from "./runner.mjs";
+import { bench, group, run } from "./runner.mjs";
 
 async function forEachBackend(name, fn) {
   group(name, () => {

bench/snippets/encode-into.mjs

@@ -1,4 +1,4 @@
-import { run, bench } from "../node_modules/mitata/src/cli.mjs";
+import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 
 const encoder = new TextEncoder();
 

bench/snippets/escapeHTML.js

@@ -1,7 +1,4 @@
-import { group } from "./runner.mjs";
-import { bench, run } from "./runner.mjs";
-import { encode as htmlEntityEncode } from "html-entities";
-import { escape as heEscape } from "he";
+import { bench, group, run } from "./runner.mjs";
 
 var bunEscapeHTML = globalThis.escapeHTML || Bun.escapeHTML;
 

bench/snippets/ffi-overhead.mjs

@@ -1,4 +1,4 @@
-import { viewSource, dlopen, CString, ptr, toBuffer, toArrayBuffer, FFIType, callback } from "bun:ffi";
+import { dlopen } from "bun:ffi";
 import { bench, group, run } from "./runner.mjs";
 
 const types = {

bench/snippets/new-incomingmessage.mjs

@@ -1,5 +1,5 @@
-import { bench, run } from "./runner.mjs";
 import { IncomingMessage } from "node:http";
+import { bench, run } from "./runner.mjs";
 
 const headers = {
   date: "Mon, 06 Nov 2023 05:12:49 GMT",

bench/snippets/node-vm.mjs

@@ -1,6 +1,6 @@
 // @runtime node, bun
-import { bench, run } from "./runner.mjs";
 import * as vm from "node:vm";
+import { bench, run } from "./runner.mjs";
 
 const context = {
   animal: "cat",

bench/snippets/object-values.mjs

@@ -24,7 +24,7 @@ const obj = {
   w: 23,
 };
 
-import { bench, group, run } from "./runner.mjs";
+import { bench, run } from "./runner.mjs";
 
 var val = 0;
 bench("Object.values(literal)", () => {

bench/snippets/pbkdf2.mjs

@@ -1,4 +1,4 @@
-import { pbkdf2, pbkdf2Sync } from "node:crypto";
+import { pbkdf2 } from "node:crypto";
 
 import { bench, run } from "./runner.mjs";
 

bench/snippets/peek-promise.mjs

@@ -1,5 +1,5 @@
-import { bench, run } from "mitata";
 import { peek } from "bun";
+import { bench, run } from "mitata";
 
 let pending = Bun.sleep(1000);
 let resolved = Promise.resolve(1);

bench/snippets/performance-now-overhead.js

@@ -1,4 +1,3 @@
-import { group } from "./runner.mjs";
 import { bench, run } from "./runner.mjs";
 bench("performance.now x 1000", () => {
   for (let i = 0; i < 1000; i++) {

bench/snippets/process-info.mjs

@@ -1,5 +1,5 @@
-import { bench, run } from "./runner.mjs";
 import { performance } from "perf_hooks";
+import { bench, run } from "./runner.mjs";
 
 bench("process.memoryUsage()", () => {
   process.memoryUsage();

bench/snippets/react-dom-render.bun.js

@@ -1,6 +1,6 @@
-import { bench, group, run } from "./runner.mjs";
-import { renderToReadableStream } from "react-dom/server.browser";
 import { renderToReadableStream as renderToReadableStreamBun } from "react-dom/server";
+import { renderToReadableStream } from "react-dom/server.browser";
+import { bench, group, run } from "./runner.mjs";
 
 const App = () => (
   <div>

bench/snippets/read-file-chunk.mjs

@@ -1,7 +1,7 @@
-import { tmpdir } from "node:os";
-import { bench, group, run } from "./runner.mjs";
 import { createReadStream, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
 import { sep } from "node:path";
+import { bench, run } from "./runner.mjs";
 
 if (!Promise.withResolvers) {
   Promise.withResolvers = function () {

bench/snippets/readdir.mjs

@@ -1,10 +1,10 @@
-import { readdirSync, readdir as readdirCb } from "fs";
+import { createHash } from "crypto";
+import { readdirSync } from "fs";
 import { readdir } from "fs/promises";
-import { bench, run } from "./runner.mjs";
+import { relative, resolve } from "path";
 import { argv } from "process";
 import { fileURLToPath } from "url";
-import { relative, resolve } from "path";
-import { createHash } from "crypto";
+import { bench, run } from "./runner.mjs";
 
 let dir = resolve(argv.length > 2 ? argv[2] : fileURLToPath(new URL("../../node_modules", import.meta.url)));
 if (dir.includes(process.cwd())) {

bench/snippets/readfile-not-found.mjs

@@ -1,6 +1,6 @@
-import { bench, run } from "./runner.mjs";
-import { readFileSync, existsSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
+import { bench, run } from "./runner.mjs";
 
 bench(`readFileSync(/tmp/404-not-found)`, () => {
   try {

bench/snippets/realpath.mjs

@@ -1,7 +1,7 @@
 import { realpathSync } from "node:fs";
+import { bench, run } from "./runner.mjs";
 const count = parseInt(process.env.ITERATIONS || "1", 10) || 1;
 const arg = process.argv[process.argv.length - 1];
-import { bench, run } from "./runner.mjs";
 
 bench("realpathSync x " + count, () => {
   for (let i = 0; i < count; i++) realpathSync(arg, "utf-8");

bench/snippets/render.js

@@ -1,4 +1,4 @@
-import decoding from "./jsx-entity-decoding";
 import ReactDOMServer from "react-dom/server.browser";
+import decoding from "./jsx-entity-decoding";
 
 console.log(ReactDOMServer.renderToString(decoding));

bench/snippets/require-builtins.mjs

@@ -1,7 +1,6 @@
-import { bench, run } from "./runner.mjs";
-import { builtinModules } from "node:module";
-import { writeFile } from "node:fs/promises";
 import { spawnSync } from "child_process";
+import { writeFile } from "node:fs/promises";
+import { builtinModules } from "node:module";
 
 for (let builtin of builtinModules) {
   const path = `/tmp/require.${builtin.replaceAll("/", "_")}.cjs`;

bench/snippets/rmdir.mjs

@@ -1,5 +1,5 @@
+import { existsSync, mkdirSync, promises } from "node:fs";
 import { tmpdir } from "node:os";
-import { promises, existsSync, mkdirSync } from "node:fs";
 const count = 1024 * 12;
 
 var queue = new Array(count);

bench/snippets/runner-entrypoint.js

@@ -1,9 +1,9 @@
 // note: this isn't done yet
 // we look for `// @runtime` in the file to determine which runtimes to run the benchmark in
 import { spawnSync } from "bun";
-import { readdirSync, readFileSync } from "node:fs";
 import { Database } from "bun:sqlite";
-import { extname, basename } from "path";
+import { readdirSync, readFileSync } from "node:fs";
+import { basename, extname } from "path";
 
 const exts = [".js", ".ts", ".mjs", ".tsx"];
 

bench/snippets/runner.mjs

@@ -1,5 +1,5 @@
-import * as Mitata from "../node_modules/mitata/src/cli.mjs";
 import process from "node:process";
+import * as Mitata from "../node_modules/mitata/src/cli.mjs";
 
 const asJSON = !!process?.env?.BENCHMARK_RUNNER;
 

bench/snippets/serialize.mjs

@@ -1,4 +1,4 @@
-import { serialize, deserialize } from "node:v8";
+import { deserialize, serialize } from "node:v8";
 import { bench, run } from "./runner.mjs";
 const obj = {
   "id": 1296269,

bench/snippets/set-timeout.mjs

@@ -1,5 +1,3 @@
-import { bench, run } from "../node_modules/mitata/src/cli.mjs";
-
 let count = 20_000_000;
 const batchSize = 1_000_000;
 console.time("Run");

bench/snippets/sha512.js

@@ -1,5 +1,5 @@
-import { bench, run } from "./runner.mjs";
 import { SHA512 } from "bun";
+import { bench, run } from "./runner.mjs";
 
 bench('SHA512.hash("hello world")', () => {
   SHA512.hash("hello world");

bench/snippets/sha512.node.mjs

@@ -1,5 +1,5 @@
-import { bench, run } from "./runner.mjs";
 import { createHash } from "crypto";
+import { bench, run } from "./runner.mjs";
 
 bench('createHash("sha256").update("hello world").digest()', () => {
   createHash("sha256").update("hello world").digest();

bench/snippets/shell-spawn.mjs

@@ -1,6 +1,6 @@
-import { $ as zx } from "zx";
 import { $ as execa$ } from "execa";
-import { bench, run, group } from "./runner.mjs";
+import { $ as zx } from "zx";
+import { bench, group, run } from "./runner.mjs";
 
 const execa = execa$({ stdio: "ignore", cwd: import.meta.dirname });
 

bench/snippets/stat.mjs

@@ -1,6 +1,6 @@
-import { readdirSync, statSync } from "fs";
-import { bench, run } from "./runner.mjs";
+import { statSync } from "fs";
 import { argv } from "process";
+import { bench, run } from "./runner.mjs";
 
 const dir = argv.length > 2 ? argv[2] : "/tmp";
 

bench/snippets/stderr.mjs

@@ -1,4 +1,4 @@
-import { run, bench } from "./runner.mjs";
+import { bench, run } from "./runner.mjs";
 
 var writer = globalThis.Bun ? Bun.stderr.writer() : undefined;
 if (writer)

bench/snippets/string-decoder.mjs

@@ -1,5 +1,5 @@
-import { bench, run } from "./runner.mjs";
 import { StringDecoder } from "string_decoder";
+import { bench, run } from "./runner.mjs";
 
 var short = Buffer.from("Hello World!");
 var shortUTF16 = Buffer.from("Hello World 💕💕💕");

bench/snippets/string-width.mjs

@@ -1,5 +1,5 @@
-import { bench, run } from "./runner.mjs";
 import npmStringWidth from "string-width";
+import { bench, run } from "./runner.mjs";
 
 const bunStringWidth = globalThis?.Bun?.stringWidth;
 

bench/snippets/tcp-echo.bun.ts

@@ -1,4 +1,4 @@
-import { listen, connect } from "bun";
+import { connect, listen } from "bun";
 
 var counter = 0;
 const msg = "Hello World!";

bench/snippets/text-encoder-stream.mjs

@@ -2,19 +2,12 @@ import { bench, run } from "./runner.mjs";
 
 const latin1 = `hello hello hello!!!! `.repeat(10240);
 
-const astralCharacter = "\u{1F499}"; // BLUE HEART
-const leading = astralCharacter[0];
-const trailing = astralCharacter[1];
-
-async function create(src, testPendingSurrogate) {
-  function split(str, chunkSize, pendingLeadSurrogate) {
+function create(src) {
+  function split(str, chunkSize) {
     let chunkedHTML = [];
     let html = str;
     while (html.length > 0) {
-      pendingLeadSurrogate
-        ? chunkedHTML.push(html.slice(0, chunkSize) + leading)
-        : chunkedHTML.push(html.slice(0, chunkSize));
-
+      chunkedHTML.push(html.slice(0, chunkSize));
       html = html.slice(chunkSize);
     }
     return chunkedHTML;
@@ -36,30 +29,21 @@ async function create(src, testPendingSurrogate) {
   // if (new TextDecoder().decode(await runBench(oneKB)) !== src) {
   //   throw new Error("Benchmark failed");
   // }
-
-  const pendingSurrogateTests = [false];
-  if (testPendingSurrogate) {
-    pendingSurrogateTests.push(true);
-  }
-
   const sizes = [1024, 16 * 1024, 64 * 1024, 256 * 1024];
   for (const chunkSize of sizes) {
-    for (const pendingLeadSurrogate of pendingSurrogateTests) {
-      const text = split(src, chunkSize, testPendingSurrogate && pendingLeadSurrogate);
-      bench(
-        `${Math.round(src.length / 1024)} KB, ${Math.round(chunkSize / 1024) > 0 ? Math.round(chunkSize / 1024) : (chunkSize / 1024).toFixed(2)} KB chunks, ${pendingLeadSurrogate ? "pending surrogate" : ""}`,
-        async () => {
-          await runBench(text);
-        },
-      );
-    }
+    const text = split(src, chunkSize);
+    bench(
+      `${Math.round(src.length / 1024)} KB of text in ${Math.round(chunkSize / 1024) > 0 ? Math.round(chunkSize / 1024) : (chunkSize / 1024).toFixed(2)} KB chunks`,
+      async () => {
+        await runBench(text);
+      },
+    );
   }
 }
-create(latin1, false);
+create(latin1);
 create(
   // bun's old readme was extremely long
   await fetch("https://web.archive.org/web/20230119110956/https://github.com/oven-sh/bun").then(res => res.text()),
-  true,
 );
 
 await run();

bench/snippets/transpiler.mjs

@@ -1,8 +1,8 @@
 import { readFileSync } from "fs";
+import { createRequire } from "module";
 import { dirname } from "path";
 import { fileURLToPath } from "url";
-import { bench, run, group } from "./runner.mjs";
-import { createRequire } from "module";
+import { bench, group, run } from "./runner.mjs";
 const require = createRequire(import.meta.url);
 const esbuild_ = require("esbuild/lib/main");
 const swc_ = require("@swc/core");

bench/snippets/write-file.mjs

@@ -1,4 +1,4 @@
-import { readFileSync, writeFileSync } from "node:fs";
+import { writeFileSync } from "node:fs";
 import { bench, run } from "./runner.mjs";
 
 var short = "Hello World!";

bench/snippets/write.bun.js

@@ -1,6 +1,6 @@
-import { bench, run } from "./runner.mjs";
 import { write } from "bun";
 import { openSync } from "fs";
+import { bench, run } from "./runner.mjs";
 
 bench('write(/tmp/foo.txt, "short string")', async () => {
   await write("/tmp/foo.txt", "short string");

bench/snippets/write.node.mjs

@@ -1,9 +1,8 @@
 // @runtime node, bun, deno
-import { bench, run } from "./runner.mjs";
 import { Buffer } from "node:buffer";
-import { openSync } from "node:fs";
+import { openSync, writeSync as write } from "node:fs";
 import { writeFile } from "node:fs/promises";
-import { writeSync as write } from "node:fs";
+import { bench, run } from "./runner.mjs";
 
 bench("writeFile(/tmp/foo.txt, short string)", async () => {
   await writeFile("/tmp/foo.txt", "short string", "utf8");

bench/sqlite/better-sqlite3.mjs

@@ -1,4 +1,4 @@
-import { run, bench } from "mitata";
+import { bench, run } from "mitata";
 import { createRequire } from "module";
 
 const require = createRequire(import.meta.url);

bench/sqlite/bun.js

@@ -1,5 +1,5 @@
-import { run, bench } from "mitata";
 import { Database } from "bun:sqlite";
+import { bench, run } from "mitata";
 import { join } from "path";
 
 const db = Database.open(join(import.meta.dir, "src", "northwind.sqlite"));

bench/sqlite/deno.js

@@ -1,5 +1,5 @@
 import { Database } from "https://deno.land/x/sqlite3@0.11.1/mod.ts";
-import { run, bench } from "../node_modules/mitata/src/cli.mjs";
+import { bench, run } from "../node_modules/mitata/src/cli.mjs";
 
 const db = new Database("./src/northwind.sqlite");
 

bench/sqlite/node.mjs

@@ -1,6 +1,6 @@
 // Run `node --experimental-sqlite bench/sqlite/node.mjs` to run the script.
 // You will need `--experimental-sqlite` flag to run this script and node v22.5.0 or higher.
-import { run, bench } from "mitata";
+import { bench, run } from "mitata";
 import { DatabaseSync as Database } from "node:sqlite";
 
 const db = new Database("./src/northwind.sqlite");

bench/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    // For the organize imports plugin
+    "jsx": "react"
+  }
+}

build.zig

@@ -89,10 +89,8 @@ const BunBuildOptions = struct {
 
 pub fn getOSVersionMin(os: OperatingSystem) ?Target.Query.OsVersion {
     return switch (os) {
-        // bun needs macOS 12 to work properly due to icucore, but we have been
-        // compiling everything with 11 as the minimum.
         .mac => .{
-            .semver = .{ .major = 11, .minor = 0, .patch = 0 },
+            .semver = .{ .major = 13, .minor = 0, .patch = 0 },
         },
 
         // Windows 10 1809 is the minimum supported version

completions/bun.bash

@@ -82,7 +82,7 @@ _bun_completions() {
     declare -A PACKAGE_OPTIONS;
     declare -A PM_OPTIONS;
 
-    local SUBCOMMANDS="dev bun create run install add remove upgrade completions discord help init pm x test repl update link unlink build";
+    local SUBCOMMANDS="dev bun create run install add remove upgrade completions discord help init pm x test repl update outdated link unlink build";
 
     GLOBAL_OPTIONS[LONG_OPTIONS]="--use --cwd --bunfile --server-bunfile --config --disable-react-fast-refresh --disable-hmr --env-file --extension-order --jsx-factory --jsx-fragment --extension-order --jsx-factory --jsx-fragment --jsx-import-source --jsx-production --jsx-runtime --main-fields --no-summary --version --platform --public-dir --tsconfig-override --define --external --help --inject --loader --origin --port --dump-environment-variables --dump-limits --disable-bun-js";
     GLOBAL_OPTIONS[SHORT_OPTIONS]="-c -v -d -e -h -i -l -u -p";

completions/bun.fish

@@ -179,6 +179,7 @@ complete -c bun -n "__fish_use_subcommand" -a "remove" -d "Remove a dependency f
 complete -c bun -n "__fish_use_subcommand" -a "add" -d "Add a dependency to package.json" -f
 complete -c bun -n "__fish_use_subcommand" -a "init" -d "Initialize a Bun project in this directory" -f
 complete -c bun -n "__fish_use_subcommand" -a "link" -d "Register or link a local npm package" -f
-complete -c bun -n "__fish_use_subcommand" -a "link" -d "Unregister a local npm package" -f
+complete -c bun -n "__fish_use_subcommand" -a "unlink" -d "Unregister a local npm package" -f
 complete -c bun -n "__fish_use_subcommand" -a "pm" -d "Additional package management utilities" -f
 complete -c bun -n "__fish_use_subcommand" -a "x" -d "Execute a package binary, installing if needed" -f
+complete -c bun -n "__fish_use_subcommand" -a "outdated" -d "Display the latest versions of outdated dependencies" -f

completions/bun.zsh

@@ -563,6 +563,22 @@ _bun_update_completion() {
     esac
 }
 
+_bun_outdated_completion() {
+    _arguments -s -C \
+        '--cwd[Set a specific cwd]:cwd' \
+        '--verbose[Excessively verbose logging]' \
+        '--no-progress[Disable the progress bar]' \
+        '--help[Print this help menu]' &&
+        ret=0
+    
+    case $state in
+    config)
+        _bun_list_bunfig_toml
+
+        ;;
+    esac
+}
+
 _bun_test_completion() {
     _arguments -s -C \
         '1: :->cmd1' \
@@ -669,6 +685,7 @@ _bun() {
             'add\:"Add a dependency to package.json (bun a)" '
             'remove\:"Remove a dependency from package.json (bun rm)" '
             'update\:"Update outdated dependencies & save to package.json" '
+            'outdated\:"Display the latest versions of outdated dependencies" '
             'link\:"Link an npm package globally" '
             'unlink\:"Globally unlink an npm package" '
             'pm\:"More commands for managing packages" '
@@ -740,6 +757,10 @@ _bun() {
         update)
             _bun_update_completion
 
+            ;;
+        outdated)
+            _bun_outdated_completion
+
             ;;
         'test')
             _bun_test_completion
@@ -819,6 +840,10 @@ _bun() {
                 update)
                     _bun_update_completion
 
+                    ;;
+                outdated)
+                    _bun_outdated_completion
+
                     ;;
                 'test')
                     _bun_test_completion

docs/api/binary-data.md

@@ -219,6 +219,11 @@ The following classes are typed arrays, along with a description of how they int
 
 ---
 
+- [`Float16Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float16Array)
+- Every two (2) bytes are interpreted as a 16-bit floating point number. Range -6.104e5 to 6.55e4.
+
+---
+
 - [`Float32Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array)
 - Every four (4) bytes are interpreted as a 32-bit floating point number. Range -3.4e38 to 3.4e38.
 

docs/api/http.md

@@ -70,6 +70,116 @@ const server = Bun.serve({
 });
 ```
 
+### Static routes
+
+Use the `static` option to serve static `Response` objects by route.
+
+```ts
+// Bun v1.1.27+ required
+Bun.serve({
+  static: {
+    // health-check endpoint
+    "/api/health-check": new Response("All good!"),
+
+    // redirect from /old-link to /new-link
+    "/old-link": Response.redirect("/new-link", 301),
+
+    // serve static text
+    "/": new Response("Hello World"),
+
+    // server a file by buffering it in memory
+    "/index.html": new Response(await Bun.file("./index.html").bytes(), {
+      headers: {
+        "Content-Type": "text/html",
+      },
+    }),
+    "/favicon.ico": new Response(await Bun.file("./favicon.ico").bytes(), {
+      headers: {
+        "Content-Type": "image/x-icon",
+      },
+    }),
+
+    // serve JSON
+    "/api/version.json": Response.json({ version: "1.0.0" }),
+  },
+
+  fetch(req) {
+    return new Response("404!");
+  },
+});
+```
+
+Static routes support headers, status code, and other `Response` options.
+
+```ts
+Bun.serve({
+  static: {
+    "/api/time": new Response(new Date().toISOString(), {
+      headers: {
+        "X-Custom-Header": "Bun!",
+      },
+    }),
+  },
+
+  fetch(req) {
+    return new Response("404!");
+  },
+});
+```
+
+Static routes can serve Response bodies faster than `fetch` handlers because they don't create `Request` objects, they don't create `AbortSignal`, they don't create additional `Response` objects. The only per-request memory allocation is the TCP/TLS socket data needed for each request.
+
+{% note %}
+`static` is experimental
+{% /note %}
+
+Static route responses are cached for the lifetime of the server object. To reload static routes, call `server.reload(options)`.
+
+```ts
+const server = Bun.serve({
+  static: {
+    "/api/time": new Response(new Date().toISOString()),
+  },
+
+  fetch(req) {
+    return new Response("404!");
+  },
+});
+
+// Update the time every second.
+setInterval(() => {
+  server.reload({
+    static: {
+      "/api/time": new Response(new Date().toISOString()),
+    },
+
+    fetch(req) {
+      return new Response("404!");
+    },
+  });
+}, 1000);
+```
+
+Reloading static routes only impact the next request. In-flight requests continue to use the old static routes. After in-flight requests to old static routes are finished, the old static routes are freed from memory.
+
+To simplify error handling, static routes do not support streaming response bodies from `ReadableStream` or an `AsyncIterator`. Fortunately, you can still buffer the response in memory first:
+
+```ts
+const time = await fetch("https://api.example.com/v1/data");
+// Buffer the response in memory first.
+const blob = await time.blob();
+
+const server = Bun.serve({
+  static: {
+    "/api/data": new Response(blob),
+  },
+
+  fetch(req) {
+    return new Response("404!");
+  },
+});
+```
+
 ### Changing the `port` and `hostname`
 
 To configure which port and hostname the server will listen on, set `port` and `hostname` in the options object.
@@ -326,7 +436,24 @@ Bun.serve({
 });
 ```
 
-## Object syntax
+## idleTimeout
+
+To configure the idle timeout, set the `idleTimeout` field in Bun.serve.
+
+```ts
+Bun.serve({
+  // 10 seconds:
+  idleTimeout: 10,
+
+  fetch(req) {
+    return new Response("Bun!");
+  },
+});
+```
+
+This is the maximum amount of time a connection is allowed to be idle before the server closes it. A connection is idling if there is no data sent or received.
+
+## export default syntax
 
 Thus far, the examples on this page have used the explicit `Bun.serve` API. Bun also supports an alternate syntax.