bun-types 1.2.19-canary.20250719T140529 → 1.2.20-canary.20250720T140547

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/api/fetch.md CHANGED
@@ -337,7 +337,7 @@ This will print the request and response headers to your terminal:
337
337
  ```sh
338
338
  [fetch] > HTTP/1.1 GET http://example.com/
339
339
  [fetch] > Connection: keep-alive
340
- [fetch] > User-Agent: Bun/1.2.19-canary.20250719T140529
340
+ [fetch] > User-Agent: Bun/1.2.20-canary.20250720T140547
341
341
  [fetch] > Accept: */*
342
342
  [fetch] > Host: example.com
343
343
  [fetch] > Accept-Encoding: gzip, deflate, br
package/docs/api/spawn.md CHANGED
@@ -140,7 +140,7 @@ You can read results from the subprocess via the `stdout` and `stderr` propertie
140
140
  ```ts
141
141
  const proc = Bun.spawn(["bun", "--version"]);
142
142
  const text = await proc.stdout.text();
143
- console.log(text); // => "1.2.19-canary.20250719T140529\n"
143
+ console.log(text); // => "1.2.20-canary.20250720T140547\n"
144
144
  ```
145
145
 
146
146
  Configure the output stream by passing one of the following values to `stdout/stderr`:
@@ -245,7 +245,8 @@ linker = "hoisted"
245
245
 
246
246
  ## CI/CD
247
247
 
248
- Looking to speed up your CI? Use the official [`oven-sh/setup-bun`](https://github.com/oven-sh/setup-bun) action to install `bun` in a GitHub Actions pipeline.
248
+
249
+ Use the official [`oven-sh/setup-bun`](https://github.com/oven-sh/setup-bun) action to install `bun` in a GitHub Actions pipeline:
249
250
 
250
251
  ```yaml#.github/workflows/release.yml
251
252
  name: bun-types
@@ -264,4 +265,33 @@ jobs:
264
265
  run: bun run build
265
266
  ```
266
267
 
268
+ For CI/CD environments that want to enforce reproducible builds, use `bun ci` to fail the build if the package.json is out of sync with the lockfile:
269
+
270
+ ```bash
271
+ $ bun ci
272
+ ```
273
+
274
+ This is equivalent to `bun install --frozen-lockfile`. It installs exact versions from `bun.lock` and fails if `package.json` doesn't match the lockfile. To use `bun ci` or `bun install --frozen-lockfile`, you must commit `bun.lock` to version control.
275
+
276
+ And instead of running `bun install`, run `bun ci`.
277
+
278
+ ```yaml#.github/workflows/release.yml
279
+ name: bun-types
280
+ jobs:
281
+ build:
282
+ name: build-app
283
+ runs-on: ubuntu-latest
284
+ steps:
285
+ - name: Checkout repo
286
+ uses: actions/checkout@v4
287
+ - name: Install bun
288
+ uses: oven-sh/setup-bun@v2
289
+ - name: Install dependencies
290
+ run: bun ci
291
+ - name: Build app
292
+ run: bun run build
293
+ ```
294
+
295
+
296
+
267
297
  {% bunCLIUsage command="install" /%}
package/docs/cli/pm.md CHANGED
@@ -213,7 +213,7 @@ To display current package version and help:
213
213
 
214
214
  ```bash
215
215
  $ bun pm version
216
- bun pm version v1.2.19-canary.20250719T140529 (ca7428e9)
216
+ bun pm version v1.2.20-canary.20250720T140547 (ca7428e9)
217
217
  Current package version: v1.0.0
218
218
 
219
219
  Increment:
@@ -7,7 +7,7 @@ Use `bun publish` to publish a package to the npm registry.
7
7
  $ bun publish
8
8
 
9
9
  ## Output
10
- bun publish v1.2.19-canary.20250719T140529 (ca7428e9)
10
+ bun publish v1.2.20-canary.20250720T140547 (ca7428e9)
11
11
 
