breaking: delete `$service-worker` module by Rich-Harris · Pull Request #16450 · sveltejs/kit

Rich-Harris · 2026-07-20T22:01:56Z

This deletes the weirdo $service-worker module now that it's no longer necessary (because of $app/manifest and the availability of $app/env and $app/paths in the service worker) and overhauls our docs to use the new $app/tsconfig/service-worker etc

Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs
This message body should clearly illustrate what problems it solves.
Ideally, include a test that fails without this PR but passes with it.

Tests

Run the tests with pnpm test and lint the project with pnpm lint and pnpm check

Changesets

If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch. Please prefix changeset messages with feat:, fix:, or chore:.

Edits

Please ensure that 'Allow edits from maintainers' is checked. PRs without this option may be closed.

pkg-svelte-dev · 2026-07-20T22:01:59Z

Install the latest version of @sveltejs/kit from f4b122b:

pnpm add https://pkg.svelte.dev/@sveltejs/kit/c/f4b122b1e2df258257db2a27e8decb6cace809f7

Open in pkg.svelte.dev: https://pkg.svelte.dev/repos/kit/pr/16450

changeset-bot · 2026-07-20T22:02:01Z

🦋 Changeset detected

Latest commit: f4b122b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@sveltejs/kit	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

svelte-docs-bot · 2026-07-20T22:08:58Z

Preview: https://svelte-dev-git-preview-kit-16450-svelte.vercel.app/

ottomated · 2026-07-20T23:08:06Z

Have you looked into using multiple tsconfig files for this? I wonder if it's possible to do this nicely, since sveltekit is already using a generated tsconfig. Could even go further and remove browser types from *.remote.ts and *.server.ts.

teemingc · 2026-07-21T00:25:45Z

Not sure if language tools supports multiple tsconfigs already but that would be nice. Vite vanilla template already does this too

Rich-Harris · 2026-07-21T10:57:19Z

Have you looked into using multiple tsconfig files for this?

Yeah, shortly after writing that I reached the conclusion that including the service worker in the default project was a non-starter. For it to just work OOTB I think we need to have a service-worker directory with sibling index.ts and tsconfig.json files, because tsconfig.*.json in the root is disregarded. I don't see a way to make this work for remote/server files — all ears if there is a way but if not I don't think it's a huge problem.

Pairs with #16450. The way we handle TypeScript configuration is a little bit messy, particularly as it regards service workers, which need to be in their own TypeScript project. This PR tidies things up a bit. It will need corresponding work to happen to the default project template. Essentially, a SvelteKit 3 project only needs this `tsconfig.json` file: ```json { "extends": "$app/tsconfig" } ``` A service worker should live in a `src/service-worker/index.ts` file (_not_ a `src/service-worker.ts` file, though this will still work) with a sibling `tsconfig.json` like this: ```json { "extends": "$app/tsconfig/service-worker" } ``` You can add whatever other configuration you like there, though it's important that the first one `"excludes"` the service worker, and that both contain `"types": ["$app/types"]` if those options are overridden. In addition to those two modules — which are 'real' modules in the sense that they live in `node_modules/$app` — we introduce a third, `$app/service-worker`, which exists solely to make it easier to get a correctly-typed `self` object (without this, there is a lot of [annoying boilerplate](https://svelte.dev/docs/kit/service-workers#Inside-the-service-worker)): ```ts import { self } from '$app/service-worker'; ``` > In future, we could also use this module for e.g. offline caching strategies and the like. I've tested the `node_modules/$app` approach with pnpm and it seems like a winner. `$` is an invalid character for an npm package but valid for Node's module resolution algorithm, so it works without danger of clobbering. pnpm doesn't nuke the directory when it installs or uninstalls packages (much like things like `node_modules/.vite`). We could extend this idea to other modules, which would help with [this very longstanding issue](#1485). TODO: - [x] docs - [x] validation of `types` and `exclude` - [x] tidy up --- ### Please don't delete this checklist! Before submitting the PR, please make sure you do the following: - [x] It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs - [x] This message body should clearly illustrate what problems it solves. - [x] Ideally, include a test that fails without this PR but passes with it. ### Tests - [x] Run the tests with `pnpm test` and lint the project with `pnpm lint` and `pnpm check` ### Changesets - [x] If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running `pnpm changeset` and following the prompts. Changesets that add features should be `minor` and those that fix bugs should be `patch`. Please prefix changeset messages with `feat:`, `fix:`, or `chore:`. ### Edits - [x] Please ensure that 'Allow edits from maintainers' is checked. PRs without this option may be closed. --------- Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com> Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com>

…ing the functionality back to `$app/manifest`, we can

