use declare global instead of ambient declarations - 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

@@ -141,12 +141,16 @@ If you're using TypeScript and need to customize the shape of errors, you can do
 
 ```ts
 /// 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/adapter-static/test/apps/spa/src/app.d.ts

@@ -1,3 +1,5 @@
-/// <reference types="@sveltejs/kit" />
+declare global {
+	namespace App {}
+}
 
-declare namespace App {}
+export {};

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 {};

packages/kit/test/apps/options/source/app.d.ts

@@ -1,7 +1,9 @@
-/// <reference types="@sveltejs/kit" />
+declare global {
+	namespace App {
+		interface Locals {}
 
-declare namespace App {
-	interface Locals {}
-
-	interface Platform {}
+		interface Platform {}
+	}
 }
+
+export {};

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

@@ -1,7 +1,9 @@
-/// <reference types="@sveltejs/kit" />
+declare global {
+	namespace App {
+		interface Locals {}
 
-declare namespace App {
-	interface Locals {}
-
-	interface Platform {}
+		interface Platform {}
+	}
 }
+
+export {};