12
12
  packed 203B package.json
13
13
  packed 224B README.md
@@ -10,6 +10,86 @@ To update a specific dependency to the latest version:
10
10
  $ bun update [package]
11
11
  ```
12
12
 
13
+ ## `--interactive`
14
+
15
+ For a more controlled update experience, use the `--interactive` flag to select which packages to update:
16
+
17
+ ```sh
18
+ $ bun update --interactive
19
+ $ bun update -i
20
+ ```
21
+
22
+ This launches an interactive terminal interface that shows all outdated packages with their current and target versions. You can then select which packages to update.
23
+
24
+ ### Interactive Interface
25
+
26
+ The interface displays packages grouped by dependency type:
27
+
28
+ ```
29
+ ? Select packages to update - Space to toggle, Enter to confirm, a to select all, n to select none, i to invert, l to toggle latest
30
+
31
+ dependencies Current Target Latest
32
+ □ react 17.0.2 18.2.0 18.3.1
33
+ □ lodash 4.17.20 4.17.21 4.17.21
34
+
35
+ devDependencies Current Target Latest
36
+ □ typescript 4.8.0 5.0.0 5.3.3
37
+ □ @types/node 16.11.7 18.0.0 20.11.5
38
+
39
+ optionalDependencies Current Target Latest
40
+ □ some-optional-package 1.0.0 1.1.0 1.2.0
41
+ ```
42
+
43
+ **Sections:**
44
+
45
+ - Packages are grouped under section headers: `dependencies`, `devDependencies`, `peerDependencies`, `optionalDependencies`
46
+ - Each section shows column headers aligned with the package data
47
+
48
+ **Columns:**
49
+
50
+ - **Package**: Package name (may have suffix like ` dev`, ` peer`, ` optional` for clarity)
51
+ - **Current**: Currently installed version
52
+ - **Target**: Version that would be installed (respects semver constraints)
53
+ - **Latest**: Latest available version
54
+
55
+ ### Keyboard Controls
56
+
57
+ **Selection:**
58
+
59
+ - **Space**: Toggle package selection
60
+ - **Enter**: Confirm selections and update
61
+ - **a/A**: Select all packages
62
+ - **n/N**: Select none
63
+ - **i/I**: Invert selection
64
+
65
+ **Navigation:**
66
+
67
+ - **↑/↓ Arrow keys** or **j/k**: Move cursor
68
+ - **l/L**: Toggle between target and latest version for current package
69
+
70
+ **Exit:**
71
+
72
+ - **Ctrl+C** or **Ctrl+D**: Cancel without updating
73
+
74
+ ### Visual Indicators
75
+
76
+ - **☑** Selected packages (will be updated)
77
+ - **□** Unselected packages
78
+ - **>** Current cursor position
79
+ - **Colors**: Red (major), yellow (minor), green (patch) version changes
80
+ - **Underlined**: Currently selected update target
81
+
82
+ ### Package Grouping
83
+
84
+ Packages are organized in sections by dependency type:
85
+
86
+ - **dependencies** - Regular runtime dependencies
87
+ - **devDependencies** - Development dependencies
88
+ - **peerDependencies** - Peer dependencies
89
+ - **optionalDependencies** - Optional dependencies
90
+
91
+ Within each section, individual packages may have additional suffixes (` dev`, ` peer`, ` optional`) for extra clarity.
92
+
13
93
  ## `--latest`
14
94
 
15
95
  By default, `bun update` will update to the latest version of a dependency that satisfies the version range specified in your `package.json`.
@@ -20,6 +100,8 @@ To update to the latest version, regardless of if it's compatible with the curre
20
100
  $ bun update --latest
21
101
  ```
22
102
 
103
+ In interactive mode, you can toggle individual packages between their target version (respecting semver) and latest version using the **l** key.
104
+
23
105
  For example, with the following `package.json`:
24
106
 
