chore: use declare global instead of ambient declarations (#8589)

closes #8587

documentation/docs/25-build-and-deploy/60-adapter-cloudflare.md

@@ -59,14 +59,18 @@ To make these types available to your app, reference them in your `src/app.d.ts`
 
 ```diff
 /// file: src/app.d.ts
-declare namespace App {
-	interface Platform {
-+		env?: {
-+			YOUR_KV_NAMESPACE: KVNamespace;
-+			YOUR_DURABLE_OBJECT_NAMESPACE: DurableObjectNamespace;
-+		};
+declare global {
+	namespace App {
+		interface Platform {
++			env?: {
++				YOUR_KV_NAMESPACE: KVNamespace;
++				YOUR_DURABLE_OBJECT_NAMESPACE: DurableObjectNamespace;
++			};
+		}
 	}
 }
+
+export {};
 ```
 
 > `platform.env` is only available in the production build. Use [wrangler](https://developers.cloudflare.com/workers/cli-wrangler) to test it locally

documentation/docs/25-build-and-deploy/70-adapter-cloudflare-workers.md

@@ -94,14 +94,18 @@ To make these types available to your app, reference them in your `src/app.d.ts`
 
 ```diff
 /// file: src/app.d.ts
-declare namespace App {
-	interface Platform {
-+		env?: {
-+			YOUR_KV_NAMESPACE: KVNamespace;
-+			YOUR_DURABLE_OBJECT_NAMESPACE: DurableObjectNamespace;
-+		};
+declare global {
+	namespace App {
+		interface Platform {
++			env?: {
++				YOUR_KV_NAMESPACE: KVNamespace;
++				YOUR_DURABLE_OBJECT_NAMESPACE: DurableObjectNamespace;
++			};
+		}
 	}
 }
+
+export {};
 ```
 
 > `platform.env` is only available in the production build. Use [wrangler](https://developers.cloudflare.com/workers/cli-wrangler) to test it locally

documentation/docs/30-advanced/20-hooks.md

@@ -148,12 +148,16 @@ The following code shows an example of typing the error shape as `{ message: str
 
 ```ts
 /// file: src/app.d.ts
-declare namespace App {
-	interface Error {
-		message: string;
-		errorId: string;
+declare global {
+	namespace App {
+		interface Error {
+			message: string;
+			errorId: string;
+		}
 	}
 }
+
+export {};
 ```
 
 ```js

documentation/docs/30-advanced/25-errors.md

@@ -139,14 +139,18 @@ The exception is when the error occurs inside the root `+layout.js` or `+layout.
 
 If you're using TypeScript and need to customize the shape of errors, you can do so by declaring an `App.Error` interface in your app (by convention, in `src/app.d.ts`, though it can live anywhere that TypeScript can 'see'):
 
-```ts
+```diff
 /// file: src/app.d.ts
-declare namespace App {
-	interface Error {
-		code: string;
-		id: string;
+declare global {
+	namespace App {
+		interface Error {
++			code: string;
++			id: string;
+		}
 	}
 }
+
+export {};
 ```
 
 This interface always includes a `message: string` property.

packages/kit/test/apps/basics/src/app.d.ts

@@ -1,10 +1,14 @@
-declare namespace App {
-	interface Locals {
-		answer: number;
-		name?: string;
-		key: string;
-		params: Record<string, string>;
-	}
+declare global {
+	namespace App {
+		interface Locals {
+			answer: number;
+			name?: string;
+			key: string;
+			params: Record<string, string>;
+		}
 
-	interface Platform {}
+		interface Platform {}
+	}
 }
+
+export {};