@sveltejs/kit 3.0.0-next.17 → 3.0.0-next.19

package/src/exports/public.d.ts

@@ -24,18 +24,28 @@ import { BuildData, SSRNodeLoader, SSRRoute, ValidatedConfig } from 'types';
 import { SvelteConfig } from '@sveltejs/vite-plugin-svelte';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Plugin } from 'vite';
-import {
-	RouteId as AppRouteId,
-	LayoutParams as AppLayoutParams,
-	ResolvedPathname
-} from '$app/types';
+import { RouteId as AppRouteId, LayoutParams as AppLayoutParams } from '$app/types';
+import { ParamMatcher } from '@sveltejs/kit/params';
 
 export { PrerenderOption } from '../types/private.js';
 
 // @ts-ignore this is an optional peer dependency so could be missing. Written like this so dts-buddy preserves the ts-ignore
 type Span = import('@opentelemetry/api').Span;
 
-type AppErrorWithOptionalStatus = Omit<App.Error, 'status'> & { status?: App.Error['status'] };
+type AppErrorWithOptionalDefaults = Omit<App.Error, 'status' | 'message'> & {
+	status?: App.Error['status'];
+	message?: App.Error['message'];
+};
+
+/**
+ * `void` is only a valid `handleError` return when `App.Error` adds no required properties
+ * beyond `status` and `message` — both of which are optional in the return, since they default
+ * to those of the caught error. If `App.Error` is augmented with required properties, the hook
+ * must return them, so returning nothing becomes a type error.
+ */
+type VoidIfNoRequiredAppErrorProperties = { status: number; message: string } extends App.Error
+	? void
+	: never;
 
 /**
  * [Adapters](https://svelte.dev/docs/kit/adapters) are responsible for taking the production build and turning it into something that can be deployed to a platform of your choosing.
@@ -72,11 +82,18 @@ export interface Adapter {
 	 */
 	emulate?: () => MaybePromise<Emulator>;
 	vite?: {
-		/**
-		 * Plugins provided by the adapter are placed before any of SvelteKit's own plugins.
-		 * @since 3.0.0
-		 */
-		plugins?: Plugin[];
+		plugins?: {
+			/**
+			 * Vite plugins placed before any of SvelteKit's own plugins.
+			 * @since 3.0.0
+			 */
+			pre?: Plugin[];
+			/**
+			 * Vite plugins placed after any of SvelteKit's own plugins.
+			 * @since 3.0.0
+			 */
+			post?: Plugin[];
+		};
 	};
 }
 
@@ -460,7 +477,10 @@ export interface KitConfig {
 		 *
 		 * CSRF checks only apply in production, not in local development.
 		 * @default []
-		 * @example ['https://checkout.stripe.com', 'https://accounts.google.com']
+		 * @example
+		 * ```js
+		 * ['https://checkout.stripe.com', 'https://accounts.google.com']
+		 * ```
 		 */
 		trustedOrigins?: string[];
 	};
@@ -940,45 +960,76 @@ export type Handle = (input: {
 	resolve: (event: RequestEvent, opts?: ResolveOptions) => Promise<Response>;
 }) => MaybePromise<Response>;
 
+type CaughtErrorMap = {
+	app: App.Error;
+	framework: { status: number; message: string };
+	unknown: unknown;
+};
+
+type ValidationCaughtError<Issue extends StandardSchemaV1.Issue> = {
+	kind: 'validation';
+	error: { status: number; message: string };
+	issues: Issue[];
+};
+
 /**
- * The server-side [`handleError`](https://svelte.dev/docs/kit/hooks#handleError) hook runs when an unexpected error is thrown while responding to a request.
- *
- * If an unexpected error is thrown during loading or rendering, this function will be called with the error and the event.
- * Make sure that this function _never_ throws an error.
- *
- * The returned object can include a `status` property to override the HTTP status code used in the response.
- * If omitted, the status defaults to 500.
+ * The error passed to the [`handleError`](https://svelte.dev/docs/kit/hooks#handleError) hooks.
+ * Use the `kind` discriminant to distinguish errors from your app (thrown with the
+ * [`error`](https://svelte.dev/docs/kit/errors#App-errors) helper), errors generated by
+ * SvelteKit itself (such as 404s), validation errors, and unknown errors (thrown by your code,
+ * or code it calls).
  */
