Rich-Harris · Jul 17, 2026 · Jul 17, 2026 · Jul 17, 2026 · Jul 17, 2026 · Jul 17, 2026
diff --git a/.changeset/lazy-glasses-love.md b/.changeset/lazy-glasses-love.md
@@ -0,0 +1,5 @@
+---
+'@sveltejs/kit': major
+---
+
+breaking: move `defineEnvVars` to `@sveltejs/kit/env`
diff --git a/packages/adapter-node/test/apps/basic/src/env.js b/packages/adapter-node/test/apps/basic/src/env.js
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	MY_CUSTOM_PORT: {}

diff --git a/packages/adapter-static/test/apps/prerendered/src/env.ts b/packages/adapter-static/test/apps/prerendered/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	PUBLIC_ANSWER: {

diff --git a/packages/adapter-static/test/apps/spa/src/env.ts b/packages/adapter-static/test/apps/spa/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	PUBLIC_VALUE: {

diff --git a/packages/kit/package.json b/packages/kit/package.json
@@ -34,7 +34,7 @@
 		"@sveltejs/vite-plugin-svelte": "catalog:",
 		"@types/connect": "catalog:",
 		"@types/node": "catalog:",
-		"dts-buddy": "^0.8.2",
+		"dts-buddy": "^0.8.3",
 		"jsdom": "catalog:",
 		"rolldown": "catalog:",
 		"svelte": "catalog:",

diff --git a/packages/kit/src/exports/hooks/index.js b/packages/kit/src/exports/hooks/index.js
@@ -1,16 +1,8 @@
-/** @import { EnvVarConfig } from '@sveltejs/kit' */
-
 export { sequence } from './sequence.js';
 
 /**
- * Utility for defining [environment variables](https://svelte.dev/docs/kit/environment-variables),
- * which are made available via `$app/env/public` and `$app/env/private`.
- * @template {Record<string, EnvVarConfig<any>>} T
- * @param {T} variables
- * @returns {T}
- * @deprecated Import `defineEnvVars` from `@sveltejs/kit/env` instead
+ * @internal
  */
-export function defineEnvVars(variables) {
-	console.warn(`\`defineEnvVars\` has moved — import it from \`@sveltejs/kit/env\` instead`);
-	return variables;
+export function defineEnvVars() {
+	throw new Error(`\`defineEnvVars\` has moved — import it from \`@sveltejs/kit/env\` instead`);
 }
diff --git a/packages/kit/test/apps/async/src/env.ts b/packages/kit/test/apps/async/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	PRIVATE_STATIC: {

diff --git a/packages/kit/test/apps/basics/src/env.ts b/packages/kit/test/apps/basics/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	PRIVATE_STATIC: {

diff --git a/packages/kit/test/apps/dev-only/src/env.ts b/packages/kit/test/apps/dev-only/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	SHOULD_EXPLODE: {}

diff --git a/packages/kit/test/apps/options/source/env.ts b/packages/kit/test/apps/options/source/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	GO_AWAY_PLEASE: {

diff --git a/packages/kit/test/build-errors/apps/env-private-dynamic/src/env.ts b/packages/kit/test/build-errors/apps/env-private-dynamic/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	SHOULD_EXPLODE: {}

diff --git a/packages/kit/test/build-errors/apps/env-private-service-worker/src/env.ts b/packages/kit/test/build-errors/apps/env-private-service-worker/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	SHOULD_EXPLODE: {}

diff --git a/packages/kit/test/build-errors/apps/env-private/src/env.ts b/packages/kit/test/build-errors/apps/env-private/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	SHOULD_EXPLODE: {}

diff --git a/packages/kit/test/prerendering/basics/src/env.ts b/packages/kit/test/prerendering/basics/src/env.ts
@@ -1,4 +1,4 @@
-import { defineEnvVars } from '@sveltejs/kit/hooks';
+import { defineEnvVars } from '@sveltejs/kit/env';
 
 export const variables = defineEnvVars({
 	PUBLIC_STATIC: {

diff --git a/packages/kit/types/index.d.ts b/packages/kit/types/index.d.ts
@@ -2872,13 +2872,7 @@ declare module '@sveltejs/kit/env' {
 }
 
 declare module '@sveltejs/kit/hooks' {
-	import type { EnvVarConfig, Handle } from '@sveltejs/kit';
-	/**
-	 * Utility for defining [environment variables](https://svelte.dev/docs/kit/environment-variables),
-	 * which are made available via `$app/env/public` and `$app/env/private`.
-	 * @deprecated Import `defineEnvVars` from `@sveltejs/kit/env` instead
-	 */
-	export function defineEnvVars<T extends Record<string, EnvVarConfig<any>>>(variables: T): T;
+	import type { Handle } from '@sveltejs/kit';
 	/**
 	 * A helper function for sequencing multiple `handle` calls in a middleware-like manner.
 	 * The behavior for the `handle` options is as follows:

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml