Merge branch 'main' into ali/docs-bun-serve-ws-19659

Co-authored-by: RiskyMH <git@riskymh.dev>

.buildkite/Dockerfile

@@ -1,12 +1,12 @@
-ARG LLVM_VERSION="18"
-ARG REPORTED_LLVM_VERSION="18.1.8"
+ARG LLVM_VERSION="19"
+ARG REPORTED_LLVM_VERSION="19.1.7"
 ARG OLD_BUN_VERSION="1.1.38"
 ARG DEFAULT_CFLAGS="-mno-omit-leaf-frame-pointer -fno-omit-frame-pointer -ffunction-sections -fdata-sections -faddrsig -fno-unwind-tables -fno-asynchronous-unwind-tables"
 ARG DEFAULT_CXXFLAGS="-flto=full -fwhole-program-vtables -fforce-emit-vtables"
 ARG BUILDKITE_AGENT_TAGS="queue=linux,os=linux,arch=${TARGETARCH}"
 
 FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-arm64
-FROM --platform=$BUILDPLATFORM ubuntu:18.04 as base-amd64
+FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-amd64
 FROM base-$TARGETARCH as base
 
 ARG LLVM_VERSION

.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"} Profile
+ * @typedef {"release" | "assert" | "debug" | "asan"} Profile
  */
 
 /**
@@ -107,9 +107,10 @@ 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: "aarch64", abi: "musl", distro: "alpine", release: "3.20" },
-  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.20" },
-  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.20" },
+  { 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" },
   { os: "windows", arch: "x64", release: "2019" },
   { os: "windows", arch: "x64", baseline: true, release: "2019" },
 ];
@@ -125,18 +126,16 @@ 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.20", tier: "latest" },
-  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.20", tier: "latest" },
-  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.20", tier: "latest" },
+  { os: "linux", arch: "aarch64", abi: "musl", distro: "alpine", release: "3.21", tier: "latest" },
+  { os: "linux", arch: "x64", abi: "musl", distro: "alpine", release: "3.21", tier: "latest" },
+  { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.21", tier: "latest" },
   { os: "windows", arch: "x64", release: "2019", tier: "oldest" },
   { os: "windows", arch: "x64", release: "2019", baseline: true, tier: "oldest" },
 ];
@@ -323,9 +322,25 @@ function getCppAgent(platform, options) {
  */
 function getZigAgent(platform, options) {
   const { arch } = platform;
-  return {
-    queue: "build-zig",
-  };
+
+  // Uncomment to restore to using macOS on-prem for Zig.
+  // return {
+  //   queue: "build-zig",
+  // };
+
+  return getEc2Agent(
+    {
+      os: "linux",
+      arch: "aarch64",
+      abi: "musl",
+      distro: "alpine",
+      release: "3.21",
+    },
+    options,
+    {
+      instanceType: "r8g.large",
+    },
+  );
 }
 
 /**
@@ -378,24 +393,32 @@ function getTestAgent(platform, options) {
  * @returns {Record<string, string | undefined>}
  */
 function getBuildEnv(target, options) {
-  const { profile, baseline, abi } = target;
-  const release = !profile || profile === "release";
+  const { baseline, abi } = target;
   const { canary } = options;
   const revision = typeof canary === "number" ? canary : 1;
 
   return {
-    CMAKE_BUILD_TYPE: release ? "Release" : profile === "debug" ? "Debug" : "RelWithDebInfo",
     ENABLE_BASELINE: baseline ? "ON" : "OFF",
     ENABLE_CANARY: revision > 0 ? "ON" : "OFF",
     CANARY_REVISION: revision,
-    ENABLE_ASSERTIONS: release ? "OFF" : "ON",
-    ENABLE_LOGS: release ? "OFF" : "ON",
     ABI: abi === "musl" ? "musl" : undefined,
-
+    CMAKE_VERBOSE_MAKEFILE: "ON",
     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
@@ -409,7 +432,7 @@ function getBuildVendorStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: "bun run build:ci --target dependencies",
+    command: `${getBuildCommand(platform, options)} --target dependencies`,
   };
 }
 
@@ -419,6 +442,7 @@ 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`,
@@ -429,7 +453,10 @@ function getBuildCppStep(platform, options) {
       BUN_CPP_ONLY: "ON",
       ...getBuildEnv(platform, options),
     },
-    command: "bun run build:ci --target bun",
+    // 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`],
   };
 }
 
@@ -463,8 +490,8 @@ function getBuildZigStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: `bun run build:ci --target bun-zig --toolchain ${toolchain}`,
-    timeout_in_minutes: 25,
+    command: `${getBuildCommand(platform, options)} --target bun-zig --toolchain ${toolchain}`,
+    timeout_in_minutes: 35,
   };
 }
 
@@ -477,11 +504,7 @@ function getLinkBunStep(platform, options) {
   return {
     key: `${getTargetKey(platform)}-build-bun`,
     label: `${getTargetLabel(platform)} - build-bun`,
-    depends_on: [
-      `${getTargetKey(platform)}-build-vendor`,
-      `${getTargetKey(platform)}-build-cpp`,
-      `${getTargetKey(platform)}-build-zig`,
-    ],
+    depends_on: [`${getTargetKey(platform)}-build-cpp`, `${getTargetKey(platform)}-build-zig`],
     agents: getCppAgent(platform, options),
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
@@ -489,7 +512,7 @@ function getLinkBunStep(platform, options) {
       BUN_LINK_ONLY: "ON",
       ...getBuildEnv(platform, options),
     },
-    command: "bun run build:ci --target bun",
+    command: `${getBuildCommand(platform, options)} --target bun`,
   };
 }
 
@@ -506,7 +529,7 @@ function getBuildBunStep(platform, options) {
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
     env: getBuildEnv(platform, options),
-    command: "bun run build:ci",
+    command: getBuildCommand(platform, options),
   };
 }
 