-export type HandleServerError = (input: {
-	error: unknown;
-	event: RequestEvent;
-	status: number;
-	message: string;
-}) => MaybePromise<void | AppErrorWithOptionalStatus>;
+export type CaughtError<Issue extends StandardSchemaV1.Issue = StandardSchemaV1.Issue> =
+	| {
+			[Kind in keyof CaughtErrorMap]: {
+				/** Identifies the category and origin of the error */
+				kind: Kind;
+				/** The caught error. Its type depends on `kind` */
+				error: CaughtErrorMap[Kind];
+				/** Only present for validation errors */
+				issues?: undefined;
+			};
+	  }[keyof CaughtErrorMap]
+	| ValidationCaughtError<Issue>;
+
+/** The error passed to the client-side `handleError` hook. */
+export type ClientCaughtError = Exclude<CaughtError, { kind: 'validation' }>;
 
 /**
- * The [`handleValidationError`](https://svelte.dev/docs/kit/hooks#handleValidationError) hook runs when the argument to a remote function fails validation.
+ * The server-side [`handleError`](https://svelte.dev/docs/kit/hooks#handleError) hook runs for every error thrown while responding to a request, except redirects.
+ *
+ * The `kind` property discriminates between _app_ errors (thrown with the [`error`](https://svelte.dev/docs/kit/errors#App-errors) helper),
+ * _framework_ errors (generated by SvelteKit itself, such as 404s), _validation_ errors (caused by invalid remote function arguments)
+ * and _unknown_ errors (thrown by your code, or code it calls).
+ *
+ * The hook returns an object matching `App.Error`, in which `status` and `message` are optional — return them only to
+ * override the defaults. Omitted properties are inherited from the caught error: the body passed to `error(...)` for app errors,
+ * the status and safe message for framework and validation errors, and `500`/`'Internal Error'` for unknown errors. Return nothing to
+ * keep the defaults entirely (if you augment `App.Error` with required properties, you must return those).
  *
- * It will be called with the validation issues and the event, and must return an object shape that matches `App.Error`.
+ * Make sure that this function _never_ throws an error.
  */
-export type HandleValidationError<Issue extends StandardSchemaV1.Issue = StandardSchemaV1.Issue> =
-	(input: { issues: Issue[]; event: RequestEvent }) => MaybePromise<AppErrorWithOptionalStatus>;
+export type HandleServerError<Issue extends StandardSchemaV1.Issue = StandardSchemaV1.Issue> = (
+	input: CaughtError<Issue> & { event: RequestEvent }
+) => MaybePromise<AppErrorWithOptionalDefaults | VoidIfNoRequiredAppErrorProperties>;
 
 /**
- * The client-side [`handleError`](https://svelte.dev/docs/kit/hooks#handleError) hook runs when an unexpected error is thrown while navigating.
+ * The client-side [`handleError`](https://svelte.dev/docs/kit/hooks#handleError) hook runs for every error thrown while navigating, except redirects.
+ * Errors that were already transformed by the server-side hook are not passed to it a second time.
  *
- * If an unexpected error is thrown during loading or the following render, this function will be called with the error and the event.
- * Make sure that this function _never_ throws an error.
+ * The `kind` property discriminates between _app_ errors (thrown with the [`error`](https://svelte.dev/docs/kit/errors#App-errors) helper),
+ * _framework_ errors (generated by SvelteKit itself, such as 404s) and _unknown_ errors (thrown by your code, or code it calls).
  *
- * The returned object can include a `status` property to override the HTTP status code used in the response.
- * If omitted, the status defaults to 500.
+ * The hook returns an object matching `App.Error`, in which `status` and `message` are optional — return them only to
+ * override the defaults. Omitted properties are inherited from the caught error: the body passed to `error(...)` for app errors,
+ * the status and safe message for framework errors, and `500`/`'Internal Error'` for unknown errors. Return nothing to
+ * keep the defaults entirely (if you augment `App.Error` with required properties, you must return those).
+ *
+ * Make sure that this function _never_ throws an error.
  */
