bun-types-no-globals 1.2.21-canary.20250823T140535 → 1.2.21-canary.20250825T140701

package/README.md

@@ -42,6 +42,21 @@ export function createPlugin(): BunPlugin | WebpackPlugin | VitePlugin {
 }
 ```
 
+### 🛠️ [Re-\]declaring the Bun namespace
+
+Sometimes you'll still want the Bun namespace to globally exist - this is most helpful in situations where actually including a runtime import from `bun` is more inconvenient than using the Bun namespace itself. You can tell TypeScript about the namespace by including this code somewhere in your program:
+
+```ts
+// File could be called `bun.ns.d.ts` for example
+import * as BunModule from 'bun';
+
+declare global {
+	export import Bun = BunModule;
+}
+```
+
+I wrote a little about the above syntax [on my blog about Ambient Declarations](https://alistair.sh/ambient-declarations).
+
 ## Usage
 
 We recommend you require these types with a triple slash reference anywhere in your program

package/lib/bun.d.ts

@@ -1628,7 +1628,7 @@ declare module "bun" {
     kind: ImportKind;
   }
 
-  namespace _BunBuildInterface {
+  namespace Build {
     type Architecture = "x64" | "arm64";
     type Libc = "glibc" | "musl";
     type SIMD = "baseline" | "modern";
@@ -1641,6 +1641,7 @@ declare module "bun" {
       | `bun-windows-x64-${SIMD}`
       | `bun-linux-x64-${SIMD}-${Libc}`;
   }
+
   /**
    * @see [Bun.build API docs](https://bun.com/docs/bundler#api)
    */
@@ -1836,7 +1837,7 @@ declare module "bun" {
   }
 
   interface CompileBuildOptions {
-    target?: _BunBuildInterface.Target;
+    target?: Bun.Build.Target;
     execArgv?: string[];
     executablePath?: string;
     outfile?: string;
@@ -1878,7 +1879,7 @@ declare module "bun" {
      * });
      * ```
      */
-    compile: boolean | _BunBuildInterface.Target | CompileBuildOptions;
+    compile: boolean | Bun.Build.Target | CompileBuildOptions;
   }
 
   /**

package/lib/shell.d.ts

@@ -211,7 +211,7 @@ declare module "bun" {
      * try {
      *   const result = await $`exit 1`;
      * } catch (error) {
-     *   if (error instanceof ShellError) {
+     *   if (error instanceof $.ShellError) {
      *     console.log(error.exitCode); // 1
      *   }
      * }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bun-types-no-globals",
-	"version": "1.2.21-canary.20250823T140535",
+	"version": "1.2.21-canary.20250825T140701",
 	"main": "./generator/index.ts",
 	"types": "./lib/index.d.ts",
 	"description": "TypeScript type definitions for Bun without global types pollution",