…es(url.pathname)` can never match because `$app/manifest` paths are base-relative (no leading slash) while `url.pathname` is absolute, so the cache-first branch is dead code. This commit fixes the issue reported at documentation/docs/30-advanced/40-service-workers.md:69 ## Bug The service worker example in `documentation/docs/30-advanced/40-service-workers.md` builds its asset list from `$app/manifest`: ```js const ASSETS = [ ...immutable.map((asset) => asset.path), // the Vite output ...assets.map((asset) => asset.path) // everything in `static` ]; ``` Per `packages/kit/src/types/ambient.d.ts` (lines 65–74), the `path` values from `immutable`/`assets` are **relative to the base path with no leading slash** (e.g. `_app/immutable/...`). This is confirmed in `packages/kit/src/exports/vite/index.js`, where `immutable` is generated as `{ path: file }` from Vite manifest keys and `assets` as `{ path: asset.file }` — both bare relative paths. In the `fetch` handler: ```js const url = new URL(event.request.url); ... if (ASSETS.includes(url.pathname)) { // url.pathname is ALWAYS absolute, e.g. "/_app/immutable/..." const response = await cache.match(url.pathname); ... } ``` `url.pathname` is always absolute (leading `/`, plus any base prefix). Since `ASSETS` contains only bare relative strings, the equality-based `Array.includes()` check **never matches**. The entire cache-first branch — the primary thing the example is meant to demonstrate — is dead code. This is a regression from the earlier `$service-worker`-based example, where `build`/`files` were absolute paths (`base + '/file'`) that did match `url.pathname`. The `install` step happens to still work only because `cache.addAll` resolves the relative URLs against the service worker's scope. **Concrete trigger:** any GET request for a build/static asset (e.g. `/_app/immutable/entry/start.<hash>.js`) enters `respond()`; `ASSETS.includes('/_app/immutable/entry/start.<hash>.js')` returns `false` because `ASSETS` contains `_app/immutable/entry/start.<hash>.js` (no leading slash), so it falls through to the network-first path instead of serving from cache. ## Fix Resolve the base-relative manifest paths to absolute pathnames using `resolve()` from `$app/paths` (which is available in service workers — see `packages/kit/test/apps/options-2/src/service-worker.js`, which imports and uses it): ```js import { resolve } from '$app/paths'; ... const ASSETS = [ ...immutable.map((asset) => resolve(asset.path)), ...assets.map((asset) => resolve(asset.path)) ]; ``` For an input that does not start with `/`, `resolve` returns `base + '/' + path` (see `packages/kit/src/runtime/app/paths/client.js`), producing an absolute pathname such as `/_app/immutable/...` (or `/base/_app/...` with a configured base) that matches `url.pathname`. `cache.addAll(ASSETS)` continues to work with these absolute pathnames. Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com> Co-authored-by: Rich-Harris <hello@rich-harris.dev>

…udes"`/`"excludes"` instead of the correct `"include"`/`"exclude"`, so copying it fails to exclude the service worker from root type-checking This commit fixes the issue reported at documentation/docs/30-advanced/40-service-workers.md:114 ## Bug In `documentation/docs/30-advanced/40-service-workers.md` the "Type safety" section shows a root `tsconfig.json` example: ```json { "extends": "$app/tsconfig", "includes": ["src", "test"], "excludes": ["src/service-worker"] } ``` TypeScript's config schema uses the **singular** keys `include` and `exclude`. The plural forms `includes`/`excludes` are unknown top-level keys, which TypeScript silently ignores. A user copying this example verbatim would therefore **not** exclude `src/service-worker` from the root project, so the service worker code would still be type-checked by the root project with the wrong `lib`/types — defeating the entire purpose of the section. Confirmed against the actual generated config in `packages/kit/src/core/sync/write_tsconfig/index.js` (emits `exclude` and `include`) and `packages/kit/test/apps/basics/tsconfig.json` which uses `"include"`. ## Fix Changed `"includes"` → `"include"` and `"excludes"` → `"exclude"` in the example. Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com> Co-authored-by: Rich-Harris <hello@rich-harris.dev>

…ltejs/kit into delete-service-worker-module

elliott-with-the-longest-name-on-github

lgtm, just some questions / nits

…set without `posixify()`, so on Windows it never matches the posix-normalized importer keys and transitive server-only imports into a service worker go undetected. This commit fixes the issue reported at packages/kit/src/exports/vite/index.js:792 ## Bug In `plugin_guard`'s `load` handler (`packages/kit/src/exports/vite/index.js`), the import graph is walked to detect server-only code leaking into client entrypoints. The importer keys stored in `import_map` are produced by `normalize_id(importer, ...)` (line 744), and `normalize_id` ends with `return posixify(id)` — so **every key uses forward slashes**. The `entrypoints` set is compared against those keys via `entrypoints.has(importer)` (line 817). All entrypoints derived from `manifest_data` are already posixified. However, the service worker entrypoint was added as: ```js entrypoints.add(path.relative(root, service_worker_entry_file)); ``` `path.relative` returns platform separators, so on Windows this yields e.g. `src\service-worker.js`, which can never equal the posixified importer key `src/service-worker.js`. ## Trigger On Windows, a project with a `src/service-worker.js` that transitively imports a `$env/dynamic/private` (or otherwise server-only) module. The guard's `find_chain` walk reaches the service worker importer but `entrypoints.has(importer)` returns `false`, so the server-only-import error is silently not raised — weakening a correctness/security guard. (Note: even though `service_worker_entry_file` is posixified elsewhere at line 1059, `path.relative` re-introduces backslashes on Windows regardless of input.) ## Fix Wrap with `posixify()` to match the pattern used for all other entrypoints: ```js entrypoints.add(posixify(path.relative(root, service_worker_entry_file))); ``` `posixify` is already imported at the top of the file (line 15). Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com> Co-authored-by: Rich-Harris <hello@rich-harris.dev>

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to version-3, this PR will be updated. ⚠️

⚠️

⚠️ `version-3` is currently in **pre mode** so this branch has prereleases rather than normal releases. If you want to exit prereleases, run `changeset pre exit` on `version-3`. ⚠️

⚠️

⚠️ # Releases ## @sveltejs/kit@3.0.0-next.12 ### Major Changes - breaking: rename `Pathname` type to `Path` and `Asset` to `AssetPath` ([#16430](#16430)) breaking: remove leading `/` from `Path` and `AssetPath` - breaking: write tsconfig to `node_modules/$app/tsconfig` ([#16458](#16458)) - breaking: error on `event.url`, `event.params` and `event.route` access inside queries ([#16452](#16452)) - breaking: delete `$service-worker` module ([#16450](#16450)) - breaking: detect new deployments on data, remote, and form action responses, tab focus, and visibility change, and default `version.pollInterval` to 1 hour ([#16496](#16496)) ### Minor Changes - feat: add `$app/manifest` module with `immutable`, `assets`, `prerendered`, and `routes` exports ([#16372](#16372)) - feat: validate that all remote form fields were created with form.fields.foo.as(...) ([#16331](#16331)) - feat: make `$app/paths` importable in service workers ([#16441](#16441)) - feat: `$app/service-worker` module ([#16458](#16458)) - feat: better tsconfig validation ([#16458](#16458)) - fix: default cookies to `secure` to `false` during development ([#16462](#16462)) ### Patch Changes - fix: allow `undefined` values to be passed to form field `.as(...)` where applicable ([#15681](#15681)) - fix: include queries refreshed from within another query in the serialized response ([#16461](#16461)) - fix: generate sourcemaps for remote modules ([#16440](#16440)) - fix: avoid empty getElementById() call on hash routing navigation ([#16448](#16448)) - fix: warn if hook files are spelled as "hook" instead of "hooks" ([#16483](#16483)) - chore: deprecate the `alias` option ([#16470](#16470)) - fix: prevent infinite loops when server-side queries refresh each other in a cycle during the single-flight drain ([#16461](#16461)) - fix: populate `version` in service workers ([#16434](#16434)) - fix: resolve remote modules as external during dev prebundling so packages can re-export remote functions ([#16426](#16426)) - fix: refetch route-tracking server data when navigating away from an error page ([#16381](#16381)) - fix: serialize `query(...).set(...)`/`query(...).refresh()` values into the rendered HTML when called from within a query during SSR ([#16461](#16461)) - fix: fall back to the page's form actions when a sibling endpoint has no POST handler ([#16349](#16349)) - fix: return a lightweight 404 instead of rendering the error page for subresource requests ([#16463](#16463)) - fix: preserve stripped path prefixes by making trailing-slash redirects relative ([#16431](#16431)) - chore: deduplicate type-stripping logic in `tweak_types` ([#16454](#16454)) - fix: more informative error message when running a command inside a query or prerender function ([`eb5c973`](eb5c973)) ## @sveltejs/adapter-cloudflare@8.0.0-next.3 ### Patch Changes - chore: bump `@cloudflare/workers-types` to `4.20260621.1` ([#16455](#16455)) - Updated dependencies [[`adc4c5b`](adc4c5b), [`ecb0701`](ecb0701), [`4b4cc60`](4b4cc60), [`7390dbe`](7390dbe), [`2e71340`](2e71340), [`c87bc3a`](c87bc3a), [`af15c6c`](af15c6c), [`c6fa431`](c6fa431), [`bfe4dea`](bfe4dea), [`df7dc72`](df7dc72), [`5ae11a1`](5ae11a1), [`781205c`](781205c), [`c87bc3a`](c87bc3a), [`a1bfeb9`](a1bfeb9), [`c87bc3a`](c87bc3a), [`9f0127d`](9f0127d), [`4b4cc60`](4b4cc60), [`8f5b9c7`](8f5b9c7), [`c9b5544`](c9b5544), [`fe1d4a4`](fe1d4a4), [`4b4cc60`](4b4cc60), [`5f78e95`](5f78e95), [`25510fc`](25510fc), [`c99a6cf`](c99a6cf), [`17a45ca`](17a45ca), [`2ca20c3`](2ca20c3), [`eb5c973`](eb5c973)]: - @sveltejs/kit@3.0.0-next.12 ## @sveltejs/adapter-netlify@7.0.0-next.4 ### Patch Changes - fix: await `init` on every request to prevent race condition ([#16467](#16467)) - chore: bump Rolldown to `1.2.0` ([#16455](#16455)) - Updated dependencies [[`adc4c5b`](adc4c5b), [`ecb0701`](ecb0701), [`4b4cc60`](4b4cc60), [`7390dbe`](7390dbe), [`2e71340`](2e71340), [`c87bc3a`](c87bc3a), [`af15c6c`](af15c6c), [`c6fa431`](c6fa431), [`bfe4dea`](bfe4dea), [`df7dc72`](df7dc72), [`5ae11a1`](5ae11a1), [`781205c`](781205c), [`c87bc3a`](c87bc3a), [`a1bfeb9`](a1bfeb9), [`c87bc3a`](c87bc3a), [`9f0127d`](9f0127d), [`4b4cc60`](4b4cc60), [`8f5b9c7`](8f5b9c7), [`c9b5544`](c9b5544), [`fe1d4a4`](fe1d4a4), [`4b4cc60`](4b4cc60), [`5f78e95`](5f78e95), [`25510fc`](25510fc), [`c99a6cf`](c99a6cf), [`17a45ca`](17a45ca), [`2ca20c3`](2ca20c3), [`eb5c973`](eb5c973)]: - @sveltejs/kit@3.0.0-next.12 ## @sveltejs/adapter-node@6.0.0-next.6 ### Patch Changes - fix: preserve stripped path prefixes by making trailing-slash redirects relative ([#16431](#16431)) - chore: bump Rolldown to `1.2.0` ([#16455](#16455)) - Updated dependencies [[`adc4c5b`](adc4c5b), [`ecb0701`](ecb0701), [`4b4cc60`](4b4cc60), [`7390dbe`](7390dbe), [`2e71340`](2e71340), [`c87bc3a`](c87bc3a), [`af15c6c`](af15c6c), [`c6fa431`](c6fa431), [`bfe4dea`](bfe4dea), [`df7dc72`](df7dc72), [`5ae11a1`](5ae11a1), [`781205c`](781205c), [`c87bc3a`](c87bc3a), [`a1bfeb9`](a1bfeb9), [`c87bc3a`](c87bc3a), [`9f0127d`](9f0127d), [`4b4cc60`](4b4cc60), [`8f5b9c7`](8f5b9c7), [`c9b5544`](c9b5544), [`fe1d4a4`](fe1d4a4), [`4b4cc60`](4b4cc60), [`5f78e95`](5f78e95), [`25510fc`](25510fc), [`c99a6cf`](c99a6cf), [`17a45ca`](17a45ca), [`2ca20c3`](2ca20c3), [`eb5c973`](eb5c973)]: - @sveltejs/kit@3.0.0-next.12 ## @sveltejs/adapter-vercel@7.0.0-next.3 ### Patch Changes - fix: await `init` on every request to prevent race condition ([#16467](#16467)) - chore: bump Rolldown to `1.2.0` ([#16455](#16455)) - Updated dependencies [[`adc4c5b`](adc4c5b), [`ecb0701`](ecb0701), [`4b4cc60`](4b4cc60), [`7390dbe`](7390dbe), [`2e71340`](2e71340), [`c87bc3a`](c87bc3a), [`af15c6c`](af15c6c), [`c6fa431`](c6fa431), [`bfe4dea`](bfe4dea), [`df7dc72`](df7dc72), [`5ae11a1`](5ae11a1), [`781205c`](781205c), [`c87bc3a`](c87bc3a), [`a1bfeb9`](a1bfeb9), [`c87bc3a`](c87bc3a), [`9f0127d`](9f0127d), [`4b4cc60`](4b4cc60), [`8f5b9c7`](8f5b9c7), [`c9b5544`](c9b5544), [`fe1d4a4`](fe1d4a4), [`4b4cc60`](4b4cc60), [`5f78e95`](5f78e95), [`25510fc`](25510fc), [`c99a6cf`](c99a6cf), [`17a45ca`](17a45ca), [`2ca20c3`](2ca20c3), [`eb5c973`](eb5c973)]: - @sveltejs/kit@3.0.0-next.12 Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

`utils/path.js` lost its only importer in #16374, `decode_params` in #16189, `strip_virtual_prefix` in #16450.

`sveltekit_server` was removed as an unused module ID in sveltejs#16465, then reintroduced by sveltejs#16450 without a consumer. `noop_tracer` has been unused since it was added in sveltejs#13899, and `remove_optional_params` since sveltejs#9571. Removing `remove_optional_params` also orphans `optional_param_regex`, and removing `noop_tracer` orphans the `Tracer` type import; both go with them. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This PR contains the following updates: | Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) | |---|---|---|---| | [@sveltejs/kit](https://svelte.dev) ([source](https://github.com/sveltejs/kit/tree/HEAD/packages/kit)) | [`2.70.3` → `3.0.0`](https://renovatebot.com/diffs/npm/@sveltejs%2fkit/2.70.3/3.0.0) | ![age](https://developer.mend.io/api/mc/badges/age/npm/@sveltejs%2fkit/3.0.0?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/@sveltejs%2fkit/2.70.3/3.0.0?slim=true) | --- ### Release Notes <details> <summary>sveltejs/kit (@sveltejs/kit)</summary> ### [`v3.0.0`](https://github.com/sveltejs/kit/blob/HEAD/packages/kit/CHANGELOG.md#300) [Compare Source](https://github.com/sveltejs/kit/compare/@sveltejs/kit@2.70.3...@sveltejs/kit@3.0.0) ##### Major Changes - breaking: move remote function types to `$app/server` ([#16740](sveltejs/kit#16740)) - breaking: remove `experimental.handleRenderingErrors` flag ([#16265](sveltejs/kit#16265)) - breaking: make `getRequest` and `setResponse` synchronous ([#16280](sveltejs/kit#16280)) - breaking: TypeScript 6 is now the minimum required version ([#15930](sveltejs/kit#15930)) - breaking: refresh all load functions/queries when clicking a link to the current URL ([#16572](sveltejs/kit#16572)) - breaking: move remote function types to `$app/server` ([#16764](sveltejs/kit#16764)) - breaking: upgrade to `cookie` v2. Cookie names must now contain only ASCII characters ([#13386](sveltejs/kit#13386)) - breaking: require Node 22 or newer ([#12548](sveltejs/kit#12548)) - major: error when a client-requested single-flight mutation isn't respected by the server, allow the server to explicitly ignore refreshes ([#16892](sveltejs/kit#16892)) - breaking: remove the `preloadStrategy` option. `modulepreload` will always be used ([#15256](sveltejs/kit#15256)) - breaking: default the cookie `path` option to `'/'` ([#15398](sveltejs/kit#15398)) - breaking: remove `@sveltejs/kit/node/polyfills` ([#15430](sveltejs/kit#15430)) - breaking: add `config.kit.output.linkHeaderPreload` to preload using the `Link` header ([#15939](sveltejs/kit#15939)) - breaking: require `@sveltejs/vite-plugin-svelte` v7 ([#15371](sveltejs/kit#15371)) - breaking: make `page.url` immutable on a type level ([#16256](sveltejs/kit#16256)) - breaking: remove `base`, `assets`, and `resolveRoute` from `$app/paths` ([#15507](sveltejs/kit#15507)) - breaking: remove `createEntries` from the `Builder` object passed to adapter functions ([#15509](sveltejs/kit#15509)) - breaking: return no content for 204 responses ([#16200](sveltejs/kit#16200)) - breaking: rename `Pathname` type to `Path` and `Asset` to `AssetPath` ([#16430](sveltejs/kit#16430)) breaking: remove leading `/` from `Path` and `AssetPath` - breaking: `handle`'s `resolve` is now typed to always return a `Promise` ([#16352](sveltejs/kit#16352)) - breaking: remove `Server` constructor and `SSRManifest` from public types ([#16876](sveltejs/kit#16876)) - breaking: require Svelte config options to be passed through the Vite plugin ([#16007](sveltejs/kit#16007)) - breaking: form action responses now use the HTTP status code returned from `fail` ([#16200](sveltejs/kit#16200)) - breaking: write tsconfig to `node_modules/$app/tsconfig` ([#16458](sveltejs/kit#16458)) - breaking: move `defineParams` and associated types to `@sveltejs/kit/params` ([#16716](sveltejs/kit#16716)) - breaking: remove the deprecated CSRF `checkOrigin` option in favor of `trustedOrigins` ([#15437](sveltejs/kit#15437)) - breaking: the `delta` property now only exists for `popstate` navigation events ([#15522](sveltejs/kit#15522)) - breaking: change `form.error` type from `any` to `App.Error | undefined` ([#16245](sveltejs/kit#16245)) - breaking: remove deprecated `pragma` header in version polling for improved CORS support ([#15428](sveltejs/kit#15428)) - breaking: `goto` now rejects when called with a URL that does not resolve to a route within the app, matching the existing behaviour for external URLs ([#16164](sveltejs/kit#16164)) - breaking: run all errors through the `handleError` hook ([#16664](sveltejs/kit#16664)) - breaking: require Svelte 5.56.4 or newer ([#15371](sveltejs/kit#15371)) - breaking: error on `event.url`, `event.params` and `event.route` access inside queries ([#16452](sveltejs/kit#16452)) - breaking: enhanced cross-page form actions now navigate to the action page on success and failure, matching native form behavior ([#16684](sveltejs/kit#16684)) - breaking: delete `$service-worker` module ([#16450](sveltejs/kit#16450)) - breaking: move `defineEnvVars` to `@sveltejs/kit/env` ([#16375](sveltejs/kit#16375)) - breaking: nested server-only directories ([#15685](sveltejs/kit#15685)) - feat: allow adapters to provide additional Vite plugins ([#16206](sveltejs/kit#16206)) - breaking: replace the `$lib` alias with `#lib` and remove `files.lib` config. ([#16360](sveltejs/kit#16360)) - breaking: remove `#lib` definition from `paths`; requires explicit module extensions as a result ([#16736](sveltejs/kit#16736)) - chore: change `error`, `isHttpError`, `redirect`, and `isRedirect` to refer to public type instead of internal class ([#13036](sveltejs/kit#13036)) - breaking: move hooks-related types to `@sveltejs/kit/hooks` ([#16737](sveltejs/kit#16737)) - breaking: add 'error' result type to `preloadData` ([#12579](sveltejs/kit#12579)) - breaking: detect new deployments on data, remote, and form action responses, tab focus, and visibility change, and default `version.pollInterval` to 1 hour ([#16496](sveltejs/kit#16496)) - breaking: disallow cross-origin form submissions without a `Content-Type` header ([#16347](sveltejs/kit#16347)) - breaking: Server-only directories (`/server/` in the path) are now treated as server-only everywhere inside the project (except `src/routes` and the assets directory) ([#16360](sveltejs/kit#16360)) - breaking: `config` exported from a universal route file takes precedence over a server one ([#16400](sveltejs/kit#16400)) - breaking: require Vite 8. Provides new functionality even for existing Vite 8 users such as faster builds with Vite hook filters and more powerful SvelteKit adapters with the Vite environment API ([#15371](sveltejs/kit#15371)) - breaking: remove `data-sveltekit-*` option `'off'` in favour of `false` ([#15907](sveltejs/kit#15907)) - breaking: move tracing out of the experimental namespace and remove the instrumentation flag ([#16260](sveltejs/kit#16260)) - breaking: add `kit.paths.origin` config option, remove `kit.prerender.origin` and the `adapter-node` `ORIGIN` environment variable ([#16161](sveltejs/kit#16161)) - breaking: move `Page`, `ReadonlyURL` and `ReadonlyURLSearchParams` from `@sveltejs/kit` to `$app/state` ([#16694](sveltejs/kit#16694)) - breaking: remove `$app/stores` ([#15499](sveltejs/kit#15499)) - breaking: add `refreshAll` and deprecate `invalidateAll` ([#16289](sveltejs/kit#16289)) - breaking: reject query parameters beginning with `x-sveltekit-` ([#17125](sveltejs/kit#17125)) - breaking: disallow `*.remote.ts/js` files unless `experimental.remoteFunctions` is enabled ([#16247](sveltejs/kit#16247)) - breaking: replace the `noScroll` and `keepFocus` options of `goto` with a single `reset` option, and the `data-sveltekit-noscroll` and `data-sveltekit-keepfocus` attributes with `data-sveltekit-reset` ([#16558](sveltejs/kit#16558)) - breaking: don't abort navigation when calling `invalidate(All)` during navigation ([#16188](sveltejs/kit#16188)) - breaking: consistent special filename patterns ([#16382](sveltejs/kit#16382)) - breaking: allow `handleError` to influence status code ([#16162](sveltejs/kit#16162)) - breaking: delegate CORS handling to Vite for static directory requests during development ([#16357](sveltejs/kit#16357)) - breaking: require `vite@^8.0.12`, the first Vite 8 release bundling stable `rolldown` 1.0.0 ([#16134](sveltejs/kit#16134)) - breaking: only include routes with a `+page` or `+server` in `RouteId` ([#16580](sveltejs/kit#16580)) - breaking: require Node 22.17 ([#16597](sveltejs/kit#16597)) - breaking: deprecate `error(status, {...})` in favour of `error(status, message, {...})` ([#16540](sveltejs/kit#16540)) - breaking: replace the `builder.generateManifest` with `builder.generateServerInstance` and `builder.manifest` ([#16875](sveltejs/kit#16875)) - breaking: forbid external redirects by default ([#16198](sveltejs/kit#16198)) - breaking: separate adapter Vite plugins into `pre` and `post` ([#16711](sveltejs/kit#16711)) - breaking: remove param files in folder in favor of `params.js/ts` file ([#16189](sveltejs/kit#16189)) - breaking: move env-related types to `@sveltejs/kit/env` ([#16739](sveltejs/kit#16739)) - breaking: `preloadCode` now takes a route ID (e.g. `/blog/[slug]`) instead of a pathname. Route IDs are not prefixed with `paths.base` ([#16576](sveltejs/kit#16576)) - breaking: move `BeforeNavigate`, `OnNavigate`, `AfterNavigate`, `Navigation`, `NavigationTarget`, `NavigationType`, `GotoOptions` and the `Navigation*` variant types from `@sveltejs/kit` to `$app/navigation` ([#16694](sveltejs/kit#16694)) - breaking: move `ActionResult` and `SubmitFunction` from `@sveltejs/kit` to `$app/forms` ([#16694](sveltejs/kit#16694)) - breaking: remove `handleValidationError` and pass remote function validation errors to `handleError` with `kind: 'validation'` ([#16672](sveltejs/kit#16672)) - breaking: remove deprecated `.run()` method from live queries ([#16573](sveltejs/kit#16573)) ##### Minor Changes - feat: allow hyphens in param and matcher names ([#16284](sveltejs/kit#16284)) - feat: add `$app/manifest` module with `immutable`, `assets`, `prerendered`, and `routes` exports ([#16372](sveltejs/kit#16372)) - feat: ignore files with + prefix if they contain test/spec/stories ([#16715](sveltejs/kit#16715)) - feat: add `ErrorProps` to generated types ([#16272](sveltejs/kit#16272)) - feat: support sourcemaps in production ([#16412](sveltejs/kit#16412)) - feat: return the list of compressed files from `builder.compress` ([#16566](sveltejs/kit#16566)) - feat: better response logging ([#16744](sveltejs/kit#16744)) - feat: warn when tsconfig doesn't exclude service worker ([#16645](sveltejs/kit#16645)) - feat: validate that all remote form fields were created with form.fields.foo.as(...) ([#16331](sveltejs/kit#16331)) - feat: support function validators for environment variables ([#16402](sveltejs/kit#16402)) - feat: use `type: 'module'` for service worker registrations ([#16169](sveltejs/kit#16169)) - feat: allow adapters to receive the Svelte config as a function argument when adding Vite plugins ([#16986](sveltejs/kit#16986)) - feat: add shallow routing to `goto` and deprecate `pushState` and `replaceState` ([#16449](sveltejs/kit#16449)) - feat: abort `request.signal` when the response closes prematurely, via a new `response` option for `getRequest` ([#16793](sveltejs/kit#16793)) - feat: make `$app/paths` importable in service workers ([#16441](sveltejs/kit#16441)) - feat: pass the project-relative source `filename` to the `preload` filter for fonts ([#16443](sveltejs/kit#16443)) - feat: preserve page state set through `goto(..., { state, persistState: true })` across reloads ([#16449](sveltejs/kit#16449)) - feat: reinstate `$env/static/private`, `$env/dynamic/private`, `$env/static/public`, `$env/dynamic/public` and `$app/environment` as deprecated aliases for `$app/env/private` `$app/env/public` and `$app/env` ([#16334](sveltejs/kit#16334)) - feat: add `page` and `endpoint` booleans to `$app/manifest`'s `routes`, and export a `ManifestRoute` type ([#16594](sveltejs/kit#16594)) - feat: `$app/service-worker` module ([#16458](sveltejs/kit#16458)) - feat: resolve paths using the Vite config `root` option instead of `process.cwd()` to better support monorepo configurations such as Vitest workspaces ([#15469](sveltejs/kit#15469)) - feat: better error logging ([#16374](sveltejs/kit#16374)) - feat: add `PageRouteId` and `EndpointRouteId` to `$app/types` ([#16594](sveltejs/kit#16594)) - feat: better tsconfig validation ([#16458](sveltejs/kit#16458)) - feat: add `dirty()` property to form fields ([#16208](sveltejs/kit#16208)) - feat: support the `QUERY` HTTP method in `+server.js` ([#16782](sveltejs/kit#16782)) - feat: allow adapters to override `getRequest` and `setResponse` during `vite dev` and `vite preview` ([#16753](sveltejs/kit#16753)) - chore: deprecate `Response` helpers in favor of platform-provided alternatives ([#15448](sveltejs/kit#15448)) - feat: add `cookies.parse` method ([#16203](sveltejs/kit#16203)) - chore: deprecate `export const snapshot` in favour of the `snapshot` helper ([#16687](sveltejs/kit#16687)) - feat: add `snapshot` helper to `$app/navigation` ([#16685](sveltejs/kit#16685)) - feat: support custom values in `page.state` via `transport` hook ([#16662](sveltejs/kit#16662)) - fix: default cookies to `secure` to `false` during development ([#16462](sveltejs/kit#16462)) - feat: warn when naively proxying requests that result in responses with a `content-encoding` header ([#16633](sveltejs/kit#16633)) - feat: accept the checked state as a third argument to `.as('radio', ...)` and `.as('checkbox', ...)` so that these inputs reset to it after a submission ([#16926](sveltejs/kit#16926)) - feat: add an `applyReroute` helper for adapters that support split serverless function deployments ([#16665](sveltejs/kit#16665)) ##### Patch Changes - fix: prevent scheme-like path segments from causing off-site trailing-slash redirects ([#17294](sveltejs/kit#17294)) - chore: share the action error result between form actions and remote forms ([#16835](sveltejs/kit#16835)) - fix: persist global app state across module graph reloads ([#16663](sveltejs/kit#16663)) - fix: generate valid `Path` types for routes with optional or rest params, several params in one segment, or escape sequences ([#16577](sveltejs/kit#16577)) - fix: coerce values typed into remote form fields, and only apply the default given to `.as()` until the field is edited ([#16939](sveltejs/kit#16939)) - fix: blur focused SVG elements before the DOM update on navigation ([#16983](sveltejs/kit#16983)) - fix: support bigint params in server-side route resolution ([#17130](sveltejs/kit#17130)) - chore: build streamed responses from async generators ([#16847](sveltejs/kit#16847)) - fix: generate types when dev server starts ([#17034](sveltejs/kit#17034)) - fix: allow `undefined` values to be passed to form field `.as(...)` where applicable ([#15681](sveltejs/kit#15681)) - fix: respect `paths.relative` during development for client files ([#17053](sveltejs/kit#17053)) - fix: validate prerender concurrency ([#17145](sveltejs/kit#17145)) - chore: deprecate `builder.rimraf` and `builder.mkdirp` in favour of `node:fs` methods ([#16610](sveltejs/kit#16610)) - fix: manipulate stack trace for errors that happen while generating prerender inputs ([#17113](sveltejs/kit#17113)) - fix: don't treat callable standard schemas as function param matchers ([#16403](sveltejs/kit#16403)) - fix: prevent non-redirect enhanced form results from navigating to another origin ([#17293](sveltejs/kit#17293)) - fix: clarify circular imports from `src/env` ([#17014](sveltejs/kit#17014)) - fix: keep memory flat when precompressing many files ([#16993](sveltejs/kit#16993)) - fix: render remote form actions while prerendering ([#17139](sveltejs/kit#17139)) - fix: ignore Vitest browser loader HTML transforms ([#17092](sveltejs/kit#17092)) - fix: prevent failed link preloads from causing unhandled promise rejections in production ([#17181](sveltejs/kit#17181)) - fix: resolve generated rootDirs from the project root ([#17242](sveltejs/kit#17242)) - fix: generate route resolution modules as siblings of `.html` pages ([#16674](sveltejs/kit#16674)) - perf: parse large streamed frames in linear time ([#16489](sveltejs/kit#16489)) - fix: keep at most one pending body read at a time when deserializing binary forms ([#16783](sveltejs/kit#16783)) - fix: escape cache-control headers in prerendered HTML ([#17293](sveltejs/kit#17293)) - fix: decode all numeric character references, including above `ffff`, when crawling prerendered pages ([#16611](sveltejs/kit#16611)) - fix: enforce request body size limits when Content-Type is absent ([#17127](sveltejs/kit#17127)) - fix: include queries refreshed from within another query in the serialized response ([#16461](sveltejs/kit#16461)) - fix: reject malformed streamed data encoding ([#16423](sveltejs/kit#16423)) - perf: cache the default cookie header parse and avoid allocations in `cookies.get` ([#16341](sveltejs/kit#16341)) - fix: exclude deleted cookies from `cookies.getAll()` so it stays consistent with `cookies.get()` ([#16297](sveltejs/kit#16297)) - fix: hide stack traces for internal errors like 404s ([#16411](sveltejs/kit#16411)) - chore: deduplicate repeated CSP directive handling ([#16498](sveltejs/kit#16498)) - fix: render the nearest error page when a form submission receives a non-ActionResult error response ([#16308](sveltejs/kit#16308)) - chore: bump `mrmime` to 2.0.1 ([#16745](sveltejs/kit#16745)) - fix: correctly implement Vite plugin hook filters ([#16760](sveltejs/kit#16760)) - fix: ignore nested outDir files outside generated ([#17150](sveltejs/kit#17150)) - fix: defer `query.refresh()` in server commands until after the command body completes ([#16225](sveltejs/kit#16225)) - fix: drain unconsumed request bodies so keep-alive connections don't hang ([#16170](sveltejs/kit#16170)) - fix: keep `history.scrollRestoration` set to `manual` when leaving the page, so a document restored from the back/forward cache does not fall back to browser scroll restoration ([#17244](sveltejs/kit#17244)) - fix: resolve service worker and `tsconfig.json` based on Vite `root` setting ([#16229](sveltejs/kit#16229)) - fix: rebuild the dev manifest when route files disappear during an incremental update ([#16643](sveltejs/kit#16643)) - breaking: populate env vars before `instrumentation.server.js` is evaluated and update the adapter instrumentation API ([#16303](sveltejs/kit#16303)) - fix: only print prerender progress newline when necessary ([#16766](sveltejs/kit#16766)) - perf: match only unpaired surrogates when escaping HTML ([#16407](sveltejs/kit#16407)) - fix: treat `data:` protocol URLs as external for redirect ([#16392](sveltejs/kit#16392)) - chore: deduplicate request hashing for serialized fetch responses ([#16499](sveltejs/kit#16499)) - fix: don't treat `Object.prototype` members as param matchers during validation ([#16612](sveltejs/kit#16612)) - fix: generate a `never` `Path` type when there are no routes ([#17228](sveltejs/kit#17228)) - fix: follow HTTP redirects from authentication proxies when enhancing form submissions ([#17106](sveltejs/kit#17106)) - fix: don't report empty environment variables as missing ([#16401](sveltejs/kit#16401)) - chore: generate the env modules in a single pass ([#16833](sveltejs/kit#16833)) - fix: externalize `@opentelemetry/api` to prevent bundler chunk colocation between `instrumentation.server.js` and application code ([#16302](sveltejs/kit#16302)) - fix: support form fields named after Object prototype properties ([#17136](sveltejs/kit#17136)) - fix: exclude routes without a page or endpoint from `routes` in `$app/manifest`, and remove directories with no route files from `LayoutParams` ([#16588](sveltejs/kit#16588)) - fix: record a history traversal before resolving its route ([#16959](sveltejs/kit#16959)) - fix: avoid Vite dev server reload on initial page request ([#16553](sveltejs/kit#16553)) - fix: don't set a `null` `accept-language` header on internal `fetch` sub-requests when the incoming request has none ([#16527](sveltejs/kit#16527)) - fix: reuse SSR-cached fetch responses during hydration when a cross-origin URL is not in canonical form ([#16339](sveltejs/kit#16339)) - fix: correctly detect prerendered paths in server `fetch` when `paths.base` is set ([#16525](sveltejs/kit#16525)) - chore: say what a valid remote form field name looks like when rejecting one ([#16938](sveltejs/kit#16938)) - chore: warn when remote form fields are enumerated in dev ([#16940](sveltejs/kit#16940)) - fix: populate `$app/env/*` dynamic variables in contexts that don't run the dev server, such as `vite-node` ([#16223](sveltejs/kit#16223)) - fix: resolve client manifest imports against the Vite root ([#16803](sveltejs/kit#16803)) - fix: properly handle Date objects in form.fields.set ([#16168](sveltejs/kit#16168)) - fix: return 404 for form actions and remote functions whose name is an `Object.prototype` member ([#16072](sveltejs/kit#16072)) - fix: no longer throw "An impossible situation occurred" when a server-only module is imported by both server and client code ([#16257](sveltejs/kit#16257)) - fix: respect Vite default log level ([#16767](sveltejs/kit#16767)) - fix: set the focus starting point without a fragment navigation, which leaked a `hashchange` to app listeners ([#16992](sveltejs/kit#16992)) - fix: keep a `form.for` instance registered when the derived that holds it disconnects and reconnects ([#17230](sveltejs/kit#17230)) - fix: make cookie options optional ([#17201](sveltejs/kit#17201)) - fix: don't duplicate remote modules in the generated manifest ([#16532](sveltejs/kit#16532)) - fix: evict hashed fetch cache entries after mutations ([#17146](sveltejs/kit#17146)) - chore: reuse base64 and text decoding helpers ([#16608](sveltejs/kit#16608)) - fix: explain the removal of `$lib` and `$service-worker` when their imports fail to resolve ([#16635](sveltejs/kit#16635)) - fix: tweak response logging for remote requests ([#16865](sveltejs/kit#16865)) - fix: correctly massage stack traces with async frames ([#16633](sveltejs/kit#16633)) - fix: mark `RequestEvent` properties as `readonly` ([#16661](sveltejs/kit#16661)) - fix: render the nearest `+error.svelte` at the depth it occupies when an error is thrown during rendering ([#16526](sveltejs/kit#16526)) - fix: support coordinate objects from image inputs in remote forms ([#16944](sveltejs/kit#16944)) - fix: revert route metadata caching to regenerate missing root-route types during sync ([#17281](sveltejs/kit#17281)) - chore: bump `@sveltejs/acorn-typescript` to 1.0.12 ([#16745](sveltejs/kit#16745)) - fix: update `match` parameter type ([#16636](sveltejs/kit#16636)) - fix: generate sourcemaps for remote modules ([#16440](sveltejs/kit#16440)) - fix: keep hash-router links on the current document when resolving paths ([#17107](sveltejs/kit#17107)) - fix: avoid empty getElementById() call on hash routing navigation ([#16448](sveltejs/kit#16448)) - fix: resolve every module entry point using `kit.moduleExtensions` ([#17043](sveltejs/kit#17043)) - fix: serve `.ico` files with `image/x-icon` Content-Type ([#16234](sveltejs/kit#16234)) - chore: bump `magic-string` to 1.1.0 ([#16745](sveltejs/kit#16745)) - fix: exclude inlined files from the page's `$app/manifest` immutable list ([#16531](sveltejs/kit#16531)) - fix: discard invalidation results when a navigation completes while they load ([#16852](sveltejs/kit#16852)) - fix: avoid client-side code being bundled by Cloudflare Wrangler ([#16364](sveltejs/kit#16364)) - fix: wait for the redirect navigation before remote form submissions resolve ([#16765](sveltejs/kit#16765)) - fix: record the mime types of prerendered paths in the server manifest ([#16564](sveltejs/kit#16564)) - fix: only require the `svelte-trusted-html` trusted-types policy when client-side code is shipped, allowing builds where all pages have `csr: false` ([#16928](sveltejs/kit#16928)) - chore: clarify which hooks run during server route resolution ([#16397](sveltejs/kit#16397)) - fix: yield to allow prerender updates to be visible ([#16748](sveltejs/kit#16748)) - fix: make `paths.origin` type looser ([#16215](sveltejs/kit#16215)) - chore: bump `devalue` to 5.9.0 ([#16745](sveltejs/kit#16745)) - feat: send periodic `keep-alive` SSE comments from `query.live` to prevent idle-timeout errors ([#16063](sveltejs/kit#16063)) - fix: send an explicit SSE Accept header for `query.live` requests to avoid buffering by proxies ([#17104](sveltejs/kit#17104)) - fix: don't touch the `query.live` stream controller after teardown, and make response cancellation observable via the generator's `request.signal` ([#16790](sveltejs/kit#16790)) - fix: print `builder.log.warn` messages to stderr, as documented ([#17253](sveltejs/kit#17253)) - fix: warn if hook files are spelled as "hook" instead of "hooks" ([#16483](sveltejs/kit#16483)) - fix: only suggest a `+` prefix for route filenames that are valid with the file's extension ([#16837](sveltejs/kit#16837)) - chore: only generate each route's resolution module once when prerendering ([#16576](sveltejs/kit#16576)) - fix: don't throw from remote form `validate()` if the form unmounts while it is waiting for a tick ([#16720](sveltejs/kit#16720)) - chore: share navigation completion between navigate and shallow routing ([#16838](sveltejs/kit#16838)) - fix: route dev-server response logging through Vite's logger so it respects `logLevel` and `customLogger` ([#16858](sveltejs/kit#16858)) - fix: skip clean fields when programmatically validating forms ([#16208](sveltejs/kit#16208)) - perf: skip import graph collection outside client environments ([#16383](sveltejs/kit#16383)) - breaking: experimental remote form `validate({ includeUntouched })` option is now `all` ([#16208](sveltejs/kit#16208)) - fix: rerun load functions when the number of values of a tracked search parameter changes ([#16495](sveltejs/kit#16495)) - chore: read build-time config from defines on the server instead of carrying it in `options` ([#16873](sveltejs/kit#16873)) - fix: avoid client build warning about externalising `node:async_hooks` ([#16244](sveltejs/kit#16244)) - chore: stop externalizing `cookie` dependency during build ([#16936](sveltejs/kit#16936)) - fix: reinstate `$app/environment` as an alias for `$app/env`, in case dependencies import it ([#15964](sveltejs/kit#15964)) - fix: preserve `paths.base` when `vite preview` redirects a prerendered page to the correct trailing slash ([#16836](sveltejs/kit#16836)) - fix: error when reading non-serialized `set-cookie` headers via `getSetCookie` in `load` ([#16614](sveltejs/kit#16614)) - fix: walk and copy directories without a stat per file ([#16995](sveltejs/kit#16995)) - perf: avoid quadratic remote form issue merging ([#16493](sveltejs/kit#16493)) - fix: widen remote form fields for union schemas and string enums ([#16937](sveltejs/kit#16937)) - chore: deprecate the `alias` option ([#16470](sveltejs/kit#16470)) - fix: don't attempt to serialize fetch responses when the request body is not a string or TypedArray ([#16501](sveltejs/kit#16501)) - fix: respond to `HEAD` requests without a body ([#17036](sveltejs/kit#17036)) - chore: replace deprecated Vite dev server APIs ([#16961](sveltejs/kit#16961)) - chore: iterate the query cache maps through a single generator ([#16846](sveltejs/kit#16846)) - fix: handle rejected streamed server data after delayed loads ([#16268](sveltejs/kit#16268)) - fix: don't crash on interactions inside a form whose controls shadow `nodeName` ([#16769](sveltejs/kit#16769)) - fix: don't replay a preloaded redirect when a later hop of the navigation returns to the route ([#16955](sveltejs/kit#16955)) - fix: prevent path traversal when previewing prerendered pages and data on Windows ([#17293](sveltejs/kit#17293)) - fix: settle a query's pending request in place when its value arrives through `set()` ([#16958](sveltejs/kit#16958)) - fix: render pages over sibling endpoints without GET or HEAD handlers ([#16125](sveltejs/kit#16125)) - fix: exit build workers after completing their tasks while allowing synchronous exit handlers to run ([#17135](sveltejs/kit#17135)) - fix: prevent infinite loops when server-side queries refresh each other in a cycle during the single-flight drain ([#16461](sveltejs/kit#16461)) - fix: populate `version` in service workers ([#16434](sveltejs/kit#16434)) - feat: add field.touched() helper to remote form fields ([#14692](sveltejs/kit#14692)) - fix: respect `paths.relative` for server-side route resolution imports ([#17056](https://github.com/sveltejs/kit/pull/17056)) - fix: read the error status of `App.Error` in the `prerender` and `query.live` remote functions ([#16529](https://github.com/sveltejs/kit/pull/16529)) - fix: resolve remote modules as external during dev prebundling so packages can re-export remote functions ([#16426](https://github.com/sveltejs/kit/pull/16426)) - chore: standardize remote-function and shared form diagnostics ([#17277](https://github.com/sveltejs/kit/pull/17277)) - fix: avoid `Promise.withResolvers` in client remote functions for older browser support ([#16777](https://github.com/sveltejs/kit/pull/16777)) - fix: propagate errors from prerendered remote responses instead of re-running the function ([#16535](https://github.com/sveltejs/kit/pull/16535)) - chore: remove unused helpers ([#16834](https://github.com/sveltejs/kit/pull/16834)) - fix: allow reserved words (e.g. `delete`, `class`) as remote function export names ([#16264](https://github.com/sveltejs/kit/pull/16264)) - fix: reset failed `<svelte:boundary>` on client navigation so a stale `+error.svelte` is torn down ([#16296](https://github.com/sveltejs/kit/pull/16296)) - fix: clear `navigating` when a shallow popstate aborts an in-flight navigation ([#17118](https://github.com/sveltejs/kit/pull/17118)) - fix: expand `[x+nn]` and `[u+nnnn]` escape sequences when resolving a route id to a pathname ([#16570](https://github.com/sveltejs/kit/pull/16570)) - fix: respect user-set `server.cors` and `preview.cors` config instead of overriding them ([#16924](https://github.com/sveltejs/kit/pull/16924)) - fix: respect the status returned from `handleError` on the fallback error page served to error-page sub-requests ([#16528](https://github.com/sveltejs/kit/pull/16528)) - fix: restore scroll position after back-forward cache returns ([#17255](https://github.com/sveltejs/kit/pull/17255)) - fix: warn if there are plugins using `transformIndexHtml` ([#16394](https://github.com/sveltejs/kit/pull/16394)) - fix: refetch route-tracking server data when navigating away from an error page ([#16381](https://github.com/sveltejs/kit/pull/16381)) - fix: allow routes to contain `[` and `]` via the `[x+5b]` and `[x+5d]` escapes ([#16569](https://github.com/sveltejs/kit/pull/16569)) - chore: use `Response.json` instead of the deprecated `json` helper in runtime responses ([#16804](https://github.com/sveltejs/kit/pull/16804)) - fix: recommend safe include and exclude patterns in tsconfig warning ([#17102](https://github.com/sveltejs/kit/pull/17102)) - chore: remove dependency on kleur ([#12548](sveltejs/kit#12548)) - fix: prevent server-side self-fetch fallbacks from following redirects ([#17293](sveltejs/kit#17293)) - fix: serialize `query(...).set(...)`/`query(...).refresh()` values into the rendered HTML when called from within a query during SSR ([#16461](sveltejs/kit#16461)) - chore: configure the server runtime in one place, deprecate `Server` in favour of the `server` object written by `builder.generateServerInstance` ([#17000](https://github.com/sveltejs/kit/pull/17000)) - chore: derive `content-length` from fixed response bodies in `setResponse` ([#16794](https://github.com/sveltejs/kit/pull/16794)) - fix: correctly read zero-length files at the end of a binary form payload ([#16783](sveltejs/kit#16783)) - fix: reject fallback handlers on prerendered endpoints ([#17140](https://github.com/sveltejs/kit/pull/17140)) - fix: don't destroy partial-line app output with the prerender progress line ([#16750](https://github.com/sveltejs/kit/pull/16750)) - chore: remove virtual modules ([#16813](https://github.com/sveltejs/kit/pull/16813)) - fix: surface prerender errors during development ([#16507](https://github.com/sveltejs/kit/pull/16507)) - chore: bump `cookie` to 2.0.1 ([#16745](sveltejs/kit#16745)) - fix: detect `$app/server` and `$app/env/private` client imports when SvelteKit is installed inside the project root ([#16648](https://github.com/sveltejs/kit/pull/16648)) - chore: read `options` from a single module instead of passing it through the server runtime ([#16871](https://github.com/sveltejs/kit/pull/16871)) - fix: wait for the redirect navigation before prerendered remote functions resolve ([#16765](sveltejs/kit#16765)) - fix: sort directory entries when building the route manifest so node indices are deterministic across runtimes (e.g. Bun and Node) ([#16074](https://github.com/sveltejs/kit/pull/16074)) - fix: skip unnecessary `version.json` checks if `updated.current` is already `true` ([#16518](https://github.com/sveltejs/kit/pull/16518)) - fix: allow generation of $app/tsconfig without TypeScript installed ([#16534](https://github.com/sveltejs/kit/pull/16534)) - chore: remove dependency on `set-cookie-parser` ([#15384](https://github.com/sveltejs/kit/pull/15384)) - chore: share the nearest error page walk between client and server ([#16774](https://github.com/sveltejs/kit/pull/16774)) - fix: fall back to the page's form actions when a sibling endpoint has no POST handler ([#16349](https://github.com/sveltejs/kit/pull/16349)) - fix: record client output extensions in `builder.mimeTypes` ([#16908](https://github.com/sveltejs/kit/pull/16908)) - perf: use a `Set` to check element ids when validating fragment links during prerendering ([#16494](https://github.com/sveltejs/kit/pull/16494)) - fix: preserve shared client chunk hashes when the app version changes ([#16324](https://github.com/sveltejs/kit/pull/16324)) - fix: include hoisted packages in Vite's `server.fs.allow` list ([#15998](https://github.com/sveltejs/kit/pull/15998)) - chore: standardize app template diagnostics ([#17250](https://github.com/sveltejs/kit/pull/17250)) - chore: standardize Vite plugin, build, prerender and adapter diagnostics ([#17253](sveltejs/kit#17253)) - chore: standardize client navigation, preload, snapshot and enhancement diagnostics ([#17276](https://github.com/sveltejs/kit/pull/17276)) - chore: standardize configuration, environment and tsconfig diagnostics ([#17251](https://github.com/sveltejs/kit/pull/17251)) - chore: standardize public API, `$app/*` and deprecated module diagnostics ([#17265](https://github.com/sveltejs/kit/pull/17265)) - chore: standardize route discovery, parameter and route export diagnostics ([#17252](https://github.com/sveltejs/kit/pull/17252)) - chore: standardize server request, hook and page diagnostics ([#17275](https://github.com/sveltejs/kit/pull/17275)) - fix: preserve metadata on streamed page responses ([#16935](https://github.com/sveltejs/kit/pull/16935)) - fix: only include `_app/immutable` files in `$app/manifest`'s `immutable` in the service worker ([#16531](sveltejs/kit#16531)) - chore: remove the dead `SSRState.fallback` field and name the server state fork semantics ([#16598](https://github.com/sveltejs/kit/pull/16598)) - fix: atomically replace route metadata during sync ([#17096](https://github.com/sveltejs/kit/pull/17096)) - fix: import resolved peer dependencies as file URLs so project-relative resolution works on Windows ([#16618](https://github.com/sveltejs/kit/pull/16618)) - fix: preserve sourcemap source paths when adapters copy build output ([#17082](https://github.com/sveltejs/kit/pull/17082)) - fix: log errors caught by the Vite dev server handler ([#16550](https://github.com/sveltejs/kit/pull/16550)) - chore: bump `acorn` to 8.18.0 ([#16745](sveltejs/kit#16745)) - fix: resolve `root` per instance of the SvelteKit Vite plugin ([#16513](https://github.com/sveltejs/kit/pull/16513)) - fix: report tsconfig parse errors on Windows ([#17251](https://github.com/sveltejs/kit/pull/17251)) - fix: return root layout server data for error-page data requests to non-existent routes ([#16376](https://github.com/sveltejs/kit/pull/16376)) - fix: prevent prerender crawler from hanging on unterminated unquoted attributes ([#17141](https://github.com/sveltejs/kit/pull/17141)) - fix: prevent `await_reactivity_loss` warning and `state_unsafe_mutation` error when the new version detector runs after an `await` ([#16915](https://github.com/sveltejs/kit/pull/16915)) - fix: redact nested and typed underscore-prefixed remote form fields after invalid submissions ([#17128](https://github.com/sveltejs/kit/pull/17128)) - fix: ignore path casing differences when warning about overridden Vite config on Windows ([#16545](https://github.com/sveltejs/kit/pull/16545)) - fix: return a lightweight 404 instead of rendering the error page for subresource requests ([#16463](https://github.com/sveltejs/kit/pull/16463)) - fix: preserve stripped path prefixes by making trailing-slash redirects relative ([#16431](https://github.com/sveltejs/kit/pull/16431)) - fix: preserve the current URL search parameters when submitting a remote form without JavaScript ([#16373](https://github.com/sveltejs/kit/pull/16373)) - fix: only treat files in node\_modules as remote modules when the package has a peer dependency on [@sveltejs/kit](https://github.com/sveltejs/kit) ([#16492](https://github.com/sveltejs/kit/pull/16492)) - fix: treeshake prerendered remote functions in the right chunks ([#16533](https://github.com/sveltejs/kit/pull/16533)) - fix: correctly serialize Node.js buffers returned from remote functions during SSR ([#17158](https://github.com/sveltejs/kit/pull/17158)) - fix: preserve errors with read-only stack properties ([#17180](https://github.com/sveltejs/kit/pull/17180)) - chore: deduplicate type-stripping logic in `tweak_types` ([#16454](https://github.com/sveltejs/kit/pull/16454)) - fix: avoid infinite loop when building with `--watch` flag ([#16632](https://github.com/sveltejs/kit/pull/16632)) - chore: unify the `walk` and `list_files` filesystem helpers ([#16784](https://github.com/sveltejs/kit/pull/16784)) - fix: error during development if the adapter does not support instrumentation and it exists ([#16548](https://github.com/sveltejs/kit/pull/16548)) - fix: use mouseover+mousemove for preloading to reduce events ([#16325](https://github.com/sveltejs/kit/pull/16325)) - fix: reject invalid binary form file metadata ([#17149](https://github.com/sveltejs/kit/pull/17149)) - fix: error on server-only imports reachable from hooks or service worker files outside the project root ([#16912](https://github.com/sveltejs/kit/pull/16912)) - fix: write generated tsconfig to `node_modules/$app/tsconfig.json` so that tools with simplified tsconfig resolution can find it ([#16589](https://github.com/sveltejs/kit/pull/16589)) - chore: emit env modules to disk ([#16807](https://github.com/sveltejs/kit/pull/16807)) - fix: more informative error message when running a command inside a query or prerender function ([#17293](sveltejs/kit#17293)) - fix: adjust error overload for optional `App.Error` parameters ([#16725](https://github.com/sveltejs/kit/pull/16725)) - fix: prerender and crawl pages whose `content-type` header carries a `charset` parameter ([#16567](https://github.com/sveltejs/kit/pull/16567)) - fix: stream promised `read` results lazily instead of eagerly buffering them ([#16622](https://github.com/sveltejs/kit/pull/16622)) - fix: copy worker files emitted by the server build to the client output directory ([#16929](https://github.com/sveltejs/kit/pull/16929)) - chore: parse page options and remote modules with Vite's `parseSync` instead of `acorn` ([#16947](https://github.com/sveltejs/kit/pull/16947)) - fix: correctly decode `[u+nnnn]` escape sequences above `ffff` ([#16611](sveltejs/kit#16611)) - fix: Reject all pending query promises when a query fails before resolving with a value for the first time ([#16890](https://github.com/sveltejs/kit/pull/16890)) </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate CLI](https://github.com/renovatebot/renovate).  Co-authored-by: Davide Zarantonello <davide@zarantonello.dev>

breaking: delete $service-worker module

3118b79

Rich-Harris mentioned this pull request Jul 21, 2026

breaking: overhaul tsconfig #16458

Merged

9 tasks done

Rich-Harris added 6 commits July 24, 2026 10:26

merge version-3

43cc2b7

regenerate

ddfabd6

fix

d7a3fdc

use removed() helper for serviceWorker.files option. if we need to br…

301cf06

…ing the functionality back to `$app/manifest`, we can

update docs

71204d1

typo

345ffda

Rich-Harris marked this pull request as ready for review July 24, 2026 16:44

vercel Bot reviewed Jul 24, 2026

View reviewed changes

Comment thread documentation/docs/30-advanced/40-service-workers.md Outdated

Comment thread documentation/docs/30-advanced/40-service-workers.md Outdated

vercel Bot and others added 4 commits July 24, 2026 16:54

fix

5425535

Merge branch 'delete-service-worker-module' of https://github.com/sve…

6d3f092

…ltejs/kit into delete-service-worker-module

elliott-with-the-longest-name-on-github approved these changes Jul 24, 2026

View reviewed changes

Comment thread documentation/docs/30-advanced/40-service-workers.md

Comment thread documentation/docs/30-advanced/40-service-workers.md

Comment thread packages/kit/src/exports/vite/index.js Outdated

Rich-Harris added 2 commits July 24, 2026 14:54

apply import guard to service worker

5fee7fd

prevent invalid imports into service worker

5cd21ae

vercel Bot reviewed Jul 24, 2026

View reviewed changes

Comment thread packages/kit/src/exports/vite/index.js Outdated

Rich-Harris and others added 2 commits July 24, 2026 15:38

lockfile

094aac0

Rich-Harris merged commit 5ae11a1 into version-3 Jul 24, 2026
20 of 21 checks passed

Rich-Harris deleted the delete-service-worker-module branch July 24, 2026 20:59

github-actions Bot mentioned this pull request Jul 24, 2026

Version Packages (next) #16435

Merged

teemingc linked an issue Jul 24, 2026 that may be closed by this pull request

Revisit service worker modules #16159

Closed

teemingc mentioned this pull request Jul 24, 2026

Revisit service worker modules #16159

Closed

Michael-Obele mentioned this pull request Jul 28, 2026

Integrate PWA Vite for Automated Service Worker Generation Michael-Obele/Svelte-MiniApps#3

Closed

Nic-Polumeyv mentioned this pull request Aug 3, 2026

docs: add migration guide #16505

Merged

manuel3108 mentioned this pull request Aug 7, 2026

sv migrate sveltejs/cli#1124

Closed

Nic-Polumeyv mentioned this pull request Aug 17, 2026

chore: remove unused helpers #16834

Merged

Rich-Harris pushed a commit that referenced this pull request Aug 18, 2026

chore: remove unused helpers (#16834)

e4876e9

`utils/path.js` lost its only importer in #16374, `decode_params` in #16189, `strip_virtual_prefix` in #16450.

Navigation Menu

Repository navigation

breaking: delete `$service-worker` module - #16450

breaking: delete `$service-worker` module#16450
Rich-Harris merged 15 commits into
version-3from
delete-service-worker-module

Rich-Harris commented Jul 20, 2026 •

edited

Loading

Uh oh!

pkg-svelte-dev Bot commented Jul 20, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Jul 20, 2026 •

edited

Loading

Uh oh!

svelte-docs-bot Bot commented Jul 20, 2026

Uh oh!

ottomated commented Jul 20, 2026

Uh oh!

teemingc commented Jul 21, 2026

Uh oh!

Rich-Harris commented Jul 21, 2026

Uh oh!

Uh oh!

Uh oh!

elliott-with-the-longest-name-on-github left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Rich-Harris commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

Tests

Changesets

Edits

Uh oh!

pkg-svelte-dev Bot commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

svelte-docs-bot Bot commented Jul 20, 2026

Uh oh!

ottomated commented Jul 20, 2026

Uh oh!

teemingc commented Jul 21, 2026

Uh oh!

Rich-Harris commented Jul 21, 2026

Uh oh!

Uh oh!

Uh oh!

elliott-with-the-longest-name-on-github left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Rich-Harris commented Jul 20, 2026 •

edited

Loading

pkg-svelte-dev Bot commented Jul 20, 2026 •

edited

Loading

changeset-bot Bot commented Jul 20, 2026 •

edited

Loading