partially fix: test-http-server.js

.buildkite/ci.mjs

@@ -35,7 +35,7 @@ import {
  * @typedef {"musl"} Abi
  * @typedef {"debian" | "ubuntu" | "alpine" | "amazonlinux"} Distro
  * @typedef {"latest" | "previous" | "oldest" | "eol"} Tier
- * @typedef {"release" | "assert" | "debug" | "asan"} Profile
+ * @typedef {"release" | "assert" | "debug"} Profile
  */
 
 /**
@@ -107,7 +107,6 @@ const buildPlatforms = [
   { os: "linux", arch: "aarch64", distro: "amazonlinux", release: "2023", features: ["docker"] },
   { os: "linux", arch: "x64", distro: "amazonlinux", release: "2023", features: ["docker"] },
   { os: "linux", arch: "x64", baseline: true, distro: "amazonlinux", release: "2023", features: ["docker"] },
-  { os: "linux", arch: "x64", profile: "asan", distro: "amazonlinux", release: "2023", features: ["docker"] },
   { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.21" },
   { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.21" },
   { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.21" },
@@ -126,12 +125,14 @@ const testPlatforms = [
   { os: "linux", arch: "aarch64", distro: "debian", release: "12", tier: "latest" },
   { os: "linux", arch: "x64", distro: "debian", release: "12", tier: "latest" },
   { os: "linux", arch: "x64", baseline: true, distro: "debian", release: "12", tier: "latest" },
-  { os: "linux", arch: "x64", profile: "asan", distro: "debian", release: "12", tier: "latest" },
   { os: "linux", arch: "aarch64", distro: "ubuntu", release: "24.04", tier: "latest" },
+  { os: "linux", arch: "aarch64", distro: "ubuntu", release: "22.04", tier: "previous" },
   { os: "linux", arch: "aarch64", distro: "ubuntu", release: "20.04", tier: "oldest" },
   { os: "linux", arch: "x64", distro: "ubuntu", release: "24.04", tier: "latest" },
+  { os: "linux", arch: "x64", distro: "ubuntu", release: "22.04", tier: "previous" },
   { os: "linux", arch: "x64", distro: "ubuntu", release: "20.04", tier: "oldest" },
   { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "24.04", tier: "latest" },
+  { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "22.04", tier: "previous" },
   { os: "linux", arch: "x64", baseline: true, distro: "ubuntu", release: "20.04", tier: "oldest" },
   { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.21", tier: "latest" },
   { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.21", tier: "latest" },
@@ -323,26 +324,9 @@ function getCppAgent(platform, options) {
 function getZigAgent(platform, options) {
   const { arch } = platform;
 
-  // Uncomment to restore to using macOS on-prem for Zig.
-  // return {
-  //   queue: "build-zig",
-  // };
-
-  return getEc2Agent(
-    {
-      os: "linux",
-      arch: "x64",
-      abi: "musl",
-      distro: "alpine",
-      release: "3.21",
-    },
-    options,
-    {
-      instanceType: "c7i.2xlarge",
-      cpuCount: 4,
-      threadsPerCore: 1,
-    },
-  );
+  return {
+    queue: "build-zig",
+  };
 }
 
 /**
@@ -395,32 +379,30 @@ function getTestAgent(platform, options) {
  * @returns {Record<string, string | undefined>}
  */
 function getBuildEnv(target, options) {
-  const { baseline, abi } = target;
+  const { profile, baseline, abi } = target;
+  const release = !profile || profile === "release";
   const { canary } = options;
   const revision = typeof canary === "number" ? canary : 1;
 
+  const isMusl = abi === "musl";
+
+  let CMAKE_BUILD_TYPE = release ? "Release" : profile === "debug" ? "Debug" : "RelWithDebInfo";
+  if (isMusl && release) {
+    CMAKE_BUILD_TYPE = "MinSizeRel";
+  }
+
   return {
+    CMAKE_BUILD_TYPE,
     ENABLE_BASELINE: baseline ? "ON" : "OFF",
     ENABLE_CANARY: revision > 0 ? "ON" : "OFF",
     CANARY_REVISION: revision,
-    ABI: abi === "musl" ? "musl" : undefined,
-    CMAKE_VERBOSE_MAKEFILE: "ON",
+    ENABLE_ASSERTIONS: release ? "OFF" : "ON",
+    ENABLE_LOGS: release ? "OFF" : "ON",
+    ABI: isMusl ? "musl" : undefined,
     CMAKE_TLS_VERIFY: "0",
   };
 }
 
-/**
- * @param {Target} target
- * @param {PipelineOptions} options
- * @returns {string}
- */
-function getBuildCommand(target, options) {
-  const { profile } = target;
-
-  const label = profile || "release";
-  return `bun run build:${label}`;
-}
-
 /**
  * @param {Platform} platform
  * @param {PipelineOptions} options
@@ -434,7 +416,7 @@ function getBuildVendorStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: `${getBuildCommand(platform, options)} --target dependencies`,
+    command: "bun run build:ci --target dependencies",
   };
 }
 
@@ -444,7 +426,6 @@ function getBuildVendorStep(platform, options) {
  * @returns {Step}
  */
 function getBuildCppStep(platform, options) {
-  const command = getBuildCommand(platform, options);
   return {
     key: `${getTargetKey(platform)}-build-cpp`,
     label: `${getTargetLabel(platform)} - build-cpp`,
@@ -455,10 +436,7 @@ function getBuildCppStep(platform, options) {
       BUN_CPP_ONLY: "ON",
       ...getBuildEnv(platform, options),
     },
-    // We used to build the C++ dependencies and bun in seperate steps.
-    // However, as long as the zig build takes longer than both sequentially,
-    // it's cheaper to run them in the same step. Can be revisited in the future.
-    command: [`${command} --target bun`, `${command} --target dependencies`],
+    command: "bun run build:ci --target bun",
   };
 }
 
@@ -492,7 +470,7 @@ function getBuildZigStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: `${getBuildCommand(platform, options)} --target bun-zig --toolchain ${toolchain}`,
+    command: `bun run build:ci --target bun-zig --toolchain ${toolchain}`,
     timeout_in_minutes: 35,
   };
 }
@@ -506,7 +484,11 @@ function getLinkBunStep(platform, options) {
   return {
     key: `${getTargetKey(platform)}-build-bun`,
     label: `${getTargetLabel(platform)} - build-bun`,
-    depends_on: [`${getTargetKey(platform)}-build-cpp`, `${getTargetKey(platform)}-build-zig`],
+    depends_on: [
+      `${getTargetKey(platform)}-build-vendor`,
+      `${getTargetKey(platform)}-build-cpp`,
+      `${getTargetKey(platform)}-build-zig`,
+    ],
     agents: getCppAgent(platform, options),
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
@@ -514,7 +496,7 @@ function getLinkBunStep(platform, options) {
       BUN_LINK_ONLY: "ON",
       ...getBuildEnv(platform, options),
     },
-    command: `${getBuildCommand(platform, options)} --target bun`,
+    command: "bun run build:ci --target bun",
   };
 }
 
@@ -531,7 +513,7 @@ function getBuildBunStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: getBuildCommand(platform, options),
+    command: "bun run build:ci",
   };
 }
 
