Merge branch 'main' into pfg/event-target

Author: Jarred-Sumner

.github/workflows/clang-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/clang-tidy.yml

@@ -43,6 +43,9 @@
     "editor.tabSize": 4,
     "editor.useTabStops": false,
     "editor.defaultFormatter": "ziglang.vscode-zig",
+    "editor.codeActionsOnSave": {
+      "source.organizeImports": "never",
+    },
   },
 
   // lldb

.github/workflows/format.yml

@@ -557,6 +557,7 @@ Buffer.from(buf, 0, 10);
 #### To `string`
 
 As UTF-8:
+
 ```ts
 new TextDecoder().decode(buf);
 ```
@@ -638,6 +639,7 @@ Buffer.from(arr);
 #### To `string`
 
 As UTF-8:
+
 ```ts
 new TextDecoder().decode(arr);
 ```
@@ -716,6 +718,7 @@ Buffer.from(view.buffer, view.byteOffset, view.byteLength);
 #### To `string`
 
 As UTF-8:
+
 ```ts
 new TextDecoder().decode(view);
 ```
@@ -788,16 +791,21 @@ new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
 #### To `string`
 
 As UTF-8:
+
 ```ts
 buf.toString();
 ```
+
 As base64:
+
 ```ts
-buf.toString('base64');
+buf.toString("base64");
 ```
+
 As hex:
+
 ```ts
-buf.toString('hex');
+buf.toString("hex");
 ```
 
 #### To `number[]`
@@ -876,6 +884,7 @@ Buffer.from(await blob.arrayBuffer());
 #### To `string`
 
 As UTF-8:
+
 ```ts
 await blob.text();
 ```
@@ -962,6 +971,7 @@ Buffer.from(Bun.readableStreamToArrayBuffer(stream));
 #### To `string`
 
 As UTF-8:
+
 ```ts
 // with Response
 await new Response(stream).text();

.github/workflows/prettier-format.yml

@@ -10,7 +10,7 @@ console.log(addrs);
 
 ## DNS caching in Bun
 
-In Bun v1.1.9, we added support for DNS caching. This cache makes repeated connections to the same hosts faster. 
+In Bun v1.1.9, we added support for DNS caching. This cache makes repeated connections to the same hosts faster.
 
 At the time of writing, we cache up to 255 entries for a maximum of 30 seconds (each). If any connections to a host fail, we remove the entry from the cache. When multiple connections are made to the same host simultaneously, DNS lookups are deduplicated to avoid making multiple requests for the same host.
 
@@ -27,10 +27,10 @@ This cache is automatically used by:
 
 Web browsers expose [`<link rel="dns-prefetch">`](https://developer.mozilla.org/en-US/docs/Web/Performance/dns-prefetch) to allow developers to prefetch DNS entries. This is useful when you know you'll need to connect to a host in the near future and want to avoid the initial DNS lookup.
 
-In Bun, you can use the `dns.prefetch` API to achieve the same effect. 
+In Bun, you can use the `dns.prefetch` API to achieve the same effect.
 
 ```ts
-import {dns} from "bun";
+import { dns } from "bun";
 
 dns.prefetch("my.database-host.com", 5432);
 ```
@@ -52,7 +52,7 @@ dns.prefetch(hostname: string, port: number): void;
 Here's an example:
 
 ```ts
-import {dns} from "bun";
+import { dns } from "bun";
 
 dns.prefetch("bun.sh", 443);
 //
@@ -66,13 +66,13 @@ await fetch("https://bun.sh");
 **🚧** — This API is experimental and may change in the future.
 {% /callout %}
 
-To get the current cache stats, you can use the `dns.getCacheStats` API. 
+To get the current cache stats, you can use the `dns.getCacheStats` API.
 
 This API returns an object with the following properties:
 
 ```ts
 {
-  // Cache hits 
+  // Cache hits
   cacheHitsCompleted: number;
   cacheHitsInflight: number;
   cacheMisses: number;
@@ -90,7 +90,7 @@ This API returns an object with the following properties:
 Example:
 
 ```ts
-import {dns} from "bun";
+import { dns } from "bun";
 
 const stats = dns.getCacheStats();
 console.log(stats);
@@ -107,7 +107,4 @@ BUN_CONFIG_DNS_TIME_TO_LIVE_SECONDS=5 bun run my-script.ts
 
 #### Why is 30 seconds the default?
 
-Unfortunately, the system API underneath (`getaddrinfo`) does not provide a way to get the TTL of a DNS entry. This means we have to pick a number arbitrarily. We chose 30 seconds because it's long enough to see the benefits of caching, and short enough to be unlikely to cause issues if a DNS entry changes. [Amazon Web Services recommends 5 seconds](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/jvm-ttl-dns.html) for the Java Virtual Machine, however the JVM defaults to cache indefinitely. 
-
-
-
+Unfortunately, the system API underneath (`getaddrinfo`) does not provide a way to get the TTL of a DNS entry. This means we have to pick a number arbitrarily. We chose 30 seconds because it's long enough to see the benefits of caching, and short enough to be unlikely to cause issues if a DNS entry changes. [Amazon Web Services recommends 5 seconds](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/jvm-ttl-dns.html) for the Java Virtual Machine, however the JVM defaults to cache indefinitely.

.github/workflows/zig-format.yml

@@ -67,7 +67,7 @@ Bun.stderr;
 You can delete a file by calling the `.delete()` function.
 
 ```ts
-await Bun.file("logs.json").delete()
+await Bun.file("logs.json").delete();
 ```
 
 ## Writing files (`Bun.write()`)