-export type HandleClientError = (input: {
-	error: unknown;
-	event: NavigationEvent;
-	status: number;
-	message: string;
-}) => MaybePromise<void | AppErrorWithOptionalStatus>;
+export type HandleClientError = (
+	input: ClientCaughtError & { event: NavigationEvent }
+) => MaybePromise<AppErrorWithOptionalDefaults | VoidIfNoRequiredAppErrorProperties>;
 
 /**
  * The [`handleFetch`](https://svelte.dev/docs/kit/hooks#handleFetch) hook allows you to modify (or replace) the result of an [`event.fetch`](https://svelte.dev/docs/kit/load#Making-fetch-requests) call that runs on the server (or during prerendering) inside an endpoint, `load`, `action`, `handle`, `handleError` or `reroute`.
@@ -1204,355 +1255,6 @@ export interface NavigationEvent<
 	url: URL;
 }
 
-/**
- * Information about the target of a specific navigation.
- */
-export interface NavigationTarget<
-	Params extends AppLayoutParams<'/'> = AppLayoutParams<'/'>,
-	RouteId extends AppRouteId | null = AppRouteId | null
-> {
-	/**
-	 * Parameters of the target page - e.g. for a route like `/blog/[slug]`, a `{ slug: string }` object.
-	 * Is `null` if the target is not part of the SvelteKit app (could not be resolved to a route).
-	 */
-	params: Params | null;
-	/**
-	 * Info about the target route
-	 */
-	route: {
-		/**
-		 * The ID of the current route - e.g. for `src/routes/blog/[slug]`, it would be `/blog/[slug]`. It is `null` when no route is matched.
-		 */
-		id: RouteId | null;
-	};
-	/**
-	 * The URL that is navigated to
-	 */
-	url: URL;
-	/**
-	 * The scroll position associated with this navigation.
-	 *
-	 * For the `from` target, this is the scroll position at the moment of navigation.
-	 *
-	 * For the `to` target, this represents the scroll position that will be or was restored:
-	 * - In `beforeNavigate` and `onNavigate`, this is only available for `popstate` navigations (back/forward button)
-	 *   and will be `null` for other navigation types, since the final scroll position isn't known
-	 *   ahead of time.
-	 * - In `afterNavigate`, this is always the scroll position that was applied after the navigation
-	 *   completed.
-	 */
-	scroll: { x: number; y: number } | null;
-}
-
-export interface GotoOptions {
-	/**
-	 * If `true`, replaces the current history entry rather than creating a new one.
-	 * @default false
-	 */
-	replace?: boolean;
-	/** @deprecated Use `replace` instead. */
-	replaceState?: boolean;
-	/**
-	 * If `true`, updates the URL and `page.state` without navigating.
-	 * @default false
-	 */
-	shallow?: boolean;
-	/**
-	 * If `true`, resets the scroll position (to the top of the page, or to the element
-	 * matching the URL's `#hash` if there is one) and resets focus (to the `<body>`, or the
-	 * `autofocus` element if there is one) once the navigation completes.
-	 *
-	 * If `false`, the current scroll position and focused element are left alone.
-	 * @default true, or false when `shallow` is true
-	 */
-	reset?: boolean;
-	/**
-	 * If `true`, reruns all `load` functions and queries of the page.
-	 * @default false
-	 */
-	refreshAll?: boolean;
-	/** Causes any `load` functions to rerun if they depend on one of the URLs. */
-	invalidate?: Array<string | URL | ((url: URL) => boolean)>;
-	/** @deprecated Use `refreshAll` instead. */
-	invalidateAll?: boolean;
-	/** An optional object that will be available as `page.state`. */
-	state?: App.PageState;
-	/**
-	 * If `true`, `page.state` will be restored after a full page reload.
-	 * @default false
-	 */
-	persistState?: boolean;
-}
-
-/**
- * - `enter`: The app has hydrated/started
- * - `form`: The user submitted a `<form method="GET">`
- * - `goto`: Navigation was triggered by a `goto(...)` call or a redirect
- * - `leave`: The app is being left either because the tab is being closed or a navigation to a different document is occurring
- * - `link`: Navigation was triggered by a link click
- * - `popstate`: Navigation was triggered by back/forward navigation
- */
-export type NavigationType = 'enter' | 'form' | 'leave' | 'link' | 'goto' | 'popstate';
-
-export interface NavigationBase {
-	/**
-	 * The type of navigation:
-	 * - `enter`: The app has hydrated/started
-	 * - `form`: The user submitted a `<form method="GET">`
-	 * - `goto`: Navigation was triggered by a `goto(...)` call or a redirect
-	 * - `leave`: The app is being left either because the tab is being closed or a navigation to a different document is occurring
-	 * - `link`: Navigation was triggered by a link click
-	 * - `popstate`: Navigation was triggered by back/forward navigation
-	 */
-	type: NavigationType;
-	/** Whether this is a shallow navigation. */
-	shallow: boolean;
-	/**
-	 * Where navigation was triggered from
-	 */
-	from: NavigationTarget | null;
-	/**
-	 * Where navigation is going to/has gone to
-	 */
-	to: NavigationTarget | null;
-	/**
-	 * Whether or not the navigation will result in the page being unloaded (i.e. not a client-side navigation).
-	 */
-	willUnload: boolean;
-	/**
-	 * A promise that resolves once the navigation is complete, and rejects if the navigation
-	 * fails or is aborted. In the case of a `willUnload` navigation, the promise will never resolve
-	 */
-	complete: Promise<void>;
-}
-
-/**
- * The navigation that occurs when the app starts/hydrates
- */
-export interface NavigationEnter extends NavigationBase {
-	type: 'enter';
-
-	/**
-	 * In case of a history back/forward navigation, the number of steps to go back/forward
-	 */
-	delta?: undefined;
-
-	/**
-	 * Dispatched `Event` object when navigation occurred by `popstate` or `link`.
-	 */
-	event?: undefined;
-}
-
-export type NavigationExternal = NavigationGoto | NavigationLeave;
-
-/**
- * A navigation triggered by a `goto(...)` call or a redirect
- */
-export interface NavigationGoto extends NavigationBase {
-	type: 'goto';
-}
-
-/**
- * A navigation triggered by the tab being closed, or the user navigating to a different document
- */
-export interface NavigationLeave extends NavigationBase {
-	type: 'leave';
-}
-
-/**
- * A navigation triggered by a `<form method="GET">`
- */
-export interface NavigationFormSubmit extends NavigationBase {
-	type: 'form';
-
-	/**
-	 * The `SubmitEvent` that caused the navigation
-	 */
-	event: SubmitEvent;
-}
-
-/**
- * A navigation triggered by back/forward navigation
- */
-export interface NavigationPopState extends NavigationBase {
-	type: 'popstate';
-
-	/**
-	 * In case of a history back/forward navigation, the number of steps to go back/forward
-	 */
-	delta: number;
-
-	/**
-	 * The `PopStateEvent` that caused the navigation
-	 */
-	event: PopStateEvent;
-}
-
-/**
- * A navigation triggered by a link click
- */
-export interface NavigationLink extends NavigationBase {
-	type: 'link';
-
-	/**
-	 * The `PointerEvent` that caused the navigation
-	 */
-	event: PointerEvent;
-}
-
-export type Navigation =
-	NavigationExternal | NavigationFormSubmit | NavigationPopState | NavigationLink;
-
-/**
- * The argument passed to [`beforeNavigate`](https://svelte.dev/docs/kit/$app-navigation#beforeNavigate) callbacks.
- */
-export type BeforeNavigate = Navigation & {
-	/**
-	 * Call this to prevent the navigation from starting.
-	 */
-	cancel: () => void;
-};
-
-/**
- * The argument passed to [`onNavigate`](https://svelte.dev/docs/kit/$app-navigation#onNavigate) callbacks.
- */
-export type OnNavigate = Navigation & {
-	type: Exclude<NavigationType, 'enter' | 'leave'>;
-	/**
-	 * Since `onNavigate` callbacks are called immediately before a client-side navigation, they will never be called with a navigation that unloads the page.
-	 */
-	willUnload: false;
-};
-
-/**
- * The argument passed to [`afterNavigate`](https://svelte.dev/docs/kit/$app-navigation#afterNavigate) callbacks.
- */
-export type AfterNavigate = (Navigation | NavigationEnter) & {
-	type: Exclude<NavigationType, 'leave'>;
-	/**
-	 * Since `afterNavigate` callbacks are called after a navigation completes, they will never be called with a navigation that unloads the page.
-	 */
-	willUnload: false;
-};
-
-/**
- * The shape of the [`page`](https://svelte.dev/docs/kit/$app-state#page) reactive object.
- */
-export interface Page<
-	Params extends AppLayoutParams<'/'> = AppLayoutParams<'/'>,
-	RouteId extends AppRouteId | null = AppRouteId | null
-> {
-	/**
-	 * The URL of the current page.
-	 */
-	url: ReadonlyURL & { readonly pathname: ResolvedPathname | (string & {}) };
-	/**
-	 * The parameters of the current page - e.g. for a route like `/blog/[slug]`, a `{ slug: string }` object.
-	 */
-	params: Params;
-	/**
-	 * Info about the current route.
-	 */
-	route: {
-		/**
-		 * The ID of the current route - e.g. for `src/routes/blog/[slug]`, it would be `/blog/[slug]`. It is `null` when no route is matched.
-		 */
-		id: RouteId;
-	};
-	/**
-	 * HTTP status code of the current page.
-	 */
-	status: number;
-	/**
-	 * The error object of the current page, if any. Filled from the `handleError` hooks.
-	 */
-	error: App.Error | null;
-	/**
-	 * The merged result of all data from all `load` functions on the current page. You can type a common denominator through `App.PageData`.
-	 */
-	data: App.PageData & Record<string, any>;
-	/**
-	 * The page state, which can be manipulated using [`goto`](https://svelte.dev/docs/kit/$app-navigation#goto) from `$app/navigation`.
-	 */
-	state: App.PageState;
-	/**
-	 * Information about the target of the current shallow navigation, or `null` if no shallow navigation has occurred.
-	 */
-	shallow: {
-		/** Parameters of the target route, or `null` if the URL does not resolve to a route. */
-		params: AppLayoutParams<'/'> | null;
-		/** Info about the target route, or `null` if the URL does not resolve to a route. */
-		route: { id: AppRouteId } | null;
-		/** The normalized URL passed to `goto(..., { shallow: true })`. */
-		url: ReadonlyURL;
-	} | null;
-	/**
-	 * Filled only after a form submission. See [form actions](https://svelte.dev/docs/kit/form-actions) for more info.
-	 */
-	form: any;
-}
-
-/**
- * The shape of a param matcher. See [matching](https://svelte.dev/docs/kit/advanced-routing#Matching) for more info.
- */
-export type ParamMatcher<Output = any> = StandardSchemaV1<string, Output>;
-
-/**
- * A value that can be parsed from a URL param and losslessly encoded with `String(...)`.
- */
-export type ParamValue = string | number | boolean | bigint;
-
-/**
- * A param matcher definition passed to [`defineParams`](https://svelte.dev/docs/kit/@sveltejs-kit#defineParams).
- */
-export type ParamDefinition =
-	((param: string) => ParamValue | undefined) | StandardSchemaV1<string, ParamValue>;
-
-/**
- * The return type of [`defineParams`](https://svelte.dev/docs/kit/@sveltejs-kit#defineParams).
- */
-export type DefinedParams<T extends Record<string, ParamDefinition>> = {
-	readonly [K in keyof T]: ParamEntry<T[K]>;
-};
-
-/**
- * Normalizes a property of defineParams (schema or function) to standard schema.
- */
-type ParamEntry<M> =
-	M extends StandardSchemaV1<any, any>
-		? StandardSchemaV1.InferOutput<M> extends ParamValue
-			? StandardSchemaV1<any, M>
-			: StandardSchemaV1<any, never>
-		: M extends (param: string) => infer R
-			? Exclude<R, undefined> extends ParamValue
-				? StandardSchemaV1<any, Exclude<R, undefined>>
-				: StandardSchemaV1<any, never>
-			: never;
-
-/**
- * Extracts the param type from a matcher.
- */
-export type MatcherParam<M extends StandardSchemaV1<any, any>> =
-	M extends StandardSchemaV1<any, infer Inner>
-		? Inner extends ParamValue
-			? Inner
-			: Inner extends StandardSchemaV1<any, any>
-				? StandardSchemaV1.InferOutput<Inner> extends ParamValue
-					? StandardSchemaV1.InferOutput<Inner>
-					: never
-				: never
-		: never;
-
-/**
- * Define [parameter matchers](https://svelte.dev/docs/kit/advanced-routing#Matching) for your app.
- *
- * @template T
- * @param definitions
- */
-export function defineParams<T extends Record<string, ParamDefinition>>(
-	definitions: T
-): DefinedParams<T>;
-
 /**
  * A single entry yielded by [`requested`](https://svelte.dev/docs/kit/$app-server#requested)
  * when called with a regular `query`. `arg` is the validated argument (the input *after*
@@ -1611,7 +1313,8 @@ export type LiveQueryRequestedResult<Validated, Output> = Iterable<
 	};
 
 export type RequestedResult<Validated, Output> =
-	QueryRequestedResult<Validated, Output> | LiveQueryRequestedResult<Validated, Output>;
+	| QueryRequestedResult<Validated, Output>
+	| LiveQueryRequestedResult<Validated, Output>;
 
 export interface RequestEvent<
 	Params extends AppLayoutParams<'/'> = AppLayoutParams<'/'>,
@@ -1932,30 +1635,6 @@ export type Actions<
 	RouteId extends AppRouteId | null = AppRouteId | null
 > = Record<string, Action<Params, OutputData, RouteId>>;
 
-/**
- * When calling a form action via fetch, the response will be one of these shapes.
- * ```svelte
- * <form method="post" use:enhance={() => {
- *   return ({ result }) => {
- * 		// result is of type ActionResult
- *   };
- * }}
- * ```
- *
- * Success and failure results carry the root-relative `pathname + search` of the action URL, with
- * the `?/actionName` parameter removed. Redirect results carry the redirect target. Server-generated
- * error results also carry the action location, while client-generated errors such as network
- * failures do not. `update` uses this location to emulate native form navigation.
- */
-export type ActionResult<
-	Success extends Record<string, unknown> | undefined = Record<string, any>,
-	Failure extends Record<string, unknown> | undefined = Record<string, any>
-> =
-	| { type: 'success'; status: number; data?: Success; location: string }
-	| { type: 'failure'; status: number; data?: Failure; location: string }
-	| { type: 'redirect'; status: number; location: string }
-	| { type: 'error'; status?: number; error: App.Error; location?: string };
-
 /**
  * The object returned by the [`error`](https://svelte.dev/docs/kit/@sveltejs-kit#error) function.
  */