@@ -550,7 +532,7 @@ function getBuildBunStep(platform, options) {
  * @returns {Step}
  */
 function getTestBunStep(platform, options, testOptions = {}) {
-  const { os, profile } = platform;
+  const { os } = platform;
   const { buildId, unifiedTests, testFiles } = testOptions;
 
   const args = [`--step=${getTargetKey(platform)}-build-bun`];
@@ -574,7 +556,6 @@ function getTestBunStep(platform, options, testOptions = {}) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     parallelism: unifiedTests ? undefined : os === "darwin" ? 2 : 10,
-    timeout_in_minutes: profile === "asan" ? 90 : 30,
     command:
       os === "windows"
         ? `node .\\scripts\\runner.node.mjs ${args.join(" ")}`
@@ -648,7 +629,6 @@ function getReleaseStep(buildPlatforms, options) {
 }
 
 /**
- * @param {Platform[]} buildPlatforms
  * @returns {Step}
  */
 function getBenchmarkStep() {
@@ -656,10 +636,10 @@ function getBenchmarkStep() {
     key: "benchmark",
     label: "📊",
     agents: {
-      queue: "build-image",
+      queue: "build-zig",
     },
-    depends_on: `linux-x64-build-bun`,
-    command: "node .buildkite/scripts/upload-benchmark.mjs",
+    command: "bun .buildkite/scripts/upload-benchmark.ts",
+    depends_on: [`linux-x64-build-bun`],
   };
 }
 
@@ -749,6 +729,7 @@ function getBenchmarkStep() {
  * @property {string | boolean} [buildImages]
  * @property {string | boolean} [publishImages]
  * @property {number} [canary]
+ * @property {Profile[]} [buildProfiles]
  * @property {Platform[]} [buildPlatforms]
  * @property {Platform[]} [testPlatforms]
  * @property {string[]} [testFiles]
@@ -843,10 +824,6 @@ function getOptionsStep() {
             label: `${getEmoji("assert")} Release with Assertions`,
             value: "assert",
           },
-          {
-            label: `${getEmoji("asan")} Release with ASAN`,
-            value: "asan",
-          },
           {
             label: `${getEmoji("debug")} Debug`,
             value: "debug",
@@ -969,13 +946,8 @@ async function getPipelineOptions() {
     return;
   }
 
-  let filteredBuildPlatforms = buildPlatforms;
-  if (isMainBranch()) {
-    filteredBuildPlatforms = buildPlatforms.filter(({ profile }) => profile !== "asan");
-  }
-
   const canary = await getCanaryRevision();
-  const buildPlatformsMap = new Map(filteredBuildPlatforms.map(platform => [getTargetKey(platform), platform]));
+  const buildPlatformsMap = new Map(buildPlatforms.map(platform => [getTargetKey(platform), platform]));
   const testPlatformsMap = new Map(testPlatforms.map(platform => [getPlatformKey(platform), platform]));
 
   if (isManual) {
@@ -994,7 +966,6 @@ async function getPipelineOptions() {
         ?.map(item => item.trim())
         ?.filter(Boolean);
 
-    const buildProfiles = parseArray(options["build-profiles"]);
     const buildPlatformKeys = parseArray(options["build-platforms"]);
     const testPlatformKeys = parseArray(options["test-platforms"]);
     return {
@@ -1007,11 +978,12 @@ async function getPipelineOptions() {
       testFiles: parseArray(options["test-files"]),
       unifiedBuilds: parseBoolean(options["unified-builds"]),
       unifiedTests: parseBoolean(options["unified-tests"]),
+      buildProfiles: parseArray(options["build-profiles"]),
       buildPlatforms: buildPlatformKeys?.length
-        ? buildPlatformKeys.flatMap(key => buildProfiles.map(profile => ({ ...buildPlatformsMap.get(key), profile })))
+        ? buildPlatformKeys.map(key => buildPlatformsMap.get(key))
         : Array.from(buildPlatformsMap.values()),
       testPlatforms: testPlatformKeys?.length
-        ? testPlatformKeys.flatMap(key => buildProfiles.map(profile => ({ ...testPlatformsMap.get(key), profile })))
+        ? testPlatformKeys.map(key => testPlatformsMap.get(key))
         : Array.from(testPlatformsMap.values()),
       dryRun: parseBoolean(options["dry-run"]),
     };
@@ -1046,6 +1018,7 @@ async function getPipelineOptions() {
     publishImages: parseOption(/\[(publish images?)\]/i),
     buildPlatforms: Array.from(buildPlatformsMap.values()),
     testPlatforms: Array.from(testPlatformsMap.values()),
+    buildProfiles: ["release"],
   };
 }
 
@@ -1068,7 +1041,7 @@ async function getPipeline(options = {}) {
     return;
   }
 
-  const { buildPlatforms = [], testPlatforms = [], buildImages, publishImages } = options;
+  const { buildProfiles = [], buildPlatforms = [], testPlatforms = [], buildImages, publishImages } = options;
   const imagePlatforms = new Map(
     buildImages || publishImages
       ? [...buildPlatforms, ...testPlatforms]
@@ -1103,28 +1076,29 @@ async function getPipeline(options = {}) {
     }
   }
 
-  const includeASAN = !isMainBranch();
-
   if (!buildId) {
-    const relevantBuildPlatforms = includeASAN
-      ? buildPlatforms
-      : buildPlatforms.filter(({ profile }) => profile !== "asan");
-
     steps.push(
-      ...relevantBuildPlatforms.map(target => {
-        const imageKey = getImageKey(target);
+      ...buildPlatforms
+        .flatMap(platform => buildProfiles.map(profile => ({ ...platform, profile })))
+        .map(target => {
+          const imageKey = getImageKey(target);
 
-        return getStepWithDependsOn(
-          {
-            key: getTargetKey(target),
-            group: getTargetLabel(target),
-            steps: unifiedBuilds
-              ? [getBuildBunStep(target, options)]
-              : [getBuildCppStep(target, options), getBuildZigStep(target, options), getLinkBunStep(target, options)],
-          },
-          imagePlatforms.has(imageKey) ? `${imageKey}-build-image` : undefined,
-        );
-      }),
+          return getStepWithDependsOn(
+            {
+              key: getTargetKey(target),
+              group: getTargetLabel(target),
+              steps: unifiedBuilds
+                ? [getBuildBunStep(target, options)]
+                : [
+                    getBuildVendorStep(target, options),
+                    getBuildCppStep(target, options),
+                    getBuildZigStep(target, options),
+                    getLinkBunStep(target, options),
+                  ],
+            },
+            imagePlatforms.has(imageKey) ? `${imageKey}-build-image` : undefined,
+          );
+        }),
     );
   }
 
@@ -1132,11 +1106,13 @@ async function getPipeline(options = {}) {
     const { skipTests, forceTests, unifiedTests, testFiles } = options;
     if (!skipTests || forceTests) {
       steps.push(
-        ...testPlatforms.map(target => ({
-          key: getTargetKey(target),
-          group: getTargetLabel(target),
-          steps: [getTestBunStep(target, options, { unifiedTests, testFiles, buildId })],
-        })),
+        ...testPlatforms
+          .flatMap(platform => buildProfiles.map(profile => ({ ...platform, profile })))
+          .map(target => ({
+            key: getTargetKey(target),
+            group: getTargetLabel(target),
+            steps: [getTestBunStep(target, options, { unifiedTests, testFiles, buildId })],
+          })),
       );
     }
   }
@@ -1144,6 +1120,7 @@ async function getPipeline(options = {}) {
   if (isMainBranch()) {
     steps.push(getReleaseStep(buildPlatforms, options));
   }
+
   steps.push(getBenchmarkStep());
 
   /** @type {Map<string, GroupStep>} */

.cursor/rules/javascriptcore-class.mdc

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

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

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

.git-blame-ignore-revs

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

.github/pull_request_template.md

@@ -28,7 +28,7 @@ This adds a new flag --bail to bun test. When set, it will stop running tests af
 
 - [ ] I checked the lifetime of memory allocated to verify it's (1) freed and (2) only freed when it should be
 - [ ] I included a test for the new code, or an existing test covers it
-- [ ] JSValue used outside of the stack is either wrapped in a JSC.Strong or is JSValueProtect'ed
+- [ ] JSValue used outside outside of the stack is either wrapped in a JSC.Strong or is JSValueProtect'ed
 - [ ] I wrote TypeScript/JavaScript tests and they pass locally (`bun-debug test test-file-name.test`)
 -->
 

.github/workflows/docs.yml

@@ -4,7 +4,6 @@ on:
   push:
     paths:
       - "docs/**"
-      - "packages/bun-types/**.d.ts"
       - "CONTRIBUTING.md"
     branches:
       - main

.github/workflows/lint.yml

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

.github/workflows/update-cares.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/ref/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 

.github/workflows/update-libarchive.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 

.github/workflows/update-libdeflate.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 

.github/workflows/update-lolhtml.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 

.github/workflows/update-lshpack.yml

@@ -50,14 +50,9 @@ jobs:
             exit 1
           fi
 
-          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
-            exit 1
-          fi
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
           if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
-            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
             exit 1
           fi
 

.gitignore

@@ -153,7 +153,6 @@ test/cli/install/registry/packages/publish-pkg-*
 test/cli/install/registry/packages/@secret/publish-pkg-8
 test/js/third_party/prisma/prisma/sqlite/dev.db-journal
 tmp
-codegen-for-zig-team.tar.gz
 
 # Dependencies
 /vendor

.vscode/launch.json

@@ -1118,11 +1118,7 @@
       "request": "attach",
       "name": "rr",
       "trace": "Off",
-      "setupCommands": [
-        "handle SIGPWR nostop noprint pass",
-        "source ${workspaceFolder}/misctools/gdb/std_gdb_pretty_printers.py",
-        "source ${workspaceFolder}/misctools/gdb/zig_gdb_pretty_printers.py",
-      ],
+      "setupCommands": ["handle SIGPWR nostop noprint pass"],
     },
   ],
   "inputs": [

.vscode/settings.json

@@ -30,7 +30,7 @@
   "zig.initialSetupDone": true,
   "zig.buildOption": "build",
   "zig.zls.zigLibPath": "${workspaceFolder}/vendor/zig/lib",
-  "zig.buildArgs": ["-Dgenerated-code=./build/debug/codegen", "--watch", "-fincremental"],
+  "zig.buildArgs": ["-Dgenerated-code=./build/debug/codegen"],
   "zig.zls.buildOnSaveStep": "check",
   // "zig.zls.enableBuildOnSave": true,
   // "zig.buildOnSave": true,
@@ -136,6 +136,9 @@
     "**/*.xcscheme": true,
     "**/*.xcodeproj": true,
     "**/*.i": true,
+
+    // uws WebSocket.cpp conflicts with webcore WebSocket.cpp
+    "packages/bun-uws/fuzzing": true,
   },
   "files.associations": {
     "*.css": "tailwindcss",
@@ -143,8 +146,6 @@
     "*.mdc": "markdown",
     "array": "cpp",
     "ios": "cpp",
-    "oxlint.json": "jsonc",
-    "bun.lock": "jsonc",
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,

CONTRIBUTING.md

@@ -53,39 +53,39 @@ $ brew install bun
 
 ## Install LLVM
 
-Bun requires LLVM 19 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
+Bun requires LLVM 18 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
 
 {% codetabs group="os" %}
 
 ```bash#macOS (Homebrew)
-$ brew install llvm@19
+$ brew install llvm@18
 ```
 
 ```bash#Ubuntu/Debian
 $ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
-$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 18 all
 ```
 
 ```bash#Arch
-$ sudo pacman -S llvm clang lld
+$ sudo pacman -S llvm clang18 lld
 ```
 
 ```bash#Fedora
-$ sudo dnf install llvm clang lld-devel
+$ sudo dnf install llvm18 clang18 lld18-devel
 ```
 
 ```bash#openSUSE Tumbleweed
-$ sudo zypper install clang19 lld19 llvm19
+$ sudo zypper install clang18 lld18 llvm18
 ```
 
 {% /codetabs %}
 
 If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.7).
 
-Make sure Clang/LLVM 19 is in your path:
+Make sure Clang/LLVM 18 is in your path:
 
 ```bash
-$ which clang-19
+$ which clang-18
 ```
 
 If not, run this to manually add it:
@@ -94,13 +94,13 @@ If not, run this to manually add it:
 
 ```bash#macOS (Homebrew)
 # use fish_add_path if you're using fish
-# use path+="$(brew --prefix llvm@19)/bin" if you are using zsh
-$ export PATH="$(brew --prefix llvm@19)/bin:$PATH"
+# use path+="$(brew --prefix llvm@18)/bin" if you are using zsh
+$ export PATH="$(brew --prefix llvm@18)/bin:$PATH"
 ```
 
 ```bash#Arch
 # use fish_add_path if you're using fish
-$ export PATH="$PATH:/usr/lib/llvm19/bin"
+$ export PATH="$PATH:/usr/lib/llvm18/bin"
 ```
 
 {% /codetabs %}
@@ -134,16 +134,6 @@ We recommend adding `./build/debug` to your `$PATH` so that you can run `bun-deb
 $ bun-debug
 ```
 
-## Running debug builds
-
-The `bd` package.json script compiles and runs a debug build of Bun, only printing the output of the build process if it fails.
-
-```sh
-$ bun bd <args>
-$ bun bd test foo.test.ts
-$ bun bd ./foo.ts
-```
-
 ## Code generation scripts
 
 Several code generation scripts are used during Bun's build process. These are run automatically when changes are made to certain files.
@@ -222,9 +212,6 @@ $ git -C vendor/WebKit checkout <commit_hash>
 # Optionally, you can use `make jsc` for a release build
 $ make jsc-debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
 
-# After an initial run of `make jsc-debug`, you can rebuild JSC with:
-$ cmake --build vendor/WebKit/WebKitBuild/Debug --target jsc && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
-
 # Build bun with the local JSC build
 $ bun run build:local
 ```
@@ -263,7 +250,7 @@ The issue may manifest when initially running `bun setup` as Clang being unable
 ```
 The C++ compiler
 
-  "/usr/bin/clang++-19"
+  "/usr/bin/clang++-18"
 
 is not able to compile a simple test program.
 ```

LATEST

@@ -1 +1 @@
-1.2.12
+1.2.5

Makefile

@@ -1183,8 +1183,6 @@ jsc-copy-headers:
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/runtime/SymbolObject.h $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/SymbolObject.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/runtime/JSGenerator.h $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/JSGenerator.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/bytecode/UnlinkedFunctionCodeBlock.h $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/UnlinkedFunctionCodeBlock.h
-	cp $(WEBKIT_DIR)/Source/JavaScriptCore/bytecode/GlobalCodeBlock.h $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/GlobalCodeBlock.h
-	cp $(WEBKIT_DIR)/Source/JavaScriptCore/bytecode/ProgramCodeBlock.h $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/ProgramCodeBlock.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/runtime/AggregateError.h $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/AggregateError.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/API/JSWeakValue.h  $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/JSWeakValue.h
 	find $(WEBKIT_RELEASE_DIR)/JavaScriptCore/Headers/JavaScriptCore/ -name "*.h" -exec cp {} $(WEBKIT_RELEASE_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/ \;
@@ -1236,8 +1234,6 @@ jsc-copy-headers-debug:
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/runtime/SymbolObject.h $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/SymbolObject.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/runtime/JSGenerator.h $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/JSGenerator.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/bytecode/UnlinkedFunctionCodeBlock.h $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/UnlinkedFunctionCodeBlock.h
-	cp $(WEBKIT_DIR)/Source/JavaScriptCore/bytecode/GlobalCodeBlock.h $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/GlobalCodeBlock.h
-	cp $(WEBKIT_DIR)/Source/JavaScriptCore/bytecode/ProgramCodeBlock.h $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/ProgramCodeBlock.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/runtime/AggregateError.h $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/AggregateError.h
 	cp $(WEBKIT_DIR)/Source/JavaScriptCore/API/JSWeakValue.h  $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/JSWeakValue.h
 	find $(WEBKIT_DEBUG_DIR)/JavaScriptCore/Headers/JavaScriptCore/ -name "*.h" -exec cp {} $(WEBKIT_DEBUG_DIR)/JavaScriptCore/PrivateHeaders/JavaScriptCore/ \;
@@ -1396,7 +1392,7 @@ jsc-build-linux-compile-build-debug:
 		cmake --build $(WEBKIT_DEBUG_DIR) --config Debug --target jsc
 
 
-jsc-build-mac: jsc-force-fastjit jsc-build-mac-compile
+jsc-build-mac: jsc-force-fastjit jsc-build-mac-compile jsc-build-copy
 jsc-build-mac-debug: jsc-force-fastjit jsc-build-mac-compile-debug
 
 jsc-build-linux: jsc-build-linux-compile-config jsc-build-linux-compile-build jsc-build-copy

bench/crypto/aes-gcm-throughput.mjs

@@ -1,44 +0,0 @@
-import { bench, run } from "../runner.mjs";
-import crypto from "node:crypto";
-import { Buffer } from "node:buffer";
-
-const keylen = { "aes-128-gcm": 16, "aes-192-gcm": 24, "aes-256-gcm": 32 };
-const sizes = [4 * 1024, 1024 * 1024];
-const ciphers = ["aes-128-gcm", "aes-192-gcm", "aes-256-gcm"];
-
-const messages = {};
-sizes.forEach(size => {
-  messages[size] = Buffer.alloc(size, "b");
-});
-
-const keys = {};
-ciphers.forEach(cipher => {
-  keys[cipher] = crypto.randomBytes(keylen[cipher]);
-});
-
-// Fixed IV and AAD
-const iv = crypto.randomBytes(12);
-const associate_data = Buffer.alloc(16, "z");
-
-for (const cipher of ciphers) {
-  for (const size of sizes) {
-    const message = messages[size];
-    const key = keys[cipher];
-
-    bench(`${cipher} ${size / 1024}KB`, () => {
-      const alice = crypto.createCipheriv(cipher, key, iv);
-      alice.setAAD(associate_data);
-      const enc = alice.update(message);
-      alice.final();
-      const tag = alice.getAuthTag();
-
-      const bob = crypto.createDecipheriv(cipher, key, iv);
-      bob.setAuthTag(tag);
-      bob.setAAD(associate_data);
-      bob.update(enc);
-      bob.final();
-    });
-  }
-}
-
-await run();

bench/express/tsconfig.json

@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     // Enable latest features
-    "lib": ["ESNext"],
+    "lib": ["ESNext", "DOM"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/types/global" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

bench/hot-module-reloading/css-stress-test/run.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+
+echo "Running next at 24ms"
+PROJECT=next SLEEP_INTERVAL=24 make generate &
+PROJECT=next SLEEP_INTERVAL=24 make loop
+killall Chromium || echo "";
+PROJECT=next SLEEP_INTERVAL=24 make process_video
+PROJECT=next SLEEP_INTERVAL=24 make frames -j$(nproc)
+PROJECT=next SLEEP_INTERVAL=24 make trim
+cp src/colors.css.blob next/colors.css.blob
+PROJECT=next SLEEP_INTERVAL=24 make print > "next.latest.24ms.txt"
+
+echo "Running bun at 24ms"
+PROJECT=bun SLEEP_INTERVAL=24 make generate &
+PROJECT=bun SLEEP_INTERVAL=24 make loop
+killall Chromium || echo "";
+PROJECT=bun SLEEP_INTERVAL=24 make process_video
+PROJECT=bun SLEEP_INTERVAL=24 make frames -j$(nproc)
+PROJECT=bun SLEEP_INTERVAL=24 make trim
+cp src/colors.css.blob bun/colors.css.blob
+PROJECT=bun SLEEP_INTERVAL=24 make print > "bun.latest.24ms.txt"
+
+echo "Running next at 16ms"
+PROJECT=next SLEEP_INTERVAL=16 make generate &
+PROJECT=next SLEEP_INTERVAL=16 make loop
+killall Chromium || echo "";
+PROJECT=next SLEEP_INTERVAL=16 make process_video
+PROJECT=next SLEEP_INTERVAL=16 make frames -j$(nproc)
+PROJECT=next SLEEP_INTERVAL=16 make trim
+cp src/colors.css.blob next/colors.css.blob
+PROJECT=next SLEEP_INTERVAL=16 make print > "next.latest.16ms.txt"
+
+echo "Running bun at 16ms"
+PROJECT=bun SLEEP_INTERVAL=16 make generate &
+PROJECT=bun SLEEP_INTERVAL=16 make loop
+killall Chromium || echo "";
+PROJECT=bun SLEEP_INTERVAL=16 make process_video
+PROJECT=bun SLEEP_INTERVAL=16 make frames -j$(nproc)
+PROJECT=bun SLEEP_INTERVAL=16 make trim
+cp src/colors.css.blob bun/colors.css.blob
+PROJECT=bun SLEEP_INTERVAL=16 make print > "bun.latest.16ms.txt"
+
+echo "Running bun at 8ms"
+PROJECT=bun SLEEP_INTERVAL=8 make generate &
+PROJECT=bun SLEEP_INTERVAL=8 make loop
+killall Chromium || echo "";
+PROJECT=bun SLEEP_INTERVAL=8 make process_video
+PROJECT=bun SLEEP_INTERVAL=8 make frames -j$(nproc)
+PROJECT=bun SLEEP_INTERVAL=8 make trim
+cp src/colors.css.blob bun/colors.css.blob
+PROJECT=bun SLEEP_INTERVAL=8 make print > "bun.latest.8ms.txt"
+
+
+echo "Running next at 8ms"
+PROJECT=next SLEEP_INTERVAL=8 make generate &
+PROJECT=next SLEEP_INTERVAL=8 make loop
+killall Chromium || echo "";
+PROJECT=next SLEEP_INTERVAL=8 make process_video
+PROJECT=next SLEEP_INTERVAL=8 make frames -j$(nproc)
+PROJECT=next SLEEP_INTERVAL=8 make trim
+cp src/colors.css.blob next/colors.css.blob
+PROJECT=next SLEEP_INTERVAL=8 make print > "next.latest.8ms.txt"
+
+echo "Running bun at 32ms"
+PROJECT=bun SLEEP_INTERVAL=32 make generate &
+PROJECT=bun SLEEP_INTERVAL=32 make loop
+killall Chromium || echo "";
+PROJECT=bun SLEEP_INTERVAL=32 make process_video
+PROJECT=bun SLEEP_INTERVAL=32 make frames -j$(nproc)
+PROJECT=bun SLEEP_INTERVAL=32 make trim
+cp src/colors.css.blob bun/colors.css.blob
+PROJECT=bun SLEEP_INTERVAL=32 make print > "bun.latest.32ms.txt"
+
+echo "Running next at 32ms"
+PROJECT=next SLEEP_INTERVAL=32 make generate &
+PROJECT=next SLEEP_INTERVAL=32 make loop
+killall Chromium || echo "";
+PROJECT=next SLEEP_INTERVAL=32 make process_video
+PROJECT=next SLEEP_INTERVAL=32 make frames -j$(nproc)
+PROJECT=next SLEEP_INTERVAL=32 make trim
+cp src/colors.css.blob next/colors.css.blob
+PROJECT=next SLEEP_INTERVAL=32 make print > "next.latest.32ms.txt"
+

bench/hot-module-reloading/css-stress-test/src/colors.css.0

@@ -0,0 +1,14 @@
+:root {
+  --timestamp: "0";
+  --interval: "8";
+  --progress-bar: 0%;
+  --spinner-1-muted: rgb(179, 6, 202);
+  --spinner-1-primary: rgb(224, 8, 253);
+  --spinner-2-muted: rgb(22, 188, 124);
+  --spinner-2-primary: rgb(27, 235, 155);
+  --spinner-3-muted: rgb(89, 72, 0);
+  --spinner-3-primary: rgb(111, 90, 0);
+  --spinner-4-muted: rgb(18, 84, 202);
+  --spinner-4-primary: rgb(23, 105, 253);
+  --spinner-rotate: 304deg;
+}

bench/hot-module-reloading/css-stress-test/src/css-in-js-styles.0

@@ -0,0 +1,23 @@
+import { Global } from "@emotion/react";
+export function CSSInJSStyles() {
+  return (
+    <Global
+      styles={`
+      :root {
+        --timestamp: "0";
+        --interval: "8";
+        --progress-bar: 11.83299999999997%;
+        --spinner-1-muted: rgb(142, 6, 182);
+        --spinner-1-primary: rgb(177, 8, 227);
+        --spinner-2-muted: rgb(110, 148, 190);
+        --spinner-2-primary: rgb(138, 185, 238);
+        --spinner-3-muted: rgb(75, 45, 64);
+        --spinner-3-primary: rgb(94, 56, 80);
+        --spinner-4-muted: rgb(155, 129, 108);
+        --spinner-4-primary: rgb(194, 161, 135);
+        --spinner-rotate: 213deg;
+      }
+  `}
+    />
+  );
+}

bench/hot-module-reloading/css-stress-test/src/css-in-js-styles.tsx

@@ -0,0 +1,22 @@
+import { Global } from "@emotion/react";
+export function CSSInJSStyles() {
+  return (
+    <Global
+      styles={`
+:root {
+  --timestamp: "16336621338281";
+  --interval: "16";
+  --progress-bar: 56.889%;
+  --spinner-1-muted: rgb(179, 6, 202);
+  --spinner-1-primary: rgb(224, 8, 253);
+  --spinner-2-muted: rgb(22, 188, 124);
+  --spinner-2-primary: rgb(27, 235, 155);
+  --spinner-3-muted: rgb(89, 72, 0);
+  --spinner-3-primary: rgb(111, 90, 0);
+  --spinner-4-muted: rgb(18, 84, 202);
+  --spinner-4-primary: rgb(23, 105, 253);
+  --spinner-rotate: 304deg;
+}  `}
+    />
+  );
+}

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

@@ -0,0 +1,248 @@
+@import "./colors.css";
+
+:root {
+  --heading-font: "Space Mono", system-ui;
+  --body-font: "IBM Plex Sans", system-ui;
+
+  --color-brand: #02ff00;
+  --color-brand-muted: rgb(2, 150, 0);
+
+  --padding-horizontal: 90px;
+
+  --page-background: black;
+  --page-background-alpha: rgba(0, 0, 0, 0.8);
+
+  --result__background-color: black;
+  --result__primary-color: var(--color-brand);
+  --result__foreground-color: white;
+  --result__muted-color: rgb(165, 165, 165);
+
+  --card-width: 352px;
+
+  --page-width: 1152px;
+
+  --snippets_container-background-unfocused: #171717;
+  --snippets_container-background-focused: #0017e9;
+  --snippets_container-background: var(
+    --snippets_container-background-unfocused
+  );
+  --snippets_container-muted-color: rgb(153, 153, 153);
+}
+
+body {
+  color: white;
+  margin: 0;
+
+  padding: 0;
+  font-family: var(--body-font);
+  background-color: var(--page-background);
+  color: var(--result__muted-color);
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+}
+
+.Subtitle {
+  text-align: center;
+  font-size: 4em;
+  margin: 0;
+  padding: 0;
+  margin-bottom: 0.25em;
+
+  align-items: center;
+  display: flex;
+  flex-direction: row;
+}
+
+#reactroot,
+#__next,
+body,
+html {
+  height: 100%;
+}
+
+.Title {
+  color: var(--color-brand);
+  font-family: var(--heading-font);
+  font-weight: 700;
+  margin-top: 48px;
+  font-size: 48px;
+  text-transform: capitalize;
+  text-align: center;
+}
+
+.Description {
+  text-align: center;
+}
+
+.main {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+}
+
+header,
+.main {
+  width: 650px;
+  margin: 0 auto;
+}
+
+section {
+  width: 650px;
+}
+
+header {
+  margin-bottom: 48px;
+}
+
+footer {
+  flex-shrink: 0;
+}
+
+#reactroot,
+#__next {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+}
+
+section {
+  height: 300px;
+  display: flex;
+  flex-direction: column;
+}
+
+.ran,
+.timer {
+  white-space: nowrap;
+  font-weight: bold;
+  -webkit-text-stroke: white;
+  -webkit-text-stroke-width: 2px;
+  color: white;
+  font-size: 100px;
+}
+.ran {
+}
+
+.ProgressBar-container {
+  width: 100%;
+  display: block;
+  position: relative;
+  border-left: 10px solid red;
+  border-right: 10px solid pink;
+  border-top: 10px solid yellow;
+  border-bottom: 10px solid orange;
+  border-radius: 4px;
+
+  height: 92px;
+}
+
+.ProgressBar {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  right: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  display: block;
+  background-color: var(--color-brand);
+  transform-origin: top left;
+  border-radius: 4px;
+  transform: scaleX(var(--progress-bar, 0%));
+}
+
+.Bundler-container {
+  background-color: var(--snippets_container-background-focused);
+  font-size: 64px;
+  font-weight: bold;
+  color: white;
+  left: 0;
+  right: 0;
+  padding: 0.8em 0.8em;
+}
+
+.Bundler-updateRate {
+  font-size: 0.8em;
+  font-weight: normal;
+  display: flex;
+  color: var(--result__muted-color);
+}
+
+.interval:before {
+  content: var(--interval, "16");
+}
+
+.highlight {
+  margin-left: 0.5ch;
+  color: white;
+}
+
+.timer:after {
+  content: var(--timestamp);
+  font-variant-numeric: tabular-nums;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen,
+    Ubuntu, Cantarell, "Open Sans", "Helvetica Neue", sans-serif;
+  display: inline;
+  font-weight: 500;
+  color: white;
+  width: 100%;
+}
+
+.SectionLabel {
+  font-weight: 300;
+  font-family: var(--heading-font);
+  text-align: center;
+  width: 100%;
+  font-weight: 700;
+  margin-top: 24px;
+}
+
+.FooterLabel {
+  margin-top: 0;
+  margin-bottom: 12px;
+}
+
+.Spinner-container {
+  --spinner-muted: rgb(0, 255, 0);
+  --spinner-primary: rgb(0, 60, 255);
+
+  width: 96px;
+  height: 96px;
+  border-radius: 50%;
+  background-color: var(--page-background);
+  border-top: 1.1em solid var(--spinner-muted);
+  border-right: 1.1em solid var(--spinner-muted);
+  border-bottom: 1.1em solid var(--spinner-muted);
+  border-left: 1.1em solid var(--spinner-primary);
+
+  transform: rotate(var(--spinner-rotate, 12deg));
+}
+
+.Spinners {
+  display: grid;
+  grid-auto-flow: column;
+  justify-content: space-between;
+
+  width: 100%;
+}
+
+.Spinner-1.Spinner-container {
+  --spinner-muted: var(--spinner-1-muted);
+  --spinner-primary: var(--spinner-1-primary);
+}
+
+.Spinner-2.Spinner-container {
+  --spinner-muted: var(--spinner-2-muted);
+  --spinner-primary: var(--spinner-2-primary);
+}
+
+.Spinner-3.Spinner-container {
+  --spinner-muted: var(--spinner-3-muted);
+  --spinner-primary: var(--spinner-3-primary);
+}
+
+.Spinner-4.Spinner-container {
+  --spinner-muted: var(--spinner-4-muted);
+  --spinner-primary: var(--spinner-4-primary);
+}

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

@@ -0,0 +1,21 @@
+import ReactDOM from "react-dom";
+import { Main } from "./main";
+
+const Base = () => {
+  const name = typeof location !== "undefined" ? decodeURIComponent(location.search.substring(1)) : null;
+  return <Main productName={name} />;
+};
+
+function startReact() {
+  ReactDOM.hydrate(<Base />, document.querySelector("#reactroot"));
+}
+
+if (typeof window !== "undefined") {
+  globalThis.addEventListener("DOMContentLoaded", () => {
+    startReact();
+  });
+
+  startReact();
+}
+
+export { Base };

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

@@ -0,0 +1,56 @@
+export const Main = (props: { productName: string; cssInJS?: string }) => {
+  return (
+    <>
+      <header>
+        <div className="Title">CSS HMR Stress Test!</div>
+        <p className="Description">
+          This page visually tests how quickly a bundler can update {props.cssInJS ? "CSS-in-JS" : "CSS"} over Hot
+          Module Reloading.
+        </p>
+      </header>
+      <main className="main">
+        <section className="ProgressSection">
+          <p className="Subtitle">
+            <span className="Subtitle-part ran">
+              Ran: <span className="timer"></span>
+            </span>
+          </p>
+
+          <div className="ProgressBar-container">
+            <div className="ProgressBar"></div>
+          </div>
+          <div className="SectionLabel">The progress bar should move from left to right smoothly.</div>
+        </section>
+
+        <section>
+          <div className="Spinners">
+            <div className="Spinner-container Spinner-1">
+              <div className="Spinner"></div>
+            </div>
+
+            <div className="Spinner-container Spinner-2">
+              <div className="Spinner"></div>
+            </div>
+
+            <div className="Spinner-container Spinner-3">
+              <div className="Spinner"></div>
+            </div>
+
+            <div className="Spinner-container Spinner-4">
+              <div className="Spinner"></div>
+            </div>
+          </div>
+          <div className="SectionLabel">The spinners should rotate &amp; change color smoothly.</div>
+        </section>
+      </main>
+      <footer>
+        <div className="SectionLabel FooterLabel">There are no CSS animations on this page.</div>
+
+        <div className="Bundler-container">
+          <div className="Bundler">{props.productName}</div>
+          <div className="Bundler-updateRate">{props.cssInJS ? "CSS-in-JS framework: " + props.cssInJS : ""}</div>
+        </div>
+      </footer>
+    </>
+  );
+};

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

@@ -0,0 +1,178 @@
+{
+  "label": "bun-cli@0.0.34",
+  "at": "2021-10-08T01:01:18.129Z",
+  "sleep": "32",
+  "package": {
+    "name": "bun-cli",
+    "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
+  ],
+  "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
+  ],
+  "percentileMs": {
+    "50": 40.7,
+    "75": 42.3,
+    "90": 43.5,
+    "95": 76.4,
+    "99": 118.8
+  }
+}

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

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "jsx": "react-jsx",
+    "paths": {}
+  }
+}

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

@@ -0,0 +1,5 @@
+import reactRefresh from "@vitejs/plugin-react-refresh";
+
+export default {
+  plugins: [reactRefresh()],
+};

bench/hot-module-reloading/readme.md

@@ -0,0 +1,15 @@
+# Benchmarking hot module reloading
+
+## Methodology
+
+How do you benchmark hot module reloading? What do you call "done" and what do you call "start"?
+
+The answer for "done" is certainly not compilation time. Compilation time is one step.
+
+I think the answer should be different depending on the type of content loaded.
+
+For CSS, the answer should be "when the updated stylesheet was drawn on the screen"
+For JavaScript, the answer should be "when the rebuilt code completed execution such that any changes are applied"
+For images & assets, the answer should be "when the updated asset finished loading"
+
+The start time should be defined as "the timestamp the filesystem set as the write time". As in, the time the developer pressed save in their editor.

bench/postgres/tsconfig.json

@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     // Enable latest features
-    "lib": ["ESNext"],
+    "lib": ["ESNext", "DOM"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",

bench/snippets/redis-simple.mjs

@@ -1,28 +0,0 @@
-import ioredis from "ioredis";
-
-const redis = process.argv.includes("--redis=native")
-  ? Bun.redis
-  : new ioredis("redis://localhost:6379", {
-      enableAutoPipelining: true,
-    });
-
-const isBun = globalThis.Bun && redis === Bun.redis;
-for (let count of [100, 1000]) {
-  function iterate() {
-    const promises = new Array(count);
-    for (let i = 0; i < count; i++) {
-      promises[i] = redis.get("greeting");
-    }
-
-    return Promise.all(promises);
-  }
-
-  const label = isBun ? `Bun.redis` : `ioredis`;
-  console.time(`GET 'greeting' batches of ${count} - ${label} (${count} iterations)`);
-  for (let i = 0; i < 1000; i++) {
-    await iterate();
-  }
-  console.timeEnd(`GET 'greeting' batches of ${count} - ${label} (${count} iterations)`);
-}
-
-process.exit(0);

bench/snippets/request-method-getter.mjs

@@ -1,14 +0,0 @@
-import { bench, run } from "../runner.mjs";
-
-const url = "http://localhost:3000/";
-const clonable = new Request(url);
-
-bench("request.clone().method", () => {
-  return clonable.clone().method;
-});
-
-bench("new Request(url).method", () => {
-  return new Request(url).method;
-});
-
-await run();

bench/stress/hot-reload-files/.gitignore

@@ -1 +0,0 @@
-modules

bench/stress/hot-reload-files/README.md

@@ -1,48 +0,0 @@
-# Hot Reload Files Stress Test
-
-This is a stress test for Bun's hot reloading functionality, designed to test performance with a high number of interdependent files.
-
-## What It Does
-
-- Generates 1000 interconnected TypeScript modules
-- Each module imports 2 other modules
-- Uses IPC (Inter-Process Communication) to detect reloads
-- Performs 1,000 hot reloads and tracks memory usage
-- Reports statistics about hot reload performance
-
-## Usage
-
-```bash
-./run-stress-test.sh
-```
-
-This will:
-
-1. Generate 1000 interconnected modules
-2. Run the stress test that performs 10,000 hot reloads
-3. Report complete performance statistics
-
-## How The Test Works
-
-The test utilizes Node.js's child_process fork API for communication:
-
-1. The main process (stress-test.ts) creates a child process running Bun with hot reloading
-2. The modules communicate with the parent process via IPC when they're reloaded
-3. After detecting a successful reload, the parent modifies another file
-4. This continues for 1,000 iterations
-5. Memory usage is tracked throughout the process
-
-## Architecture
-
-- **generate.ts**: Creates 1000 interconnected modules with IPC signaling
-- **stress-test.ts**: Controls the test, forks Bun, and tracks metrics
-- **run-stress-test.sh**: Script to run the entire test from scratch
-
-## Performance Metrics
-
-The test reports:
-
-- Total number of hot reloads completed
-- Time taken to complete all reloads
-- Average time per reload
-- Initial and final RSS memory usage

bench/stress/hot-reload-files/generate.ts

@@ -1,166 +0,0 @@
-import { mkdir, writeFile } from "fs/promises";
-import { join } from "path";
-
-const MODULES_DIR = join(process.cwd(), "modules");
-const NUM_MODULES = 1000;
-
-// Create the modules directory if it doesn't exist
-async function ensureModulesDir() {
-  try {
-    await mkdir(MODULES_DIR, { recursive: true });
-    console.log(`Created directory: ${MODULES_DIR}`);
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code !== "EEXIST") {
-      throw err;
-    }
-  }
-}
-
-const html = `
-<!DOCTYPE html>
-<html>
-<head>
-  <title>Hot Reload Stress Test</title>
-  <script src="./client_1.js"></script>
-</head>
-<body>
-  <h1>Hot Reload Stress Test</h1>
-</body>
-</html>
-`;
-
-// Generate the HTTP server file (the last file)
-async function generateServerFile() {
-  const content = `
-// File: module_${NUM_MODULES}.ts
-console.log("Server module loaded");
-import html from './index.html';
-
-// Create a server to prove things are running
-const server = Bun.serve({
-  port: 0,
-  routes: {
-    "/": html,
-  },
-  fetch() {
-    return new Response("Hot reload stress test server running");
-  },
-});
-
-if (process.send) {
-  process.send({
-    type: "server-started",
-    url: server.url.href,
-  });
-}
-
-console.log(\`Server started on http://localhost:\${server.port}\`);
-
-// Print RSS memory usage
-const rss = process.memoryUsage().rss / 1024 / 1024;
-console.log(\`RSS Memory: \${rss.toFixed(2)} MB\`);
-`;
-
-  await writeFile(join(MODULES_DIR, `module_${NUM_MODULES}.ts`), content);
-}
-
-// Generate interconnected module files
-async function generateModuleFiles() {
-  // Generate modules 1 through NUM_MODULES-1
-  for (let i = 1; i < NUM_MODULES; i++) {
-    // Each module imports 2 other modules (except for the ones near the end that need to import the server)
-    const importIdx1 = Math.min(i + 1, NUM_MODULES);
-    const importIdx2 = Math.min(i + 2, NUM_MODULES);
-
-    const content = `
-// File: module_${i}.ts
-import "./module_${importIdx1}";
-import "./module_${importIdx2}";
-
-// This value will be changed during hot reload stress testing
-export const value${i} = {
-  moduleId: ${i},
-  timestamp: \`\${new Date().toISOString()}\`,
-  counter: 0
-};
-
-`;
-
-    await writeFile(join(MODULES_DIR, `module_${i}.ts`), content);
-
-    if (i % 100 === 0) {
-      console.log(`Generated ${i} modules`);
-    }
-  }
-}
-
-// Generate the entry point file
-async function generateEntryPoint() {
-  const content = `
-
-if (!globalThis.hasLoadedOnce) {
-globalThis.hasLoadedOnce = true;
-console.log("Starting hot-reload stress test...");
-
-// Print RSS memory usage
-const rss = process.memoryUsage().rss / 1024 / 1024;
-console.log(\`RSS Memory: \${rss.toFixed(2)} MB\`);
-
-// Signal when the entry point is loaded
-if (process.send && process.env.HOT_RELOAD_TEST === "true") {
-  process.send({
-    type: 'test-started',
-    rss: rss.toFixed(2)
-  });
-}
-
-// Print memory usage periodically
-setInterval(() => {
-  const rss = process.memoryUsage().rss / 1024 / 1024;
-  console.log(\`[MEMORY] RSS: \${rss.toFixed(2)} MB at \${new Date().toISOString()}\`);
-  
-  // Also send via IPC if available
-  if (process.send && process.env.HOT_RELOAD_TEST === "true") {
-    process.send({
-      type: 'memory-update',
-      rss: rss.toFixed(2),
-      time: Date.now()
-    });
-  }
-}, 5000);
-}
-
-await import("./module_1");
-
-process.send({
-  type: "module-reloaded",
-  rss: (process.memoryUsage.rss() / 1024 / 1024) | 0,
-});
-
-
-`;
-
-  await writeFile(join(MODULES_DIR, "index.ts"), content);
-}
-
-async function generateClientFile() {
-  const content = `
-// File: client_1.js
-console.log("Client module loaded");
-`;
-  await writeFile(join(MODULES_DIR, "client_1.js"), content);
-  await writeFile(join(MODULES_DIR, "index.html"), html);
-  console.log("Generated client module");
-}
-
-await ensureModulesDir();
-console.log("Generating server module...");
-await generateServerFile();
-console.log("Generating client module...");
-await generateClientFile();
-console.log("Generating interconnected modules...");
-await generateModuleFiles();
-console.log("Generating entry point...");
-await generateEntryPoint();
-console.log("Generation complete!");
-console.log("Run with: HOT_RELOAD_TEST=true RELOAD_ID=initial bun --hot modules/index.ts");

bench/stress/hot-reload-files/run-stress-test.sh

@@ -1,14 +0,0 @@
-#!/bin/bash
-
-# Clean up modules directory
-rm -rf modules
-
-# Generate the module files
-echo "Generating 1000 module files..."
-bun generate.ts
-
-# Run the stress test
-echo "Running stress test for 1000 reloads..."
-bun stress-test.ts
-
-# All done - the stress test manages the child process internally

bench/stress/hot-reload-files/stress-test.ts

@@ -1,161 +0,0 @@
-import { Subprocess } from "bun";
-import { readFile, writeFile } from "fs/promises";
-import { join } from "path";
-
-const MODULES_DIR = join(process.cwd(), "modules");
-const NUM_MODULES = 1000;
-const TOTAL_RELOADS = 1000;
-
-// Tracking metrics
-let completedReloads = 0;
-let startTime = 0;
-let lastRss = 0;
-
-// Function to write modified files
-async function modifyFile(moduleNum: number, reloadId: string): Promise<void> {
-  const modulePath = join(MODULES_DIR, `module_${moduleNum}.ts`);
-
-  try {
-    // Read the current file content
-    const content = await readFile(modulePath, "utf8");
-
-    // Create a new timestamp
-    const timestamp = new Date().toISOString();
-
-    // Replace the timestamp and counter
-    const newContent = content.replace(
-      /export const value\d+ = \{[\s\S]*?\};/,
-      `export const value${moduleNum} = {
-  moduleId: ${moduleNum},
-  timestamp: "${timestamp}",
-  // comment ${completedReloads}!
-  counter: ${completedReloads + 1}
-};
-
-`,
-    );
-
-    // Write the modified content back to the file
-    await writeFile(modulePath, newContent);
-    console.count("Modify");
-    return;
-  } catch (error) {
-    console.error(`Error modifying module_${moduleNum}.ts:`, error);
-    throw error;
-  }
-}
-
-// Get a random number between min and max (inclusive)
-function getRandomInt(min: number, max: number): number {
-  return Math.floor(Math.random() * (max - min + 1)) + min;
-}
-
-// Start the child process with Bun's hot reloading
-function startBunProcess() {
-  // Start the Bun process with hot reloading enabled
-  const child = Bun.spawn({
-    cmd: [process.execPath, "--hot", "--no-clear-screen", "./modules/index.ts"],
-    stdio: ["inherit", "inherit", "inherit"],
-    env: {
-      ...process.env,
-      HOT_RELOAD_TEST: "true",
-      RELOAD_ID: "initial",
-    },
-    ipc(message, subprocess) {
-      if (message.type === "test-started") {
-        console.log(`Test started with initial RSS: ${message.rss} MB`);
-        lastRss = parseFloat(message.rss);
-        startNextReload();
-      } else if (message.type === "module-reloaded") {
-        const { rss } = message;
-        lastRss = parseFloat(rss);
-
-        // Check if this is the current reload we're waiting for
-        completedReloads++;
-        console.log(`[${completedReloads}/${TOTAL_RELOADS}] Module reloaded - RSS: ${rss} MB`);
-
-        // Start the next reload or finish
-        if (completedReloads < TOTAL_RELOADS) {
-          startNextReload();
-        } else {
-          finishTest();
-        }
-      } else if (message.type === "memory-update") {
-        // Periodic memory updates from the child process
-        lastRss = parseFloat(message.rss);
-      } else if (message.type === "server-started") {
-        fetch(message.url).then(res => {
-          res.text().then(text => {
-            console.count("Request completed");
-          });
-        });
-      }
-    },
-  });
-
-  return child;
-}
-
-// Start the next reload
-async function startNextReload() {
-  const nextReloadNum = completedReloads + 1;
-  if (nextReloadNum > TOTAL_RELOADS) return;
-
-  try {
-    // Generate a unique reload ID for this reload
-    const reloadId = `reload-${nextReloadNum}`;
-
-    // Set the reload ID in the environment for the child process
-    process.env.RELOAD_ID = reloadId;
-
-    // Pick a random module to modify
-    const moduleNum = getRandomInt(1, NUM_MODULES - 1);
-
-    // Modify the file to trigger a hot reload
-    await modifyFile(moduleNum, reloadId);
-  } catch (error) {
-    console.error(`Error during reload #${nextReloadNum}:`, error);
-    // Try the next reload immediately
-    startNextReload();
-  }
-}
-
-// Finish the test and print statistics
-function finishTest() {
-  const endTime = Date.now();
-  const duration = (endTime - startTime) / 1000;
-
-  console.log(`\nStress test complete!`);
-  console.log(`Performed ${completedReloads} hot reloads in ${duration.toFixed(2)} seconds`);
-  console.log(`Average: ${((duration / completedReloads) * 1000).toFixed(2)} ms per reload`);
-  console.log(`Final RSS: ${lastRss.toFixed(2)} MB`);
-
-  // Kill the child process and exit immediately
-  if (childProcess) {
-    childProcess.kill();
-  }
-  process.exit(0);
-}
-
-// Run the stress test
-let childProcess: Subprocess | null = null;
-
-async function runStressTest() {
-  console.log(`Starting stress test - will perform ${TOTAL_RELOADS} hot reloads`);
-  startTime = Date.now();
-
-  // Start the Bun process with hot reloading
-  childProcess = startBunProcess();
-}
-
-// Start the stress test
-runStressTest();
-
-// Handle process termination
-process.on("SIGINT", () => {
-  console.log("\nTest interrupted by user");
-  if (childProcess) {
-    childProcess.kill();
-  }
-  process.exit(1);
-});

build.zig

@@ -4,7 +4,7 @@ const builtin = @import("builtin");
 const Build = std.Build;
 const Step = Build.Step;
 const Compile = Step.Compile;
-const LazyPath = Build.LazyPath;
+const LazyPath = Step.LazyPath;
 const Target = std.Target;
 const ResolvedTarget = std.Build.ResolvedTarget;
 const CrossTarget = std.zig.CrossTarget;
@@ -18,21 +18,21 @@ const OperatingSystem = @import("src/env.zig").OperatingSystem;
 
 const pathRel = fs.path.relative;
 
-/// When updating this, make sure to adjust SetupZig.cmake
+/// Do not rename this constant. It is scanned by some scripts to determine which zig version to install.
 const recommended_zig_version = "0.14.0";
 
-// comptime {
-//     if (!std.mem.eql(u8, builtin.zig_version_string, recommended_zig_version)) {
-//         @compileError(
-//             "" ++
-//                 "Bun requires Zig version " ++ recommended_zig_version ++ ", but you have " ++
-//                 builtin.zig_version_string ++ ". This is automatically configured via Bun's " ++
-//                 "CMake setup. You likely meant to run `bun run build`. If you are trying to " ++
-//                 "upgrade the Zig compiler, edit ZIG_COMMIT in cmake/tools/SetupZig.cmake or " ++
-//                 "comment this error out.",
-//         );
-//     }
-// }
+comptime {
+    if (!std.mem.eql(u8, builtin.zig_version_string, recommended_zig_version)) {
+        @compileError(
+            "" ++
+                "Bun requires Zig version " ++ recommended_zig_version ++ ", but you have " ++
+                builtin.zig_version_string ++ ". This is automatically configured via Bun's " ++
+                "CMake setup. You likely meant to run `bun run build`. If you are trying to " ++
+                "upgrade the Zig compiler, edit ZIG_COMMIT in cmake/tools/SetupZig.cmake or " ++
+                "comment this error out.",
+        );
+    }
+}
 
 const zero_sha = "0000000000000000000000000000000000000000";
 
@@ -92,9 +92,7 @@ const BunBuildOptions = struct {
         opts.addOption([:0]const u8, "sha", b.allocator.dupeZ(u8, this.sha) catch @panic("OOM"));
         opts.addOption(bool, "baseline", this.isBaseline());
         opts.addOption(bool, "enable_logs", this.enable_logs);
-        opts.addOption(bool, "enable_asan", this.enable_asan);
         opts.addOption([]const u8, "reported_nodejs_version", b.fmt("{}", .{this.reported_nodejs_version}));
-        opts.addOption(bool, "zig_self_hosted_backend", this.no_llvm);
 
         const mod = opts.createModule();
         this.cached_options_module = mod;
@@ -155,6 +153,13 @@ pub fn build(b: *Build) !void {
     std.log.info("zig compiler v{s}", .{builtin.zig_version_string});
     checked_file_exists = std.AutoHashMap(u64, void).init(b.allocator);
 
+    // TODO: Upgrade path for 0.14.0
+    // b.graph.zig_lib_directory = brk: {
+    //     const sub_path = "vendor/zig/lib";
+    //     const dir = try b.build_root.handle.openDir(sub_path, .{});
+    //     break :brk .{ .handle = dir, .path = try b.build_root.join(b.graph.arena, &.{sub_path}) };
+    // };
+
     var target_query = b.standardTargetOptionsQueryOnly(.{});
     const optimize = b.standardOptimizeOption(.{});
 
@@ -200,8 +205,10 @@ pub fn build(b: *Build) !void {
 
     const bun_version = b.option([]const u8, "version", "Value of `Bun.version`") orelse "0.0.0";
 
-    // Lower the default reference trace for incremental
-    b.reference_trace = b.reference_trace orelse if (b.graph.incremental == true) 8 else 16;
+    b.reference_trace = ref_trace: {
+        const trace = b.option(u32, "reference-trace", "Set the reference trace") orelse 24;
+        break :ref_trace if (trace == 0) null else trace;
+    };
 
     const obj_format = b.option(ObjectFormat, "obj_format", "Output file for object files") orelse .obj;
 
@@ -278,40 +285,6 @@ pub fn build(b: *Build) !void {
         step.dependOn(addInstallObjectFile(b, bun_obj, "bun-zig", obj_format));
     }
 
-    // zig build test
-    {
-        var step = b.step("test", "Build Bun's unit test suite");
-        var o = build_options;
-        var unit_tests = b.addTest(.{
-            .name = "bun-test",
-            .optimize = build_options.optimize,
-            .root_source_file = b.path("src/unit_test.zig"),
-            .test_runner = .{ .path = b.path("src/main_test.zig"), .mode = .simple },
-            .target = build_options.target,
-            .use_llvm = !build_options.no_llvm,
-            .use_lld = if (build_options.os == .mac) false else !build_options.no_llvm,
-            .omit_frame_pointer = false,
-            .strip = false,
-        });
-        configureObj(b, &o, unit_tests);
-        // Setting `linker_allow_shlib_undefined` causes the linker to ignore
-        // all undefined symbols.  We want this because all we care about is the
-        // object file Zig creates; we perform our own linking later. There is
-        // currently no way to make a test build that only creates an object
-        // file w/o creating an executable.
-        //
-        // See: https://github.com/ziglang/zig/issues/23374
-        unit_tests.linker_allow_shlib_undefined = true;
-        unit_tests.link_function_sections = true;
-        unit_tests.link_data_sections = true;
-        unit_tests.bundle_ubsan_rt = false;
-
-        const bin = unit_tests.getEmittedBin();
-        const obj = bin.dirname().path(b, "bun-test.o");
-        const cpy_obj = b.addInstallFile(obj, "bun-test.o");
-        step.dependOn(&cpy_obj.step);
-    }
-
     // zig build windows-shim
     {
         var step = b.step("windows-shim", "Build the Windows shim (bun_shim_impl.exe + bun_shim_debug.exe)");
@@ -335,22 +308,6 @@ pub fn build(b: *Build) !void {
         b.default_step.dependOn(step);
     }
 
-    // zig build watch
-    // const enable_watch_step = b.option(bool, "watch_step", "Enable the watch step. This reads more files so it is off by default") orelse false;
-    // if (no_llvm or enable_watch_step) {
-    //     self_hosted_watch.selfHostedExeBuild(b, &build_options) catch @panic("OOM");
-    // }
-
-    // zig build check-debug
-    {
-        const step = b.step("check-debug", "Check for semantic analysis errors on some platforms");
-        addMultiCheck(b, step, build_options, &.{
-            .{ .os = .windows, .arch = .x86_64 },
-            .{ .os = .mac, .arch = .aarch64 },
-            .{ .os = .linux, .arch = .x86_64 },
-        }, &.{.Debug});
-    }
-
     // zig build check-all
     {
         const step = b.step("check-all", "Check for semantic analysis errors on all supported platforms");
@@ -404,22 +361,7 @@ pub fn build(b: *Build) !void {
     // zig build translate-c-headers
     {
         const step = b.step("translate-c", "Copy generated translated-c-headers.zig to zig-out");
-        for ([_]TargetDescription{
-            .{ .os = .windows, .arch = .x86_64 },
-            .{ .os = .mac, .arch = .x86_64 },
-            .{ .os = .mac, .arch = .aarch64 },
-            .{ .os = .linux, .arch = .x86_64 },
-            .{ .os = .linux, .arch = .aarch64 },
-            .{ .os = .linux, .arch = .x86_64, .musl = true },
-            .{ .os = .linux, .arch = .aarch64, .musl = true },
-        }) |t| {
-            const resolved = t.resolveTarget(b);
-            step.dependOn(
-                &b.addInstallFile(getTranslateC(b, resolved, .Debug), b.fmt("translated-c-headers/{s}.zig", .{
-                    resolved.result.zigTriple(b.allocator) catch @panic("OOM"),
-                })).step,
-            );
-        }
+        step.dependOn(&b.addInstallFile(getTranslateC(b, b.graph.host, .Debug).getOutput(), "translated-c-headers.zig").step);
     }
 
     // zig build enum-extractor
@@ -436,32 +378,23 @@ pub fn build(b: *Build) !void {
     }
 }
 
-const TargetDescription = struct {
-    os: OperatingSystem,
-    arch: Arch,
-    musl: bool = false,
-
-    fn resolveTarget(desc: TargetDescription, b: *Build) std.Build.ResolvedTarget {
-        return b.resolveTargetQuery(.{
-            .os_tag = OperatingSystem.stdOSTag(desc.os),
-            .cpu_arch = desc.arch,
-            .cpu_model = getCpuModel(desc.os, desc.arch) orelse .determined_by_arch_os,
-            .os_version_min = getOSVersionMin(desc.os),
-            .glibc_version = if (desc.musl) null else getOSGlibCVersion(desc.os),
-        });
-    }
-};
-
-fn addMultiCheck(
+pub fn addMultiCheck(
     b: *Build,
     parent_step: *Step,
     root_build_options: BunBuildOptions,
-    to_check: []const TargetDescription,
+    to_check: []const struct { os: OperatingSystem, arch: Arch, musl: bool = false },
     optimize: []const std.builtin.OptimizeMode,
 ) void {
     for (to_check) |check| {
         for (optimize) |mode| {
-            const check_target = check.resolveTarget(b);
+            const check_target = b.resolveTargetQuery(.{
+                .os_tag = OperatingSystem.stdOSTag(check.os),
+                .cpu_arch = check.arch,
+                .cpu_model = getCpuModel(check.os, check.arch) orelse .determined_by_arch_os,
+                .os_version_min = getOSVersionMin(check.os),
+                .glibc_version = if (check.musl) null else getOSGlibCVersion(check.os),
+            });
+
             var options: BunBuildOptions = .{
                 .target = check_target,
                 .os = check.os,
@@ -485,13 +418,7 @@ fn addMultiCheck(
     }
 }
 
-fn getTranslateC(b: *Build, initial_target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) LazyPath {
-    const target = b.resolveTargetQuery(q: {
-        var query = initial_target.query;
-        if (query.os_tag == .windows)
-            query.abi = .gnu;
-        break :q query;
-    });
+fn getTranslateC(b: *Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *Step.TranslateC {
     const translate_c = b.addTranslateC(.{
         .root_source_file = b.path("src/c-headers-for-zig.h"),
         .target = target,
@@ -507,73 +434,28 @@ fn getTranslateC(b: *Build, initial_target: std.Build.ResolvedTarget, optimize:
         const str, const value = entry;
         translate_c.defineCMacroRaw(b.fmt("{s}={d}", .{ str, @intFromBool(value) }));
     }
-
-    // translate-c is unable to translate the unsuffixed windows functions
-    // like `SetCurrentDirectory` since they are defined with an odd macro
-    // that translate-c doesn't handle.
-    //
-    //     #define SetCurrentDirectory __MINGW_NAME_AW(SetCurrentDirectory)
-    //
-    // In these cases, it's better to just reference the underlying function
-    // directly: SetCurrentDirectoryW. To make the error better, a post
-    // processing step is applied to the translate-c file.
-    //
-    // Additionally, this step makes it so that decls like NTSTATUS and
-    // HANDLE point to the standard library structures.
-    //
-    // We also use this to replace some `opaque` declarations generated by
-    // translate-c with their equivalents defined in our own Zig code,
-    // since our definitions have useful declarations on them.
-    const helper_exe = b.addExecutable(.{
-        .name = "process_translate_c",
-        .root_module = b.createModule(.{
-            .root_source_file = b.path("src/codegen/process_translate_c.zig"),
-            .target = b.graph.host,
-            .optimize = .Debug,
-        }),
-    });
-    const in = translate_c.getOutput();
-    const run = b.addRunArtifact(helper_exe);
-    run.addFileArg(in);
-    const out = run.addOutputFileArg("c-headers-for-zig.zig");
-    return out;
+    return translate_c;
 }
 
 pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
-    // Create `@import("bun")`, containing most of Bun's code.
-    const bun = b.createModule(.{
-        .root_source_file = b.path("src/bun.zig"),
-    });
-    bun.addImport("bun", bun); // allow circular "bun" import
-    addInternalImports(b, bun, opts);
-
-    const root = b.createModule(.{
-        .root_source_file = b.path("src/main.zig"),
-
-        // Root module gets compilation flags. Forwarded as default to dependencies.
-        .target = opts.target,
-        .optimize = opts.optimize,
-    });
-    root.addImport("bun", bun);
-
     const obj = b.addObject(.{
         .name = if (opts.optimize == .Debug) "bun-debug" else "bun",
-        .root_module = root,
+        .root_source_file = switch (opts.os) {
+            .wasm => b.path("root_wasm.zig"),
+            else => b.path("src/main.zig"),
+            // else => b.path("root_css.zig"),
+        },
+        .target = opts.target,
+        .optimize = opts.optimize,
+        .use_llvm = !opts.no_llvm,
+        .use_lld = if (opts.os == .mac) false else !opts.no_llvm,
+
+        // https://github.com/ziglang/zig/issues/17430
+        .pic = true,
+
+        .omit_frame_pointer = false,
+        .strip = false, // stripped at the end
     });
-    configureObj(b, opts, obj);
-    return obj;
-}
-
-fn configureObj(b: *Build, opts: *BunBuildOptions, obj: *Compile) void {
-    // Flags on root module get used for the compilation
-    obj.root_module.omit_frame_pointer = false;
-    obj.root_module.strip = false; // stripped at the end
-    // https://github.com/ziglang/zig/issues/17430
-    obj.root_module.pic = true;
-
-    // Object options
-    obj.use_llvm = !opts.no_llvm;
-    obj.use_lld = if (opts.os == .mac) false else !opts.no_llvm;
     if (opts.enable_asan) {
         if (@hasField(Build.Module, "sanitize_address")) {
             obj.root_module.sanitize_address = true;
@@ -583,7 +465,7 @@ fn configureObj(b: *Build, opts: *BunBuildOptions, obj: *Compile) void {
         }
     }
     obj.bundle_compiler_rt = false;
-    obj.bundle_ubsan_rt = false;
+    obj.root_module.omit_frame_pointer = false;
 
     // Link libc
     if (opts.os != .wasm) {
@@ -593,7 +475,6 @@ fn configureObj(b: *Build, opts: *BunBuildOptions, obj: *Compile) void {
 
     // Disable stack probing on x86 so we don't need to include compiler_rt
     if (opts.arch.isX86()) {
-        // TODO: enable on debug please.
         obj.root_module.stack_check = false;
         obj.root_module.stack_protector = false;
     }
@@ -608,18 +489,17 @@ fn configureObj(b: *Build, opts: *BunBuildOptions, obj: *Compile) void {
             obj.root_module.valgrind = true;
         }
     }
+    addInternalPackages(b, obj, opts);
+    obj.root_module.addImport("build_options", opts.buildOptionsModule(b));
+
+    const translate_c = getTranslateC(b, opts.target, opts.optimize);
+    obj.root_module.addImport("translated-c-headers", translate_c.createModule());
+
+    return obj;
 }
 
 const ObjectFormat = enum {
-    /// Emitting LLVM bc files could allow a stronger LTO pass, however it
-    /// doesn't yet work. It is left accessible with `-Dobj_format=bc` or in
-    /// CMake with `-DZIG_OBJECT_FORMAT=bc`.
-    ///
-    /// To use LLVM bitcode from Zig, more work needs to be done. Currently, an install of
-    /// LLVM 18.1.7 does not compatible with what bitcode Zig 0.13 outputs (has LLVM 18.1.7)
-    /// Change to "bc" to experiment, "Invalid record" means it is not valid output.
     bc,
-    /// Emit a .o / .obj file for the bun-zig object.
     obj,
 };
 
@@ -649,21 +529,16 @@ fn exists(path: []const u8) bool {
     return true;
 }
 
-fn addInternalImports(b: *Build, mod: *Module, opts: *BunBuildOptions) void {
+fn addInternalPackages(b: *Build, obj: *Compile, opts: *BunBuildOptions) void {
     const os = opts.os;
 
-    mod.addImport("build_options", opts.buildOptionsModule(b));
-
-    const translate_c = getTranslateC(b, opts.target, opts.optimize);
-    mod.addImport("translated-c-headers", b.createModule(.{ .root_source_file = translate_c }));
-
     const zlib_internal_path = switch (os) {
         .windows => "src/deps/zlib.win32.zig",
         .linux, .mac => "src/deps/zlib.posix.zig",
         else => null,
     };
     if (zlib_internal_path) |path| {
-        mod.addAnonymousImport("zlib-internal", .{
+        obj.root_module.addAnonymousImport("zlib-internal", .{
             .root_source_file = b.path(path),
         });
     }
@@ -673,7 +548,7 @@ fn addInternalImports(b: *Build, mod: *Module, opts: *BunBuildOptions) void {
         .windows => "src/async/windows_event_loop.zig",
         else => "src/async/stub_event_loop.zig",
     };
-    mod.addAnonymousImport("async", .{
+    obj.root_module.addAnonymousImport("async", .{
         .root_source_file = b.path(async_path),
     });
 
@@ -721,7 +596,7 @@ fn addInternalImports(b: *Build, mod: *Module, opts: *BunBuildOptions) void {
                 entry.import
             else
                 entry.file;
-            mod.addAnonymousImport(import_path, .{
+            obj.root_module.addAnonymousImport(import_path, .{
                 .root_source_file = .{ .cwd_relative = path },
             });
         }
@@ -731,37 +606,16 @@ fn addInternalImports(b: *Build, mod: *Module, opts: *BunBuildOptions) void {
         .{ .import = "completions-zsh", .file = b.path("completions/bun.zsh") },
         .{ .import = "completions-fish", .file = b.path("completions/bun.fish") },
     }) |entry| {
-        mod.addAnonymousImport(entry.import, .{
+        obj.root_module.addAnonymousImport(entry.import, .{
             .root_source_file = entry.file,
         });
     }
 
     if (os == .windows) {
-        mod.addAnonymousImport("bun_shim_impl.exe", .{
+        obj.root_module.addAnonymousImport("bun_shim_impl.exe", .{
             .root_source_file = opts.windowsShim(b).exe.getEmittedBin(),
         });
     }
-
-    // Finally, make it so all modules share the same import table.
-    propagateImports(mod) catch @panic("OOM");
-}
-
-/// Makes all imports of `source_mod` visible to all of its dependencies.
-/// Does not replace existing imports.
-fn propagateImports(source_mod: *Module) !void {
-    var seen = std.AutoHashMap(*Module, void).init(source_mod.owner.graph.arena);
-    defer seen.deinit();
-    var queue = std.ArrayList(*Module).init(source_mod.owner.graph.arena);
-    defer queue.deinit();
-    try queue.appendSlice(source_mod.import_table.values());
-    while (queue.pop()) |mod| {
-        if ((try seen.getOrPut(mod)).found_existing) continue;
-        try queue.appendSlice(mod.import_table.values());
-
-        for (source_mod.import_table.keys(), source_mod.import_table.values()) |k, v|
-            if (mod.import_table.get(k) == null)
-                mod.addImport(k, v);
-    }
 }
 
 fn validateGeneratedPath(path: []const u8) void {
@@ -790,34 +644,30 @@ const WindowsShim = struct {
 
         const exe = b.addExecutable(.{
             .name = "bun_shim_impl",
-            .root_module = b.createModule(.{
-                .root_source_file = path,
-                .target = target,
-                .optimize = .ReleaseFast,
-                .unwind_tables = .none,
-                .omit_frame_pointer = true,
-                .strip = true,
-                .sanitize_thread = false,
-                .single_threaded = true,
-                .link_libc = false,
-            }),
-            .linkage = .static,
+            .root_source_file = path,
+            .target = target,
+            .optimize = .ReleaseFast,
             .use_llvm = true,
             .use_lld = true,
+            .unwind_tables = .none,
+            .omit_frame_pointer = true,
+            .strip = true,
+            .linkage = .static,
+            .sanitize_thread = false,
+            .single_threaded = true,
+            .link_libc = false,
         });
 
         const dbg = b.addExecutable(.{
             .name = "bun_shim_debug",
-            .root_module = b.createModule(.{
-                .root_source_file = path,
-                .target = target,
-                .optimize = .Debug,
-                .single_threaded = true,
-                .link_libc = false,
-            }),
-            .linkage = .static,
+            .root_source_file = path,
+            .target = target,
+            .optimize = .Debug,
             .use_llvm = true,
             .use_lld = true,
+            .linkage = .static,
+            .single_threaded = true,
+            .link_libc = false,
         });
 
         return .{ .exe = exe, .dbg = dbg };

bun.lock

@@ -29,6 +29,7 @@
       "name": "bun-types",
       "dependencies": {
         "@types/node": "*",
+        "@types/ws": "~8.5.10",
       },
       "devDependencies": {
         "@biomejs/biome": "^1.5.3",
@@ -164,6 +165,8 @@
 
     "@types/semver": ["@types/semver@7.5.8", "", {}, "sha512-I8EUhyrgfLrcTkzV3TSsGyl1tSuPrEDzr0yd5m90UgNxQkyDXULk3b6MlQqTCpZpNtWe1K0hzclnZkTcLBe2UQ=="],
 
+    "@types/ws": ["@types/ws@8.5.11", "", { "dependencies": { "@types/node": "*" } }, "sha512-4+q7P5h3SpJxaBft0Dzpbr6lmMaqh0Jr2tbhJZ/luAwvD7ohSCniYkwz/pLxuT2h0EOa6QADgJj1Ko+TzRfZ+w=="],
+
     "@typescript-eslint/eslint-plugin": ["@typescript-eslint/eslint-plugin@7.16.1", "", { "dependencies": { "@eslint-community/regexpp": "^4.10.0", "@typescript-eslint/scope-manager": "7.16.1", "@typescript-eslint/type-utils": "7.16.1", "@typescript-eslint/utils": "7.16.1", "@typescript-eslint/visitor-keys": "7.16.1", "graphemer": "^1.4.0", "ignore": "^5.3.1", "natural-compare": "^1.4.0", "ts-api-utils": "^1.3.0" }, "peerDependencies": { "@typescript-eslint/parser": "^7.0.0", "eslint": "^8.56.0" } }, "sha512-SxdPak/5bO0EnGktV05+Hq8oatjAYVY3Zh2bye9pGZy6+jwyR3LG3YKkV4YatlsgqXP28BTeVm9pqwJM96vf2A=="],
 
     "@typescript-eslint/parser": ["@typescript-eslint/parser@7.16.1", "", { "dependencies": { "@typescript-eslint/scope-manager": "7.16.1", "@typescript-eslint/types": "7.16.1", "@typescript-eslint/typescript-estree": "7.16.1", "@typescript-eslint/visitor-keys": "7.16.1", "debug": "^4.3.4" }, "peerDependencies": { "eslint": "^8.56.0" } }, "sha512-u+1Qx86jfGQ5i4JjK33/FnawZRpsLxRnKzGE6EABZ40KxVT/vWsiZFEBBHjFOljmmV3MBYOHEKi0Jm9hbAOClA=="],
@@ -912,6 +915,8 @@
 
     "@eslint-community/eslint-utils/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="],
 
+    "@types/ws/@types/node": ["@types/node@20.12.14", "", { "dependencies": { "undici-types": "~5.26.4" } }, "sha512-scnD59RpYD91xngrQQLGkE+6UrHUPzeKZWhhjBSa3HSkwjbQc38+q3RoIVEwxQGRw3M+j5hpNAM+lgV3cVormg=="],
+
     "@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.5", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow=="],
 
     "@typescript-eslint/visitor-keys/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="],
@@ -1002,6 +1007,8 @@
 
     "@definitelytyped/utils/which/isexe": ["isexe@3.1.1", "", {}, "sha512-LpB/54B+/2J5hqQ7imZHfdU31OlgQqx7ZicVlkm9kzg9/w8GKLEcFfJl/t7DCEDueOyBAD6zCCwTO6Fzs0NoEQ=="],
 
+    "@types/ws/@types/node/undici-types": ["undici-types@5.26.5", "", {}, "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA=="],
+
     "@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.1", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA=="],
 
     "are-we-there-yet/readable-stream/isarray": ["isarray@1.0.0", "", {}, "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ=="],

cmake/CompilerFlags.cmake

@@ -142,14 +142,6 @@ if(UNIX)
     -fno-unwind-tables
     -fno-asynchronous-unwind-tables
   )
-
-  # needed for libuv stubs because they use
-  # C23 feature which lets you define parameter without
-  # name
-  register_compiler_flags(
-    DESCRIPTION "Allow C23 extensions"
-    -Wno-c23-extensions
-  )
 endif()
 
 register_compiler_flags(

cmake/Globals.cmake

@@ -423,13 +423,8 @@ function(register_command)
         # libbun-profile.a is now over 5gb in size, compress it first
         list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} rm -r ${BUILD_PATH}/codegen)
         list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} rm -r ${CACHE_PATH})
-        list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} gzip -1 libbun-profile.a)
+        list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} gzip -6 libbun-profile.a)
         list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} buildkite-agent artifact upload libbun-profile.a.gz)
-      elseif(filename STREQUAL "libbun-asan.a")
-        list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} rm -r ${BUILD_PATH}/codegen)
-        list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} rm -r ${CACHE_PATH})
-        list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} gzip -1 libbun-asan.a)
-        list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} buildkite-agent artifact upload libbun-asan.a.gz)
       else()
         list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} buildkite-agent artifact upload ${filename})
       endif()
@@ -638,7 +633,7 @@ function(register_repository)
     set(GIT_PATH ${VENDOR_PATH}/${GIT_NAME})
   endif()
 
-  set(GIT_EFFECTIVE_OUTPUTS ${GIT_PATH}/.ref)
+  set(GIT_EFFECTIVE_OUTPUTS)
   foreach(output ${GIT_OUTPUTS})
     list(APPEND GIT_EFFECTIVE_OUTPUTS ${GIT_PATH}/${output})
   endforeach()
@@ -756,17 +751,11 @@ function(register_cmake_command)
     list(APPEND MAKE_EFFECTIVE_ARGS --fresh)
   endif()
 
-  set(MAKE_SOURCES)
-  if(TARGET clone-${MAKE_TARGET})
-    list(APPEND MAKE_SOURCES ${MAKE_CWD}/.ref)
-  endif()
-
   register_command(
     COMMENT "Configuring ${MAKE_TARGET}"
     TARGET configure-${MAKE_TARGET}
     COMMAND ${CMAKE_COMMAND} ${MAKE_EFFECTIVE_ARGS}
     CWD ${MAKE_CWD}
-    SOURCES ${MAKE_SOURCES}
     OUTPUTS ${MAKE_BUILD_PATH}/CMakeCache.txt
   )
 
@@ -818,7 +807,6 @@ function(register_cmake_command)
     TARGETS configure-${MAKE_TARGET}
     COMMAND ${CMAKE_COMMAND} ${MAKE_BUILD_ARGS}
     CWD ${MAKE_CWD}
-    SOURCES ${MAKE_SOURCES}
     ARTIFACTS ${MAKE_ARTIFACTS}
   )
 

cmake/Options.cmake

@@ -26,15 +26,6 @@ else()
   setx(DEBUG OFF)
 endif()
 
-optionx(BUN_TEST BOOL "Build Bun's unit test suite instead of the normal build" DEFAULT OFF)
-
-if (BUN_TEST)
-  setx(TEST ON)
-else()
-  setx(TEST OFF)
-endif()
-
-
 if(CMAKE_BUILD_TYPE MATCHES "MinSizeRel")
   setx(ENABLE_SMOL ON)
 endif()
@@ -71,14 +62,7 @@ if(ARCH STREQUAL "x64")
   optionx(ENABLE_BASELINE BOOL "If baseline features should be used for older CPUs (e.g. disables AVX, AVX2)" DEFAULT OFF)
 endif()
 
-# Disabling logs by default for tests yields faster builds
-if (DEBUG AND NOT TEST)
-  set(DEFAULT_ENABLE_LOGS ON)
-else()
-  set(DEFAULT_ENABLE_LOGS OFF)
-endif()
-
-optionx(ENABLE_LOGS BOOL "If debug logs should be enabled" DEFAULT ${DEFAULT_ENABLE_LOGS})
+optionx(ENABLE_LOGS BOOL "If debug logs should be enabled" DEFAULT ${DEBUG})
 optionx(ENABLE_ASSERTIONS BOOL "If debug assertions should be enabled" DEFAULT ${DEBUG})
 
 optionx(ENABLE_CANARY BOOL "If canary features should be enabled" DEFAULT ON)
@@ -91,19 +75,7 @@ endif()
 
 optionx(CANARY_REVISION STRING "The canary revision of the build" DEFAULT ${DEFAULT_CANARY_REVISION})
 
-if(LINUX)
-  optionx(ENABLE_VALGRIND BOOL "If Valgrind support should be enabled" DEFAULT OFF)
-endif()
-
-if(DEBUG AND APPLE AND ARCH STREQUAL "aarch64")
-  set(DEFAULT_ASAN ON)
-else()
-  set(DEFAULT_ASAN OFF)
-endif()
-
-optionx(ENABLE_ASAN BOOL "If ASAN support should be enabled" DEFAULT ${DEFAULT_ASAN})
-
-if(RELEASE AND LINUX AND CI AND NOT ENABLE_ASSERTIONS AND NOT ENABLE_ASAN)
+if(RELEASE AND LINUX AND CI)
   set(DEFAULT_LTO ON)
 else()
   set(DEFAULT_LTO OFF)
@@ -111,10 +83,16 @@ endif()
 
 optionx(ENABLE_LTO BOOL "If LTO (link-time optimization) should be used" DEFAULT ${DEFAULT_LTO})
 
-if(ENABLE_ASAN AND ENABLE_LTO)
-  message(WARNING "ASAN and LTO are not supported together, disabling LTO")
-  setx(ENABLE_LTO OFF)
+if(LINUX)
+  optionx(ENABLE_VALGRIND BOOL "If Valgrind support should be enabled" DEFAULT OFF)
 endif()
+if(DEBUG AND APPLE AND CMAKE_SYSTEM_PROCESSOR MATCHES "arm64|aarch64")
+  optionx(ENABLE_ASAN BOOL "If ASAN support should be enabled" DEFAULT ON)
+else()
+  optionx(ENABLE_ASAN BOOL "If ASAN support should be enabled" DEFAULT OFF)
+endif()
+
+optionx(ENABLE_PRETTIER BOOL "If prettier should be ran" DEFAULT OFF)
 
 if(USE_VALGRIND AND NOT USE_BASELINE)
   message(WARNING "If valgrind is enabled, baseline must also be enabled")

cmake/scripts/DownloadZig.cmake

@@ -29,9 +29,6 @@ else()
 endif()
 
 set(ZIG_NAME bootstrap-${ZIG_ARCH}-${ZIG_OS_ABI})
-if(ZIG_COMPILER_SAFE)
-  set(ZIG_NAME ${ZIG_NAME}-ReleaseSafe)
-endif()
 set(ZIG_FILENAME ${ZIG_NAME}.zip)
 
 if(CMAKE_HOST_WIN32)

cmake/targets/BuildBoringSSL.cmake

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

cmake/targets/BuildBun.cmake

@@ -1,7 +1,8 @@
 if(DEBUG)
   set(bun bun-debug)
-elseif(ENABLE_ASAN)
-  set(bun bun-asan)
+# elseif(ENABLE_SMOL)
+#   set(bun bun-smol-profile)
+#   set(bunStrip bun-smol)
 elseif(ENABLE_VALGRIND)
   set(bun bun-valgrind)
 elseif(ENABLE_ASSERTIONS)
@@ -11,10 +12,6 @@ else()
   set(bunStrip bun)
 endif()
 
-if(TEST)
-  set(bun ${bun}-test)
-endif()
-
 set(bunExe ${bun}${CMAKE_EXECUTABLE_SUFFIX})
 
 if(bunStrip)
@@ -531,6 +528,7 @@ file(GLOB_RECURSE BUN_ZIG_SOURCES ${CONFIGURE_DEPENDS}
 
 list(APPEND BUN_ZIG_SOURCES
   ${CWD}/build.zig
+  ${CWD}/src/main.zig
   ${BUN_BINDGEN_ZIG_OUTPUTS}
 )
 
@@ -552,13 +550,7 @@ else()
   list(APPEND BUN_ZIG_GENERATED_SOURCES ${BUN_BAKE_RUNTIME_OUTPUTS})
 endif()
 
-if (TEST)
-  set(BUN_ZIG_OUTPUT ${BUILD_PATH}/bun-test.o)
-  set(ZIG_STEPS test)
-else()
-  set(BUN_ZIG_OUTPUT ${BUILD_PATH}/bun-zig.o)
-  set(ZIG_STEPS obj)
-endif()
+set(BUN_ZIG_OUTPUT ${BUILD_PATH}/bun-zig.o)
 
 if(CMAKE_SYSTEM_PROCESSOR MATCHES "arm|ARM|arm64|ARM64|aarch64|AARCH64")
   if(APPLE)
@@ -587,10 +579,10 @@ register_command(
   GROUP
     console
   COMMENT
-    "Building src/*.zig into ${BUN_ZIG_OUTPUT} for ${ZIG_TARGET}"
+    "Building src/*.zig for ${ZIG_TARGET}"
   COMMAND
     ${ZIG_EXECUTABLE}
-      build ${ZIG_STEPS}
+      build obj
       ${CMAKE_ZIG_FLAGS}
       --prefix ${BUILD_PATH}
       -Dobj_format=${ZIG_OBJECT_FORMAT}
@@ -598,14 +590,12 @@ register_command(
       -Doptimize=${ZIG_OPTIMIZE}
       -Dcpu=${ZIG_CPU}
       -Denable_logs=$<IF:$<BOOL:${ENABLE_LOGS}>,true,false>
-      -Denable_asan=$<IF:$<BOOL:${ENABLE_ASAN}>,true,false>
       -Dversion=${VERSION}
       -Dreported_nodejs_version=${NODEJS_VERSION}
       -Dcanary=${CANARY_REVISION}
       -Dcodegen_path=${CODEGEN_PATH}
       -Dcodegen_embed=$<IF:$<BOOL:${CODEGEN_EMBED}>,true,false>
       --prominent-compile-errors
-      --summary all
       ${ZIG_FLAGS_BUN}
   ARTIFACTS
     ${BUN_ZIG_OUTPUT}
@@ -632,7 +622,6 @@ file(GLOB BUN_CXX_SOURCES ${CONFIGURE_DEPENDS}
   ${CWD}/src/bun.js/bindings/sqlite/*.cpp
   ${CWD}/src/bun.js/bindings/webcrypto/*.cpp
   ${CWD}/src/bun.js/bindings/webcrypto/*/*.cpp
-  ${CWD}/src/bun.js/bindings/node/*.cpp
   ${CWD}/src/bun.js/bindings/node/crypto/*.cpp
   ${CWD}/src/bun.js/bindings/v8/*.cpp
   ${CWD}/src/bun.js/bindings/v8/shim/*.cpp
@@ -646,8 +635,6 @@ file(GLOB BUN_C_SOURCES ${CONFIGURE_DEPENDS}
   ${BUN_USOCKETS_SOURCE}/src/eventing/*.c
   ${BUN_USOCKETS_SOURCE}/src/internal/*.c
   ${BUN_USOCKETS_SOURCE}/src/crypto/*.c
-  ${CWD}/src/bun.js/bindings/uv-posix-polyfills.c
-  ${CWD}/src/bun.js/bindings/uv-posix-stubs.c
 )
 
 if(WIN32)
@@ -798,10 +785,6 @@ target_include_directories(${bun} PRIVATE
   ${NODEJS_HEADERS_PATH}/include
 )
 
-if(NOT WIN32) 
-  target_include_directories(${bun} PRIVATE ${CWD}/src/bun.js/bindings/libuv)
-endif()
-
 if(LINUX)
   include(CheckIncludeFiles)
   check_include_files("sys/queue.h" HAVE_SYS_QUEUE_H)
@@ -888,7 +871,7 @@ if(NOT WIN32)
       )
     endif()
 
-    if(ENABLE_ASAN)
+    if (ENABLE_ASAN)
       target_compile_options(${bun} PUBLIC
         -fsanitize=address
       )
@@ -910,7 +893,6 @@ if(NOT WIN32)
       -Werror=sometimes-uninitialized
       -Werror=unused
       -Wno-unused-function
-      -Wno-c++23-lambda-attributes
       -Wno-nullability-completeness
       -Werror
     )
@@ -927,19 +909,9 @@ if(NOT WIN32)
       -Werror=nonnull
       -Werror=move
       -Werror=sometimes-uninitialized
-      -Wno-c++23-lambda-attributes
       -Wno-nullability-completeness
       -Werror
     )
-    
-    if(ENABLE_ASAN)
-      target_compile_options(${bun} PUBLIC
-        -fsanitize=address
-      )
-      target_link_libraries(${bun} PUBLIC
-        -fsanitize=address
-      )
-    endif()
   endif()
 else()
   target_compile_options(${bun} PUBLIC
@@ -1023,10 +995,6 @@ if(LINUX)
     -Wl,--compress-debug-sections=zlib
     -Wl,-z,lazy
     -Wl,-z,norelro
-    # enable string tail merging
-    -Wl,-O2
-    # make debug info faster to load
-    -Wl,--gdb-index
     -Wl,-z,combreloc
     -Wl,--no-eh-frame-hdr
     -Wl,--sort-section=name
@@ -1103,7 +1071,6 @@ set(BUN_DEPENDENCIES
   BoringSSL
   Brotli
   Cares
-  Highway
   LibDeflate
   LolHtml
   Lshpack
@@ -1210,27 +1177,6 @@ if(NOT BUN_CPP_ONLY)
     )
   endif()
 
-  # somehow on some Linux systems we need to disable ASLR for ASAN-instrumented binaries to run
-  # when spawned by cmake (they run fine from a shell!)
-  # otherwise they crash with:
-  # ==856230==Shadow memory range interleaves with an existing memory mapping. ASan cannot proceed correctly. ABORTING.
-  # ==856230==ASan shadow was supposed to be located in the [0x00007fff7000-0x10007fff7fff] range.
-  # ==856230==This might be related to ELF_ET_DYN_BASE change in Linux 4.12.
-  # ==856230==See https://github.com/google/sanitizers/issues/856 for possible workarounds.
-  # the linked issue refers to very old kernels but this still happens to us on modern ones.
-  # disabling ASLR to run the binary works around it
-  set(TEST_BUN_COMMAND_BASE ${BUILD_PATH}/${bunExe} --revision)
-  set(TEST_BUN_COMMAND_ENV_WRAP
-    ${CMAKE_COMMAND} -E env BUN_DEBUG_QUIET_LOGS=1)
-  if (LINUX AND ENABLE_ASAN)
-    set(TEST_BUN_COMMAND
-      ${TEST_BUN_COMMAND_ENV_WRAP} setarch ${CMAKE_HOST_SYSTEM_PROCESSOR} -R ${TEST_BUN_COMMAND_BASE}
-      || ${TEST_BUN_COMMAND_ENV_WRAP} ${TEST_BUN_COMMAND_BASE})
-  else()
-    set(TEST_BUN_COMMAND
-      ${TEST_BUN_COMMAND_ENV_WRAP} ${TEST_BUN_COMMAND_BASE})
-  endif()
-
   register_command(
     TARGET
       ${bun}
@@ -1239,7 +1185,10 @@ if(NOT BUN_CPP_ONLY)
     COMMENT
       "Testing ${bun}"
     COMMAND
-      ${TEST_BUN_COMMAND}
+      ${CMAKE_COMMAND}
+      -E env BUN_DEBUG_QUIET_LOGS=1
+      ${BUILD_PATH}/${bunExe}
+        --revision
     CWD
       ${BUILD_PATH}
   )
@@ -1299,12 +1248,7 @@ if(NOT BUN_CPP_ONLY)
     if(ENABLE_BASELINE)
       set(bunTriplet ${bunTriplet}-baseline)
     endif()
-    if(ENABLE_ASAN)
-      set(bunTriplet ${bunTriplet}-asan)
-      set(bunPath ${bunTriplet})
-    else()
-      string(REPLACE bun ${bunTriplet} bunPath ${bun})
-    endif()
+    string(REPLACE bun ${bunTriplet} bunPath ${bun})
     set(bunFiles ${bunExe} features.json)
     if(WIN32)
       list(APPEND bunFiles ${bun}.pdb)

cmake/targets/BuildHighway.cmake

@@ -1,33 +0,0 @@
-register_repository(
-  NAME
-    highway
-  REPOSITORY
-    google/highway
-  COMMIT
-    12b325bc1793dee68ab2157995a690db859fe9e0
-)
-
-set(HIGHWAY_CMAKE_ARGS
-  # Build a static library
-  -DBUILD_SHARED_LIBS=OFF
-  # Enable position-independent code for linking into the main executable
-  -DCMAKE_POSITION_INDEPENDENT_CODE=ON
-  # Disable unnecessary components
-  -DHWY_ENABLE_TESTS=OFF
-  -DHWY_ENABLE_EXAMPLES=OFF
-  -DHWY_ENABLE_CONTRIB=OFF
-  # Disable building of the install target
-  -DHWY_ENABLE_INSTALL=OFF
-)
-
-register_cmake_command(
-  TARGET
-    highway
-  LIBRARIES
-    hwy
-  ARGS
-    ${HIGHWAY_CMAKE_ARGS}
-  INCLUDES
-    .
-    hwy
-)

cmake/targets/BuildLibDeflate.cmake

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

cmake/tools/SetupBuildkite.cmake

@@ -122,8 +122,6 @@ foreach(i RANGE ${BUILDKITE_JOBS_MAX_INDEX})
     if(BUILDKITE)
       if(BUILDKITE_ARTIFACT_PATH STREQUAL "libbun-profile.a")
         set(BUILDKITE_ARTIFACT_PATH libbun-profile.a.gz)
-      elseif(BUILDKITE_ARTIFACT_PATH STREQUAL "libbun-asan.a")
-        set(BUILDKITE_ARTIFACT_PATH libbun-asan.a.gz)
       endif()
       set(BUILDKITE_DOWNLOAD_COMMAND buildkite-agent artifact download ${BUILDKITE_ARTIFACT_PATH} . --build ${BUILDKITE_BUILD_UUID} --step ${BUILDKITE_JOB_ID})
     else()
@@ -153,19 +151,6 @@ foreach(i RANGE ${BUILDKITE_JOBS_MAX_INDEX})
         DEPENDS
           ${BUILD_PATH}/libbun-profile.a.gz
       )
-    elseif(BUILDKITE_ARTIFACT_PATH STREQUAL "libbun-asan.a.gz")
-      add_custom_command(
-        COMMENT
-          "Unpacking libbun-asan.a.gz"
-        VERBATIM COMMAND
-          gunzip libbun-asan.a.gz
-        WORKING_DIRECTORY
-          ${BUILD_PATH}
-        OUTPUT
-          ${BUILD_PATH}/libbun-asan.a
-        DEPENDS
-          ${BUILD_PATH}/libbun-asan.a.gz
-      )
     endif()
   endforeach()
 

cmake/tools/SetupWebKit.cmake

@@ -2,7 +2,7 @@ option(WEBKIT_VERSION "The version of WebKit to use")
 option(WEBKIT_LOCAL "If a local version of WebKit should be used instead of downloading")
 
 if(NOT WEBKIT_VERSION)
-  set(WEBKIT_VERSION 017930ebf915121f8f593bef61cbbca82d78132d)
+  set(WEBKIT_VERSION 91bf2baced1b1309c7e05f19177c97fefec20976)
 endif()
 
 string(SUBSTRING ${WEBKIT_VERSION} 0 16 WEBKIT_VERSION_PREFIX)
@@ -73,13 +73,13 @@ endif()
 
 if(DEBUG)
   set(WEBKIT_SUFFIX "${WEBKIT_SUFFIX}-debug")
-elseif(ENABLE_LTO)
+elseif(ENABLE_LTO AND NOT WIN32)
   set(WEBKIT_SUFFIX "${WEBKIT_SUFFIX}-lto")
 else()
   set(WEBKIT_SUFFIX "${WEBKIT_SUFFIX}")
 endif()
 
-if(ENABLE_ASAN AND ((APPLE AND DEBUG AND ARCH STREQUAL "aarch64") OR (LINUX AND RELEASE)))
+if(ENABLE_ASAN)
   set(WEBKIT_SUFFIX "${WEBKIT_SUFFIX}-asan")
 endif()
 

cmake/tools/SetupZig.cmake

@@ -20,15 +20,11 @@ else()
   unsupported(CMAKE_SYSTEM_NAME)
 endif()
 
-set(ZIG_COMMIT "a207204ee57a061f2fb96c7bae0c491b609e73a5")
+set(ZIG_COMMIT "cd1995944508e4c946deb75bd70947d302e0db37")
 optionx(ZIG_TARGET STRING "The zig target to use" DEFAULT ${DEFAULT_ZIG_TARGET})
 
 if(CMAKE_BUILD_TYPE STREQUAL "Release")
-  if(ENABLE_ASAN)
-    set(DEFAULT_ZIG_OPTIMIZE "ReleaseSafe")
-  else()
-    set(DEFAULT_ZIG_OPTIMIZE "ReleaseFast")
-  endif()
+  set(DEFAULT_ZIG_OPTIMIZE "ReleaseFast")
 elseif(CMAKE_BUILD_TYPE STREQUAL "RelWithDebInfo")
   set(DEFAULT_ZIG_OPTIMIZE "ReleaseSafe")
 elseif(CMAKE_BUILD_TYPE STREQUAL "MinSizeRel")
@@ -55,14 +51,6 @@ optionx(ZIG_OBJECT_FORMAT "obj|bc" "Output file format for Zig object files" DEF
 optionx(ZIG_LOCAL_CACHE_DIR FILEPATH "The path to local the zig cache directory" DEFAULT ${CACHE_PATH}/zig/local)
 optionx(ZIG_GLOBAL_CACHE_DIR FILEPATH "The path to the global zig cache directory" DEFAULT ${CACHE_PATH}/zig/global)
 
-if(CI AND CMAKE_HOST_APPLE)
-  set(ZIG_COMPILER_SAFE_DEFAULT ON)
-else()
-  set(ZIG_COMPILER_SAFE_DEFAULT OFF)
-endif()
-
-optionx(ZIG_COMPILER_SAFE BOOL "Download a ReleaseSafe build of the Zig compiler. Only availble on macos aarch64." DEFAULT ${ZIG_COMPILER_SAFE_DEFAULT})
-
 setenv(ZIG_LOCAL_CACHE_DIR ${ZIG_LOCAL_CACHE_DIR})
 setenv(ZIG_GLOBAL_CACHE_DIR ${ZIG_GLOBAL_CACHE_DIR})
 
@@ -90,7 +78,6 @@ register_command(
       -DZIG_PATH=${ZIG_PATH}
       -DZIG_COMMIT=${ZIG_COMMIT}
       -DENABLE_ASAN=${ENABLE_ASAN}
-      -DZIG_COMPILER_SAFE=${ZIG_COMPILER_SAFE}
       -P ${CWD}/cmake/scripts/DownloadZig.cmake
   SOURCES
     ${CWD}/cmake/scripts/DownloadZig.cmake

dockerhub/debian-slim/Dockerfile

@@ -55,7 +55,7 @@ RUN apt-get update -qq \
     && which bun \
     && bun --version
 
-FROM debian:bookworm-slim
+FROM debian:bullseye-slim
 
 # Disable the runtime transpiler cache by default inside Docker containers.
 # On ephemeral containers, the cache is not useful

dockerhub/debian/Dockerfile

@@ -56,7 +56,7 @@ RUN apt-get update -qq \
     && rm -f "bun-linux-$build.zip" SHASUMS256.txt.asc SHASUMS256.txt \
     && chmod +x /usr/local/bin/bun
 
-FROM debian:bookworm
+FROM debian:bullseye
 
 COPY docker-entrypoint.sh /usr/local/bin
 COPY --from=build /usr/local/bin/bun /usr/local/bin/bun

docs/api/cookie.md

@@ -1,449 +0,0 @@
-Bun provides native APIs for working with HTTP cookies through `Bun.Cookie` and `Bun.CookieMap`. These APIs offer fast, easy-to-use methods for parsing, generating, and manipulating cookies in HTTP requests and responses.
-
-## CookieMap class
-
-`Bun.CookieMap` provides a Map-like interface for working with collections of cookies. It implements the `Iterable` interface, allowing you to use it with `for...of` loops and other iteration methods.
-
-```ts
-// Empty cookie map
-const cookies = new Bun.CookieMap();
-
-// From a cookie string
-const cookies1 = new Bun.CookieMap("name=value; foo=bar");
-
-// From an object
-const cookies2 = new Bun.CookieMap({
-  session: "abc123",
-  theme: "dark",
-});
-
-// From an array of name/value pairs
-const cookies3 = new Bun.CookieMap([
-  ["session", "abc123"],
-  ["theme", "dark"],
-]);
-```
-
-### In HTTP servers
-
-In Bun's HTTP server, the `cookies` property on the request object (in `routes`) is an instance of `CookieMap`:
-
-```ts
-const server = Bun.serve({
-  routes: {
-    "/": req => {
-      // Access request cookies
-      const cookies = req.cookies;
-
-      // Get a specific cookie
-      const sessionCookie = cookies.get("session");
-      if (sessionCookie != null) {
-        console.log(sessionCookie);
-      }
-
-      // Check if a cookie exists
-      if (cookies.has("theme")) {
-        // ...
-      }
-
-      // Set a cookie, it will be automatically applied to the response
-      cookies.set("visited", "true");
-
-      return new Response("Hello");
-    },
-  },
-});
-
-console.log("Server listening at: " + server.url);
-```
-
-### Methods
-
-#### `get(name: string): string | null`
-
-Retrieves a cookie by name. Returns `null` if the cookie doesn't exist.
-
-```ts
-// Get by name
-const cookie = cookies.get("session");
-
-if (cookie != null) {
-  console.log(cookie);
-}
-```
-
-#### `has(name: string): boolean`
-
-Checks if a cookie with the given name exists.
-
-```ts
-// Check if cookie exists
-if (cookies.has("session")) {
-  // Cookie exists
-}
-```
-
-#### `set(name: string, value: string): void`
-
-#### `set(options: CookieInit): void`
-
-#### `set(cookie: Cookie): void`
-
-Adds or updates a cookie in the map. Cookies default to `{ path: "/", sameSite: "lax" }`.
-
-```ts
-// Set by name and value
-cookies.set("session", "abc123");
-
-// Set using options object
-cookies.set({
-  name: "theme",
-  value: "dark",
-  maxAge: 3600,
-  secure: true,
-});
-
-// Set using Cookie instance
-const cookie = new Bun.Cookie("visited", "true");
-cookies.set(cookie);
-```
-
-#### `delete(name: string): void`
-
-#### `delete(options: CookieStoreDeleteOptions): void`
-
-Removes a cookie from the map. When applied to a Response, this adds a cookie with an empty string value and an expiry date in the past. A cookie will only delete successfully on the browser if the domain and path is the same as it was when the cookie was created.
-
-```ts
-// Delete by name using default domain and path.
-cookies.delete("session");
-
-// Delete with domain/path options.
-cookies.delete({
-  name: "session",
-  domain: "example.com",
-  path: "/admin",
-});
-```
-
-#### `toJSON(): Record<string, string>`
-
-Converts the cookie map to a serializable format.
-
-```ts
-const json = cookies.toJSON();
-```
-
-#### `toSetCookieHeaders(): string[]`
-
-Returns an array of values for Set-Cookie headers that can be used to apply all cookie changes.
-
-When using `Bun.serve()`, you don't need to call this method explicitly. Any changes made to the `req.cookies` map are automatically applied to the response headers. This method is primarily useful when working with other HTTP server implementations.
-
-```js
-import { createServer } from "node:http";
-import { CookieMap } from "bun";
-
-const server = createServer((req, res) => {
-  const cookieHeader = req.headers.cookie || "";
-  const cookies = new CookieMap(cookieHeader);
-
-  cookies.set("view-count", Number(cookies.get("view-count") || "0") + 1);
-  cookies.delete("session");
-
-  res.writeHead(200, {
-    "Content-Type": "text/plain",
-    "Set-Cookie": cookies.toSetCookieHeaders(),
-  });
-  res.end(`Found ${cookies.size} cookies`);
-});
-
-server.listen(3000, () => {
-  console.log("Server running at http://localhost:3000/");
-});
-```
-
-### Iteration
-
-`CookieMap` provides several methods for iteration:
-
-```ts
-// Iterate over [name, cookie] entries
-for (const [name, value] of cookies) {
-  console.log(`${name}: ${value}`);
-}
-
-// Using entries()
-for (const [name, value] of cookies.entries()) {
-  console.log(`${name}: ${value}`);
-}
-
-// Using keys()
-for (const name of cookies.keys()) {
-  console.log(name);
-}
-
-// Using values()
-for (const value of cookies.values()) {
-  console.log(value);
-}
-
-// Using forEach
-cookies.forEach((value, name) => {
-  console.log(`${name}: ${value}`);
-});
-```
-
-### Properties
-
-#### `size: number`
-
-Returns the number of cookies in the map.
-
-```ts
-console.log(cookies.size); // Number of cookies
-```
-
-## Cookie class
-
-`Bun.Cookie` represents an HTTP cookie with its name, value, and attributes.
-
-```ts
-import { Cookie } from "bun";
-
-// Create a basic cookie
-const cookie = new Bun.Cookie("name", "value");
-
-// Create a cookie with options
-const secureSessionCookie = new Bun.Cookie("session", "abc123", {
-  domain: "example.com",
-  path: "/admin",
-  expires: new Date(Date.now() + 86400000), // 1 day
-  httpOnly: true,
-  secure: true,
-  sameSite: "strict",
-});
-
-// Parse from a cookie string
-const parsedCookie = new Bun.Cookie("name=value; Path=/; HttpOnly");
-
-// Create from an options object
-const objCookie = new Bun.Cookie({
-  name: "theme",
-  value: "dark",
-  maxAge: 3600,
-  secure: true,
-});
-```
-
-### Constructors
-
-```ts
-// Basic constructor with name/value
-new Bun.Cookie(name: string, value: string);
-
-// Constructor with name, value, and options
-new Bun.Cookie(name: string, value: string, options: CookieInit);
-
-// Constructor from cookie string
-new Bun.Cookie(cookieString: string);
-
-// Constructor from cookie object
-new Bun.Cookie(options: CookieInit);
-```
-
-### Properties
-
-```ts
-cookie.name; // string - Cookie name
-cookie.value; // string - Cookie value
-cookie.domain; // string | null - Domain scope (null if not specified)
-cookie.path; // string - URL path scope (defaults to "/")
-cookie.expires; // number | undefined - Expiration timestamp (ms since epoch)
-cookie.secure; // boolean - Require HTTPS
-cookie.sameSite; // "strict" | "lax" | "none" - SameSite setting
-cookie.partitioned; // boolean - Whether the cookie is partitioned (CHIPS)
-cookie.maxAge; // number | undefined - Max age in seconds
-cookie.httpOnly; // boolean - Accessible only via HTTP (not JavaScript)
-```
-
-### Methods
-
-#### `isExpired(): boolean`
-
-Checks if the cookie has expired.
-
-```ts
-// Expired cookie (Date in the past)
-const expiredCookie = new Bun.Cookie("name", "value", {
-  expires: new Date(Date.now() - 1000),
-});
-console.log(expiredCookie.isExpired()); // true
-
-// Valid cookie (Using maxAge instead of expires)
-const validCookie = new Bun.Cookie("name", "value", {
-  maxAge: 3600, // 1 hour in seconds
-});
-console.log(validCookie.isExpired()); // false
-
-// Session cookie (no expiration)
-const sessionCookie = new Bun.Cookie("name", "value");
-console.log(sessionCookie.isExpired()); // false
-```
-
-#### `serialize(): string`
-
-#### `toString(): string`
-
-Returns a string representation of the cookie suitable for a `Set-Cookie` header.
-
-```ts
-const cookie = new Bun.Cookie("session", "abc123", {
-  domain: "example.com",
-  path: "/admin",
-  expires: new Date(Date.now() + 86400000),
-  secure: true,
-  httpOnly: true,
-  sameSite: "strict",
-});
-
-console.log(cookie.serialize());
-// => "session=abc123; Domain=example.com; Path=/admin; Expires=Sun, 19 Mar 2025 15:03:26 GMT; Secure; HttpOnly; SameSite=strict"
-console.log(cookie.toString());
-// => "session=abc123; Domain=example.com; Path=/admin; Expires=Sun, 19 Mar 2025 15:03:26 GMT; Secure; HttpOnly; SameSite=strict"
-```
-
-#### `toJSON(): CookieInit`
-
-Converts the cookie to a plain object suitable for JSON serialization.
-
-```ts
-const cookie = new Bun.Cookie("session", "abc123", {
-  secure: true,
-  httpOnly: true,
-});
-
-const json = cookie.toJSON();
-// => {
-//   name: "session",
-//   value: "abc123",
-//   path: "/",
-//   secure: true,
-//   httpOnly: true,
-//   sameSite: "lax",
-//   partitioned: false
-// }
-
-// Works with JSON.stringify
-const jsonString = JSON.stringify(cookie);
-```
-
-### Static methods
-
-#### `Cookie.parse(cookieString: string): Cookie`
-
-Parses a cookie string into a `Cookie` instance.
-
-```ts
-const cookie = Bun.Cookie.parse("name=value; Path=/; Secure; SameSite=Lax");
-
-console.log(cookie.name); // "name"
-console.log(cookie.value); // "value"
-console.log(cookie.path); // "/"
-console.log(cookie.secure); // true
-console.log(cookie.sameSite); // "lax"
-```
-
-#### `Cookie.from(name: string, value: string, options?: CookieInit): Cookie`
-
-Factory method to create a cookie.
-
-```ts
-const cookie = Bun.Cookie.from("session", "abc123", {
-  httpOnly: true,
-  secure: true,
-  maxAge: 3600,
-});
-```
-
-## Types
-
-```ts
-interface CookieInit {
-  name?: string;
-  value?: string;
-  domain?: string;
-  /** Defaults to '/'. To allow the browser to set the path, use an empty string. */
-  path?: string;
-  expires?: number | Date | string;
-  secure?: boolean;
-  /** Defaults to `lax`. */
-  sameSite?: CookieSameSite;
-  httpOnly?: boolean;
-  partitioned?: boolean;
-  maxAge?: number;
-}
-
-interface CookieStoreDeleteOptions {
-  name: string;
-  domain?: string | null;
-  path?: string;
-}
-
-interface CookieStoreGetOptions {
-  name?: string;
-  url?: string;
-}
-
-type CookieSameSite = "strict" | "lax" | "none";
-
-class Cookie {
-  constructor(name: string, value: string, options?: CookieInit);
-  constructor(cookieString: string);
-  constructor(cookieObject?: CookieInit);
-
-  readonly name: string;
-  value: string;
-  domain?: string;
-  path: string;
-  expires?: Date;
-  secure: boolean;
-  sameSite: CookieSameSite;
-  partitioned: boolean;
-  maxAge?: number;
-  httpOnly: boolean;
-
-  isExpired(): boolean;
-
-  serialize(): string;
-  toString(): string;
-  toJSON(): CookieInit;
-
-  static parse(cookieString: string): Cookie;
-  static from(name: string, value: string, options?: CookieInit): Cookie;
-}
-
-class CookieMap implements Iterable<[string, string]> {
-  constructor(init?: string[][] | Record<string, string> | string);
-
-  get(name: string): string | null;
-
-  toSetCookieHeaders(): string[];
-
-  has(name: string): boolean;
-  set(name: string, value: string, options?: CookieInit): void;
-  set(options: CookieInit): void;
-  delete(name: string): void;
-  delete(options: CookieStoreDeleteOptions): void;
-  delete(name: string, options: Omit<CookieStoreDeleteOptions, "name">): void;
-  toJSON(): Record<string, string>;
-
-  readonly size: number;
-
-  entries(): IterableIterator<[string, string]>;
-  keys(): IterableIterator<string>;
-  values(): IterableIterator<string>;
-  forEach(callback: (value: string, key: string, map: CookieMap) => void): void;
-  [Symbol.iterator](): IterableIterator<[string, string]>;
-}
-```

docs/api/http.md

@@ -61,7 +61,6 @@ Routes in `Bun.serve()` receive a `BunRequest` (which extends [`Request`](https:
 // Simplified for brevity
 interface BunRequest<T extends string> extends Request {
   params: Record<T, string>;
-  readonly cookies: CookieMap;
 }
 ```
 
@@ -935,83 +934,6 @@ const server = Bun.serve({
 
 Returns `null` for closed requests or Unix domain sockets.
 
-## Working with Cookies
-
-Bun provides a built-in API for working with cookies in HTTP requests and responses. The `BunRequest` object includes a `cookies` property that provides a `CookieMap` for easily accessing and manipulating cookies. When using `routes`, `Bun.serve()` automatically tracks `request.cookies.set` and applies them to the response.
-
-### Reading cookies
-
-Read cookies from incoming requests using the `cookies` property on the `BunRequest` object:
-
-```ts
-Bun.serve({
-  routes: {
-    "/profile": req => {
-      // Access cookies from the request
-      const userId = req.cookies.get("user_id");
-      const theme = req.cookies.get("theme") || "light";
-
-      return Response.json({
-        userId,
-        theme,
-        message: "Profile page",
-      });
-    },
-  },
-});
-```
-
-### Setting cookies
-
-To set cookies, use the `set` method on the `CookieMap` from the `BunRequest` object.
-
-```ts
-Bun.serve({
-  routes: {
-    "/login": req => {
-      const cookies = req.cookies;
-
-      // Set a cookie with various options
-      cookies.set("user_id", "12345", {
-        maxAge: 60 * 60 * 24 * 7, // 1 week
-        httpOnly: true,
-        secure: true,
-        path: "/",
-      });
-
-      // Add a theme preference cookie
-      cookies.set("theme", "dark");
-
-      // Modified cookies from the request are automatically applied to the response
-      return new Response("Login successful");
-    },
-  },
-});
-```
-
-`Bun.serve()` automatically tracks modified cookies from the request and applies them to the response.
-
-### Deleting cookies
-
-To delete a cookie, use the `delete` method on the `request.cookies` (`CookieMap`) object:
-
-```ts
-Bun.serve({
-  routes: {
-    "/logout": req => {
-      // Delete the user_id cookie
-      req.cookies.delete("user_id", {
-        path: "/",
-      });
-
-      return new Response("Logged out successfully");
-    },
-  },
-});
-```
-
-Deleted cookies become a `Set-Cookie` header on the response with the `maxAge` set to `0` and an empty `value`.
-
 ## Server Metrics
 
 ### server.pendingRequests and server.pendingWebSockets

docs/api/redis.md

@@ -1,492 +0,0 @@
-Bun provides native bindings for working with Redis databases with a modern, Promise-based API. The interface is designed to be simple and performant, with built-in connection management, fully typed responses, and TLS support. **New in Bun v1.2.9**
-
-```ts
-import { redis } from "bun";
-
-// Set a key
-await redis.set("greeting", "Hello from Bun!");
-
-// Get a key
-const greeting = await redis.get("greeting");
-console.log(greeting); // "Hello from Bun!"
-
-// Increment a counter
-await redis.set("counter", 0);
-await redis.incr("counter");
-
-// Check if a key exists
-const exists = await redis.exists("greeting");
-
-// Delete a key
-await redis.del("greeting");
-```
-
-## Getting Started
-
-To use the Redis client, you first need to create a connection:
-
-```ts
-import { redis, RedisClient } from "bun";
-
-// Using the default client (reads connection info from environment)
-// process.env.REDIS_URL is used by default
-await redis.set("hello", "world");
-const result = await redis.get("hello");
-
-// Creating a custom client
-const client = new RedisClient("redis://username:password@localhost:6379");
-await client.set("counter", "0");
-await client.incr("counter");
-```
-
-By default, the client reads connection information from the following environment variables (in order of precedence):
-
-- `REDIS_URL`
-- If not set, defaults to `"redis://localhost:6379"`
-
-### Connection Lifecycle
-
-The Redis client automatically handles connections in the background:
-
-```ts
-// No connection is made until a command is executed
-const client = new RedisClient();
-
-// First command initiates the connection
-await client.set("key", "value");
-
-// Connection remains open for subsequent commands
-await client.get("key");
-
-// Explicitly close the connection when done
-client.close();
-```
-
-You can also manually control the connection lifecycle:
-
-```ts
-const client = new RedisClient();
-
-// Explicitly connect
-await client.connect();
-
-// Run commands
-await client.set("key", "value");
-
-// Disconnect when done
-client.close();
-```
-
-## Basic Operations
-
-### String Operations
-
-```ts
-// Set a key
-await redis.set("user:1:name", "Alice");
-
-// Get a key
-const name = await redis.get("user:1:name");
-
-// Delete a key
-await redis.del("user:1:name");
-
-// Check if a key exists
-const exists = await redis.exists("user:1:name");
-
-// Set expiration (in seconds)
-await redis.set("session:123", "active");
-await redis.expire("session:123", 3600); // expires in 1 hour
-
-// Get time to live (in seconds)
-const ttl = await redis.ttl("session:123");
-```
-
-### Numeric Operations
-
-```ts
-// Set initial value
-await redis.set("counter", "0");
-
-// Increment by 1
-await redis.incr("counter");
-
-// Decrement by 1
-await redis.decr("counter");
-```
-
-### Hash Operations
-
-```ts
-// Set multiple fields in a hash
-await redis.hmset("user:123", [
-  "name",
-  "Alice",
-  "email",
-  "alice@example.com",
-  "active",
-  "true",
-]);
-
-// Get multiple fields from a hash
-const userFields = await redis.hmget("user:123", ["name", "email"]);
-console.log(userFields); // ["Alice", "alice@example.com"]
-
-// Increment a numeric field in a hash
-await redis.hincrby("user:123", "visits", 1);
-
-// Increment a float field in a hash
-await redis.hincrbyfloat("user:123", "score", 1.5);
-```
-
-### Set Operations
-
-```ts
-// Add member to set
-await redis.sadd("tags", "javascript");
-
-// Remove member from set
-await redis.srem("tags", "javascript");
-
-// Check if member exists in set
-const isMember = await redis.sismember("tags", "javascript");
-
-// Get all members of a set
-const allTags = await redis.smembers("tags");
-
-// Get a random member
-const randomTag = await redis.srandmember("tags");
-
-// Pop (remove and return) a random member
-const poppedTag = await redis.spop("tags");
-```
-
-## Advanced Usage
-
-### Command Execution and Pipelining
-
-The client automatically pipelines commands, improving performance by sending multiple commands in a batch and processing responses as they arrive.
-
-```ts
-// Commands are automatically pipelined by default
-const [infoResult, listResult] = await Promise.all([
-  redis.get("user:1:name"),
-  redis.get("user:2:email"),
-]);
-```
-
-To disable automatic pipelining, you can set the `enableAutoPipelining` option to `false`:
-
-```ts
-const client = new RedisClient("redis://localhost:6379", {
-  enableAutoPipelining: false,
-});
-```
-
-### Raw Commands
-
-When you need to use commands that don't have convenience methods, you can use the `send` method:
-
-```ts
-// Run any Redis command
-const info = await redis.send("INFO", []);
-
-// LPUSH to a list
-await redis.send("LPUSH", ["mylist", "value1", "value2"]);
-
-// Get list range
-const list = await redis.send("LRANGE", ["mylist", "0", "-1"]);
-```
-
-The `send` method allows you to use any Redis command, even ones that don't have dedicated methods in the client. The first argument is the command name, and the second argument is an array of string arguments.
-
-### Connection Events
-
-You can register handlers for connection events:
-
-```ts
-const client = new RedisClient();
-
-// Called when successfully connected to Redis server
-client.onconnect = () => {
-  console.log("Connected to Redis server");
-};
-
-// Called when disconnected from Redis server
-client.onclose = error => {
-  console.error("Disconnected from Redis server:", error);
-};
-
-// Manually connect/disconnect
-await client.connect();
-client.close();
-```
-
-### Connection Status and Monitoring
-
-```ts
-// Check if connected
-console.log(client.connected); // boolean indicating connection status
-
-// Check amount of data buffered (in bytes)
-console.log(client.bufferedAmount);
-```
-
-### Type Conversion
-
-The Redis client handles automatic type conversion for Redis responses:
-
-- Integer responses are returned as JavaScript numbers
-- Bulk strings are returned as JavaScript strings
-- Simple strings are returned as JavaScript strings
-- Null bulk strings are returned as `null`
-- Array responses are returned as JavaScript arrays
-- Error responses throw JavaScript errors with appropriate error codes
-- Boolean responses (RESP3) are returned as JavaScript booleans
-- Map responses (RESP3) are returned as JavaScript objects
-- Set responses (RESP3) are returned as JavaScript arrays
-
-Special handling for specific commands:
-
-- `EXISTS` returns a boolean instead of a number (1 becomes true, 0 becomes false)
-- `SISMEMBER` returns a boolean (1 becomes true, 0 becomes false)
-
-The following commands disable automatic pipelining:
-
-- `AUTH`
-- `INFO`
-- `QUIT`
-- `EXEC`
-- `MULTI`
-- `WATCH`
-- `SCRIPT`
-- `SELECT`
-- `CLUSTER`
-- `DISCARD`
-- `UNWATCH`
-- `PIPELINE`
-- `SUBSCRIBE`
-- `UNSUBSCRIBE`
-- `UNPSUBSCRIBE`
-
-## Connection Options
-
-When creating a client, you can pass various options to configure the connection:
-
-```ts
-const client = new RedisClient("redis://localhost:6379", {
-  // Connection timeout in milliseconds (default: 10000)
-  connectionTimeout: 5000,
-
-  // Idle timeout in milliseconds (default: 0 = no timeout)
-  idleTimeout: 30000,
-
-  // Whether to automatically reconnect on disconnection (default: true)
-  autoReconnect: true,
-
-  // Maximum number of reconnection attempts (default: 10)
-  maxRetries: 10,
-
-  // Whether to queue commands when disconnected (default: true)
-  enableOfflineQueue: true,
-
-  // Whether to automatically pipeline commands (default: true)
-  enableAutoPipelining: true,
-
-  // TLS options (default: false)
-  tls: true,
-  // Alternatively, provide custom TLS config:
-  // tls: {
-  //   rejectUnauthorized: true,
-  //   ca: "path/to/ca.pem",
-  //   cert: "path/to/cert.pem",
-  //   key: "path/to/key.pem",
-  // }
-});
-```
-
-### Reconnection Behavior
-
-When a connection is lost, the client automatically attempts to reconnect with exponential backoff:
-
-1. The client starts with a small delay (50ms) and doubles it with each attempt
-2. Reconnection delay is capped at 2000ms (2 seconds)
-3. The client attempts to reconnect up to `maxRetries` times (default: 10)
-4. Commands executed during disconnection are:
-   - Queued if `enableOfflineQueue` is true (default)
-   - Rejected immediately if `enableOfflineQueue` is false
-
-## Supported URL Formats
-
-The Redis client supports various URL formats:
-
-```ts
-// Standard Redis URL
-new RedisClient("redis://localhost:6379");
-new RedisClient("redis://localhost:6379");
-
-// With authentication
-new RedisClient("redis://username:password@localhost:6379");
-
-// With database number
-new RedisClient("redis://localhost:6379/0");
-
-// TLS connections
-new RedisClient("rediss://localhost:6379");
-new RedisClient("rediss://localhost:6379");
-new RedisClient("redis+tls://localhost:6379");
-new RedisClient("redis+tls://localhost:6379");
-
-// Unix socket connections
-new RedisClient("redis+unix:///path/to/socket");
-new RedisClient("redis+unix:///path/to/socket");
-
-// TLS over Unix socket
-new RedisClient("redis+tls+unix:///path/to/socket");
-new RedisClient("redis+tls+unix:///path/to/socket");
-```
-
-## Error Handling
-
-The Redis client throws typed errors for different scenarios:
-
-```ts
-try {
-  await redis.get("non-existent-key");
-} catch (error) {
-  if (error.code === "ERR_REDIS_CONNECTION_CLOSED") {
-    console.error("Connection to Redis server was closed");
-  } else if (error.code === "ERR_REDIS_AUTHENTICATION_FAILED") {
-    console.error("Authentication failed");
-  } else {
-    console.error("Unexpected error:", error);
-  }
-}
-```
-
-Common error codes:
-
-- `ERR_REDIS_CONNECTION_CLOSED` - Connection to the server was closed
-- `ERR_REDIS_AUTHENTICATION_FAILED` - Failed to authenticate with the server
-- `ERR_REDIS_INVALID_RESPONSE` - Received an invalid response from the server
-
-## Example Use Cases
-
-### Caching
-
-```ts
-async function getUserWithCache(userId) {
-  const cacheKey = `user:${userId}`;
-
-  // Try to get from cache first
-  const cachedUser = await redis.get(cacheKey);
-  if (cachedUser) {
-    return JSON.parse(cachedUser);
-  }
-
-  // Not in cache, fetch from database
-  const user = await database.getUser(userId);
-
-  // Store in cache for 1 hour
-  await redis.set(cacheKey, JSON.stringify(user));
-  await redis.expire(cacheKey, 3600);
-
-  return user;
-}
-```
-
-### Rate Limiting
-
-```ts
-async function rateLimit(ip, limit = 100, windowSecs = 3600) {
-  const key = `ratelimit:${ip}`;
-
-  // Increment counter
-  const count = await redis.incr(key);
-
-  // Set expiry if this is the first request in window
-  if (count === 1) {
-    await redis.expire(key, windowSecs);
-  }
-
-  // Check if limit exceeded
-  return {
-    limited: count > limit,
-    remaining: Math.max(0, limit - count),
-  };
-}
-```
-
-### Session Storage
-
-```ts
-async function createSession(userId, data) {
-  const sessionId = crypto.randomUUID();
-  const key = `session:${sessionId}`;
-
-  // Store session with expiration
-  await redis.hmset(key, [
-    "userId",
-    userId.toString(),
-    "created",
-    Date.now().toString(),
-    "data",
-    JSON.stringify(data),
-  ]);
-  await redis.expire(key, 86400); // 24 hours
-
-  return sessionId;
-}
-
-async function getSession(sessionId) {
-  const key = `session:${sessionId}`;
-
-  // Get session data
-  const exists = await redis.exists(key);
-  if (!exists) return null;
-
-  const [userId, created, data] = await redis.hmget(key, [
-    "userId",
-    "created",
-    "data",
-  ]);
-
-  return {
-    userId: Number(userId),
-    created: Number(created),
-    data: JSON.parse(data),
-  };
-}
-```
-
-## Implementation Notes
-
-Bun's Redis client is implemented in Zig and uses the Redis Serialization Protocol (RESP3). It manages connections efficiently and provides automatic reconnection with exponential backoff.
-
-The client supports pipelining commands, meaning multiple commands can be sent without waiting for the replies to previous commands. This significantly improves performance when sending multiple commands in succession.
-
-### RESP3 Protocol Support
-
-Bun's Redis client uses the newer RESP3 protocol by default, which provides more data types and features compared to RESP2:
-
-- Better error handling with typed errors
-- Native Boolean responses
-- Map/Dictionary responses (key-value objects)
-- Set responses
-- Double (floating point) values
-- BigNumber support for large integer values
-
-When connecting to Redis servers using older versions that don't support RESP3, the client automatically fallbacks to compatible modes.
-
-## Limitations and Future Plans
-
-Current limitations of the Redis client we are planning to address in future versions:
-
-- [ ] No dedicated API for pub/sub functionality (though you can use the raw command API)
-- [ ] Transactions (MULTI/EXEC) must be done through raw commands for now
-- [ ] Streams are supported but without dedicated methods
-
-Unsupported features:
-
-- Redis Sentinel
-- Redis Cluster

docs/api/s3.md

@@ -619,48 +619,6 @@ When the S3 Object Storage service returns an error (that is, not Bun), it will
 
 The `S3Client` class provides several static methods for interacting with S3.
 
-### `S3Client.write` (static)
-
-To write data directly to a path in the bucket, you can use the `S3Client.write` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
-};
-
-// Write string
-await S3Client.write("my-file.txt", "Hello World");
-
-// Write JSON with type
-await S3Client.write(
-  "data.json",
-  JSON.stringify({hello: "world"}),
-  {
-    ...credentials,
-    type: "application/json",
-  }
-);
-
-// Write from fetch
-const res = await fetch("https://example.com/data");
-await S3Client.write("data.bin", res, credentials);
-
-// Write with ACL
-await S3Client.write("public.html", html, {
-  ...credentials,
-  acl: "public-read",
-  type: "text/html"
-});
-```
-
-This is equivalent to calling `new S3Client(credentials).write("my-file.txt", "Hello World")`.
-
 ### `S3Client.presign` (static)
 
 To generate a presigned URL for an S3 file, you can use the `S3Client.presign` static method.
@@ -684,45 +642,6 @@ const url = S3Client.presign("my-file.txt", {
 
 This is equivalent to calling `new S3Client(credentials).presign("my-file.txt", { expiresIn: 3600 })`.
 
-### `S3Client.list` (static)
-
-To list some or all (up to 1,000) objects in a bucket, you can use the `S3Client.list` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
-};
-
-// List (up to) 1000 objects in the bucket
-const allObjects = await S3Client.list(null, credentials);
-
-// List (up to) 500 objects under `uploads/` prefix, with owner field for each object
-const uploads = await S3Client.list({
-  prefix: 'uploads/',
-  maxKeys: 500,
-  fetchOwner: true,
-}, credentials);
-
-// Check if more results are available
-if (uploads.isTruncated) {
-  // List next batch of objects under `uploads/` prefix
-  const moreUploads = await S3Client.list({
-    prefix: 'uploads/',
-    maxKeys: 500,
-    startAfter: uploads.contents!.at(-1).key
-    fetchOwner: true,
-  }, credentials);
-}
-```
-
-This is equivalent to calling `new S3Client(credentials).list()`.
-
 ### `S3Client.exists` (static)
 
 To check if an S3 file exists, you can use the `S3Client.exists` static method.
@@ -735,7 +654,6 @@ const credentials = {
   secretAccessKey: "your-secret-key",
   bucket: "my-bucket",
   // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
 };
 
 const exists = await S3Client.exists("my-file.txt", credentials);
@@ -752,26 +670,6 @@ const s3file = s3.file("my-file.txt", {
 const exists = await s3file.exists();
 ```
 
-### `S3Client.size` (static)
-
-To quickly check the size of S3 file without downloading it, you can use the `S3Client.size` static method.
-
-```ts
-import { S3Client } from "bun";
-
-const credentials = {
-  accessKeyId: "your-access-key",
-  secretAccessKey: "your-secret-key",
-  bucket: "my-bucket",
-  // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
-};
-
-const bytes = await S3Client.size("my-file.txt", credentials);
-```
-
-This is equivalent to calling `new S3Client(credentials).size("my-file.txt")`.
-
 ### `S3Client.stat` (static)
 
 To get the size, etag, and other metadata of an S3 file, you can use the `S3Client.stat` static method.
@@ -784,7 +682,6 @@ const credentials = {
   secretAccessKey: "your-secret-key",
   bucket: "my-bucket",
   // endpoint: "https://s3.us-east-1.amazonaws.com",
-  // endpoint: "https://<account-id>.r2.cloudflarestorage.com", // Cloudflare R2
 };
 
 const stat = await S3Client.stat("my-file.txt", credentials);

docs/api/spawn.md

@@ -253,19 +253,6 @@ const proc = Bun.spawn({
 
 The `killSignal` option also controls which signal is sent when an AbortSignal is aborted.
 
-## Using maxBuffer
-
-For spawnSync, you can limit the maximum number of bytes of output before the process is killed:
-
-```ts
-// KIll 'yes' after it emits over 100 bytes of output
-const result = Bun.spawnSync({
-  cmd: ["yes"], // or ["bun", "exec", "yes"] on windows
-  maxBuffer: 100,
-});
-// process exits
-```
-
 ## Inter-process communication (IPC)
 
 Bun supports direct inter-process communication channel between two `bun` processes. To receive messages from a spawned Bun subprocess, specify an `ipc` handler.
@@ -436,7 +423,6 @@ namespace SpawnOptions {
     signal?: AbortSignal;
     timeout?: number;
     killSignal?: string | number;
-    maxBuffer?: number;
   }
 
   type Readable =

docs/api/sql.md

@@ -240,7 +240,7 @@ const result = await sql.unsafe(
 
 ### Execute and Cancelling Queries
 
-Bun's SQL is lazy, which means it will only start executing when awaited or executed with `.execute()`.
+Bun's SQL is lazy that means its will only start executing when awaited or executed with `.execute()`.
 You can cancel a query that is currently executing by calling the `cancel()` method on the query object.
 
 ```ts

docs/api/websockets.md

@@ -117,14 +117,14 @@ type WebSocketData = {
 // TypeScript: specify the type of `data`
 Bun.serve<WebSocketData>({
   fetch(req, server) {
-    const cookies = new Bun.CookieMap(req.headers.get("cookie")!);
-
+    // use a library to parse cookies
+    const cookies = parseCookies(req.headers.get("Cookie"));
     server.upgrade(req, {
       // this object must conform to WebSocketData
       data: {
         createdAt: Date.now(),
         channelId: new URL(req.url).searchParams.get("channelId"),
-        authToken: cookies.get("X-Token"),
+        authToken: cookies["X-Token"],
       },
     });
 

docs/bundler/fullstack.md

@@ -203,34 +203,6 @@ When `development` is `true`, Bun will:
 - Include the `SourceMap` header in the response so that devtools can show the original source code
 - Disable minification
 - Re-bundle assets on each request to a .html file
-- Enable hot module reloading (unless `hmr: false` is set)
-
-#### Echo console logs from browser to terminal
-
-Bun.serve() supports echoing console logs from the browser to the terminal.
-
-To enable this, pass `console: true` in the `development` object in `Bun.serve()`.
-
-```ts
-import homepage from "./index.html";
-
-Bun.serve({
-  // development can also be an object.
-  development: {
-    // Enable Hot Module Reloading
-    hmr: true,
-
-    // Echo console logs from the browser to the terminal
-    console: true,
-  },
-
-  routes: {
-    "/": homepage,
-  },
-});
-```
-
-When `console: true` is set, Bun will stream console logs from the browser to the terminal. This reuses the existing WebSocket connection from HMR to send the logs.
 
 #### Production mode
 

docs/bundler/html.md

@@ -194,18 +194,6 @@ import "tailwindcss";
 
 Only one of those are necessary, not all three.
 
-### Echo console logs from browser to terminal
-
-Bun's dev server supports streaming console logs from the browser to the terminal.
-
-To enable, pass the `--console` CLI flag.
-
-{% bunDevServerTerminal alt="bun ./index.html --console" path="./index.html --console" routes="" /%}
-
-Each call to `console.log` or `console.error` will be broadcast to the terminal that started the server. This is useful to see errors from the browser in the same place you run your server. This is also useful for AI agents that watch terminal output.
-
-Internally, this reuses the existing WebSocket connection from hot module reloading to send the logs.
-
 ## Keyboard Shortcuts
 
 While the server is running:
@@ -300,6 +288,7 @@ All paths are resolved relative to your HTML file, making it easy to organize yo
 
 ## This is a work in progress
 
+- No HMR support yet
 - Need more plugins
 - Need more configuration options for things like asset handling
 - Need a way to configure CORS, headers, etc.

docs/guides/ecosystem/vite.md

@@ -3,7 +3,7 @@ name: Build a frontend using Vite and Bun
 ---
 
 {% callout %}
-You can use Vite with Bun, but many projects get faster builds & drop hundreds of dependencies by switching to [HTML imports](/docs/bundler/html).
+While Vite currently works with Bun, it has not been heavily optimized, nor has Vite been adapted to use Bun's bundler, module resolver, or transpiler.
 {% /callout %}
 
 ---
@@ -31,7 +31,6 @@ bun install
 Start the development server with the `vite` CLI using `bunx`.
 
 The `--bun` flag tells Bun to run Vite's CLI using `bun` instead of `node`; by default Bun respects Vite's `#!/usr/bin/env node` [shebang line](<https://en.wikipedia.org/wiki/Shebang_(Unix)>).
-
 ```bash
 bunx --bun vite
 ```

docs/guides/runtime/typescript.md

@@ -15,8 +15,8 @@ Below is the full set of recommended `compilerOptions` for a Bun project. With t
 ```jsonc
 {
   "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
+    // Enable latest features
+    "lib": ["ESNext", "DOM"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",
@@ -33,12 +33,11 @@ Below is the full set of recommended `compilerOptions` for a Bun project. With t
     "strict": true,
     "skipLibCheck": true,
     "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
 
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false,
+    // Some stricter flags
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noPropertyAccessFromIndexSignature": true,
   },
 }
 ```

docs/guides/util/javascript-uuid.md

@@ -1,23 +0,0 @@
----
-name: Generate a UUID
----
-
-Use `crypto.randomUUID()` to generate a UUID v4. This API works in Bun, Node.js, and browsers. It requires no dependencies.
-
-```ts
-crypto.randomUUID();
-// => "123e4567-e89b-12d3-a456-426614174000"
-```
-
----
-
-In Bun, you can also use `Bun.randomUUIDv7()` to generate a [UUID v7](https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-01.html).
-
-```ts
-Bun.randomUUIDv7();
-// => "0196a000-bb12-7000-905e-8039f5d5b206"
-```
-
----
-
-See [Docs > API > Utils](https://bun.sh/docs/api/utils) for more useful utilities.

docs/nav.ts

@@ -265,25 +265,12 @@ export default {
     page("test/time", "Dates and times", {
       description: "Control the date & time in your tests for more reliable and deterministic tests",
     }),
-
-    page("test/coverage", "Code coverage", {
-      description: "Generate code coverage reports with `bun test --coverage`",
-    }),
-    page("test/reporters", "Test reporters", {
-      description: "Add a junit reporter to your test runs",
-    }),
-    page("test/configuration", "Test configuration", {
-      description: "Configure the test runner with bunfig.toml",
-    }),
-    page("test/runtime-behavior", "Runtime behavior", {
-      description: "Learn how the test runner affects Bun's runtime behavior",
-    }),
-    page("test/discovery", "Finding tests", {
-      description: "Learn how the test runner discovers tests",
-    }),
     page("test/dom", "DOM testing", {
       description: "Write headless tests for UI and React/Vue/Svelte/Lit components with happy-dom",
     }),
+    page("test/coverage", "Code coverage", {
+      description: "Generate code coverage reports with `bun test --coverage`",
+    }),
 
     divider("Package runner"),
     page("cli/bunx", "`bunx`", {
@@ -344,9 +331,6 @@ export default {
     page("api/file-io", "File I/O", {
       description: `Read and write files fast with Bun's heavily optimized file system API.`,
     }), // "`Bun.write`"),
-    page("api/redis", "Redis client", {
-      description: `Bun provides a fast, native Redis client with automatic command pipelining for better performance.`,
-    }),
     page("api/import-meta", "import.meta", {
       description: `Module-scoped metadata and utilities`,
     }), // "`bun:sqlite`"),
@@ -371,24 +355,24 @@ export default {
     page("api/spawn", "Child processes", {
       description: `Spawn sync and async child processes with easily configurable input and output streams.`,
     }), // "`Bun.spawn`"),
-    page("api/html-rewriter", "HTMLRewriter", {
-      description: `Parse and transform HTML with Bun's native HTMLRewriter API, inspired by Cloudflare Workers.`,
-    }), // "`HTMLRewriter`"),
+    page("api/transpiler", "Transpiler", {
+      description: `Bun exposes its internal transpiler as a pluggable API.`,
+    }), // "`Bun.Transpiler`"),
     page("api/hashing", "Hashing", {
       description: `Native support for a range of fast hashing algorithms.`,
     }), // "`Bun.serve`"),
     page("api/console", "Console", {
       description: `Bun implements a Node.js-compatible \`console\` object with colorized output and deep pretty-printing.`,
     }), // "`Node-API`"),
-    page("api/cookie", "Cookie", {
-      description: "Bun's native Cookie API simplifies working with HTTP cookies.",
-    }), // "`Node-API`"),
     page("api/ffi", "FFI", {
       description: `Call native code from JavaScript with Bun's foreign function interface (FFI) API.`,
     }), // "`bun:ffi`"),
     page("api/cc", "C Compiler", {
       description: `Build & run native C from JavaScript with Bun's native C compiler API`,
     }), // "`bun:ffi`"),
+    page("api/html-rewriter", "HTMLRewriter", {
+      description: `Parse and transform HTML with Bun's native HTMLRewriter API, inspired by Cloudflare Workers.`,
+    }), // "`HTMLRewriter`"),
     page("api/test", "Testing", {
       description: `Bun's built-in test runner is fast and uses Jest-compatible syntax.`,
     }), // "`bun:test`"),
@@ -414,9 +398,6 @@ export default {
     page("api/color", "Color", {
       description: `Bun's color function leverages Bun's CSS parser for parsing, normalizing, and converting colors from user input to a variety of output formats.`,
     }), // "`Color`"),
-    page("api/transpiler", "Transpiler", {
-      description: `Bun exposes its internal transpiler as a pluggable API.`,
-    }), // "`Bun.Transpiler`"),
 
     // divider("Dev Server"),
     // page("bun-dev", "Vanilla"),

docs/project/asan.md

@@ -1,124 +0,0 @@
-# ASAN Builds for Bun
-
-This document explains how to use and configure ASAN (Address Sanitizer) builds for Bun.
-
-> **Note**: ASAN builds are available in CI for Linux and are configured to help identify memory issues in release builds.
-
-## What is ASAN?
-
-ASAN (Address Sanitizer) is a memory error detector for C/C++ and Zig code. It can detect:
-
-- Use-after-free
-- Heap buffer overflow
-- Stack buffer overflow
-- Global buffer overflow
-- Use-after-return
-- Use-after-scope
-- Initialization order bugs
-- Memory leaks
-
-## ASAN Builds in CI
-
-Bun CI includes ASAN builds to catch memory errors. These builds are configured with:
-
-- Release optimizations for speed
-- ASAN instrumentation for memory error detection
-- Assertions enabled for both Bun and WebKit
-
-The CI pipeline automatically:
-
-- Builds a special ASAN-enabled release build for Linux
-- Runs all tests to thoroughly check for memory issues
-- Uses reduced parallelism to avoid memory pressure during testing
-- Applies suppressions for known false positives
-- Extends test timeouts to accommodate ASAN overhead
-- Includes ASAN builds in release artifacts for debugging purposes
-
-## Local ASAN Builds
-
-To build Bun with ASAN locally, you can use the npm script:
-
-```bash
-# Build a release build with ASAN and assertions (recommended)
-bun run build:asan
-```
-
-Or manually with CMake:
-
-```bash
-# Debug build with ASAN
-cmake -B build -DCMAKE_BUILD_TYPE=Debug -DENABLE_ASAN=ON
-
-# Release build with ASAN
-cmake -B build -DCMAKE_BUILD_TYPE=Release -DENABLE_ASAN=ON
-
-# Release build with ASAN and assertions
-cmake -B build -DCMAKE_BUILD_TYPE=Release -DENABLE_ASAN=ON -DENABLE_ASSERTIONS=ON
-```
-
-## Running with ASAN
-
-When running an ASAN build, you can configure behavior with environment variables:
-
-```bash
-# Basic ASAN options - leak detection disabled (recommended)
-ASAN_OPTIONS=detect_leaks=0:halt_on_error=0:detect_odr_violation=0 ./build/bun-asan
-
-# If you really need leak detection (will produce A LOT of noise)
-# ASAN_OPTIONS=detect_leaks=1:leak_check_at_exit=1:halt_on_error=0 ./build/bun-asan
-# LSAN_OPTIONS=suppressions=lsan.supp:print_suppressions=1 ./build/bun-asan
-```
-
-> **Warning**: Enabling leak detection will generate excessive noise due to deliberately uncollected memory in WebKit and other components. It's recommended to keep leak detection disabled and focus on other memory errors like use-after-free, buffer overflows, etc.
-
-## Other Memory Error Types
-
-ASAN can detect several types of memory errors:
-
-1. **Use-after-free**: When a program continues to use memory after it's been freed
-2. **Buffer overflow**: When a program writes beyond the bounds of allocated memory
-3. **Stack overflow**: When a function's stack usage exceeds available space
-4. **Memory corruption**: Often caused by writing to invalid memory locations
-5. **Use-after-return**: When a function returns a pointer to stack memory that's no longer valid
-
-When an error is detected, ASAN will print a helpful report showing:
-
-- The type of error
-- The memory address where the error occurred
-- A stack trace showing the code path that led to the error
-- Information about the memory allocation/deallocation (if relevant)
-
-Example error output:
-
-```
-==1234==ERROR: AddressSanitizer: heap-use-after-free on address 0x614000000044 at pc 0x55d8e2ac1f14...
-READ of size 4 at 0x614000000044 thread T0
-    #0 0x55d8e2ac1f14 in main example.c:10
-    #1 0x7f91e6f5e0b2 in __libc_start_main...
-```
-
-## Understanding ASAN Reports
-
-ASAN reports contain detailed information about memory errors:
-
-```
-==12345==ERROR: AddressSanitizer: heap-use-after-free on address 0x7f7ddab8c084
-READ of size 4 at 0x7f7ddab8c084 thread T0
-    #0 0x43b45a in Function source/file.cpp:123:45
-    #1 0x44af90 in AnotherFunction source/file.cpp:234:10
-    ...
-```
-
-Key components of the report:
-
-- Error type (heap-use-after-free, heap-buffer-overflow, etc.)
-- Operation (READ/WRITE) and size
-- Stack trace showing where the error occurred
-- Information about the allocated/freed memory
-
-## Best Practices
-
-1. Run tests with ASAN builds regularly
-2. Add suppressions only for well-understood false positives
-3. Fix real issues promptly - ASAN errors indicate real problems
-4. Consider using ASAN in debug builds during development

docs/project/bindgen.md

@@ -32,7 +32,7 @@ pub fn add(global: *JSC.JSGlobalObject, a: i32, b: i32) !i32 {
 const gen = bun.gen.math; // "math" being this file's basename
 
 const std = @import("std");
-const bun = @import("bun");
+const bun = @import("root").bun;
 const JSC = bun.JSC;
 ```
 

docs/runtime/nodejs-apis.md

@@ -32,7 +32,7 @@ This page is updated regularly to reflect compatibility status of the latest ver
 
 ### [`node:events`](https://nodejs.org/api/events.html)
 
-🟢 Fully implemented. 100% of Node.js's test suite passes. `EventEmitterAsyncResource` uses `AsyncResource` underneath.
+🟢 Fully implemented. `EventEmitterAsyncResource` uses `AsyncResource` underneath. 100% of Node.js's test suite for EventEmitter passes.
 
 ### [`node:fs`](https://nodejs.org/api/fs.html)
 
@@ -104,7 +104,9 @@ This page is updated regularly to reflect compatibility status of the latest ver
 
 ### [`node:crypto`](https://nodejs.org/api/crypto.html)
 
-🟡 Missing `secureHeapUsed` `setEngine` `setFips`
+🟡 Missing `ECDH` `checkPrime` `checkPrimeSync` `generatePrime` `generatePrimeSync` `hkdf` `hkdfSync` `secureHeapUsed` `setEngine` `setFips`
+
+Some methods are not optimized yet.
 
 ### [`node:domain`](https://nodejs.org/api/domain.html)
 
@@ -116,7 +118,7 @@ This page is updated regularly to reflect compatibility status of the latest ver
 
 ### [`node:module`](https://nodejs.org/api/module.html)
 
-🟡 Missing `syncBuiltinESMExports`, `Module#load()`. Overriding `require.cache` is supported for ESM & CJS modules. `module._extensions`, `module._pathCache`, `module._cache` are no-ops. `module.register` is not implemented and we recommend using a [`Bun.plugin`](https://bun.sh/docs/runtime/plugins) in the meantime.
+🟡 Missing `runMain` `syncBuiltinESMExports`, `Module#load()`. Overriding `require.cache` is supported for ESM & CJS modules. `module._extensions`, `module._pathCache`, `module._cache` are no-ops. `module.register` is not implemented and we recommend using a [`Bun.plugin`](https://bun.sh/docs/runtime/plugins) in the meantime.
 
 ### [`node:net`](https://nodejs.org/api/net.html)
 
@@ -140,7 +142,7 @@ This page is updated regularly to reflect compatibility status of the latest ver
 
 ### [`node:util`](https://nodejs.org/api/util.html)
 
-🟡 Missing `getCallSite` `getCallSites` `getSystemErrorMap` `getSystemErrorMessage` `transferableAbortSignal` `transferableAbortController`
+🟡 Missing `getCallSite` `getCallSites` `getSystemErrorMap` `getSystemErrorMessage` `transferableAbortSignal` `transferableAbortController` `MIMEType` `MIMEParams`
 
 ### [`node:v8`](https://nodejs.org/api/v8.html)
 
@@ -376,7 +378,7 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`require()`](https://nodejs.org/api/globals.html#require)
 
-🟢 Fully implemented, including [`require.main`](https://nodejs.org/api/modules.html#requiremain), [`require.cache`](https://nodejs.org/api/modules.html#requirecache), [`require.resolve`](https://nodejs.org/api/modules.html#requireresolverequest-options).
+🟢 Fully implemented, including [`require.main`](https://nodejs.org/api/modules.html#requiremain), [`require.cache`](https://nodejs.org/api/modules.html#requirecache), [`require.resolve`](https://nodejs.org/api/modules.html#requireresolverequest-options). `require.extensions` is a stub.
 
 ### [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
 

docs/runtime/plugins.md

@@ -25,12 +25,6 @@ Plugins have to be loaded before any other code runs! To achieve this, use the `
 preload = ["./myPlugin.ts"]
 ```
 
-Preloads can be either local files or npm packages. Anything that can be imported/required can be preloaded.
-
-```toml
-preload = ["bun-plugin-foo"]
-```
-
 To preload files before `bun test`:
 
 ```toml
@@ -38,7 +32,7 @@ To preload files before `bun test`:
 preload = ["./myPlugin.ts"]
 ```
 
-## Plugin conventions
+## Third-party plugins
 
 By convention, third-party plugins intended for consumption should export a factory function that accepts some configuration and returns a plugin object.
 

docs/test/configuration.md

@@ -1,87 +0,0 @@
-Configure `bun test` via `bunfig.toml` file and command-line options. This page documents the available configuration options for `bun test`.
-
-## bunfig.toml options
-
-You can configure `bun test` behavior by adding a `[test]` section to your `bunfig.toml` file:
-
-```toml
-[test]
-# Options go here
-```
-
-### Test discovery
-
-#### root
-
-The `root` option specifies a root directory for test discovery, overriding the default behavior of scanning from the project root.
-
-```toml
-[test]
-root = "src"  # Only scan for tests in the src directory
-```
-
-### Reporters
-
-#### reporter.junit
-
-Configure the JUnit reporter output file path directly in the config file:
-
-```toml
-[test.reporter]
-junit = "path/to/junit.xml"  # Output path for JUnit XML report
-```
-
-This complements the `--reporter=junit` and `--reporter-outfile` CLI flags.
-
-### Memory usage
-
-#### smol
-
-Enable the `--smol` memory-saving mode specifically for the test runner:
-
-```toml
-[test]
-smol = true  # Reduce memory usage during test runs
-```
-
-This is equivalent to using the `--smol` flag on the command line.
-
-### Coverage options
-
-In addition to the options documented in the [coverage documentation](./coverage.md), the following options are available:
-
-#### coverageSkipTestFiles
-
-Exclude files matching test patterns (e.g., \*.test.ts) from the coverage report:
-
-```toml
-[test]
-coverageSkipTestFiles = true  # Exclude test files from coverage reports
-```
-
-#### coverageThreshold (Object form)
-
-The coverage threshold can be specified either as a number (as shown in the coverage documentation) or as an object with specific thresholds:
-
-```toml
-[test]
-# Set specific thresholds for different coverage metrics
-coverageThreshold = { lines = 0.9, functions = 0.8, statements = 0.85 }
-```
-
-Setting any of these enables `fail_on_low_coverage`, causing the test run to fail if coverage is below the threshold.
-
-#### coverageIgnoreSourcemaps
-
-Internally, Bun transpiles every file. That means code coverage must also go through sourcemaps before they can be reported. We expose this as a flag to allow you to opt out of this behavior, but it will be confusing because during the transpilation process, Bun may move code around and change variable names. This option is mostly useful for debugging coverage issues.
-
-```toml
-[test]
-coverageIgnoreSourcemaps = true  # Don't use sourcemaps for coverage analysis
-```
-
-When using this option, you probably want to stick a `// @bun` comment at the top of the source file to opt out of the transpilation process.
-
-### Install settings inheritance
-
-The `bun test` command inherits relevant network and installation configuration (registry, cafile, prefer, exact, etc.) from the `[install]` section of bunfig.toml. This is important if tests need to interact with private registries or require specific install behaviors triggered during the test run.

docs/test/coverage.md

@@ -52,22 +52,9 @@ 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 = { lines = 0.9, functions = 0.9, statements = 0.9 }
+coverageThreshold = { lines = 0.9, functions = 0.9 }
 ```
 
-Setting any of these thresholds enables `fail_on_low_coverage`, causing the test run to fail if coverage is below the threshold.
-
-### Exclude test files from coverage
-
-By default, test files themselves are included in coverage reports. You can exclude them with:
-
-```toml
-[test]
-coverageSkipTestFiles = true   # default false
-```
-
-This will exclude files matching test patterns (e.g., _.test.ts, _\_spec.js) from the coverage report.
-
 ### Sourcemaps
 
 Internally, Bun transpiles all files by default, so Bun automatically generates an internal [source map](https://web.dev/source-maps/) that maps lines of your original source code onto Bun's internal representation. If for any reason you want to disable this, set `test.coverageIgnoreSourcemaps` to `true`; this will rarely be desirable outside of advanced use cases.
@@ -77,14 +64,6 @@ Internally, Bun transpiles all files by default, so Bun automatically generates
 coverageIgnoreSourcemaps = true   # default false
 ```
 
-### Coverage defaults
-
-By default, coverage reports:
-
-1. Exclude `node_modules` directories
-2. Exclude files loaded via non-JS/TS loaders (e.g., .css, .txt) unless a custom JS loader is specified
-3. Include test files themselves (can be disabled with `coverageSkipTestFiles = true` as shown above)
-
 ### Coverage reporters
 
 By default, coverage reports will be printed to the console.

docs/test/discovery.md

@@ -1,85 +0,0 @@
-bun test's file discovery mechanism determines which files to run as tests. Understanding how it works helps you structure your test files effectively.
-
-## Default Discovery Logic
-
-By default, `bun test` recursively searches the project directory for files that match specific patterns:
-
-- `*.test.{js|jsx|ts|tsx}` - Files ending with `.test.js`, `.test.jsx`, `.test.ts`, or `.test.tsx`
-- `*_test.{js|jsx|ts|tsx}` - Files ending with `_test.js`, `_test.jsx`, `_test.ts`, or `_test.tsx`
-- `*.spec.{js|jsx|ts|tsx}` - Files ending with `.spec.js`, `.spec.jsx`, `.spec.ts`, or `.spec.tsx`
-- `*_spec.{js|jsx|ts|tsx}` - Files ending with `_spec.js`, `_spec.jsx`, `_spec.ts`, or `_spec.tsx`
-
-## Exclusions
-
-By default, Bun test ignores:
-
-- `node_modules` directories
-- Hidden directories (those starting with a period `.`)
-- Files that don't have JavaScript-like extensions (based on available loaders)
-
-## Customizing Test Discovery
-
-### Position Arguments as Filters
-
-You can filter which test files run by passing additional positional arguments to `bun test`:
-
-```bash
-$ bun test <filter> <filter> ...
-```
-
-Any test file with a path that contains one of the filters will run. These filters are simple substring matches, not glob patterns.
-
-For example, to run all tests in a `utils` directory:
-
-```bash
-$ bun test utils
-```
-
-This would match files like `src/utils/string.test.ts` and `lib/utils/array_test.js`.
-
-### Specifying Exact File Paths
-
-To run a specific file in the test runner, make sure the path starts with `./` or `/` to distinguish it from a filter name:
-
-```bash
-$ bun test ./test/specific-file.test.ts
-```
-
-### Filter by Test Name
-
-To filter tests by name rather than file path, use the `-t`/`--test-name-pattern` flag with a regex pattern:
-
-```sh
-# run all tests with "addition" in the name
-$ bun test --test-name-pattern addition
-```
-
-The pattern is matched against a concatenated string of the test name prepended with the labels of all its parent describe blocks, separated by spaces. For example, a test defined as:
-
-```js
-describe("Math", () => {
-  describe("operations", () => {
-    test("should add correctly", () => {
-      // ...
-    });
-  });
-});
-```
-
-Would be matched against the string "Math operations should add correctly".
-
-### Changing the Root Directory
-
-By default, Bun looks for test files starting from the current working directory. You can change this with the `root` option in your `bunfig.toml`:
-
-```toml
-[test]
-root = "src"  # Only scan for tests in the src directory
-```
-
-## Execution Order
-
-Tests are run in the following order:
-
-1. Test files are executed sequentially (not in parallel)
-2. Within each file, tests run sequentially based on their definition order