@@ -525,7 +548,7 @@ function getBuildBunStep(platform, options) {
  * @returns {Step}
  */
 function getTestBunStep(platform, options, testOptions = {}) {
-  const { os } = platform;
+  const { os, profile } = platform;
   const { buildId, unifiedTests, testFiles } = testOptions;
 
   const args = [`--step=${getTargetKey(platform)}-build-bun`];
@@ -549,6 +572,7 @@ 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(" ")}`
@@ -622,6 +646,7 @@ function getReleaseStep(buildPlatforms, options) {
 }
 
 /**
+ * @param {Platform[]} buildPlatforms
  * @returns {Step}
  */
 function getBenchmarkStep() {
@@ -629,10 +654,10 @@ function getBenchmarkStep() {
     key: "benchmark",
     label: "📊",
     agents: {
-      queue: "build-zig",
+      queue: "build-image",
     },
-    command: "bun .buildkite/scripts/upload-benchmark.ts",
-    depends_on: [`linux-x64-build-bun`],
+    depends_on: `linux-x64-build-bun`,
+    command: "node .buildkite/scripts/upload-benchmark.mjs",
   };
 }
 
@@ -722,7 +747,6 @@ 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]
@@ -817,6 +841,10 @@ function getOptionsStep() {
             label: `${getEmoji("assert")} Release with Assertions`,
             value: "assert",
           },
+          {
+            label: `${getEmoji("asan")} Release with ASAN`,
+            value: "asan",
+          },
           {
             label: `${getEmoji("debug")} Debug`,
             value: "debug",
@@ -939,8 +967,13 @@ async function getPipelineOptions() {
     return;
   }
 
+  let filteredBuildPlatforms = buildPlatforms;
+  if (isMainBranch()) {
+    filteredBuildPlatforms = buildPlatforms.filter(({ profile }) => profile !== "asan");
+  }
+
   const canary = await getCanaryRevision();
-  const buildPlatformsMap = new Map(buildPlatforms.map(platform => [getTargetKey(platform), platform]));
+  const buildPlatformsMap = new Map(filteredBuildPlatforms.map(platform => [getTargetKey(platform), platform]));
   const testPlatformsMap = new Map(testPlatforms.map(platform => [getPlatformKey(platform), platform]));
 
   if (isManual) {
@@ -959,6 +992,7 @@ 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 {
@@ -971,12 +1005,11 @@ 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.map(key => buildPlatformsMap.get(key))
+        ? buildPlatformKeys.flatMap(key => buildProfiles.map(profile => ({ ...buildPlatformsMap.get(key), profile })))
         : Array.from(buildPlatformsMap.values()),
       testPlatforms: testPlatformKeys?.length
-        ? testPlatformKeys.map(key => testPlatformsMap.get(key))
+        ? testPlatformKeys.flatMap(key => buildProfiles.map(profile => ({ ...testPlatformsMap.get(key), profile })))
         : Array.from(testPlatformsMap.values()),
       dryRun: parseBoolean(options["dry-run"]),
     };
@@ -1011,7 +1044,6 @@ async function getPipelineOptions() {
     publishImages: parseOption(/\[(publish images?)\]/i),
     buildPlatforms: Array.from(buildPlatformsMap.values()),
     testPlatforms: Array.from(testPlatformsMap.values()),
-    buildProfiles: ["release"],
   };
 }
 
@@ -1034,7 +1066,7 @@ async function getPipeline(options = {}) {
     return;
   }
 
-  const { buildProfiles = [], buildPlatforms = [], testPlatforms = [], buildImages, publishImages } = options;
+  const { buildPlatforms = [], testPlatforms = [], buildImages, publishImages } = options;
   const imagePlatforms = new Map(
     buildImages || publishImages
       ? [...buildPlatforms, ...testPlatforms]
@@ -1069,29 +1101,28 @@ async function getPipeline(options = {}) {
     }
   }
 
-  if (!buildId) {
-    steps.push(
-      ...buildPlatforms
-        .flatMap(platform => buildProfiles.map(profile => ({ ...platform, profile })))
-        .map(target => {
-          const imageKey = getImageKey(target);
+  const includeASAN = !isMainBranch();
 
-          return getStepWithDependsOn(
-            {
-              key: getTargetKey(target),
-              group: getTargetLabel(target),
-              steps: unifiedBuilds
-                ? [getBuildBunStep(target, options)]
-                : [
-                    getBuildVendorStep(target, options),
-                    getBuildCppStep(target, options),
-                    getBuildZigStep(target, options),
-                    getLinkBunStep(target, options),
-                  ],
-            },
-            imagePlatforms.has(imageKey) ? `${imageKey}-build-image` : undefined,
-          );
-        }),
+  if (!buildId) {
+    const relevantBuildPlatforms = includeASAN
+      ? buildPlatforms
+      : buildPlatforms.filter(({ profile }) => profile !== "asan");
+
+    steps.push(
+      ...relevantBuildPlatforms.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,
+        );
+      }),
     );
   }
 
@@ -1099,13 +1130,11 @@ async function getPipeline(options = {}) {
     const { skipTests, forceTests, unifiedTests, testFiles } = options;
     if (!skipTests || forceTests) {
       steps.push(
-        ...testPlatforms
-          .flatMap(platform => buildProfiles.map(profile => ({ ...platform, profile })))
-          .map(target => ({
-            key: getTargetKey(target),
-            group: getTargetLabel(target),
-            steps: [getTestBunStep(target, options, { unifiedTests, testFiles, buildId })],
-          })),
+        ...testPlatforms.map(target => ({
+          key: getTargetKey(target),
+          group: getTargetLabel(target),
+          steps: [getTestBunStep(target, options, { unifiedTests, testFiles, buildId })],
+        })),
       );
     }
   }
@@ -1113,7 +1142,6 @@ async function getPipeline(options = {}) {
   if (isMainBranch()) {
     steps.push(getReleaseStep(buildPlatforms, options));
   }
-
   steps.push(getBenchmarkStep());
 
   /** @type {Map<string, GroupStep>} */

.buildkite/scripts/upload-release.sh

@@ -201,6 +201,8 @@ function create_release() {
   local artifacts=(
     bun-darwin-aarch64.zip
     bun-darwin-aarch64-profile.zip
+    bun-darwin-x64.zip
+    bun-darwin-x64-profile.zip
     bun-linux-aarch64.zip
     bun-linux-aarch64-profile.zip
     bun-linux-x64.zip

.cursor/rules/javascriptcore-class.mdc

@@ -1,13 +1,14 @@
 ---
 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 [NodeFSBinding.cpp](mdc:src/bun.js/bindings/NodeFSBinding.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 [NodeFSStatBinding.cpp](mdc:src/bun.js/bindings/NodeFSStatBinding.cpp).
 - class FooPrototype : public JSC::JSNonFinalObject
 - class FooConstructor : public JSC::InternalFunction
 
@@ -18,6 +19,7 @@ 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 {
@@ -45,6 +47,7 @@ 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);
@@ -158,6 +161,7 @@ void JSX509CertificatePrototype::finishCreation(VM& vm)
 ```
 
 ### Getter definition:
+
 ```C++
 
 JSC_DEFINE_CUSTOM_GETTER(jsX509CertificateGetter_ca, (JSGlobalObject * globalObject, EncodedJSValue thisValue, PropertyName))
@@ -212,7 +216,6 @@ JSC_DEFINE_HOST_FUNCTION(jsX509CertificateProtoFuncToJSON, (JSGlobalObject * glo
 }
 ```
 
-
 ### Constructor definition
 
 ```C++
@@ -259,7 +262,6 @@ private:
 };
 ```
 
-
 ### Structure caching
 
 If there's a class, prototype, and constructor:
@@ -279,6 +281,7 @@ void GlobalObject::finishCreation(VM& vm) {
 ```
 
 Then, implement the function that creates the structure:
+
 ```c++
 void setupX509CertificateClassStructure(LazyClassStructure::Initializer& init)
 {
@@ -301,11 +304,12 @@ 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:
@@ -316,7 +320,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);
@@ -325,7 +329,6 @@ Structure* setupX509CertificateStructure(JSC::VM &vm, Zig::GlobalObject* globalO
 }
 ```
 
-
 Then, use the structure by calling `globalObject.m_myStructureName.get(globalObject)`
 
 ```C++
@@ -378,12 +381,14 @@ 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)
@@ -395,12 +400,13 @@ 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

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

@@ -0,0 +1,8 @@
+# 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)

.gitattributes

@@ -52,3 +52,6 @@ test/js/node/test/fixtures linguist-vendored
 test/js/node/test/common linguist-vendored
 
 test/js/bun/css/files linguist-vendored
+
+.vscode/*.json linguist-language=JSON-with-Comments
+src/cli/init/tsconfig.default.json linguist-language=JSON-with-Comments

.github/CODEOWNERS

@@ -0,0 +1,18 @@
+# Project
+/.github/CODEOWNERS @Jarred-Sumner
+
+# Build system
+/CMakeLists.txt @Electroid
+/cmake/*.cmake @Electroid
+/scripts/ @Electroid
+
+# CI
+/.buildkite/ @Electroid
+/.github/workflows/ @Electroid
+
+# Debugger protocol
+/packages/bun-inspector-protocol/ @Electroid
+/packages/bun-debug-adapter-protocol/ @Electroid
+
+# Tests
+/test/expectations.txt @Jarred-Sumner

.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 outside of the stack is either wrapped in a JSC.Strong or is JSValueProtect'ed
+- [ ] JSValue used outside of the stack is either wrapped in a JSC.Strong or is JSValueProtect'ed
 - [ ] I wrote TypeScript/JavaScript tests and they pass locally (`bun-debug test test-file-name.test`)
 -->
 

.github/workflows/clang-format.yml

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

.github/workflows/clang-tidy.yml

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

.github/workflows/claude.yml

@@ -0,0 +1,35 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@beta
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+

.github/workflows/docs.yml

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

.github/workflows/format.yml

@@ -0,0 +1,65 @@
+name: format
+
+permissions:
+  contents: write
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  merge_group:
+
+env:
+  BUN_VERSION: "1.2.11"
+  LLVM_VERSION: "19.1.7"
+  LLVM_VERSION_MAJOR: "19"
+
+jobs:
+  format:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Configure Git
+        run: |
+          git config --global core.autocrlf true
+          git config --global core.ignorecase true
+          git config --global core.precomposeUnicode true
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Setup Dependencies
+        run: |
+          bun install
+      - name: Install LLVM
+        run: |
+          curl -fsSL https://apt.llvm.org/llvm.sh | sudo bash -s -- ${{ env.LLVM_VERSION_MAJOR }} all
+      - name: Setup Zig
+        uses: mlugg/setup-zig@v1
+        with:
+          version: 0.14.0
+      - name: Zig Format
+        run: |
+          zig fmt src/**.zig
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run zig-format`"
+      - name: Prettier Format
+        run: |
+          bun run prettier
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run prettier`"
+      - name: Clang Format
+        run: |
+          bun run clang-format
+      - name: Commit
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "`bun run clang-format`"

.github/workflows/labeled.yml

@@ -69,7 +69,6 @@ jobs:
         shell: bash
         run: |
           LABELS=$(bun scripts/read-issue.ts)
-          echo "labels=$LABELS" >> $GITHUB_OUTPUT
           bun scripts/is-outdated.ts
 
           if [[ -f "is-outdated.txt" ]]; then
@@ -77,12 +76,19 @@ jobs:
           fi
 
           if [[ -f "outdated.txt" ]]; then
-            echo "oudated=$(cat outdated.txt)" >> $GITHUB_OUTPUT
+            echo "outdated=$(cat outdated.txt)" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "is-very-outdated.txt" ]]; then
+            echo "is-very-outdated=true" >> $GITHUB_OUTPUT
+            LABELS="$LABELS,old-version"
+          else
+            echo "is-very-outdated=false" >> $GITHUB_OUTPUT
           fi
 
           echo "latest=$(cat LATEST)" >> $GITHUB_OUTPUT
-
-          rm -rf is-outdated.txt outdated.txt latest.txt
+          echo "labels=$LABELS" >> $GITHUB_OUTPUT
+          rm -rf is-outdated.txt outdated.txt latest.txt is-very-outdated.txt
       - name: Generate comment text with Sentry Link
         if: github.event.label.name == 'crash'
         # ignore if fail
@@ -102,7 +108,14 @@ jobs:
           if [[ -f "sentry-id.txt" ]]; then
             echo "sentry-id=$(cat sentry-id.txt)" >> $GITHUB_OUTPUT
           fi
-
+      - name: Remove old labels
+        uses: actions-cool/issues-helper@v3
+        if: github.event.label.name == 'crash' && steps.add-labels.outputs.is-very-outdated == 'false'
+        with:
+          actions: "remove-labels"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          labels: old-version
       - name: Add labels
         uses: actions-cool/issues-helper@v3
         if: github.event.label.name == 'crash'
@@ -119,7 +132,7 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           issue-number: ${{ github.event.issue.number }}
           body: |
-            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.oudated }}.
+            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.outdated }}.
 
             Are you able to reproduce this crash on the latest version of Bun?
 
@@ -134,7 +147,7 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           issue-number: ${{ github.event.issue.number }}
           body: |
-            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.oudated }}.
+            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.outdated }}.
 
             Are you able to reproduce this crash on the latest version of Bun?
 

.github/workflows/lint.yml

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

.github/workflows/packages-ci.yml

@@ -0,0 +1,55 @@
+name: Packages CI
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "packages/**"
+      - .prettierrc
+      - .prettierignore
+      - tsconfig.json
+      - oxlint.json
+      - "!**/*.md"
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "packages/**"
+      - .prettierrc
+      - .prettierignore
+      - tsconfig.json
+      - oxlint.json
+      - "!**/*.md"
+
+env:
+  BUN_VERSION: "canary"
+
+jobs:
+  bun-plugin-svelte:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Install dependencies
+        run: |
+          bun install
+          pushd ./packages/bun-plugin-svelte && bun install
+
+      - name: Lint
+        run: |
+          bunx oxlint@0.15 --format github --deny-warnings
+          bunx prettier --config ../../.prettierrc --check .
+        working-directory: ./packages/bun-plugin-svelte
+
+      - name: Check types
+        run: bun check:types
+        working-directory: ./packages/bun-plugin-svelte
+
+      - name: Test
+        run: bun test
+        working-directory: ./packages/bun-plugin-svelte

.github/workflows/prettier-format.yml

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

.github/workflows/run-lint.yml

@@ -3,7 +3,6 @@ name: Lint
 permissions:
   contents: read
 env:
-  LLVM_VERSION: 16
   BUN_VERSION: "1.2.0"
 
 on:

.github/workflows/update-cares.yml

@@ -50,11 +50,16 @@ jobs:
             exit 1
           fi
 
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+          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')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
 
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
@@ -89,4 +94,6 @@ jobs:
 
             Updates c-ares to version ${{ steps.check-version.outputs.tag }}
 
+            Compare: https://github.com/c-ares/c-ares/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
             Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-cares.yml)

.github/workflows/update-libarchive.yml

@@ -50,11 +50,16 @@ jobs:
             exit 1
           fi
 
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+          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')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
 
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
@@ -89,4 +94,6 @@ jobs:
 
             Updates libarchive to version ${{ steps.check-version.outputs.tag }}
 
+            Compare: https://github.com/libarchive/libarchive/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
             Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-libarchive.yml)

.github/workflows/update-libdeflate.yml

@@ -50,11 +50,16 @@ jobs:
             exit 1
           fi
 
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+          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')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
 
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
@@ -89,4 +94,6 @@ jobs:
 
             Updates libdeflate to version ${{ steps.check-version.outputs.tag }}
 
+            Compare: https://github.com/ebiggers/libdeflate/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
             Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-libdeflate.yml)

.github/workflows/update-lolhtml.yml

@@ -50,11 +50,16 @@ jobs:
             exit 1
           fi
 
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+          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')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
 
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
@@ -89,4 +94,6 @@ jobs:
 
             Updates lolhtml to version ${{ steps.check-version.outputs.tag }}
 
+            Compare: https://github.com/cloudflare/lol-html/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
             Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-lolhtml.yml)

.github/workflows/update-lshpack.yml

@@ -50,11 +50,16 @@ jobs:
             exit 1
           fi
 
-          LATEST_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/ref/tags/$LATEST_TAG" | jq -r '.object.sha')
-          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+          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')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
 
           if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
             echo "Error: Invalid SHA format received from GitHub"
@@ -89,4 +94,6 @@ jobs:
 
             Updates lshpack to version ${{ steps.check-version.outputs.tag }}
 
+            Compare: https://github.com/litespeedtech/ls-hpack/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
             Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-lshpack.yml)

.github/workflows/update-root-certs.yml

@@ -0,0 +1,82 @@
+name: Daily Root Certs Update Check
+
+on:
+  schedule:
+    - cron: "0 0 * * *" # Runs at 00:00 UTC every day
+  workflow_dispatch: # Allows manual trigger
+
+jobs:
+  check-and-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Generate root certs and capture output
+        id: generate-certs
+        run: |
+          cd packages/bun-usockets/
+          OUTPUT=$(bun generate-root-certs.mjs -v)
+          echo "cert_output<<EOF" >> $GITHUB_ENV
+          echo "$OUTPUT" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+      - name: Check for changes and stage files
+        id: check-changes
+        run: |
+          if [[ -n "$(git status --porcelain)" ]]; then
+            echo "Found changes, staging modified files..."
+            git config --global user.name "github-actions[bot]"
+            git config --global user.email "github-actions[bot]@users.noreply.github.com"
+            
+            # Get list of modified files and add them
+            git status --porcelain | while read -r status file; do
+              # Remove leading status and whitespace
+              file=$(echo "$file" | sed 's/^.* //')
+              echo "Adding changed file: $file"
+              git add "$file"
+            done
+            
+            echo "changes=true" >> $GITHUB_OUTPUT
+            
+            # Store the list of changed files
+            CHANGED_FILES=$(git status --porcelain)
+            echo "changed_files<<EOF" >> $GITHUB_ENV
+            echo "$CHANGED_FILES" >> $GITHUB_ENV
+            echo "EOF" >> $GITHUB_ENV
+          else
+            echo "No changes detected"
+            echo "changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Pull Request
+        if: steps.check-changes.outputs.changes == 'true'
+        uses: peter-evans/create-pull-request@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "update(root_certs): Update root certificates $(date +'%Y-%m-%d')"
+          title: "update(root_certs) $(date +'%Y-%m-%d')"
+          body: |
+            Automated root certificates update
+
+            ${{ env.cert_output }}
+
+            ## Changed Files:
+            ```
+            ${{ env.changed_files }}
+            ```
+          branch: certs/update-root-certs-${{ github.run_number }}
+          base: main
+          delete-branch: true
+          labels:
+            - "automation"
+            - "root-certs"

.github/workflows/update-sqlite3.yml

@@ -106,4 +106,6 @@ jobs:
 
             Updates SQLite to version ${{ steps.check-version.outputs.latest }}
 
+            Compare: https://sqlite.org/src/vdiff?from=${{ steps.check-version.outputs.current }}&to=${{ steps.check-version.outputs.latest }}
+
             Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-sqlite3.yml)

.github/workflows/zig-format.yml

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

.gitignore

@@ -153,6 +153,7 @@ 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

.lldbinit

@@ -1,4 +1,16 @@
-# command script import vendor/zig/tools/lldb_pretty_printers.py
-command script import vendor/WebKit/Tools/lldb/lldb_webkit.py
+# Tell LLDB what to do when the debugged process receives SIGPWR: pass it through to the process
+# (-p), but do not stop the process (-s) or notify the user (-n).
+#
+# JSC's garbage collector sends this signal (as configured by Bun WebKit in
+# Thread::initializePlatformThreading() in ThreadingPOSIX.cpp) to the JS thread to suspend or resume
+# it. So stopping the process would just create noise when debugging any long-running script.
+process handle -p true -s false -n false SIGPWR
 
