npm - bun-types - Versions diffs - 1.3.3 → 1.3.4-canary.20251125T140733 - Mend

bun-types 1.3.3 → 1.3.4-canary.20251125T140733

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.

Files changed (220) hide show

package/CLAUDE.md +3 -3
package/docs/bundler/css.mdx +1 -1
package/docs/bundler/executables.mdx +33 -4
package/docs/bundler/fullstack.mdx +3 -3
package/docs/bundler/hot-reloading.mdx +2 -2
package/docs/bundler/html-static.mdx +10 -9
package/docs/bundler/index.mdx +27 -18
package/docs/bundler/loaders.mdx +2 -2
package/docs/bundler/macros.mdx +1 -1
package/docs/feedback.mdx +2 -12
package/docs/guides/binary/arraybuffer-to-array.mdx +1 -1
package/docs/guides/binary/arraybuffer-to-blob.mdx +1 -1
package/docs/guides/binary/arraybuffer-to-buffer.mdx +1 -1
package/docs/guides/binary/arraybuffer-to-string.mdx +1 -1
package/docs/guides/binary/arraybuffer-to-typedarray.mdx +1 -1
package/docs/guides/binary/blob-to-arraybuffer.mdx +1 -1
package/docs/guides/binary/blob-to-dataview.mdx +1 -1
package/docs/guides/binary/blob-to-stream.mdx +1 -1
package/docs/guides/binary/blob-to-string.mdx +1 -1
package/docs/guides/binary/blob-to-typedarray.mdx +1 -1
package/docs/guides/binary/buffer-to-arraybuffer.mdx +1 -1
package/docs/guides/binary/buffer-to-blob.mdx +1 -1
package/docs/guides/binary/buffer-to-readablestream.mdx +1 -1
package/docs/guides/binary/buffer-to-string.mdx +1 -1
package/docs/guides/binary/buffer-to-typedarray.mdx +1 -1
package/docs/guides/binary/dataview-to-string.mdx +1 -1
package/docs/guides/binary/typedarray-to-arraybuffer.mdx +1 -1
package/docs/guides/binary/typedarray-to-blob.mdx +1 -1
package/docs/guides/binary/typedarray-to-buffer.mdx +1 -1
package/docs/guides/binary/typedarray-to-dataview.mdx +1 -1
package/docs/guides/binary/typedarray-to-readablestream.mdx +1 -1
package/docs/guides/binary/typedarray-to-string.mdx +1 -1
package/docs/guides/deployment/aws-lambda.mdx +6 -6
package/docs/guides/deployment/digital-ocean.mdx +7 -7
package/docs/guides/deployment/vercel.mdx +1 -3
package/docs/guides/ecosystem/discordjs.mdx +2 -2
package/docs/guides/ecosystem/express.mdx +2 -2
package/docs/guides/ecosystem/mongoose.mdx +1 -1
package/docs/guides/ecosystem/neon-drizzle.mdx +2 -2
package/docs/guides/ecosystem/neon-serverless-postgres.mdx +2 -2
package/docs/guides/ecosystem/nuxt.mdx +1 -1
package/docs/guides/ecosystem/prisma-postgres.mdx +1 -1
package/docs/guides/ecosystem/prisma.mdx +1 -1
package/docs/guides/ecosystem/qwik.mdx +4 -4
package/docs/guides/ecosystem/sentry.mdx +2 -2
package/docs/guides/ecosystem/sveltekit.mdx +1 -1
package/docs/guides/ecosystem/tanstack-start.mdx +0 -1
package/docs/guides/ecosystem/upstash.mdx +2 -2
package/docs/guides/ecosystem/vite.mdx +2 -2
package/docs/guides/html-rewriter/extract-links.mdx +2 -2
package/docs/guides/html-rewriter/extract-social-meta.mdx +1 -1
package/docs/guides/http/file-uploads.mdx +1 -1
package/docs/guides/http/hot.mdx +1 -1
package/docs/guides/http/server.mdx +1 -1
package/docs/guides/http/simple.mdx +1 -1
package/docs/guides/http/stream-file.mdx +3 -3
package/docs/guides/http/tls.mdx +1 -1
package/docs/guides/install/add-dev.mdx +1 -1
package/docs/guides/install/add-git.mdx +1 -1
package/docs/guides/install/add-optional.mdx +1 -1
package/docs/guides/install/add-peer.mdx +3 -3
package/docs/guides/install/add-tarball.mdx +1 -1
package/docs/guides/install/add.mdx +1 -1
package/docs/guides/install/azure-artifacts.mdx +3 -3
package/docs/guides/install/custom-registry.mdx +2 -2
package/docs/guides/install/from-npm-install-to-bun-install.mdx +1 -1
package/docs/guides/install/git-diff-bun-lockfile.mdx +2 -1
package/docs/guides/install/npm-alias.mdx +1 -1
package/docs/guides/install/registry-scope.mdx +3 -3
package/docs/guides/install/trusted.mdx +1 -1
package/docs/guides/install/workspaces.mdx +1 -1
package/docs/guides/install/yarnlock.mdx +4 -3
package/docs/guides/process/ctrl-c.mdx +1 -1
package/docs/guides/process/ipc.mdx +2 -2
package/docs/guides/process/nanoseconds.mdx +1 -1
package/docs/guides/process/os-signals.mdx +1 -1
package/docs/guides/process/spawn-stderr.mdx +2 -2
package/docs/guides/process/spawn-stdout.mdx +2 -2
package/docs/guides/process/spawn.mdx +2 -2
package/docs/guides/process/stdin.mdx +1 -1
package/docs/guides/read-file/arraybuffer.mdx +2 -2
package/docs/guides/read-file/buffer.mdx +1 -1
package/docs/guides/read-file/exists.mdx +1 -1
package/docs/guides/read-file/mime.mdx +1 -1
package/docs/guides/read-file/stream.mdx +1 -1
package/docs/guides/read-file/uint8array.mdx +1 -1
package/docs/guides/read-file/watch.mdx +1 -1
package/docs/guides/runtime/build-time-constants.mdx +3 -3
package/docs/guides/runtime/cicd.mdx +1 -1
package/docs/guides/runtime/codesign-macos-executable.mdx +1 -1
package/docs/guides/runtime/delete-directory.mdx +1 -1
package/docs/guides/runtime/delete-file.mdx +1 -1
package/docs/guides/runtime/heap-snapshot.mdx +1 -1
package/docs/guides/runtime/import-json.mdx +1 -1
package/docs/guides/runtime/import-toml.mdx +1 -1
package/docs/guides/runtime/import-yaml.mdx +1 -1
package/docs/guides/runtime/read-env.mdx +1 -1
package/docs/guides/runtime/set-env.mdx +2 -2
package/docs/guides/runtime/shell.mdx +1 -1
package/docs/guides/runtime/tsconfig-paths.mdx +1 -1
package/docs/guides/runtime/typescript.mdx +1 -1
package/docs/guides/runtime/vscode-debugger.mdx +1 -2
package/docs/guides/runtime/web-debugger.mdx +1 -1
package/docs/guides/streams/to-array.mdx +1 -1
package/docs/guides/streams/to-arraybuffer.mdx +1 -1
package/docs/guides/streams/to-blob.mdx +1 -1
package/docs/guides/streams/to-buffer.mdx +1 -1
package/docs/guides/streams/to-json.mdx +1 -1
package/docs/guides/streams/to-string.mdx +1 -1
package/docs/guides/streams/to-typedarray.mdx +1 -1
package/docs/guides/test/bail.mdx +1 -1
package/docs/guides/test/concurrent-test-glob.mdx +5 -2
package/docs/guides/test/coverage-threshold.mdx +1 -1
package/docs/guides/test/coverage.mdx +1 -1
package/docs/guides/test/happy-dom.mdx +1 -1
package/docs/guides/test/migrate-from-jest.mdx +7 -7
package/docs/guides/test/mock-clock.mdx +2 -2
package/docs/guides/test/mock-functions.mdx +1 -1
package/docs/guides/test/rerun-each.mdx +1 -1
package/docs/guides/test/run-tests.mdx +2 -2
package/docs/guides/test/skip-tests.mdx +2 -2
package/docs/guides/test/snapshot.mdx +4 -4
package/docs/guides/test/spy-on.mdx +1 -1
package/docs/guides/test/svelte-test.mdx +4 -4
package/docs/guides/test/testing-library.mdx +3 -3
package/docs/guides/test/timeout.mdx +1 -1
package/docs/guides/test/todo-tests.mdx +2 -2
package/docs/guides/test/update-snapshots.mdx +1 -1
package/docs/guides/test/watch-mode.mdx +1 -1
package/docs/guides/util/base64.mdx +1 -1
package/docs/guides/util/deep-equals.mdx +3 -3
package/docs/guides/util/deflate.mdx +1 -1
package/docs/guides/util/entrypoint.mdx +2 -2
package/docs/guides/util/escape-html.mdx +1 -1
package/docs/guides/util/file-url-to-path.mdx +1 -1
package/docs/guides/util/gzip.mdx +1 -1
package/docs/guides/util/hash-a-password.mdx +1 -1
package/docs/guides/util/import-meta-dir.mdx +2 -2
package/docs/guides/util/import-meta-file.mdx +2 -2
package/docs/guides/util/import-meta-path.mdx +2 -2
package/docs/guides/util/javascript-uuid.mdx +2 -2
package/docs/guides/util/main.mdx +1 -1
package/docs/guides/util/path-to-file-url.mdx +1 -1
package/docs/guides/util/sleep.mdx +1 -1
package/docs/guides/util/version.mdx +2 -2
package/docs/guides/util/which-path-to-executable-bin.mdx +1 -1
package/docs/guides/websocket/context.mdx +1 -1
package/docs/guides/websocket/simple.mdx +1 -1
package/docs/guides/write-file/basic.mdx +2 -2
package/docs/guides/write-file/blob.mdx +2 -2
package/docs/guides/write-file/cat.mdx +2 -2
package/docs/guides/write-file/file-cp.mdx +2 -2
package/docs/guides/write-file/filesink.mdx +1 -1
package/docs/guides/write-file/response.mdx +2 -2
package/docs/guides/write-file/stdout.mdx +2 -2
package/docs/guides/write-file/stream.mdx +2 -2
package/docs/guides/write-file/unlink.mdx +1 -1
package/docs/index.mdx +2 -2
package/docs/installation.mdx +3 -3
package/docs/pm/bunx.mdx +2 -2
package/docs/pm/cli/install.mdx +8 -8
package/docs/pm/cli/link.mdx +2 -2
package/docs/pm/cli/outdated.mdx +3 -3
package/docs/pm/cli/patch.mdx +2 -2
package/docs/pm/cli/pm.mdx +1 -1
package/docs/pm/cli/publish.mdx +1 -1
package/docs/pm/filter.mdx +2 -2
package/docs/pm/isolated-installs.mdx +3 -3
package/docs/pm/npmrc.mdx +6 -6
package/docs/pm/scopes-registries.mdx +1 -1
package/docs/pm/security-scanner-api.mdx +2 -2
package/docs/pm/workspaces.mdx +3 -4
package/docs/project/benchmarking.mdx +1 -1
package/docs/project/building-windows.mdx +1 -1
package/docs/project/contributing.mdx +1 -1
package/docs/project/license.mdx +1 -1
package/docs/quickstart.mdx +3 -3
package/docs/runtime/auto-install.mdx +1 -1
package/docs/runtime/binary-data.mdx +1 -1
package/docs/runtime/bun-apis.mdx +35 -35
package/docs/runtime/bunfig.mdx +29 -3
package/docs/runtime/c-compiler.mdx +3 -3
package/docs/runtime/child-process.mdx +2 -2
package/docs/runtime/cookies.mdx +19 -19
package/docs/runtime/debugger.mdx +4 -4
package/docs/runtime/environment-variables.mdx +24 -7
package/docs/runtime/ffi.mdx +2 -2
package/docs/runtime/file-io.mdx +2 -2
package/docs/runtime/file-types.mdx +5 -5
package/docs/runtime/globals.mdx +4 -4
package/docs/runtime/http/error-handling.mdx +2 -2
package/docs/runtime/http/routing.mdx +1 -1
package/docs/runtime/http/server.mdx +5 -9
package/docs/runtime/http/websockets.mdx +1 -1
package/docs/runtime/index.mdx +2 -2
package/docs/runtime/jsx.mdx +1 -1
package/docs/runtime/module-resolution.mdx +2 -2
package/docs/runtime/networking/fetch.mdx +4 -4
package/docs/runtime/nodejs-compat.mdx +3 -3
package/docs/runtime/plugins.mdx +1 -1
package/docs/runtime/s3.mdx +4 -4
package/docs/runtime/secrets.mdx +10 -7
package/docs/runtime/sql.mdx +10 -10
package/docs/runtime/sqlite.mdx +15 -4
package/docs/runtime/templating/create.mdx +4 -4
package/docs/runtime/transpiler.mdx +1 -1
package/docs/runtime/utils.mdx +3 -3
package/docs/runtime/watch-mode.mdx +1 -1
package/docs/runtime/workers.mdx +5 -17
package/docs/snippets/cli/publish.mdx +2 -2
package/docs/test/configuration.mdx +1 -1
package/docs/test/dom.mdx +1 -1
package/docs/test/index.mdx +8 -8
package/docs/test/reporters.mdx +1 -1
package/docs/test/snapshots.mdx +3 -3
package/docs/test/writing-tests.mdx +37 -0
package/docs/typescript.mdx +2 -2
package/package.json +3 -4
package/docs/snippets/product-card.mdx +0 -32
package/docs/snippets/product-tiles.mdx +0 -94