@@ -1976,37 +1655,6 @@ export interface Redirect {
 	location: string;
 }
 
-export type SubmitFunction<
-	Success extends Record<string, unknown> | undefined = Record<string, any>,
-	Failure extends Record<string, unknown> | undefined = Record<string, any>
-> = (input: {
-	action: URL;
-	formData: FormData;
-	formElement: HTMLFormElement;
-	controller: AbortController;
-	submitter: HTMLElement | null;
-	cancel: () => void;
-}) => MaybePromise<
-	| void
-	| ((opts: {
-			formData: FormData;
-			formElement: HTMLFormElement;
-			action: URL;
-			result: ActionResult<Success, Failure>;
-			/**
-			 * Call this to get the default behavior of a form submission response.
-			 * @param options Set `reset: false` if you don't want the `<form>` values to be reset after a successful submission. `refreshAll` defaults to `true` for successful results and `false` for failures. When the submission navigates, setting it to `false` still runs the destination's `load` functions but may reuse shared layout data. Set `navigate: false` to apply non-redirect results to the current page instead of navigating to `result.location`. Redirects are always followed.
-			 */
-			update: (options?: {
-				reset?: boolean;
-				refreshAll?: boolean;
-				navigate?: boolean;
-				/** @deprecated Use `refreshAll` instead. */
-				invalidateAll?: boolean;
-			}) => Promise<void>;
-	  }) => MaybePromise<void>)
->;
-
 /**
  * The type of `export const snapshot` exported from a page or layout component.
  * @deprecated Use the [`snapshot`](https://svelte.dev/docs/kit/$app-navigation#snapshot) helper from `$app/navigation` instead.
@@ -2016,14 +1664,6 @@ export interface Snapshot<T = any> {
 	restore: (snapshot: T) => void;
 }
 
-export type ReadonlyURLSearchParams = Omit<URLSearchParams, 'set' | 'append' | 'delete' | 'sort'>;
-
-export type ReadonlyURL = Readonly<
-	Omit<URL, 'searchParams'> & {
-		searchParams: ReadonlyURLSearchParams;
-	}
->;
-
 // If T is unknown or has an index signature, the types below will recurse indefinitely and create giant unions that TS can't handle
 type WillRecurseIndefinitely<T> = unknown extends T ? true : string extends keyof T ? true : false;
 

package/src/exports/vite/build/build_server.js

@@ -1,4 +1,4 @@
-/** @import { AssetDependencies, ManifestData, SSRNode, ValidatedKitConfig } from 'types' */
+/** @import { AssetDependencies, ManifestData, ValidatedKitConfig } from 'types' */
 /** @import { Manifest, Rolldown } from 'vite' */
 import fs from 'node:fs';
 import {
@@ -118,7 +118,7 @@ export function build_server_nodes(
 		const imports = [];
 
 		// String representation of
-		/** @type {SSRNode} */
+		/* @type {SSRNode} */
 		/** @type {string[]} */
 		const exports = [`export const index = ${i};`];
 

package/src/exports/vite/dev/index.js

@@ -215,8 +215,7 @@ export async function dev(
 				),
 				nodes: manifest_data.nodes.map((node, index) => {
 					return async () => {
-						/** @type {SSRNode} */
-						const result = {};
+						const result = /** @type {SSRNode} */ ({});
 						result.index = index;
 						result.universal_id = node.universal;
 						result.server_id = node.server;
@@ -428,7 +427,7 @@ export async function dev(
 		// Don't run for a single file if the whole manifest is about to get updated
 		// Unless it's a file where the trailing slash page option might have changed
 		if (timeout || !/\+(page|layout|server).*$/.test(file)) return;
-		sync.update(svelte_config, manifest_data, file, root);
+		if (!sync.update(svelte_config, manifest_data, file, root)) debounce(update_manifest);
 	});
 
 	const { appTemplate, errorTemplate, serviceWorker, hooks } = svelte_config.kit.files;