-# type summary add --summary-string "${var} | inner=${var[0-30]}, source=${var[33-64]}, tag=${var[31-32]}" "unsigned long"
+command script import misctools/lldb/lldb_pretty_printers.py
+type category enable zig.lang
+type category enable zig.std
+
+command script import misctools/lldb/lldb_webkit.py
+
+command script delete btjs
+command alias btjs p {printf("gathering btjs trace...\n");printf("%s\n", (char*)dumpBtjsTrace())}

.vscode/launch.json

@@ -5,6 +5,9 @@
   // - FORCE_COLOR=1 forces colors in the terminal
   // - "${workspaceFolder}/test" is the cwd for `bun test` so it matches CI, we should fix this later
   // - "cppvsdbg" is used instead of "lldb" on Windows, because "lldb" is too slow
+  // - Seeing WebKit files requires `vendor/WebKit` to exist and have code from the right commit.
+  //   Run `bun sync-webkit-source` to ensure that folder is at the right commit. If you haven't
+  //   cloned it at all, that script will suggest how.
   "version": "0.2.0",
   "configurations": [
     // bun test [file]
@@ -21,8 +24,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -37,14 +46,28 @@
         "BUN_DEBUG_jest": "1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
       "name": "Attach",
       "request": "attach",
       "pid": "${command:pickMyProcess}",
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -59,8 +82,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -75,8 +104,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -91,8 +126,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -107,8 +148,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -124,8 +171,14 @@
         "BUN_INSPECT": "ws://localhost:0/?wait=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -146,8 +199,14 @@
         "BUN_INSPECT": "ws://localhost:0/?break=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -168,8 +227,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -187,8 +252,14 @@
         "GOMAXPROCS": "1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -202,8 +273,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -213,15 +290,18 @@
       "args": ["run", "--watch", "${file}"],
       "cwd": "${fileDirname}",
       "env": {
-        // "BUN_DEBUG_DEBUGGER": "1",
-        // "BUN_DEBUG_INTERNAL_DEBUGGER": "1",
         "BUN_DEBUG_QUIET_LOGS": "1",
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
-        // "BUN_INSPECT": "ws+unix:///var/folders/jk/8fzl9l5119598vsqrmphsw7m0000gn/T/tl15npi7qtf.sock?report=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -235,8 +315,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -252,8 +338,14 @@
         "BUN_INSPECT": "ws://localhost:0/?wait=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -274,8 +366,14 @@
         "BUN_INSPECT": "ws://localhost:0/?break=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -296,8 +394,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -312,8 +416,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -328,8 +438,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -344,8 +460,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -360,8 +482,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -377,8 +505,14 @@
         "BUN_INSPECT": "ws://localhost:0/?wait=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -399,8 +533,14 @@
         "BUN_INSPECT": "ws://localhost:0/?break=1",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -420,8 +560,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     // bun test [*]
     {
@@ -436,8 +582,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -451,8 +603,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "0",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -467,8 +625,14 @@
         "BUN_INSPECT": "ws://localhost:0/",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
       "serverReadyAction": {
         "pattern": "https://debug.bun.sh/#localhost:([0-9]+)/",
         "uriFormat": "https://debug.bun.sh/#ws://localhost:%s/",
@@ -487,8 +651,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     {
       "type": "lldb",
@@ -502,8 +672,14 @@
         "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
       },
       "console": "internalConsole",
-      // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+      "sourceMap": {
+        // macOS
+        "/Users/runner/work/_temp/webkit-release/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/Users/runner/work/_temp/webkit-release/WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // linux
+        "/webkitbuild/vendor/WebKit": "${workspaceFolder}/vendor/WebKit",
+        "/webkitbuild/.WTF/Headers": "${workspaceFolder}/vendor/WebKit/Source/WTF",
+      },
     },
     // Windows: bun test [file]
     {
@@ -1129,7 +1305,44 @@
       ],
       "console": "internalConsole",
       // Don't pause when the GC runs while the debugger is open.
-      "postRunCommands": ["command source '${workspaceFolder}/misctools/lldb/lldb_commands'"],
+    },
+    {
+      "type": "bun",
+      "name": "[JS] bun test [file]",
+      "runtime": "${workspaceFolder}/build/debug/bun-debug",
+      "runtimeArgs": ["test", "${file}"],
+      "cwd": "${workspaceFolder}",
+      "env": {
+        "BUN_DEBUG_QUIET_LOGS": "1",
+        "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
+      },
+    },
+    {
+      "type": "bun",
+      "name": "[JS] bun run [file]",
+      "runtime": "${workspaceFolder}/build/debug/bun-debug",
+      "runtimeArgs": ["run", "${file}"],
+      "cwd": "${workspaceFolder}",
+      "env": {
+        "BUN_DEBUG_QUIET_LOGS": "1",
+        "BUN_GARBAGE_COLLECTOR_LEVEL": "2",
+      },
+    },
+    {
+      "type": "midas-rr",
+      "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",
+        "set substitute-path /webkitbuild/vendor/WebKit ${workspaceFolder}/vendor/WebKit",
+        "set substitute-path /webkitbuild/.WTF/Headers ${workspaceFolder}/vendor/WebKit/Source/WTF",
+        // uncomment if you like
+        // "set disassembly-flavor intel",
+        "set print asm-demangle",
+      ],
     },
   ],
   "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"],
+  "zig.buildArgs": ["-Dgenerated-code=./build/debug/codegen", "--watch", "-fincremental"],
   "zig.zls.buildOnSaveStep": "check",
   // "zig.zls.enableBuildOnSave": true,
   // "zig.buildOnSave": true,
@@ -43,6 +43,9 @@
     "editor.tabSize": 4,
     "editor.useTabStops": false,
     "editor.defaultFormatter": "ziglang.vscode-zig",
+    "editor.codeActionsOnSave": {
+      "source.organizeImports": "never",
+    },
   },
 
   // lldb
@@ -136,14 +139,15 @@
     "**/*.xcscheme": true,
     "**/*.xcodeproj": true,
     "**/*.i": true,
-
-    // uws WebSocket.cpp conflicts with webcore WebSocket.cpp
-    "packages/bun-uws/fuzzing": true,
   },
   "files.associations": {
+    "*.css": "tailwindcss",
     "*.idl": "cpp",
     "*.mdc": "markdown",
     "array": "cpp",
+    "ios": "cpp",
+    "oxlint.json": "jsonc",
+    "bun.lock": "jsonc",
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,

AGENTS.md

@@ -0,0 +1,36 @@
+## bun tests
+
+**IMPORTANT**: use the `bun agent` command instead of the `bun` command. For example:
+
+✅ Good
+
+```sh
+bun agent test internal/ban-words.test.ts
+bun agent ./foo.ts
+```
+
+The `bun agent` command runs the DEBUG build. If you forget to run the debug build, your changes will not be reflected..
+
+### Run a file
+
+To run a file, you can use the `bun agent <file-path>` command.
+
+```sh
+bun agent ./foo.ts
+```
+
+### Run tests
+
+To run a single test, you need to use the `bun agent test <test-name>` command.
+
+```sh
+bun agent test internal/ban-words.test.ts
+```
+
+You must ALWAYS make sure to pass a file path to the `bun agent test <file-path>` command. DO NOT try to run ALL the tests at once unless you're in a specific subdirectory.
+
+### Run a Node.js test
+
+```sh
+bun agent --silent node:test test-fs-link
+```

CONTRIBUTING.md

@@ -53,39 +53,39 @@ $ brew install bun
 
 ## Install LLVM
 
-Bun requires LLVM 18 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
+Bun requires LLVM 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:
 
 {% codetabs group="os" %}
 
 ```bash#macOS (Homebrew)
-$ brew install llvm@18
+$ brew install llvm@19
 ```
 
 ```bash#Ubuntu/Debian
 $ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
-$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 18 all
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
 ```
 
 ```bash#Arch
-$ sudo pacman -S llvm clang18 lld
+$ sudo pacman -S llvm clang lld
 ```
 
 ```bash#Fedora
-$ sudo dnf install llvm18 clang18 lld18-devel
+$ sudo dnf install llvm clang lld-devel
 ```
 
 ```bash#openSUSE Tumbleweed
-$ sudo zypper install clang18 lld18 llvm18
+$ sudo zypper install clang19 lld19 llvm19
 ```
 
 {% /codetabs %}
 
-If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8).
+If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.7).
 
-Make sure Clang/LLVM 18 is in your path:
+Make sure Clang/LLVM 19 is in your path:
 
 ```bash
-$ which clang-18
+$ which clang-19
 ```
 
 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@18)/bin" if you are using zsh
-$ export PATH="$(brew --prefix llvm@18)/bin:$PATH"
+# use path+="$(brew --prefix llvm@19)/bin" if you are using zsh
+$ export PATH="$(brew --prefix llvm@19)/bin:$PATH"
 ```
 
 ```bash#Arch
 # use fish_add_path if you're using fish
-$ export PATH="$PATH:/usr/lib/llvm18/bin"
+$ export PATH="$PATH:/usr/lib/llvm19/bin"
 ```
 
 {% /codetabs %}
@@ -134,6 +134,16 @@ 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.
@@ -205,18 +215,33 @@ WebKit is not cloned by default (to save time and disk space). To clone and buil
 # Clone WebKit into ./vendor/WebKit
 $ git clone https://github.com/oven-sh/WebKit vendor/WebKit
 
+# Check out the commit hash specified in `set(WEBKIT_VERSION <commit_hash>)` in cmake/tools/SetupWebKit.cmake
+$ git -C vendor/WebKit checkout <commit_hash>
+
 # Make a debug build of JSC. This will output build artifacts in ./vendor/WebKit/WebKitBuild/Debug
 # Optionally, you can use `make jsc` for a release build
-$ make jsc-debug
+$ 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
 ```
 
+Using `bun run build:local` will build Bun in the `./build/debug-local` directory (instead of `./build/debug`), you'll have to change a couple of places to use this new directory:
+
+- The first line in [`src/js/builtins.d.ts`](/src/js/builtins.d.ts)
+- The `CompilationDatabase` line in [`.clangd` config](/.clangd) should be `CompilationDatabase: build/debug-local`
+- In [`build.zig`](/build.zig), the `codegen_path` option should be `build/debug-local/codegen` (instead of `build/debug/codegen`)
+- In [`.vscode/launch.json`](/.vscode/launch.json), many configurations use `./build/debug/`, change them as you see fit
+
 Note that the WebKit folder, including build artifacts, is 8GB+ in size.
 
 If you are using a JSC debug build and using VScode, make sure to run the `C/C++: Select a Configuration` command to configure intellisense to find the debug headers.
 