25
107
  ```json
@@ -9,7 +9,7 @@ $ bunx nuxi init my-nuxt-app
9
9
  ✔ Which package manager would you like to use?
10
10
  bun
11
11
  ◐ Installing dependencies...
12
- bun install v1.2.19-canary.20250719T140529 (16b4bf34)
12
+ bun install v1.2.20-canary.20250720T140547 (16b4bf34)
13
13
  + @nuxt/devtools@0.8.2
14
14
  + nuxt@3.7.0
15
15
  785 packages installed [2.67s]
@@ -15,7 +15,7 @@ This will add the package to `peerDependencies` in `package.json`.
15
15
  ```json-diff
16
16
  {
17
17
  "peerDependencies": {
18
- + "@types/bun": "^1.2.19-canary.20250719T140529"
18
+ + "@types/bun": "^1.2.20-canary.20250720T140547"
19
19
  }
20
20
  }
21
21
  ```
@@ -27,7 +27,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
27
27
  ```json-diff
28
28
  {
29
29
  "peerDependencies": {
30
- "@types/bun": "^1.2.19-canary.20250719T140529"
30
+ "@types/bun": "^1.2.20-canary.20250720T140547"
31
31
  },
32
32
  "peerDependenciesMeta": {
33
33
  + "@types/bun": {
@@ -97,7 +97,7 @@ $ bun update
97
97
  $ bun update @types/bun --latest
98
98
 
99
99
  # Update a dependency to a specific version
100
- $ bun update @types/bun@1.2.19-canary.20250719T140529
100
+ $ bun update @types/bun@1.2.20-canary.20250720T140547
101
101
 
102
102
  # Update all dependencies to the latest versions
103
103
  $ bun update --latest
@@ -21,7 +21,7 @@ Here's what the output of a typical test run looks like. In this case, there are
21
21
 
22
22
  ```sh
23
23
  $ bun test
24
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
24
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
25
25
 
26
26
  test.test.js:
27
27
  ✓ add [0.87ms]
@@ -47,7 +47,7 @@ To only run certain test files, pass a positional argument to `bun test`. The ru
47
47
 
48
48
  ```sh
49
49
  $ bun test test3
50
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
50
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
51
51
 
52
52
  test3.test.js:
53
53
  ✓ add [1.40ms]
@@ -85,7 +85,7 @@ Adding `-t add` will only run tests with "add" in the name. This works with test
85
85
 
86
86
  ```sh
87
87
  $ bun test -t add
88
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
88
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
89
89
 
90
90
  test.test.js:
91
91
  ✓ add [1.79ms]
@@ -18,7 +18,7 @@ The first time this test is executed, Bun will evaluate the value passed into `e
18
18
 
19
19
  ```sh
20
20
  $ bun test test/snap
21
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
21
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
22
22
 
23
23
  test/snap.test.ts:
24
24
  ✓ snapshot [1.48ms]
@@ -61,7 +61,7 @@ Later, when this test file is executed again, Bun will read the snapshot file an
61
61
 
62
62
  ```sh
63
63
  $ bun test
64
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
64
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
65
65
 
66
66
  test/snap.test.ts:
67
67
  ✓ snapshot [1.05ms]
@@ -78,7 +78,7 @@ To update snapshots, use the `--update-snapshots` flag.
78
78
 
79
79
  ```sh
80
80
  $ bun test --update-snapshots
81
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
81
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
82
82
 
83
83
  test/snap.test.ts:
84
84
  ✓ snapshot [0.86ms]
@@ -29,7 +29,7 @@ To regenerate snapshots, use the `--update-snapshots` flag.
29
29
 
30
30
  ```sh
31
31
  $ bun test --update-snapshots
32
- bun test v1.2.19-canary.20250719T140529 (9c68abdb)
32
+ bun test v1.2.20-canary.20250720T140547 (9c68abdb)
33
33
 
34
34
  test/snap.test.ts:
35
35
  ✓ snapshot [0.86ms]
@@ -5,7 +5,7 @@ name: Get the current Bun version
5
5
  Get the current version of Bun in a semver format.
6
6
 
7
7
  ```ts#index.ts
8
- Bun.version; // => "1.2.19-canary.20250719T140529"
8
+ Bun.version; // => "1.2.20-canary.20250720T140547"
9
9
  ```
10
10
 
11
11
  ---
@@ -14,7 +14,7 @@ Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1. Us
14
14
  ```bash#macOS/Linux_(curl)
15
15
  $ curl -fsSL https://bun.com/install | bash # for macOS, Linux, and WSL
16
16
  # to install a specific version
17
- $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250719T140529"
17
+ $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.20-canary.20250720T140547"
18
18
  ```
19
19
 
20
20
  ```bash#npm
@@ -189,10 +189,10 @@ Since Bun is a single binary, you can install older versions of Bun by re-runnin
189
189
 
190
190
  ### Installing a specific version of Bun on Linux/Mac
191
191
 
192
- To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.19-canary.20250719T140529`.
192
+ To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.20-canary.20250720T140547`.
193
193
 
194
194
  ```sh
195
- $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250719T140529"
195
+ $ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.20-canary.20250720T140547"
196
196
  ```
197
197
 
198
198
  ### Installing a specific version of Bun on Windows
@@ -201,7 +201,7 @@ On Windows, you can install a specific version of Bun by passing the version num
201
201
 
202
202
  ```sh
203
203
  # PowerShell:
204
- $ iex "& {$(irm https://bun.com/install.ps1)} -Version 1.2.19-canary.20250719T140529"
204
+ $ iex "& {$(irm https://bun.com/install.ps1)} -Version 1.2.20-canary.20250720T140547"
205
205
  ```
206
206
 
207
207
  ## Downloading Bun binaries directly
@@ -124,11 +124,11 @@ await fetch("https://example.com", {
124
124
  This prints the `fetch` request as a single-line `curl` command to let you copy-paste into your terminal to replicate the request.
125
125
 
126
126
  ```sh
127
- [fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.19-canary.20250719T140529" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
127
+ [fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.20-canary.20250720T140547" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
128
128
  [fetch] > HTTP/1.1 POST https://example.com/
129
129
  [fetch] > content-type: application/json
130
130
  [fetch] > Connection: keep-alive
131
- [fetch] > User-Agent: Bun/1.2.19-canary.20250719T140529
131
+ [fetch] > User-Agent: Bun/1.2.20-canary.20250720T140547
132
132
  [fetch] > Accept: */*
133
133
  [fetch] > Host: example.com
134
134
  [fetch] > Accept-Encoding: gzip, deflate, br
@@ -170,7 +170,7 @@ This prints the following to the console:
170
170
  [fetch] > HTTP/1.1 POST https://example.com/
171
171
  [fetch] > content-type: application/json
172
172
  [fetch] > Connection: keep-alive
173
- [fetch] > User-Agent: Bun/1.2.19-canary.20250719T140529
173
+ [fetch] > User-Agent: Bun/1.2.20-canary.20250720T140547
174
174
  [fetch] > Accept: */*
175
175
  [fetch] > Host: example.com
176
176
  [fetch] > Accept-Encoding: gzip, deflate, br
package/docs/test/dom.md CHANGED
@@ -55,7 +55,7 @@ Let's run this test with `bun test`:
55
55
 
56
56
  ```bash
57
57
  $ bun test
58
- bun test v1.2.19-canary.20250719T140529
58
+ bun test v1.2.20-canary.20250720T140547
59
59
 
60
60
  dom.test.ts:
61
61
  ✓ dom test [0.82ms]
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.2.19-canary.20250719T140529",
2
+ "version": "1.2.20-canary.20250720T140547",
3
3
  "name": "bun-types",
4
4
  "license": "MIT",
5
5
  "types": "./index.d.ts",