package/CLAUDE.md CHANGED Viewed

@@ -5,6 +5,7 @@ Default to using Bun instead of Node.js.
 - Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
 - Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
 - Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
+- Use `bunx <package> <command>` instead of `npx <package> <command>`
 - Bun automatically loads .env, so don't use dotenv.
 ## APIs
@@ -81,12 +82,11 @@ With the following `frontend.tsx`:
 ```tsx#frontend.tsx
 import React from "react";
+import { createRoot } from "react-dom/client";
 // import .css files directly and it works
 import './index.css';
-import { createRoot } from "react-dom/client";
 const root = createRoot(document.body);
 export default function Frontend() {
@@ -102,4 +102,4 @@ Then, run index.ts
 bun --hot ./index.ts
 ```
-For more information, read the Bun API docs in `docs/**.md`.
+For more information, read the Bun API docs in `docs/**.mdx`.

package/docs/bundler/css.mdx CHANGED Viewed

@@ -72,7 +72,7 @@ Bun's CSS bundler automatically converts this nested syntax into traditional fla
 You can also nest media queries and other at-rules inside selectors, eliminating the need to repeat selector patterns:
-```css title="styles.css" icon="file-code"
+```scss title="styles.css" icon="file-code"
 .responsive-element {
   display: block;

package/docs/bundler/executables.mdx CHANGED Viewed

@@ -118,7 +118,7 @@ These constants are embedded directly into your compiled binary at build time, p
 <Note>
   For comprehensive examples and advanced patterns, see the [Build-time constants
-  guide](https://bun.com/guides/runtime/build-time-constants).
+  guide](/docs/guides/runtime/build-time-constants).
 </Note>
 ---
@@ -183,6 +183,35 @@ console.log(process.execArgv); // ["--smol", "--user-agent=MyBot"]
 ---
+## Disabling automatic config loading
+By default, standalone executables look for `.env` and `bunfig.toml` files in the directory where the executable is run. You can disable this behavior at build time for deterministic execution regardless of the user's working directory.
+```bash icon="terminal" terminal
+# Disable .env loading
+bun build --compile --no-compile-autoload-dotenv ./app.ts --outfile myapp
+# Disable bunfig.toml loading
+bun build --compile --no-compile-autoload-bunfig ./app.ts --outfile myapp
+# Disable both
+bun build --compile --no-compile-autoload-dotenv --no-compile-autoload-bunfig ./app.ts --outfile myapp
+```
+You can also configure this via the JavaScript API:
+```ts
+await Bun.build({
+  entrypoints: ["./app.ts"],
+  compile: {
+    autoloadDotenv: false, // Disable .env loading
+    autoloadBunfig: false, // Disable bunfig.toml loading
+  },
+});
+```
+---
 ## Act as the Bun CLI
 <Note>New in Bun v1.2.16</Note>
@@ -259,12 +288,12 @@ console.log(`Server running at http://localhost:${server.port}`);
   </head>
   <body>
     <h1>Hello World</h1>
-    <script src="./app.js"></script>
+    <script src="./app.ts"></script>
   </body>
 </html>
 ```
-```ts app.js icon="file-code"
+```ts app.ts icon="file-code"
 console.log("Hello from the client!");
 ```
@@ -297,7 +326,7 @@ The result is a single file that can be deployed anywhere without needing Node.j
 Bun automatically handles serving the frontend assets with proper MIME types and cache headers. The HTML import is replaced with a manifest object that `Bun.serve` uses to efficiently serve pre-bundled assets.
-For more details on building full-stack applications with Bun, see the [full-stack guide](/bundler/fullstack).
+For more details on building full-stack applications with Bun, see the [full-stack guide](/docs/bundler/fullstack).
 ---

package/docs/bundler/fullstack.mdx CHANGED Viewed

@@ -632,7 +632,7 @@ const server = serve({
 console.log(`🚀 Server running on ${server.url}`);
 ```
-```html title="public/index.html"
+```html title="public/index.html" icon="file-code"
 <!DOCTYPE html>
 <html>
   <head>
@@ -757,7 +757,7 @@ export function App() {
 }
 ```
-```css title="src/styles.css"
+```css title="src/styles.css" icon="file-code"
 * {
   margin: 0;
   padding: 0;
@@ -999,7 +999,7 @@ CMD ["bun", "index.js"]
 ### Environment Variables
-```bash title=".env.production" icon="file-code"
+```ini title=".env.production" icon="file-code"
 NODE_ENV=production
 PORT=3000
 DATABASE_URL=postgresql://user:pass@localhost:5432/myapp

package/docs/bundler/hot-reloading.mdx CHANGED Viewed

@@ -9,7 +9,7 @@ Hot Module Replacement (HMR) allows you to update modules in a running applicati
 ## `import.meta.hot` API Reference
-Bun implements a client-side HMR API modeled after [Vite's `import.meta.hot` API](https://vitejs.dev/guide/api-hmr.html). It can be checked for with `if (import.meta.hot)`, tree-shaking it in production.
+Bun implements a client-side HMR API modeled after [Vite's `import.meta.hot` API](https://vite.dev/guide/api-hmr). It can be checked for with `if (import.meta.hot)`, tree-shaking it in production.
 ```ts title="index.ts" icon="/icons/typescript.svg"
 if (import.meta.hot) {
@@ -144,7 +144,7 @@ Indicates that multiple dependencies' modules can be accepted. This variant acce
 `import.meta.hot.data` maintains state between module instances during hot replacement, enabling data transfer from previous to new versions. When `import.meta.hot.data` is written into, Bun will also mark this module as capable of self-accepting (equivalent of calling `import.meta.hot.accept()`).
-```jsx title="index.ts" icon="/icons/typescript.svg"
+```tsx title="index.tsx" icon="/icons/typescript.svg"
 import { createRoot } from "react-dom/client";
 import { App } from "./app";

package/docs/bundler/html-static.mdx CHANGED Viewed

@@ -25,7 +25,7 @@ bun ./index.html
 ```
 ```
-Bun v1.3.2
+Bun v1.3.3
 ready in 6.62ms
 → http://localhost:3000/
 Press h + Enter to show shortcuts
@@ -51,7 +51,7 @@ bun index.html
 ```
 ```
-Bun v1.3.2
+Bun v1.3.3
 ready in 6.62ms
 → http://localhost:3000/
 Press h + Enter to show shortcuts
@@ -81,7 +81,7 @@ bun ./index.html ./about.html
 ```
 ```txt
-Bun v1.3.2
+Bun v1.3.3
 ready in 6.62ms
 → http://localhost:3000/
 Routes:
@@ -104,7 +104,7 @@ bun ./**/*.html
 ```
 ```
-Bun v1.3.2
+Bun v1.3.3
 ready in 6.62ms
 → http://localhost:3000/
 Routes:
@@ -122,7 +122,7 @@ bun ./index.html ./about/index.html ./about/foo/index.html
 ```
 ```
-Bun v1.3.2
+Bun v1.3.3
 ready in 6.62ms
 → http://localhost:3000/
 Routes:
@@ -164,7 +164,7 @@ For example:
 }
 ```
-```css abc.css
+```css abc.css icon="file-code"
 body {
   background-color: red;
 }
@@ -174,7 +174,7 @@ body {
 This outputs:
-```css
+```css styles.css icon="file-code"
 body {
   background-color: red;
 }
@@ -273,7 +273,7 @@ bun ./index.html --console
 ```
 ```
-Bun v1.3.2
+Bun v1.3.3
 ready in 6.62ms
 → http://localhost:3000/
 Press h + Enter to show shortcuts
@@ -385,7 +385,8 @@ All paths are resolved relative to your HTML file, making it easy to organize yo
 - Need more configuration options for things like asset handling
 - Need a way to configure CORS, headers, etc.
-If you want to submit a PR, most of the code is [here](https://github.com/oven-sh/bun/blob/main/src/bun.js/api/bun/html-rewriter.ts). You could even copy paste that file into your project and use it as a starting point.
+{/* todo: find the correct link to link to as this 404's and there isn't any similar files */}
+{/* If you want to submit a PR, most of the code is [here](https://github.com/oven-sh/bun/blob/main/src/bun.js/api/bun/html-rewriter.ts). You could even copy paste that file into your project and use it as a starting point. */}
 </Warning>

package/docs/bundler/index.mdx CHANGED Viewed

@@ -106,7 +106,7 @@ For each file specified in `entrypoints`, Bun will generate a new bundle. This b
 The contents of `out/index.js` will look something like this:
-```ts title="out/index.js" icon="/icons/javascript.svg"
+```js title="out/index.js" icon="/icons/javascript.svg"
 // out/index.js
 // ...
 // ~20k lines of code
@@ -154,7 +154,7 @@ bun build ./index.tsx --outdir ./out --watch
 ## Content types
-Like the Bun runtime, the bundler supports an array of file types out of the box. The following table breaks down the bundler's set of standard "loaders". Refer to [Bundler > File types](/bundler/loaders) for full documentation.
+Like the Bun runtime, the bundler supports an array of file types out of the box. The following table breaks down the bundler's set of standard "loaders". Refer to [Bundler > File types](/docs/bundler/loaders) for full documentation.
 | Extensions                                            | Details                                                                                                                                                                                                                                                                                                                                                      |
 | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -190,11 +190,11 @@ console.log(logo);
 The exact behavior of the file loader is also impacted by [`naming`](#naming) and [`publicPath`](#publicpath).
-<Info>Refer to the [Bundler > Loaders](/bundler/loaders) page for more complete documentation on the file loader.</Info>
+<Info>Refer to the [Bundler > Loaders](/docs/bundler/loaders) page for more complete documentation on the file loader.</Info>
 ### Plugins
-The behavior described in this table can be overridden or extended with plugins. Refer to the [Bundler > Loaders](/bundler/loaders) page for complete documentation.
+The behavior described in this table can be overridden or extended with plugins. Refer to the [Bundler > Loaders](/docs/bundler/loaders) page for complete documentation.
 ## API
@@ -498,7 +498,7 @@ await Bun.build({
 });
 ```
-Bun implements a universal plugin system for both Bun's runtime and bundler. Refer to the [plugin documentation](/bundler/plugins) for complete documentation.
+Bun implements a universal plugin system for both Bun's runtime and bundler. Refer to the [plugin documentation](/docs/bundler/plugins) for complete documentation.
 ### env
@@ -527,7 +527,7 @@ Injects environment variables into the bundled output by converting `process.env
 For the input below:
-```ts title="input.js" icon="/icons/javascript.svg"
+```js title="input.js" icon="/icons/javascript.svg"
 // input.js
 console.log(process.env.FOO);
 console.log(process.env.BAZ);
@@ -535,7 +535,7 @@ console.log(process.env.BAZ);
 The generated bundle will contain the following code:
-```ts title="output.js" icon="/icons/javascript.svg"
+```js title="output.js" icon="/icons/javascript.svg"
 // output.js
 console.log("bar");
 console.log("123");
@@ -580,7 +580,7 @@ console.log(process.env.BAZ);
 The generated bundle will contain the following code:
-```ts title="output.js" icon="/icons/javascript.svg"
+```js title="output.js" icon="/icons/javascript.svg"
 console.log(process.env.FOO);
 console.log("https://acme.com");
 console.log(process.env.BAZ);
@@ -722,7 +722,7 @@ Normally, bundling `index.tsx` would generate a bundle containing the entire sou
 The generated bundle will look something like this:
-```ts title="out/index.js" icon="/icons/javascript.svg"
+```js title="out/index.js" icon="/icons/javascript.svg"
 import { z } from "zod";
 // ...
@@ -1026,7 +1026,7 @@ Setting `publicPath` will prefix all file paths with the specified value.
 The output file would now look something like this.
-```ts title="out/index.js" icon="/icons/javascript.svg"
+```js title="out/index.js" icon="/icons/javascript.svg"
 var logo = "https://cdn.example.com/logo-a7305bdef.svg";
 ```
@@ -1181,7 +1181,7 @@ Each artifact also contains the following properties:
 | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `kind`      | What kind of build output this file is. A build generates bundled entrypoints, code-split "chunks", sourcemaps, bytecode, and copied assets (like images).   |
 | `path`      | Absolute path to the file on disk                                                                                                                            |
-| `loader`    | The loader was used to interpret the file. See [Bundler > Loaders](/bundler/loaders) to see how Bun maps file extensions to the appropriate built-in loader. |
+| `loader`    | The loader was used to interpret the file. See [Bundler > Loaders](/docs/bundler/loaders) to see how Bun maps file extensions to the appropriate built-in loader. |
 | `hash`      | The hash of the file contents. Always defined for assets.                                                                                                    |
 | `sourcemap` | The sourcemap file corresponding to this file, if generated. Only defined for entrypoints and chunks.                                                        |
@@ -1268,7 +1268,7 @@ bun build ./cli.tsx --outfile mycli --compile
 ./mycli
 ```
-Refer to [Bundler > Executables](/bundler/executables) for complete documentation.
+Refer to [Bundler > Executables](/docs/bundler/executables) for complete documentation.
 ## Logs and errors
@@ -1356,10 +1356,12 @@ interface BuildConfig {
    * JSX configuration object for controlling JSX transform behavior
    */
   jsx?: {
+    runtime?: "automatic" | "classic";
+    importSource?: string;
     factory?: string;
     fragment?: string;
-    importSource?: string;
-    runtime?: "automatic" | "classic";
+    sideEffects?: boolean;
+    development?: boolean;
   };
   naming?:
     | string
@@ -1443,13 +1445,20 @@ interface BuildConfig {
   drop?: string[];
   /**
-   * When set to `true`, the returned promise rejects with an AggregateError when a build failure happens.
-   * When set to `false`, the `success` property of the returned object will be `false` when a build failure happens.
+   * - When set to `true`, the returned promise rejects with an AggregateError when a build failure happens.
+   * - When set to `false`, returns a {@link BuildOutput} with `{success: false}`
    *
-   * This defaults to `false` in Bun 1.1 and will change to `true` in Bun 1.2
-   * as most usage of `Bun.build` forgets to check for errors.
+   * @default true
    */
   throw?: boolean;
+  /**
+   * Custom tsconfig.json file path to use for path resolution.
+   * Equivalent to `--tsconfig-override` in the CLI.
+   */
+  tsconfig?: string;
+  outdir?: string;
 }
 interface BuildOutput {

package/docs/bundler/loaders.mdx CHANGED Viewed

@@ -312,7 +312,7 @@ The `html` loader processes HTML files and bundles any referenced assets. It wil
 For example, given this HTML file:
-```html title="src/index.html"
+```html title="src/index.html" icon="file-code"
 <!DOCTYPE html>
 <html>
   <body>
@@ -325,7 +325,7 @@ For example, given this HTML file:
 It will output a new HTML file with the bundled assets:
-```html title="dist/index.html"
+```html title="dist/index.html" icon="file-code"
 <!DOCTYPE html>
 <html>
   <body>

package/docs/bundler/macros.mdx CHANGED Viewed

@@ -87,7 +87,7 @@ macro();
 When shipping a library containing a macro to npm or another package registry, use the `"macro"` export condition to provide a special version of your package exclusively for the macro environment.
-```json title="package.json" icon="file-code"
+```json title="package.json" icon="file-json"
 {
   "name": "my-package",
   "exports": {

package/docs/feedback.mdx CHANGED Viewed

@@ -4,13 +4,9 @@ description: Share feedback, bug reports, and feature requests
 mode: center
 ---
-import Feedback from "/snippets/cli/feedback.mdx";
 Whether you've found a bug, have a performance issue, or just want to suggest an improvement, here's how you can open a helpful issue:
-<Callout icon="discord">
-  For general questions, please join our [Discord](https://discord.com/invite/CXdq2DP29u).
-</Callout>
+<Callout icon="discord">For general questions, please join our [Discord](https://bun.com/discord).</Callout>
 ## Reporting Issues
@@ -56,9 +52,7 @@ Whether you've found a bug, have a performance issue, or just want to suggest an
     		<Note>
     			- For MacOS and Linux: copy the output of `uname -mprs`
     		  - For Windows: copy the output of this command in the powershell console:
-    				```powershell
-    					"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"
-    				```
+    				`"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"`
     		</Note>
     </Step>
@@ -79,7 +73,3 @@ echo "please document X" | bun feedback --email you@example.com
 ```
 You can provide feedback as text arguments, file paths, or piped input.
----
-<Feedback />

package/docs/guides/binary/arraybuffer-to-array.mdx CHANGED Viewed

@@ -26,4 +26,4 @@ const regularArr = Array.from(uintArr);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/arraybuffer-to-blob.mdx CHANGED Viewed

@@ -23,4 +23,4 @@ blob.type; // => "application/octet-stream"
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/arraybuffer-to-buffer.mdx CHANGED Viewed

@@ -24,4 +24,4 @@ const nodeBuffer = Buffer.from(arrBuffer, 0, 16); // view first 16 bytes
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/arraybuffer-to-string.mdx CHANGED Viewed

@@ -14,4 +14,4 @@ const str = decoder.decode(buf);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/arraybuffer-to-typedarray.mdx CHANGED Viewed

@@ -38,4 +38,4 @@ const arr = new Uint8Array(buffer, 0, 16); // view first 16 bytes
 ---
-See [Docs > API > Utils](https://bun.com/docs/api/utils) for more useful utilities.
+See [Docs > API > Utils](/docs/runtime/utils) for more useful utilities.

package/docs/guides/binary/blob-to-arraybuffer.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const buf = await blob.arrayBuffer();
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/blob-to-dataview.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const arr = new DataView(await blob.arrayBuffer());
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/blob-to-stream.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const stream = await blob.stream();
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/blob-to-string.mdx CHANGED Viewed

@@ -14,4 +14,4 @@ const str = await blob.text();
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/blob-to-typedarray.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const arr = new Uint8Array(await blob.arrayBuffer());
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/buffer-to-arraybuffer.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const arrBuf = nodeBuf.buffer;
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/buffer-to-blob.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const blob = new Blob([buf]);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/buffer-to-readablestream.mdx CHANGED Viewed

@@ -40,4 +40,4 @@ const stream = blob.stream(1024);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/buffer-to-string.mdx CHANGED Viewed

@@ -24,4 +24,4 @@ const str = buf.toString("utf8", 0, 5);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/buffer-to-typedarray.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ buf instanceof Uint8Array; // => true
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/dataview-to-string.mdx CHANGED Viewed

@@ -14,4 +14,4 @@ const str = decoder.decode(dv);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/typedarray-to-arraybuffer.mdx CHANGED Viewed

@@ -24,4 +24,4 @@ arr.byteLength; // => 32
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/typedarray-to-blob.mdx CHANGED Viewed

@@ -15,4 +15,4 @@ console.log(await blob.text());
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/typedarray-to-buffer.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const buf = Buffer.from(arr);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/typedarray-to-dataview.mdx CHANGED Viewed

@@ -13,4 +13,4 @@ const dv = new DataView(arr.buffer, arr.byteOffset, arr.byteLength);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/typedarray-to-readablestream.mdx CHANGED Viewed

@@ -40,4 +40,4 @@ const stream = blob.stream(1024);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.

package/docs/guides/binary/typedarray-to-string.mdx CHANGED Viewed

@@ -15,4 +15,4 @@ const str = decoder.decode(arr);
 ---
-See [Docs > API > Binary Data](https://bun.com/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun.
+See [Docs > API > Binary Data](/docs/runtime/binary-data#conversion) for complete documentation on manipulating binary data with Bun.