Add multi-environment type generation documentation / changelog

src/content/changelog/workers/2026-01-13-wrangler-types-multi-environment.mdx

@@ -0,0 +1,27 @@
+---
+title: "`wrangler types` now generates types for all environments"
+description: The `wrangler types` command now aggregates bindings from all environments by default, ensuring complete type coverage across your deployment environments.
+products:
+  - workers
+date: 2026-01-13
+---
+
+The `wrangler types` command now generates TypeScript types for bindings from **all environments** defined in your Wrangler configuration file by default.
+
+Previously, `wrangler types` only generated types for bindings in the top-level configuration (or a single environment when using the `--env` flag). This meant that if you had environment-specific bindings — for example, a KV namespace only in production or an R2 bucket only in staging — those bindings would be missing from your generated types, causing TypeScript errors when accessing them.
+
+Now, running `wrangler types` collects bindings from all environments and includes them in the generated `Env` type. This ensures your types are complete regardless of which environment you deploy to.
+
+## Type conflict detection
+
+If the same binding name exists with different types across environments (for example, `CACHE` is a KV namespace in one environment but an R2 bucket in another), Wrangler will throw an error to prevent type conflicts.
+
+## Generating types for a specific environment
+
+If you want the previous behavior of generating types for only a specific environment, you can use the `--env` flag:
+
+```sh
+wrangler types --env production
+```
+
+Learn more about [generating types for your Worker](/workers/wrangler/commands/#types) in the Wrangler documentation.

src/content/docs/workers/wrangler/commands.mdx

@@ -498,7 +498,7 @@
 ✓ Select an account: › My account
 | Name                        | ID                                  | StoreID                             | Comment | Scopes  | Status  | Created                | Modified               |
 |-----------------------------|-------------------------------------|-------------------------------------|---------|---------|---------|------------------------|------------------------|
 | ServiceA_key-1          | 13bc7498c6374a4e9d13be091c3c65f1    | 8f7a1cdced6342c18d223ece462fd88d    |         | workers | active  | 4/9/2025, 10:06:01 PM  | 4/15/2025, 09:13:05 AM |
 ```
 
 <WranglerCommand command="secrets-store secret delete" headingLevel={3} />
@@ -552,7 +552,7 @@
 ┌─────────┬──────────────────────────────────┬──────────────────────────────────┬──────────────────────┬──────────────────────┐
 │ Name    │ ID                               │ AccountID                        │ Created              │ Modified             │
 ├─────────┼──────────────────────────────────┼──────────────────────────────────┼──────────────────────┼──────────────────────┤
 │ default │ 8876bad33f164462bf0743fe8adf98f4 │ REDACTED │ 4/9/2025, 1:11:48 PM  │ 4/9/2025, 1:11:48 PM │
 └─────────┴──────────────────────────────────┴──────────────────────────────────┴──────────────────────┴──────────────────────┘
 ```
 
@@ -820,7 +820,7 @@
 Success! Uploaded mTLS Certificate my-origin-cert
 ID: 99f5fef1-6cc1-46b8-bd79-44a0d5082b8d
 Issuer: CN=my-secured-origin.com,OU=my-team,O=my-org,L=San Francisco,ST=California,C=US
 Expires: 1/01/2025
 ```
 
 You can then add this certificate as a [binding](/workers/runtime-apis/bindings/) in your [Wrangler configuration file](/workers/wrangler/configuration/):
@@ -849,13 +849,13 @@
 ID: 99f5fef1-6cc1-46b8-bd79-44a0d5082b8d
 Name: my-origin-cert
 Issuer: CN=my-secured-origin.com,OU=my-team,O=my-org,L=San Francisco,ST=California,C=US
 Created on: 1/01/2023
 Expires: 1/01/2025
 
 ID: c5d004d1-8312-402c-b8ed-6194328d5cbe
 Issuer: CN=another-origin.com,OU=my-team,O=my-org,L=San Francisco,ST=California,C=US
 Created on: 1/01/2023
 Expires: 1/01/2025
 ```
 
 <WranglerCommand command="mtls-certificate delete" headingLevel={3} />
@@ -894,7 +894,7 @@
 Success! Uploaded mTLS Certificate my-origin-cert
 ID: 99f5fef1-6cc1-46b8-bd79-44a0d5082b8d
 Issuer: CN=my-secured-origin.com,OU=my-team,O=my-org,L=San Francisco,ST=California,C=US
 Expires: 1/01/2025
 ```
 
 Note that the certificate and private keys must be in separate (typically `.pem`) files when uploading.
@@ -968,9 +968,23 @@
 
 :::
 
+### Multi-environment support
+
+By default, `wrangler types` generates types for bindings from **all environments** defined in your configuration file. This ensures your generated `Env` type includes all bindings that might be used across different deployment environments (such as staging and production), preventing TypeScript errors when accessing environment-specific bindings.
+
+For example, if you have a KV namespace binding only in production and an R2 bucket binding only in staging, both will be included in the generated types.
+
+If the same binding name exists with different types across environments (for example, `CACHE` is a KV namespace in one environment but an R2 bucket in another), Wrangler will throw an error to prevent type conflicts.
+
+To generate types for only a specific environment, use the `--env` flag.
+
+### Options
+
 - `PATH` <Type text="string" /> <MetaInfo text="(default: `./worker-configuration.d.ts`)" />
   - The path to where types for your Worker will be written.
   - The path must have a `d.ts` extension.
+- `--env` <Type text="string" /> <MetaInfo text="optional" />
+  - Generate types for bindings in a specific environment only, rather than aggregating bindings from all environments.
 - `--env-interface` <Type text="string" /> <MetaInfo text="(default: `Env`)" />
   - The name of the interface to generate for the environment object.
   - Not valid if the Worker uses the Service Worker syntax.