+Note that if you change make changes to our [WebKit fork](https://github.com/oven-sh/WebKit), you will also have to change [`SetupWebKit.cmake`](/cmake/tools/SetupWebKit.cmake) to point to the commit hash.
+
 ## Troubleshooting
 
 ### 'span' file not found on Ubuntu
@@ -238,7 +263,7 @@ The issue may manifest when initially running `bun setup` as Clang being unable
 ```
 The C++ compiler
 
-  "/usr/bin/clang++-18"
+  "/usr/bin/clang++-19"
 
 is not able to compile a simple test program.
 ```

LATEST

@@ -1 +1 @@
-1.2.4
+1.2.14

Makefile

@@ -91,9 +91,9 @@ ZIG ?= $(shell which zig 2>/dev/null || echo -e "error: Missing zig. Please make
 # This is easier to happen than you'd expect.
 # Using realpath here causes issues because clang uses clang++ as a symlink
 # so if that's resolved, it won't build for C++
-REAL_CC = $(shell which clang-18 2>/dev/null || which clang 2>/dev/null)
-REAL_CXX = $(shell which clang++-18 2>/dev/null || which clang++ 2>/dev/null)
-CLANG_FORMAT = $(shell which clang-format-18 2>/dev/null || which clang-format 2>/dev/null)
+REAL_CC = $(shell which clang-19 2>/dev/null || which clang 2>/dev/null)
+REAL_CXX = $(shell which clang++-19 2>/dev/null || which clang++ 2>/dev/null)
+CLANG_FORMAT = $(shell which clang-format-19 2>/dev/null || which clang-format 2>/dev/null)
 
 CC = $(REAL_CC)
 CXX = $(REAL_CXX)
@@ -117,14 +117,14 @@ CC_WITH_CCACHE = $(CCACHE_PATH) $(CC)
 ifeq ($(OS_NAME),darwin)
 # Find LLVM
 	ifeq ($(wildcard $(LLVM_PREFIX)),)
-		LLVM_PREFIX = $(shell brew --prefix llvm@18)
+		LLVM_PREFIX = $(shell brew --prefix llvm@19)
 	endif
 	ifeq ($(wildcard $(LLVM_PREFIX)),)
 		LLVM_PREFIX = $(shell brew --prefix llvm)
 	endif
 	ifeq ($(wildcard $(LLVM_PREFIX)),)
 #   This is kinda ugly, but I can't find a better way to error :(
-		LLVM_PREFIX = $(shell echo -e "error: Unable to find llvm. Please run 'brew install llvm@18' or set LLVM_PREFIX=/path/to/llvm")
+		LLVM_PREFIX = $(shell echo -e "error: Unable to find llvm. Please run 'brew install llvm@19' or set LLVM_PREFIX=/path/to/llvm")
 	endif
 
 	LDFLAGS += -L$(LLVM_PREFIX)/lib
@@ -164,7 +164,7 @@ CMAKE_FLAGS_WITHOUT_RELEASE = -DCMAKE_C_COMPILER=$(CC) \
 	-DCMAKE_OSX_DEPLOYMENT_TARGET=$(MIN_MACOS_VERSION) \
 	$(CMAKE_CXX_COMPILER_LAUNCHER_FLAG) \
 	-DCMAKE_AR=$(AR) \
-	-DCMAKE_RANLIB=$(which llvm-18-ranlib 2>/dev/null || which llvm-ranlib 2>/dev/null) \
+	-DCMAKE_RANLIB=$(which llvm-19-ranlib 2>/dev/null || which llvm-ranlib 2>/dev/null) \
 	-DCMAKE_CXX_STANDARD=20 \
 	-DCMAKE_C_STANDARD=17 \
 	-DCMAKE_CXX_STANDARD_REQUIRED=ON \
@@ -191,7 +191,7 @@ endif
 
 ifeq ($(OS_NAME),linux)
 LIBICONV_PATH =
-AR = $(shell which llvm-ar-18 2>/dev/null || which llvm-ar 2>/dev/null || which ar 2>/dev/null)
+AR = $(shell which llvm-ar-19 2>/dev/null || which llvm-ar 2>/dev/null || which ar 2>/dev/null)
 endif
 
 OPTIMIZATION_LEVEL=-O3 $(MARCH_NATIVE)
@@ -255,7 +255,7 @@ DEFAULT_LINKER_FLAGS= -pthread -ldl
 endif
 ifeq ($(OS_NAME),darwin)
     _MIMALLOC_OBJECT_FILE = 0
-	JSC_BUILD_STEPS += jsc-build-mac jsc-copy-headers
+	JSC_BUILD_STEPS += jsc-build-mac
 	JSC_BUILD_STEPS_DEBUG += jsc-build-mac-debug
 	_MIMALLOC_FILE = libmimalloc.a
 	_MIMALLOC_INPUT_PATH = libmimalloc.a
@@ -286,7 +286,7 @@ STRIP=/usr/bin/strip
 endif
 
 ifeq ($(OS_NAME),linux)
-STRIP=$(shell which llvm-strip 2>/dev/null || which llvm-strip-18 2>/dev/null || which strip 2>/dev/null || echo "Missing strip")
+STRIP=$(shell which llvm-strip 2>/dev/null || which llvm-strip-19 2>/dev/null || which strip 2>/dev/null || echo "Missing strip")
 endif
 
 
@@ -674,7 +674,7 @@ endif
 .PHONY: assert-deps
 assert-deps:
 	@echo "Checking if the required utilities are available..."
-	@if [ $(CLANG_VERSION) -lt "18" ]; then echo -e "ERROR: clang version >=18 required, found: $(CLANG_VERSION). Install with:\n\n    $(POSIX_PKG_MANAGER) install llvm@18"; exit 1; fi
+	@if [ $(CLANG_VERSION) -lt "19" ]; then echo -e "ERROR: clang version >=19 required, found: $(CLANG_VERSION). Install with:\n\n    $(POSIX_PKG_MANAGER) install llvm@19"; exit 1; fi
 	@cmake --version >/dev/null 2>&1 || (echo -e "ERROR: cmake is required."; exit 1)
 	@$(PYTHON) --version >/dev/null 2>&1 || (echo -e "ERROR: python is required."; exit 1)
 	@$(ESBUILD) --version >/dev/null 2>&1 || (echo -e "ERROR: esbuild is required."; exit 1)
@@ -924,7 +924,7 @@ bun-codesign-release-local-debug:
 
 
 .PHONY: jsc
-jsc: jsc-build jsc-copy-headers jsc-bindings
+jsc: jsc-build
 .PHONY: jsc-debug
 jsc-debug: jsc-build-debug
 .PHONY: jsc-build
@@ -1183,6 +1183,8 @@ 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/ \;
@@ -1234,6 +1236,8 @@ 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/ \;
@@ -1392,7 +1396,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-copy
+jsc-build-mac: jsc-force-fastjit jsc-build-mac-compile
 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

README.md

@@ -96,10 +96,14 @@ bun upgrade --canary
   - [`bun init`](https://bun.sh/docs/cli/init)
   - [`bun create`](https://bun.sh/docs/cli/bun-create)
 
+- CLI
+
+  - [`bun upgrade`](https://bun.sh/docs/cli/bun-upgrade)
+
 - Runtime
 
   - [`bun run`](https://bun.sh/docs/cli/run)
-  - [File types](https://bun.sh/docs/runtime/loaders)
+  - [File types (Loaders)](https://bun.sh/docs/runtime/loaders)
   - [TypeScript](https://bun.sh/docs/runtime/typescript)
   - [JSX](https://bun.sh/docs/runtime/jsx)
   - [Environment variables](https://bun.sh/docs/runtime/env)
@@ -108,12 +112,12 @@ bun upgrade --canary
   - [Node.js compatibility](https://bun.sh/docs/runtime/nodejs-apis)
   - [Single-file executable](https://bun.sh/docs/bundler/executables)
   - [Plugins](https://bun.sh/docs/runtime/plugins)
-  - [Watch mode](https://bun.sh/docs/runtime/hot)
+  - [Watch mode / Hot Reloading](https://bun.sh/docs/runtime/hot)
   - [Module resolution](https://bun.sh/docs/runtime/modules)
   - [Auto-install](https://bun.sh/docs/runtime/autoimport)
   - [bunfig.toml](https://bun.sh/docs/runtime/bunfig)
   - [Debugger](https://bun.sh/docs/runtime/debugger)
-  - [Framework API](https://bun.sh/docs/runtime/framework)
+  - [$ Shell](https://bun.sh/docs/runtime/shell)
 
 - Package manager
 
@@ -122,7 +126,12 @@ bun upgrade --canary
   - [`bun remove`](https://bun.sh/docs/cli/remove)
   - [`bun update`](https://bun.sh/docs/cli/update)
   - [`bun link`](https://bun.sh/docs/cli/link)
+  - [`bun unlink`](https://bun.sh/docs/cli/unlink)
   - [`bun pm`](https://bun.sh/docs/cli/pm)
+  - [`bun outdated`](https://bun.sh/docs/cli/outdated)
+  - [`bun publish`](https://bun.sh/docs/cli/publish)
+  - [`bun patch`](https://bun.sh/docs/install/patch)
+  - [`bun patch-commit`](https://bun.sh/docs/cli/patch-commit)
   - [Global cache](https://bun.sh/docs/install/cache)
   - [Workspaces](https://bun.sh/docs/install/workspaces)
   - [Lifecycle scripts](https://bun.sh/docs/install/lifecycle)
@@ -130,6 +139,7 @@ bun upgrade --canary
   - [Lockfile](https://bun.sh/docs/install/lockfile)
   - [Scopes and registries](https://bun.sh/docs/install/registries)
   - [Overrides and resolutions](https://bun.sh/docs/install/overrides)
+  - [`.npmrc`](https://bun.sh/docs/install/npmrc)
 
 - Bundler
 
@@ -138,6 +148,11 @@ bun upgrade --canary
   - [Plugins](https://bun.sh/docs/bundler/plugins)
   - [Macros](https://bun.sh/docs/bundler/macros)
   - [vs esbuild](https://bun.sh/docs/bundler/vs-esbuild)
+  - [Single-file executable](https://bun.sh/docs/bundler/executables)
+  - [CSS](https://bun.sh/docs/bundler/css)
+  - [HTML](https://bun.sh/docs/bundler/html)
+  - [Hot Module Replacement (HMR)](https://bun.sh/docs/bundler/hmr)
+  - [Full-stack with HTML imports](https://bun.sh/docs/bundler/fullstack)
 
 - Test runner
 
@@ -150,6 +165,10 @@ bun upgrade --canary
   - [Dates and times](https://bun.sh/docs/test/time)
   - [DOM testing](https://bun.sh/docs/test/dom)
   - [Code coverage](https://bun.sh/docs/test/coverage)
+  - [Configuration](https://bun.sh/docs/test/configuration)
+  - [Discovery](https://bun.sh/docs/test/discovery)
+  - [Reporters](https://bun.sh/docs/test/reporters)
+  - [Runtime Behavior](https://bun.sh/docs/test/runtime-behavior)
 
 - Package runner
 
@@ -157,219 +176,235 @@ bun upgrade --canary
 
 - API
 
-  - [HTTP server](https://bun.sh/docs/api/http)
+  - [HTTP server (`Bun.serve`)](https://bun.sh/docs/api/http)
   - [WebSockets](https://bun.sh/docs/api/websockets)
   - [Workers](https://bun.sh/docs/api/workers)
   - [Binary data](https://bun.sh/docs/api/binary-data)
   - [Streams](https://bun.sh/docs/api/streams)
-  - [File I/O](https://bun.sh/docs/api/file-io)
+  - [File I/O (`Bun.file`)](https://bun.sh/docs/api/file-io)
   - [import.meta](https://bun.sh/docs/api/import-meta)
-  - [SQLite](https://bun.sh/docs/api/sqlite)
+  - [SQLite (`bun:sqlite`)](https://bun.sh/docs/api/sqlite)
+  - [PostgreSQL (`Bun.sql`)](https://bun.sh/docs/api/sql)
+  - [Redis (`Bun.redis`)](https://bun.sh/docs/api/redis)
+  - [S3 Client (`Bun.s3`)](https://bun.sh/docs/api/s3)
   - [FileSystemRouter](https://bun.sh/docs/api/file-system-router)
   - [TCP sockets](https://bun.sh/docs/api/tcp)
   - [UDP sockets](https://bun.sh/docs/api/udp)
   - [Globals](https://bun.sh/docs/api/globals)
   - [$ Shell](https://bun.sh/docs/runtime/shell)
-  - [Child processes](https://bun.sh/docs/api/spawn)
-  - [Transpiler](https://bun.sh/docs/api/transpiler)
+  - [Child processes (spawn)](https://bun.sh/docs/api/spawn)
+  - [Transpiler (`Bun.Transpiler`)](https://bun.sh/docs/api/transpiler)
   - [Hashing](https://bun.sh/docs/api/hashing)
+  - [Colors (`Bun.color`)](https://bun.sh/docs/api/color)
   - [Console](https://bun.sh/docs/api/console)
-  - [FFI](https://bun.sh/docs/api/ffi)
+  - [FFI (`bun:ffi`)](https://bun.sh/docs/api/ffi)
+  - [C Compiler (`bun:ffi` cc)](https://bun.sh/docs/api/cc)
   - [HTMLRewriter](https://bun.sh/docs/api/html-rewriter)
-  - [Testing](https://bun.sh/docs/api/test)
+  - [Testing (`bun:test`)](https://bun.sh/docs/api/test)
+  - [Cookies (`Bun.Cookie`)](https://bun.sh/docs/api/cookie)
   - [Utils](https://bun.sh/docs/api/utils)
   - [Node-API](https://bun.sh/docs/api/node-api)
-  - [Glob](https://bun.sh/docs/api/glob)
-  - [Semver](https://bun.sh/docs/api/semver)
-
-- Project
-  - [Roadmap](https://bun.sh/docs/project/roadmap)
-  - [Benchmarking](https://bun.sh/docs/project/benchmarking)
-  - [Contributing](https://bun.sh/docs/project/contributing)
-  - [Building Windows](https://bun.sh/docs/project/building-windows)
-  - [License](https://bun.sh/docs/project/licensing)
+  - [Glob (`Bun.Glob`)](https://bun.sh/docs/api/glob)
+  - [Semver (`Bun.semver`)](https://bun.sh/docs/api/semver)
+  - [DNS](https://bun.sh/docs/api/dns)
+  - [fetch API extensions](https://bun.sh/docs/api/fetch)
 
 ## Guides
 
 - Binary
 
-  - [Convert a Blob to a DataView](https://bun.sh/guides/binary/blob-to-dataview)
-  - [Convert a Blob to a ReadableStream](https://bun.sh/guides/binary/blob-to-stream)
   - [Convert a Blob to a string](https://bun.sh/guides/binary/blob-to-string)
-  - [Convert a Blob to a Uint8Array](https://bun.sh/guides/binary/blob-to-typedarray)
-  - [Convert a Blob to an ArrayBuffer](https://bun.sh/guides/binary/blob-to-arraybuffer)
   - [Convert a Buffer to a blob](https://bun.sh/guides/binary/buffer-to-blob)
-  - [Convert a Buffer to a ReadableStream](https://bun.sh/guides/binary/buffer-to-readablestream)
+  - [Convert a Blob to a DataView](https://bun.sh/guides/binary/blob-to-dataview)
   - [Convert a Buffer to a string](https://bun.sh/guides/binary/buffer-to-string)
-  - [Convert a Buffer to a Uint8Array](https://bun.sh/guides/binary/buffer-to-typedarray)
-  - [Convert a Buffer to an ArrayBuffer](https://bun.sh/guides/binary/buffer-to-arraybuffer)
+  - [Convert a Blob to a ReadableStream](https://bun.sh/guides/binary/blob-to-stream)
+  - [Convert a Blob to a Uint8Array](https://bun.sh/guides/binary/blob-to-typedarray)
   - [Convert a DataView to a string](https://bun.sh/guides/binary/dataview-to-string)
   - [Convert a Uint8Array to a Blob](https://bun.sh/guides/binary/typedarray-to-blob)
-  - [Convert a Uint8Array to a Buffer](https://bun.sh/guides/binary/typedarray-to-buffer)
-  - [Convert a Uint8Array to a DataView](https://bun.sh/guides/binary/typedarray-to-dataview)
-  - [Convert a Uint8Array to a ReadableStream](https://bun.sh/guides/binary/typedarray-to-readablestream)
-  - [Convert a Uint8Array to a string](https://bun.sh/guides/binary/typedarray-to-string)
-  - [Convert a Uint8Array to an ArrayBuffer](https://bun.sh/guides/binary/typedarray-to-arraybuffer)
+  - [Convert a Blob to an ArrayBuffer](https://bun.sh/guides/binary/blob-to-arraybuffer)
   - [Convert an ArrayBuffer to a Blob](https://bun.sh/guides/binary/arraybuffer-to-blob)
+  - [Convert a Buffer to a Uint8Array](https://bun.sh/guides/binary/buffer-to-typedarray)
+  - [Convert a Uint8Array to a Buffer](https://bun.sh/guides/binary/typedarray-to-buffer)
+  - [Convert a Uint8Array to a string](https://bun.sh/guides/binary/typedarray-to-string)
+  - [Convert a Buffer to an ArrayBuffer](https://bun.sh/guides/binary/buffer-to-arraybuffer)
   - [Convert an ArrayBuffer to a Buffer](https://bun.sh/guides/binary/arraybuffer-to-buffer)
   - [Convert an ArrayBuffer to a string](https://bun.sh/guides/binary/arraybuffer-to-string)
+  - [Convert a Uint8Array to a DataView](https://bun.sh/guides/binary/typedarray-to-dataview)
+  - [Convert a Buffer to a ReadableStream](https://bun.sh/guides/binary/buffer-to-readablestream)
+  - [Convert a Uint8Array to an ArrayBuffer](https://bun.sh/guides/binary/typedarray-to-arraybuffer)
   - [Convert an ArrayBuffer to a Uint8Array](https://bun.sh/guides/binary/arraybuffer-to-typedarray)
   - [Convert an ArrayBuffer to an array of numbers](https://bun.sh/guides/binary/arraybuffer-to-array)
+  - [Convert a Uint8Array to a ReadableStream](https://bun.sh/guides/binary/typedarray-to-readablestream)
 
 - Ecosystem
 
-  - [Build a frontend using Vite and Bun](https://bun.sh/guides/ecosystem/vite)
-  - [Build an app with Astro and Bun](https://bun.sh/guides/ecosystem/astro)
-  - [Build an app with Next.js and Bun](https://bun.sh/guides/ecosystem/nextjs)
+  - [Use React and JSX](https://bun.sh/guides/ecosystem/react)
+  - [Use EdgeDB with Bun](https://bun.sh/guides/ecosystem/edgedb)
+  - [Use Prisma with Bun](https://bun.sh/guides/ecosystem/prisma)
+  - [Add Sentry to a Bun app](https://bun.sh/guides/ecosystem/sentry)
+  - [Create a Discord bot](https://bun.sh/guides/ecosystem/discordjs)
+  - [Run Bun as a daemon with PM2](https://bun.sh/guides/ecosystem/pm2)
+  - [Use Drizzle ORM with Bun](https://bun.sh/guides/ecosystem/drizzle)
   - [Build an app with Nuxt and Bun](https://bun.sh/guides/ecosystem/nuxt)
   - [Build an app with Qwik and Bun](https://bun.sh/guides/ecosystem/qwik)
+  - [Build an app with Astro and Bun](https://bun.sh/guides/ecosystem/astro)
   - [Build an app with Remix and Bun](https://bun.sh/guides/ecosystem/remix)
-  - [Build an app with SolidStart and Bun](https://bun.sh/guides/ecosystem/solidstart)
-  - [Build an app with SvelteKit and Bun](https://bun.sh/guides/ecosystem/sveltekit)
-  - [Build an HTTP server using Elysia and Bun](https://bun.sh/guides/ecosystem/elysia)
-  - [Build an HTTP server using Express and Bun](https://bun.sh/guides/ecosystem/express)
+  - [Build a frontend using Vite and Bun](https://bun.sh/guides/ecosystem/vite)
+  - [Build an app with Next.js and Bun](https://bun.sh/guides/ecosystem/nextjs)
+  - [Run Bun as a daemon with systemd](https://bun.sh/guides/ecosystem/systemd)
+  - [Deploy a Bun application on Render](https://bun.sh/guides/ecosystem/render)
   - [Build an HTTP server using Hono and Bun](https://bun.sh/guides/ecosystem/hono)
+  - [Build an app with SvelteKit and Bun](https://bun.sh/guides/ecosystem/sveltekit)
+  - [Build an app with SolidStart and Bun](https://bun.sh/guides/ecosystem/solidstart)
+  - [Build an HTTP server using Elysia and Bun](https://bun.sh/guides/ecosystem/elysia)
   - [Build an HTTP server using StricJS and Bun](https://bun.sh/guides/ecosystem/stric)
   - [Containerize a Bun application with Docker](https://bun.sh/guides/ecosystem/docker)
-  - [Create a Discord bot](https://bun.sh/guides/ecosystem/discordjs)
-  - [Deploy a Bun application on Render](https://bun.sh/guides/ecosystem/render)
-  - [Read and write data to MongoDB using Mongoose and Bun](https://bun.sh/guides/ecosystem/mongoose)
-  - [Run Bun as a daemon with PM2](https://bun.sh/guides/ecosystem/pm2)
-  - [Run Bun as a daemon with systemd](https://bun.sh/guides/ecosystem/systemd)
+  - [Build an HTTP server using Express and Bun](https://bun.sh/guides/ecosystem/express)
+  - [Use Neon Postgres through Drizzle ORM](https://bun.sh/guides/ecosystem/neon-drizzle)
   - [Server-side render (SSR) a React component](https://bun.sh/guides/ecosystem/ssr-react)
-  - [Use Drizzle ORM with Bun](https://bun.sh/guides/ecosystem/drizzle)
-  - [Use EdgeDB with Bun](https://bun.sh/guides/ecosystem/edgedb)
+  - [Read and write data to MongoDB using Mongoose and Bun](https://bun.sh/guides/ecosystem/mongoose)
   - [Use Neon's Serverless Postgres with Bun](https://bun.sh/guides/ecosystem/neon-serverless-postgres)
-  - [Use Prisma with Bun](https://bun.sh/guides/ecosystem/prisma)
-  - [Use React and JSX](https://bun.sh/guides/ecosystem/react)
-  - [Add Sentry to a Bun app](https://bun.sh/guides/ecosystem/sentry)
+
+- HTMLRewriter
+
+  - [Extract links from a webpage using HTMLRewriter](https://bun.sh/guides/html-rewriter/extract-links)
+  - [Extract social share images and Open Graph tags](https://bun.sh/guides/html-rewriter/extract-social-meta)
 
 - HTTP
 
-  - [Common HTTP server usage](https://bun.sh/guides/http/server)
-  - [Configure TLS on an HTTP server](https://bun.sh/guides/http/tls)
-  - [fetch with unix domain sockets in Bun](https://bun.sh/guides/http/fetch-unix)
   - [Hot reload an HTTP server](https://bun.sh/guides/http/hot)
-  - [Proxy HTTP requests using fetch()](https://bun.sh/guides/http/proxy)
+  - [Common HTTP server usage](https://bun.sh/guides/http/server)
+  - [Write a simple HTTP server](https://bun.sh/guides/http/simple)
+  - [Configure TLS on an HTTP server](https://bun.sh/guides/http/tls)
   - [Send an HTTP request using fetch](https://bun.sh/guides/http/fetch)
+  - [Proxy HTTP requests using fetch()](https://bun.sh/guides/http/proxy)
   - [Start a cluster of HTTP servers](https://bun.sh/guides/http/cluster)
   - [Stream a file as an HTTP Response](https://bun.sh/guides/http/stream-file)
+  - [fetch with unix domain sockets in Bun](https://bun.sh/guides/http/fetch-unix)
+  - [Upload files via HTTP using FormData](https://bun.sh/guides/http/file-uploads)
   - [Streaming HTTP Server with Async Iterators](https://bun.sh/guides/http/stream-iterator)
   - [Streaming HTTP Server with Node.js Streams](https://bun.sh/guides/http/stream-node-streams-in-bun)
-  - [Upload files via HTTP using FormData](https://bun.sh/guides/http/file-uploads)
-  - [Write a simple HTTP server](https://bun.sh/guides/http/simple)
 
 - Install
 
   - [Add a dependency](https://bun.sh/guides/install/add)
-  - [Add a development dependency](https://bun.sh/guides/install/add-dev)
   - [Add a Git dependency](https://bun.sh/guides/install/add-git)
   - [Add a peer dependency](https://bun.sh/guides/install/add-peer)
-  - [Add a tarball dependency](https://bun.sh/guides/install/add-tarball)
   - [Add a trusted dependency](https://bun.sh/guides/install/trusted)
+  - [Add a development dependency](https://bun.sh/guides/install/add-dev)
+  - [Add a tarball dependency](https://bun.sh/guides/install/add-tarball)
   - [Add an optional dependency](https://bun.sh/guides/install/add-optional)
-  - [Configure a private registry for an organization scope with bun install](https://bun.sh/guides/install/registry-scope)
-  - [Configure git to diff Bun's lockb lockfile](https://bun.sh/guides/install/git-diff-bun-lockfile)
+  - [Generate a yarn-compatible lockfile](https://bun.sh/guides/install/yarnlock)
   - [Configuring a monorepo using workspaces](https://bun.sh/guides/install/workspaces)
-  - [Generate a human-readable lockfile](https://bun.sh/guides/install/yarnlock)
   - [Install a package under a different name](https://bun.sh/guides/install/npm-alias)
   - [Install dependencies with Bun in GitHub Actions](https://bun.sh/guides/install/cicd)
+  - [Using bun install with Artifactory](https://bun.sh/guides/install/jfrog-artifactory)
+  - [Configure git to diff Bun's lockb lockfile](https://bun.sh/guides/install/git-diff-bun-lockfile)
   - [Override the default npm registry for bun install](https://bun.sh/guides/install/custom-registry)
   - [Using bun install with an Azure Artifacts npm registry](https://bun.sh/guides/install/azure-artifacts)
-  - [Using bun install with Artifactory](https://bun.sh/guides/install/jfrog-artifactory)
+  - [Migrate from npm install to bun install](https://bun.sh/guides/install/from-npm-install-to-bun-install)
+  - [Configure a private registry for an organization scope with bun install](https://bun.sh/guides/install/registry-scope)
 
 - Process
 
-  - [Get the process uptime in nanoseconds](https://bun.sh/guides/process/nanoseconds)
+  - [Read from stdin](https://bun.sh/guides/process/stdin)
   - [Listen for CTRL+C](https://bun.sh/guides/process/ctrl-c)
+  - [Spawn a child process](https://bun.sh/guides/process/spawn)
   - [Listen to OS signals](https://bun.sh/guides/process/os-signals)
   - [Parse command-line arguments](https://bun.sh/guides/process/argv)
-  - [Read from stdin](https://bun.sh/guides/process/stdin)
   - [Read stderr from a child process](https://bun.sh/guides/process/spawn-stderr)
   - [Read stdout from a child process](https://bun.sh/guides/process/spawn-stdout)
-  - [Spawn a child process](https://bun.sh/guides/process/spawn)
+  - [Get the process uptime in nanoseconds](https://bun.sh/guides/process/nanoseconds)
   - [Spawn a child process and communicate using IPC](https://bun.sh/guides/process/ipc)
 
 - Read file
 
+  - [Read a JSON file](https://bun.sh/guides/read-file/json)
   - [Check if a file exists](https://bun.sh/guides/read-file/exists)
-  - [Get the MIME type of a file](https://bun.sh/guides/read-file/mime)
-  - [Read a file as a ReadableStream](https://bun.sh/guides/read-file/stream)
   - [Read a file as a string](https://bun.sh/guides/read-file/string)
   - [Read a file to a Buffer](https://bun.sh/guides/read-file/buffer)
+  - [Get the MIME type of a file](https://bun.sh/guides/read-file/mime)
+  - [Watch a directory for changes](https://bun.sh/guides/read-file/watch)
+  - [Read a file as a ReadableStream](https://bun.sh/guides/read-file/stream)
   - [Read a file to a Uint8Array](https://bun.sh/guides/read-file/uint8array)
   - [Read a file to an ArrayBuffer](https://bun.sh/guides/read-file/arraybuffer)
-  - [Read a JSON file](https://bun.sh/guides/read-file/json)
-  - [Watch a directory for changes](https://bun.sh/guides/read-file/watch)
 
 - Runtime
 
-  - [Debugging Bun with the VS Code extension](https://bun.sh/guides/runtime/vscode-debugger)
-  - [Debugging Bun with the web debugger](https://bun.sh/guides/runtime/web-debugger)
-  - [Define and replace static globals & constants](https://bun.sh/guides/runtime/define-constant)
+  - [Delete files](https://bun.sh/guides/runtime/delete-file)
+  - [Run a Shell Command](https://bun.sh/guides/runtime/shell)
   - [Import a JSON file](https://bun.sh/guides/runtime/import-json)
   - [Import a TOML file](https://bun.sh/guides/runtime/import-toml)
-  - [Import HTML file as text](https://bun.sh/guides/runtime/import-html)
-  - [Install and run Bun in GitHub Actions](https://bun.sh/guides/runtime/cicd)
-  - [Install TypeScript declarations for Bun](https://bun.sh/guides/runtime/typescript)
-  - [Re-map import paths](https://bun.sh/guides/runtime/tsconfig-paths)
-  - [Read environment variables](https://bun.sh/guides/runtime/read-env)
-  - [Run a Shell Command](https://bun.sh/guides/runtime/shell)
   - [Set a time zone in Bun](https://bun.sh/guides/runtime/timezone)
   - [Set environment variables](https://bun.sh/guides/runtime/set-env)
+  - [Re-map import paths](https://bun.sh/guides/runtime/tsconfig-paths)
+  - [Delete directories](https://bun.sh/guides/runtime/delete-directory)
+  - [Read environment variables](https://bun.sh/guides/runtime/read-env)
+  - [Import a HTML file as text](https://bun.sh/guides/runtime/import-html)
+  - [Install and run Bun in GitHub Actions](https://bun.sh/guides/runtime/cicd)
+  - [Debugging Bun with the web debugger](https://bun.sh/guides/runtime/web-debugger)
+  - [Install TypeScript declarations for Bun](https://bun.sh/guides/runtime/typescript)
+  - [Debugging Bun with the VS Code extension](https://bun.sh/guides/runtime/vscode-debugger)
+  - [Inspect memory usage using V8 heap snapshots](https://bun.sh/guides/runtime/heap-snapshot)
+  - [Define and replace static globals & constants](https://bun.sh/guides/runtime/define-constant)
+  - [Codesign a single-file JavaScript executable on macOS](https://bun.sh/guides/runtime/codesign-macos-executable)
 
 - Streams
 
-  - [Convert a Node.js Readable to a Blob](https://bun.sh/guides/streams/node-readable-to-blob)
-  - [Convert a Node.js Readable to a string](https://bun.sh/guides/streams/node-readable-to-string)
-  - [Convert a Node.js Readable to an ArrayBuffer](https://bun.sh/guides/streams/node-readable-to-arraybuffer)
-  - [Convert a Node.js Readable to JSON](https://bun.sh/guides/streams/node-readable-to-json)
+  - [Convert a ReadableStream to JSON](https://bun.sh/guides/streams/to-json)
   - [Convert a ReadableStream to a Blob](https://bun.sh/guides/streams/to-blob)
   - [Convert a ReadableStream to a Buffer](https://bun.sh/guides/streams/to-buffer)
   - [Convert a ReadableStream to a string](https://bun.sh/guides/streams/to-string)
   - [Convert a ReadableStream to a Uint8Array](https://bun.sh/guides/streams/to-typedarray)
   - [Convert a ReadableStream to an array of chunks](https://bun.sh/guides/streams/to-array)
+  - [Convert a Node.js Readable to JSON](https://bun.sh/guides/streams/node-readable-to-json)
   - [Convert a ReadableStream to an ArrayBuffer](https://bun.sh/guides/streams/to-arraybuffer)
-  - [Convert a ReadableStream to JSON](https://bun.sh/guides/streams/to-json)
+  - [Convert a Node.js Readable to a Blob](https://bun.sh/guides/streams/node-readable-to-blob)
+  - [Convert a Node.js Readable to a string](https://bun.sh/guides/streams/node-readable-to-string)
+  - [Convert a Node.js Readable to an Uint8Array](https://bun.sh/guides/streams/node-readable-to-uint8array)
+  - [Convert a Node.js Readable to an ArrayBuffer](https://bun.sh/guides/streams/node-readable-to-arraybuffer)
 
 - Test
 
-  - [Bail early with the Bun test runner](https://bun.sh/guides/test/bail)
-  - [Generate code coverage reports with the Bun test runner](https://bun.sh/guides/test/coverage)
-  - [Mark a test as a "todo" with the Bun test runner](https://bun.sh/guides/test/todo-tests)
-  - [Migrate from Jest to Bun's test runner](https://bun.sh/guides/test/migrate-from-jest)
-  - [Mock functions in `bun test`](https://bun.sh/guides/test/mock-functions)
-  - [Re-run tests multiple times with the Bun test runner](https://bun.sh/guides/test/rerun-each)
-  - [Run tests in watch mode with Bun](https://bun.sh/guides/test/watch-mode)
-  - [Run your tests with the Bun test runner](https://bun.sh/guides/test/run-tests)
-  - [Set a code coverage threshold with the Bun test runner](https://bun.sh/guides/test/coverage-threshold)
-  - [Set a per-test timeout with the Bun test runner](https://bun.sh/guides/test/timeout)
-  - [Set the system time in Bun's test runner](https://bun.sh/guides/test/mock-clock)
-  - [Skip tests with the Bun test runner](https://bun.sh/guides/test/skip-tests)
   - [Spy on methods in `bun test`](https://bun.sh/guides/test/spy-on)
-  - [Update snapshots in `bun test`](https://bun.sh/guides/test/update-snapshots)
+  - [Bail early with the Bun test runner](https://bun.sh/guides/test/bail)
+  - [Mock functions in `bun test`](https://bun.sh/guides/test/mock-functions)
+  - [Run tests in watch mode with Bun](https://bun.sh/guides/test/watch-mode)
   - [Use snapshot testing in `bun test`](https://bun.sh/guides/test/snapshot)
+  - [Skip tests with the Bun test runner](https://bun.sh/guides/test/skip-tests)
+  - [Using Testing Library with Bun](https://bun.sh/guides/test/testing-library)
+  - [Update snapshots in `bun test`](https://bun.sh/guides/test/update-snapshots)
+  - [Run your tests with the Bun test runner](https://bun.sh/guides/test/run-tests)
+  - [Set the system time in Bun's test runner](https://bun.sh/guides/test/mock-clock)
+  - [Set a per-test timeout with the Bun test runner](https://bun.sh/guides/test/timeout)
+  - [Migrate from Jest to Bun's test runner](https://bun.sh/guides/test/migrate-from-jest)
   - [Write browser DOM tests with Bun and happy-dom](https://bun.sh/guides/test/happy-dom)
+  - [Mark a test as a "todo" with the Bun test runner](https://bun.sh/guides/test/todo-tests)
+  - [Re-run tests multiple times with the Bun test runner](https://bun.sh/guides/test/rerun-each)
+  - [Generate code coverage reports with the Bun test runner](https://bun.sh/guides/test/coverage)
+  - [import, require, and test Svelte components with bun test](https://bun.sh/guides/test/svelte-test)
+  - [Set a code coverage threshold with the Bun test runner](https://bun.sh/guides/test/coverage-threshold)
 
 - Util
 
-  - [Check if the current file is the entrypoint](https://bun.sh/guides/util/entrypoint)
+  - [Generate a UUID](https://bun.sh/guides/util/javascript-uuid)
+  - [Hash a password](https://bun.sh/guides/util/hash-a-password)
+  - [Escape an HTML string](https://bun.sh/guides/util/escape-html)
+  - [Get the current Bun version](https://bun.sh/guides/util/version)
+  - [Encode and decode base64 strings](https://bun.sh/guides/util/base64)
+  - [Compress and decompress data with gzip](https://bun.sh/guides/util/gzip)
+  - [Sleep for a fixed number of milliseconds](https://bun.sh/guides/util/sleep)
+  - [Detect when code is executed with Bun](https://bun.sh/guides/util/detect-bun)
   - [Check if two objects are deeply equal](https://bun.sh/guides/util/deep-equals)
   - [Compress and decompress data with DEFLATE](https://bun.sh/guides/util/deflate)
-  - [Compress and decompress data with gzip](https://bun.sh/guides/util/gzip)
+  - [Get the absolute path to the current entrypoint](https://bun.sh/guides/util/main)
+  - [Get the directory of the current file](https://bun.sh/guides/util/import-meta-dir)
+  - [Check if the current file is the entrypoint](https://bun.sh/guides/util/entrypoint)
+  - [Get the file name of the current file](https://bun.sh/guides/util/import-meta-file)
   - [Convert a file URL to an absolute path](https://bun.sh/guides/util/file-url-to-path)
   - [Convert an absolute path to a file URL](https://bun.sh/guides/util/path-to-file-url)
-  - [Detect when code is executed with Bun](https://bun.sh/guides/util/detect-bun)
-  - [Encode and decode base64 strings](https://bun.sh/guides/util/base64)
-  - [Escape an HTML string](https://bun.sh/guides/util/escape-html)
   - [Get the absolute path of the current file](https://bun.sh/guides/util/import-meta-path)
-  - [Get the absolute path to the current entrypoint](https://bun.sh/guides/util/main)
-  - [Get the current Bun version](https://bun.sh/guides/util/version)
-  - [Get the directory of the current file](https://bun.sh/guides/util/import-meta-dir)
-  - [Get the file name of the current file](https://bun.sh/guides/util/import-meta-file)
   - [Get the path to an executable bin file](https://bun.sh/guides/util/which-path-to-executable-bin)
-  - [Hash a password](https://bun.sh/guides/util/hash-a-password)
-  - [Sleep for a fixed number of milliseconds](https://bun.sh/guides/util/sleep)
 
 - WebSocket
 
@@ -379,16 +414,17 @@ bun upgrade --canary
   - [Set per-socket contextual data on a WebSocket](https://bun.sh/guides/websocket/context)
 
 - Write file
-  - [Append content to a file](https://bun.sh/guides/write-file/append)
-  - [Copy a file to another location](https://bun.sh/guides/write-file/file-cp)
+
   - [Delete a file](https://bun.sh/guides/write-file/unlink)
-  - [Write a Blob to a file](https://bun.sh/guides/write-file/blob)
-  - [Write a file incrementally](https://bun.sh/guides/write-file/filesink)
-  - [Write a file to stdout](https://bun.sh/guides/write-file/cat)
-  - [Write a ReadableStream to a file](https://bun.sh/guides/write-file/stream)
-  - [Write a Response to a file](https://bun.sh/guides/write-file/response)
-  - [Write a string to a file](https://bun.sh/guides/write-file/basic)
   - [Write to stdout](https://bun.sh/guides/write-file/stdout)
+  - [Write a file to stdout](https://bun.sh/guides/write-file/cat)
+  - [Write a Blob to a file](https://bun.sh/guides/write-file/blob)
+  - [Write a string to a file](https://bun.sh/guides/write-file/basic)
+  - [Append content to a file](https://bun.sh/guides/write-file/append)
+  - [Write a file incrementally](https://bun.sh/guides/write-file/filesink)
+  - [Write a Response to a file](https://bun.sh/guides/write-file/response)
+  - [Copy a file to another location](https://bun.sh/guides/write-file/file-cp)
+  - [Write a ReadableStream to a file](https://bun.sh/guides/write-file/stream)
 
 ## Contributing
 

bench/crypto/aes-gcm-throughput.mjs

@@ -0,0 +1,44 @@
+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/crypto/diffie-hellman.mjs

@@ -0,0 +1,53 @@
+import crypto from "node:crypto";
+import { bench, run } from "../runner.mjs";
+
+// Pre-generate DH params to avoid including setup in benchmarks
+const dhSize = 1024; // Reduced from 2048 for faster testing
+const dh = crypto.createDiffieHellman(dhSize);
+const dhPrime = dh.getPrime();
+const dhGenerator = dh.getGenerator();
+
+// Classical Diffie-Hellman
+bench("DH - generateKeys", () => {
+  const alice = crypto.createDiffieHellman(dhPrime, dhGenerator);
+  return alice.generateKeys();
+});
+
+bench("DH - computeSecret", () => {
+  // Setup
+  const alice = crypto.createDiffieHellman(dhPrime, dhGenerator);
+  const aliceKey = alice.generateKeys();
+  const bob = crypto.createDiffieHellman(dhPrime, dhGenerator);
+  const bobKey = bob.generateKeys();
+
+  // Benchmark just the secret computation
+  return alice.computeSecret(bobKey);
+});
+
+// ECDH with prime256v1 (P-256)
+bench("ECDH-P256 - generateKeys", () => {
+  const ecdh = crypto.createECDH("prime256v1");
+  return ecdh.generateKeys();
+});
+
+bench("ECDH-P256 - computeSecret", () => {
+  // Setup
+  const alice = crypto.createECDH("prime256v1");
+  const aliceKey = alice.generateKeys();
+  const bob = crypto.createECDH("prime256v1");
+  const bobKey = bob.generateKeys();
+
+  // Benchmark just the secret computation
+  return alice.computeSecret(bobKey);
+});
+
+// ECDH with secp384r1 (P-384)
+bench("ECDH-P384 - computeSecret", () => {
+  const alice = crypto.createECDH("secp384r1");
+  const aliceKey = alice.generateKeys();
+  const bob = crypto.createECDH("secp384r1");
+  const bobKey = bob.generateKeys();
+  return alice.computeSecret(bobKey);
+});
+
+await run();

bench/crypto/ecdh-convert-key.mjs

@@ -0,0 +1,44 @@
+import crypto from "node:crypto";
+import { bench, run } from "../runner.mjs";
+
+function generateTestKeyPairs() {
+  const curves = crypto.getCurves();
+  const keys = {};
+
+  for (const curve of curves) {
+    const ecdh = crypto.createECDH(curve);
+    ecdh.generateKeys();
+
+    keys[curve] = {
+      compressed: ecdh.getPublicKey("hex", "compressed"),
+      uncompressed: ecdh.getPublicKey("hex", "uncompressed"),
+      instance: ecdh,
+    };
+  }
+
+  return keys;
+}
+
+const testKeys = generateTestKeyPairs();
+
+bench("ECDH key format - P256 compressed to uncompressed", () => {
+  const publicKey = testKeys["prime256v1"].compressed;
+  return crypto.ECDH.convertKey(publicKey, "prime256v1", "hex", "hex", "uncompressed");
+});
+
+bench("ECDH key format - P256 uncompressed to compressed", () => {
+  const publicKey = testKeys["prime256v1"].uncompressed;
+  return crypto.ECDH.convertKey(publicKey, "prime256v1", "hex", "hex", "compressed");
+});
+
+bench("ECDH key format - P384 compressed to uncompressed", () => {
+  const publicKey = testKeys["secp384r1"].compressed;
+  return crypto.ECDH.convertKey(publicKey, "secp384r1", "hex", "hex", "uncompressed");
+});
+
+bench("ECDH key format - P384 uncompressed to compressed", () => {
+  const publicKey = testKeys["secp384r1"].uncompressed;
+  return crypto.ECDH.convertKey(publicKey, "secp384r1", "hex", "hex", "compressed");
+});
+
+await run();

bench/crypto/hkdf.mjs

@@ -0,0 +1,50 @@
+import crypto from "node:crypto";
+import { bench, run } from "../runner.mjs";
+
+// Sample keys with different lengths
+const keys = {
+  short: "secret",
+  long: "this-is-a-much-longer-secret-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+};
+
+// Test parameters
+const salts = ["", "salt"];
+const infos = ["", "info"];
+const hashes = ["sha256", "sha512"];
+const sizes = [10, 1024];
+
+// Benchmark sync HKDF
+for (const hash of hashes) {
+  for (const keyName of Object.keys(keys)) {
+    const key = keys[keyName];
+    for (const size of sizes) {
+      bench(`hkdfSync ${hash} ${keyName}-key ${size} bytes`, () => {
+        return crypto.hkdfSync(hash, key, "salt", "info", size);
+      });
+    }
+  }
+}
+
+// Benchmark different combinations of salt and info
+for (const salt of salts) {
+  for (const info of infos) {
+    bench(`hkdfSync sha256 with ${salt ? "salt" : "no-salt"} and ${info ? "info" : "no-info"}`, () => {
+      return crypto.hkdfSync("sha256", "secret", salt, info, 64);
+    });
+  }
+}
+
+// Benchmark async HKDF (using promises for cleaner benchmark)
+// Note: async benchmarks in Mitata require returning a Promise
+for (const hash of hashes) {
+  bench(`hkdf ${hash} async`, async () => {
+    return new Promise((resolve, reject) => {
+      crypto.hkdf(hash, "secret", "salt", "info", 64, (err, derivedKey) => {
+        if (err) reject(err);
+        else resolve(derivedKey);
+      });
+    });
+  });
+}
+
+await run();

bench/crypto/primes.mjs

@@ -0,0 +1,43 @@
+import { checkPrime, checkPrimeSync, generatePrime, generatePrimeSync } from "node:crypto";
+import { bench, run } from "../runner.mjs";
+
+const prime512 = generatePrimeSync(512);
+const prime2048 = generatePrimeSync(2048);
+
+bench("checkPrimeSync 512", () => {
+  return checkPrimeSync(prime512);
+});
+
+bench("checkPrimeSync 2048", () => {
+  return checkPrimeSync(prime2048);
+});
+
+bench("checkPrime 512", async () => {
+  const promises = Array.from({ length: 10 }, () => new Promise(resolve => checkPrime(prime512, resolve)));
+  await Promise.all(promises);
+});
+
+bench("checkPrime 2048", async () => {
+  const promises = Array.from({ length: 10 }, () => new Promise(resolve => checkPrime(prime2048, resolve)));
+  await Promise.all(promises);
+});
+
+bench("generatePrimeSync 512", () => {
+  return generatePrimeSync(512);
+});
+
+bench("generatePrimeSync 2048", () => {
+  return generatePrimeSync(2048);
+});
+
+bench("generatePrime 512", async () => {
+  const promises = Array.from({ length: 10 }, () => new Promise(resolve => generatePrime(512, resolve)));
+  await Promise.all(promises);
+});
+
+bench("generatePrime 2048", async () => {
+  const promises = Array.from({ length: 10 }, () => new Promise(resolve => generatePrime(2048, resolve)));
+  await Promise.all(promises);
+});
+
+await run();

bench/crypto/random.mjs

@@ -0,0 +1,50 @@
+import crypto from "crypto";
+import { bench, run } from "../runner.mjs";
+
+bench("randomInt - sync", () => {
+  crypto.randomInt(1000);
+});
+
+bench("randomInt - async", async () => {
+  const { promise, resolve } = Promise.withResolvers();
+  crypto.randomInt(1000, () => {
+    resolve();
+  });
+  await promise;
+});
+
+bench("randonBytes - 32", () => {
+  crypto.randomBytes(32);
+});
+
+bench("randomBytes - 256", () => {
+  crypto.randomBytes(256);
+});
+
+const buf = Buffer.alloc(256);
+
+bench("randomFill - 32", async () => {
+  const { promise, resolve } = Promise.withResolvers();
+  crypto.randomFill(buf, 0, 32, () => {
+    resolve();
+  });
+  await promise;
+});
+
+bench("randomFill - 256", async () => {
+  const { promise, resolve } = Promise.withResolvers();
+  crypto.randomFill(buf, 0, 256, () => {
+    resolve();
+  });
+  await promise;
+});
+
+bench("randomFillSync - 32", () => {
+  crypto.randomFillSync(buf, 0, 32);
+});
+
+bench("randomFillSync - 256", () => {
+  crypto.randomFillSync(buf, 0, 256);
+});
+
+await run();

bench/express/tsconfig.json

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,43 +0,0 @@
-{
-  "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

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

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

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

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

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

@@ -1,83 +0,0 @@
-#!/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

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

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

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

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

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

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

@@ -1,178 +0,0 @@
-{
-  "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

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

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

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

bench/hot-module-reloading/readme.md

@@ -1,15 +0,0 @@
-# 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/package.json

@@ -12,6 +12,7 @@
     "eventemitter3": "^5.0.0",
     "execa": "^8.0.1",
     "fast-glob": "3.3.1",
+    "fastify": "^5.0.0",
     "fdir": "^6.1.0",
     "mitata": "^1.0.25",
     "react": "^18.3.1",

bench/postgres/tsconfig.json

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

bench/snippets/express-hello.mjs

@@ -0,0 +1,13 @@
+import express from "express";
+
+const app = express();
+const port = 3000;
+
+var i = 0;
+app.get("/", (req, res) => {
+  res.send("Hello World!" + i++);
+});
+
+app.listen(port, () => {
+  console.log(`Express app listening at http://localhost:${port}`);
+});

bench/snippets/fastify.mjs

@@ -0,0 +1,20 @@
+import Fastify from "fastify";
+
+const fastify = Fastify({
+  logger: false,
+});
+
+fastify.get("/", async (request, reply) => {
+  return { hello: "world" };
+});
+
+const start = async () => {
+  try {
+    await fastify.listen({ port: 3000 });
+  } catch (err) {
+    fastify.log.error(err);
+    process.exit(1);
+  }
+};
+
+start();

bench/snippets/redis-simple.mjs

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

@@ -0,0 +1,14 @@
+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/snippets/require-builtins.mjs

@@ -8,9 +8,9 @@ for (let builtin of builtinModules) {
     path,
     `
 const builtin = ${JSON.stringify(builtin)};
-const now = require("perf_hooks").performance.now();
+const now = performance.now();
 require(builtin);
-const end = require("perf_hooks").performance.now();
+const end = performance.now();
 process.stdout.write(JSON.stringify({builtin, time: end - now}) + "\\n");
   `,
   );

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

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

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

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

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

@@ -0,0 +1,14 @@
+#!/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

@@ -0,0 +1,161 @@
+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 = Step.LazyPath;
+const LazyPath = Build.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;
 
-/// 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-dev.2987+183bb8b08";
+/// When updating this, make sure to adjust SetupZig.cmake
+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 ++ " (found " ++
-                builtin.zig_version_string ++ "). This is " ++
-                "automatically configured via Bun's CMake setup. You likely meant to run " ++
-                "`bun setup`. If you are trying to upgrade the Zig compiler, " ++
-                "run `./scripts/download-zig.sh master` or comment this message 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,7 +92,9 @@ 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;
@@ -153,13 +155,6 @@ 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(.{});
 
@@ -205,10 +200,8 @@ pub fn build(b: *Build) !void {
 
     const bun_version = b.option([]const u8, "version", "Value of `Bun.version`") orelse "0.0.0";
 
-    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;
-    };
+    // Lower the default reference trace for incremental
+    b.reference_trace = b.reference_trace orelse if (b.graph.incremental == true) 8 else 16;
 
     const obj_format = b.option(ObjectFormat, "obj_format", "Output file for object files") orelse .obj;
 
@@ -285,6 +278,40 @@ 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)");
@@ -308,6 +335,22 @@ 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");
@@ -319,7 +362,21 @@ pub fn build(b: *Build) !void {
             .{ .os = .linux, .arch = .aarch64 },
             .{ .os = .linux, .arch = .x86_64, .musl = true },
             .{ .os = .linux, .arch = .aarch64, .musl = true },
-        });
+        }, &.{ .Debug, .ReleaseFast });
+    }
+
+    // zig build check-all-debug
+    {
+        const step = b.step("check-all-debug", "Check for semantic analysis errors on all supported platforms in debug mode");
+        addMultiCheck(b, step, build_options, &.{
+            .{ .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 },
+        }, &.{.Debug});
     }
 
     // zig build check-windows
@@ -327,27 +384,42 @@ pub fn build(b: *Build) !void {
         const step = b.step("check-windows", "Check for semantic analysis errors on Windows");
         addMultiCheck(b, step, build_options, &.{
             .{ .os = .windows, .arch = .x86_64 },
-        });
+        }, &.{ .Debug, .ReleaseFast });
     }
     {
         const step = b.step("check-macos", "Check for semantic analysis errors on Windows");
         addMultiCheck(b, step, build_options, &.{
             .{ .os = .mac, .arch = .x86_64 },
             .{ .os = .mac, .arch = .aarch64 },
-        });
+        }, &.{ .Debug, .ReleaseFast });
     }
     {
         const step = b.step("check-linux", "Check for semantic analysis errors on Windows");
         addMultiCheck(b, step, build_options, &.{
             .{ .os = .linux, .arch = .x86_64 },
             .{ .os = .linux, .arch = .aarch64 },
-        });
+        }, &.{ .Debug, .ReleaseFast });
     }
 
     // zig build translate-c-headers
     {
         const step = b.step("translate-c", "Copy generated translated-c-headers.zig to zig-out");
-        step.dependOn(&b.addInstallFile(getTranslateC(b, b.graph.host, .Debug).getOutput(), "translated-c-headers.zig").step);
+        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,
+            );
+        }
     }
 
     // zig build enum-extractor
@@ -364,22 +436,32 @@ pub fn build(b: *Build) !void {
     }
 }
 
-pub fn addMultiCheck(
+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(
     b: *Build,
     parent_step: *Step,
     root_build_options: BunBuildOptions,
-    to_check: []const struct { os: OperatingSystem, arch: Arch, musl: bool = false },
+    to_check: []const TargetDescription,
+    optimize: []const std.builtin.OptimizeMode,
 ) void {
     for (to_check) |check| {
-        for ([_]std.builtin.Mode{ .Debug, .ReleaseFast }) |mode| {
-            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),
-            });
-
+        for (optimize) |mode| {
+            const check_target = check.resolveTarget(b);
             var options: BunBuildOptions = .{
                 .target = check_target,
                 .os = check.os,
@@ -403,7 +485,13 @@ pub fn addMultiCheck(
     }
 }
 
-fn getTranslateC(b: *Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *Step.TranslateC {
+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;
+    });
     const translate_c = b.addTranslateC(.{
         .root_source_file = b.path("src/c-headers-for-zig.h"),
         .target = target,
@@ -419,28 +507,72 @@ fn getTranslateC(b: *Build, target: std.Build.ResolvedTarget, optimize: std.buil
         const str, const value = entry;
         translate_c.defineCMacroRaw(b.fmt("{s}={d}", .{ str, @intFromBool(value) }));
     }
-    return translate_c;
+
+    if (target.result.os.tag == .windows) {
+        // 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.
+        const helper_exe = b.addExecutable(.{
+            .name = "process_windows_translate_c",
+            .root_module = b.createModule(.{
+                .root_source_file = b.path("src/codegen/process_windows_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.getOutput();
 }
 
 pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
-    const obj = b.addObject(.{
-        .name = if (opts.optimize == .Debug) "bun-debug" else "bun",
-        .root_source_file = switch (opts.os) {
-            .wasm => b.path("root_wasm.zig"),
-            else => b.path("src/main.zig"),
-            // else => b.path("root_css.zig"),
-        },
+    // 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,
-        .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
     });
+    root.addImport("bun", bun);
+
+    const obj = b.addObject(.{
+        .name = if (opts.optimize == .Debug) "bun-debug" else "bun",
+        .root_module = root,
+    });
+    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;
@@ -450,7 +582,7 @@ pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
         }
     }
     obj.bundle_compiler_rt = false;
-    obj.root_module.omit_frame_pointer = false;
+    obj.bundle_ubsan_rt = false;
 
     // Link libc
     if (opts.os != .wasm) {
@@ -460,6 +592,7 @@ pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
 
     // 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;
     }
@@ -474,17 +607,18 @@ pub fn addBunObject(b: *Build, opts: *BunBuildOptions) *Compile {
             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,
 };
 
@@ -514,16 +648,21 @@ fn exists(path: []const u8) bool {
     return true;
 }
 
-fn addInternalPackages(b: *Build, obj: *Compile, opts: *BunBuildOptions) void {
+fn addInternalImports(b: *Build, mod: *Module, 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| {
-        obj.root_module.addAnonymousImport("zlib-internal", .{
+        mod.addAnonymousImport("zlib-internal", .{
             .root_source_file = b.path(path),
         });
     }
@@ -533,7 +672,7 @@ fn addInternalPackages(b: *Build, obj: *Compile, opts: *BunBuildOptions) void {
         .windows => "src/async/windows_event_loop.zig",
         else => "src/async/stub_event_loop.zig",
     };
-    obj.root_module.addAnonymousImport("async", .{
+    mod.addAnonymousImport("async", .{
         .root_source_file = b.path(async_path),
     });
 
@@ -581,7 +720,7 @@ fn addInternalPackages(b: *Build, obj: *Compile, opts: *BunBuildOptions) void {
                 entry.import
             else
                 entry.file;
-            obj.root_module.addAnonymousImport(import_path, .{
+            mod.addAnonymousImport(import_path, .{
                 .root_source_file = .{ .cwd_relative = path },
             });
         }
@@ -591,16 +730,37 @@ fn addInternalPackages(b: *Build, obj: *Compile, opts: *BunBuildOptions) void {
         .{ .import = "completions-zsh", .file = b.path("completions/bun.zsh") },
         .{ .import = "completions-fish", .file = b.path("completions/bun.fish") },
     }) |entry| {
-        obj.root_module.addAnonymousImport(entry.import, .{
+        mod.addAnonymousImport(entry.import, .{
             .root_source_file = entry.file,
         });
     }
 
     if (os == .windows) {
-        obj.root_module.addAnonymousImport("bun_shim_impl.exe", .{
+        mod.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 {
@@ -629,30 +789,34 @@ const WindowsShim = struct {
 
         const exe = b.addExecutable(.{
             .name = "bun_shim_impl",
-            .root_source_file = path,
-            .target = target,
-            .optimize = .ReleaseFast,
+            .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,
             .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_source_file = path,
-            .target = target,
-            .optimize = .Debug,
+            .root_module = b.createModule(.{
+                .root_source_file = path,
+                .target = target,
+                .optimize = .Debug,
+                .single_threaded = true,
+                .link_libc = false,
+            }),
+            .linkage = .static,
             .use_llvm = true,
             .use_lld = true,
-            .linkage = .static,
-            .single_threaded = true,
-            .link_libc = false,
         });
 
         return .{ .exe = exe, .dbg = dbg };

bunfig.node-test.toml

@@ -2,3 +2,7 @@
 # https://github.com/oven-sh/bun/issues/16289
 [test]
 preload = ["./test/js/node/harness.ts", "./test/preload.ts"]
+
+[install]
+# Node.js never auto-installs modules.
+auto = "disable"

cmake/CompilerFlags.cmake

@@ -88,7 +88,7 @@ endif()
 if(UNIX)
   register_compiler_flags(
     DESCRIPTION "Enable debug symbols"
-    -g3 ${DEBUG}
+    -g3 -gz=zstd ${DEBUG}
     -g1 ${RELEASE}
   )
 
@@ -142,6 +142,14 @@ 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

@@ -419,7 +419,20 @@ function(register_command)
     list(APPEND CMD_EFFECTIVE_OUTPUTS ${artifact})
     if(BUILDKITE)
       file(RELATIVE_PATH filename ${BUILD_PATH} ${artifact})
-      list(APPEND CMD_COMMANDS COMMAND ${CMAKE_COMMAND} -E chdir ${BUILD_PATH} buildkite-agent artifact upload ${filename})
+      if(filename STREQUAL "libbun-profile.a")
+        # 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} 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()
     endif()
   endforeach()
 
@@ -625,7 +638,7 @@ function(register_repository)
     set(GIT_PATH ${VENDOR_PATH}/${GIT_NAME})
   endif()
 
-  set(GIT_EFFECTIVE_OUTPUTS)
+  set(GIT_EFFECTIVE_OUTPUTS ${GIT_PATH}/.ref)
   foreach(output ${GIT_OUTPUTS})
     list(APPEND GIT_EFFECTIVE_OUTPUTS ${GIT_PATH}/${output})
   endforeach()
@@ -743,11 +756,17 @@ 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
   )
 
@@ -799,6 +818,7 @@ 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,6 +26,15 @@ 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()
@@ -62,7 +71,14 @@ 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()
 
-optionx(ENABLE_LOGS BOOL "If debug logs should be enabled" DEFAULT ${DEBUG})
+# 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_ASSERTIONS BOOL "If debug assertions should be enabled" DEFAULT ${DEBUG})
 
 optionx(ENABLE_CANARY BOOL "If canary features should be enabled" DEFAULT ON)
@@ -75,7 +91,19 @@ endif()
 
 optionx(CANARY_REVISION STRING "The canary revision of the build" DEFAULT ${DEFAULT_CANARY_REVISION})
 
-if(RELEASE AND LINUX AND CI)
+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)
   set(DEFAULT_LTO ON)
 else()
   set(DEFAULT_LTO OFF)
@@ -83,16 +111,10 @@ endif()
 
 optionx(ENABLE_LTO BOOL "If LTO (link-time optimization) should be used" DEFAULT ${DEFAULT_LTO})
 
-if(LINUX)
-  optionx(ENABLE_VALGRIND BOOL "If Valgrind support should be enabled" DEFAULT OFF)
+if(ENABLE_ASAN AND ENABLE_LTO)
+  message(WARNING "ASAN and LTO are not supported together, disabling LTO")
+  setx(ENABLE_LTO 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/Sources.json

@@ -0,0 +1,65 @@
+[
+  {
+    "output": "BunErrorSources.txt",
+    "paths": ["packages/bun-error/*.{json,ts,tsx,css}", "packages/bun-error/img/*"]
+  },
+  {
+    "output": "NodeFallbacksSources.txt",
+    "paths": ["src/node-fallbacks/*.js"]
+  },
+  {
+    "output": "ZigGeneratedClassesSources.txt",
+    "paths": ["src/bun.js/*.classes.ts", "src/bun.js/{api,node,test,webcore}/*.classes.ts"]
+  },
+  {
+    "output": "JavaScriptSources.txt",
+    "paths": ["src/js/**/*.{js,ts}"]
+  },
+  {
+    "output": "JavaScriptCodegenSources.txt",
+    "paths": ["src/codegen/*.ts"]
+  },
+  {
+    "output": "BakeRuntimeSources.txt",
+    "paths": ["src/bake/*.ts", "src/bake/*/*.{ts,css}"],
+    "exclude": ["src/bake/generated.ts"]
+  },
+  {
+    "output": "BindgenSources.txt",
+    "paths": ["src/**/*.bind.ts"]
+  },
+  {
+    "output": "ZigSources.txt",
+    "paths": ["src/**/*.zig"]
+  },
+  {
+    "output": "CxxSources.txt",
+    "paths": [
+      "src/io/*.cpp",
+      "src/bun.js/modules/*.cpp",
+      "src/bun.js/bindings/*.cpp",
+      "src/bun.js/bindings/webcore/*.cpp",
+      "src/bun.js/bindings/sqlite/*.cpp",
+      "src/bun.js/bindings/webcrypto/*.cpp",
+      "src/bun.js/bindings/webcrypto/*/*.cpp",
+      "src/bun.js/bindings/node/*.cpp",
+      "src/bun.js/bindings/node/crypto/*.cpp",
+      "src/bun.js/bindings/v8/*.cpp",
+      "src/bun.js/bindings/v8/shim/*.cpp",
+      "src/bake/*.cpp",
+      "src/deps/*.cpp",
+      "packages/bun-usockets/src/crypto/*.cpp"
+    ]
+  },
+  {
+    "output": "CSources.txt",
+    "paths": [
+      "packages/bun-usockets/src/*.c",
+      "packages/bun-usockets/src/eventing/*.c",
+      "packages/bun-usockets/src/internal/*.c",
+      "packages/bun-usockets/src/crypto/*.c",
+      "src/bun.js/bindings/uv-posix-polyfills.c",
+      "src/bun.js/bindings/uv-posix-stubs.c"
+    ]
+  }
+]

cmake/scripts/DownloadZig.cmake

@@ -29,6 +29,9 @@ 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/scripts/PathUtils.cmake

@@ -0,0 +1,35 @@
+# Function to convert relative paths from a file to absolute paths
+# Usage: absolute_sources(OUTPUT_VAR INPUT_FILE [BASE_DIR])
+# OUTPUT_VAR: Variable name to store the resulting absolute paths
+# INPUT_FILE: File containing relative paths (one per line)
+# BASE_DIR: Optional base directory for resolving paths (defaults to CMAKE_CURRENT_SOURCE_DIR)
+function(absolute_sources OUTPUT_VAR INPUT_FILE)
+    # Check if a custom base directory was provided
+    if(${ARGC} GREATER 2)
+        set(BASE_DIR ${ARGV2})
+    else()
+        set(BASE_DIR ${CMAKE_CURRENT_SOURCE_DIR})
+    endif()
+    
+    # Read the file containing relative paths
+    file(STRINGS "${INPUT_FILE}" RELATIVE_PATHS)
+    
+    # Create a list to store absolute paths
+    set(RESULT_LIST "")
+    
+    # Convert each relative path to absolute
+    foreach(REL_PATH ${RELATIVE_PATHS})
+        # Skip empty lines
+        if(NOT "${REL_PATH}" STREQUAL "")
+            # Construct the absolute path
+            get_filename_component(ABS_PATH "${BASE_DIR}/${REL_PATH}" ABSOLUTE)
+            list(APPEND RESULT_LIST ${ABS_PATH})
+        endif()
+    endforeach()
+    
+    # Set the output variable in the parent scope
+    set(${OUTPUT_VAR} ${RESULT_LIST} PARENT_SCOPE)
+    
+    # Tell CMake that the configuration depends on this file
+    set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS "${INPUT_FILE}")
+endfunction()