@sveltejs/kit 2.63.0 → 3.0.0-next.1

package/src/core/sync/utils.js

@@ -1,12 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { mkdirp } from '../../utils/filesystem.js';
-import { import_peer } from '../../utils/import.js';
-
-/** @type {{ VERSION: string }} */
-const { VERSION } = await import_peer('svelte/compiler');
-
-const [MAJOR, MINOR] = VERSION.split('.').map(Number);
 
 /** @type {Map<string, string>} */
 const previous_contents = new Map();
@@ -74,12 +68,3 @@ export function dedent(strings, ...values) {
 
 	return str;
 }
-
-export function isSvelte5Plus() {
-	return MAJOR >= 5;
-}
-
-// TODO 3.0 remove this once we can bump the peerDep range
-export function supportsTrustedTypes() {
-	return (MAJOR === 5 && MINOR >= 51) || MAJOR > 5;
-}

package/src/core/sync/write_ambient.js

@@ -1,69 +1,18 @@
-import fs from 'node:fs';
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { get_env } from '../../exports/vite/utils.js';
 import { GENERATED_COMMENT } from '../../constants.js';
-import { create_dynamic_types, create_static_types } from '../env.js';
 import { write_if_changed } from './utils.js';
 
-// TODO these types should be described in a neutral place, rather than
-// inside either `packages/kit` or `svelte.dev/docs/kit`
-const descriptions_dir = fileURLToPath(new URL('../../../src/types/synthetic', import.meta.url));
-
-/** @param {string} filename */
-function read_description(filename) {
-	const content = fs.readFileSync(`${descriptions_dir}/${filename}`, 'utf8');
-	return `/**\n${content
-		.trim()
-		.split('\n')
-		.map((line) => ` * ${line}`)
-		.join('\n')}\n */`;
-}
-
-/**
- * @param {import('types').Env} env
- * @param {{
- * 	public_prefix: string;
- * 	private_prefix: string;
- * }} prefixes
- */
-const template = (env, prefixes) => `
-${GENERATED_COMMENT}
-
-/// <reference types="@sveltejs/kit" />
-
-${read_description('$env+static+private.md')}
-${create_static_types('private', env)}
-
-${read_description('$env+static+public.md')}
-${create_static_types('public', env)}
-
-${read_description('$env+dynamic+private.md')}
-${create_dynamic_types('private', env, prefixes)}
-
-${read_description('$env+dynamic+public.md')}
-${create_dynamic_types('public', env, prefixes)}
-`;
+// TODO get rid of this, it's useless
 
 /**
  * Writes ambient declarations including types reference to @sveltejs/kit,
  * and the existing environment variables in process.env to
  * $env/static/private and $env/static/public
  * @param {import('types').ValidatedKitConfig} config
- * @param {string} mode The Vite mode
  */
-export function write_ambient(config, mode) {
+export function write_ambient(config) {
 	/** @type {string} */
-	let content;
-
-	if (config.experimental.explicitEnvironmentVariables) {
-		content = `${GENERATED_COMMENT}\n/// <reference types="@sveltejs/kit" />`;
-	} else {
-		const env = get_env(config.env, mode);
-		const { publicPrefix: public_prefix, privatePrefix: private_prefix } = config.env;
-
-		content = template(env, { public_prefix, private_prefix });
-	}
+	const content = `${GENERATED_COMMENT}\n/// <reference types="@sveltejs/kit" />`;
 
 	write_if_changed(path.join(config.outDir, 'ambient.d.ts'), content);
 }

package/src/core/sync/write_client_manifest.js

@@ -1,8 +1,8 @@
 import path from 'node:path';
+import { styleText } from 'node:util';
 import { relative_path, resolve_entry } from '../../utils/filesystem.js';
 import { s } from '../../utils/misc.js';
-import { dedent, isSvelte5Plus, write_if_changed } from './utils.js';
-import colors from 'kleur';
+import { dedent, write_if_changed } from './utils.js';
 
 /**
  * Writes the client manifest to disk. The manifest is used to power the router. It contains the
@@ -126,12 +126,11 @@ export function write_client_manifest(kit, manifest_data, output, metadata) {
 	const typo = resolve_entry('src/+hooks.client');
 	if (typo) {
 		console.log(
-			colors
-				.bold()
-				.yellow(
-					`Unexpected + prefix. Did you mean ${typo.split('/').at(-1)?.slice(1)}?` +
-						` at ${path.resolve(typo)}`
-				)
+			styleText(
+				['bold', 'yellow'],
+				`Unexpected + prefix. Did you mean ${typo.split('/').at(-1)?.slice(1)}?` +
+					` at ${path.resolve(typo)}`
+			)
 		);
 	}
 
@@ -177,7 +176,7 @@ export function write_client_manifest(kit, manifest_data, output, metadata) {
 
 			export const decode = (type, value) => decoders[type](value);
 
-			export { default as root } from '../root.${isSvelte5Plus() ? 'js' : 'svelte'}';
+			export { default as root } from '../root.js';
 		`
 	);
 

package/src/core/sync/write_env.js

@@ -25,7 +25,11 @@ export function write_env(kit, entry, env_config) {
 			create_explicit_env_types(env_config, relative, 'public')
 		);
 	} else {
-		content.push(DOCS);
+		content.push(
+			DOCS,
+			create_explicit_env_types({}, '', 'private'),
+			create_explicit_env_types({}, '', 'public')
+		);
 	}
 
 	write_if_changed(out, content.join('\n\n'));

package/src/core/sync/write_non_ambient.js

@@ -1,6 +1,6 @@
 import path from 'node:path';
 import { GENERATED_COMMENT } from '../../constants.js';
-import { posixify } from '../../utils/filesystem.js';
+import { posixify } from '../../utils/os.js';
 import { write_if_changed } from './utils.js';
 import { s } from '../../utils/misc.js';
 import { get_route_segments } from '../../utils/routing.js';
@@ -58,21 +58,21 @@ ${GENERATED_COMMENT}
 
 declare module "svelte/elements" {
 	export interface HTMLAttributes<T> {
-		'data-sveltekit-keepfocus'?: true | '' | 'off' | undefined | null;
-		'data-sveltekit-noscroll'?: true | '' | 'off' | undefined | null;
+		'data-sveltekit-keepfocus'?: true | false | '' | undefined | null;
+		'data-sveltekit-noscroll'?: true | false | '' | undefined | null;
 		'data-sveltekit-preload-code'?:
 			| true
+			| false
 			| ''
 			| 'eager'
 			| 'viewport'
 			| 'hover'
 			| 'tap'
-			| 'off'
 			| undefined
 			| null;
-		'data-sveltekit-preload-data'?: true | '' | 'hover' | 'tap' | 'off' | undefined | null;
-		'data-sveltekit-reload'?: true | '' | 'off' | undefined | null;
-		'data-sveltekit-replacestate'?: true | '' | 'off' | undefined | null;
+		'data-sveltekit-preload-data'?: true | false | '' | 'hover' | 'tap' | undefined | null;
+		'data-sveltekit-reload'?: true | false | '' | undefined | null;
+		'data-sveltekit-replacestate'?: true | false | '' | undefined | null;
 	}
 }
 

package/src/core/sync/write_root.js

@@ -1,4 +1,4 @@
-import { dedent, isSvelte5Plus, write_if_changed } from './utils.js';
+import { dedent, write_if_changed } from './utils.js';
 
 /**
  * @param {import('types').ManifestData} manifest_data
@@ -8,7 +8,7 @@ import { dedent, isSvelte5Plus, write_if_changed } from './utils.js';
 export function write_root(manifest_data, config, output) {
 	// TODO remove default layout altogether
 
-	const use_boundaries = config.kit.experimental.handleRenderingErrors && isSvelte5Plus();
+	const use_boundaries = config.kit.experimental.handleRenderingErrors;
 
 	const max_depth = Math.max(
 		...manifest_data.routes.map((route) =>
@@ -26,7 +26,7 @@ export function write_root(manifest_data, config, output) {
 	/** @type {string} */
 	let pyramid;
 
-	if (isSvelte5Plus() && use_boundaries) {
+	if (use_boundaries) {
 		// with the @const we force the data[depth] access to be derived, which is important to not fire updates needlessly
 		// TODO in Svelte 5 we should rethink the client.js side, we can likely make data a $state and only update indexes that changed there, simplifying this a lot
 		pyramid = dedent`
@@ -55,39 +55,21 @@ export function write_root(manifest_data, config, output) {
 		`;
 	} else {
 		pyramid = dedent`
-	${
-		isSvelte5Plus()
-			? `<!-- svelte-ignore binding_property_non_reactive -->
-		<Pyramid_${l} bind:this={components[${l}]} data={data_${l}} {form} params={page.params} />`
-			: `<svelte:component this={constructors[${l}]} bind:this={components[${l}]} data={data_${l}} {form} params={page.params} />`
-	}`;
+		<!-- svelte-ignore binding_property_non_reactive -->
+		<Pyramid_${l} bind:this={components[${l}]} data={data_${l}} {form} params={page.params} />`;
 
 		while (l--) {
 			pyramid = dedent`
 			{#if constructors[${l + 1}]}
-				${
-					isSvelte5Plus()
-						? dedent`{@const Pyramid_${l} = constructors[${l}]}
-						<!-- svelte-ignore binding_property_non_reactive -->
-						<Pyramid_${l} bind:this={components[${l}]} data={data_${l}} {form} params={page.params}>
-							${pyramid}
-						</Pyramid_${l}>`
-						: dedent`<svelte:component this={constructors[${l}]} bind:this={components[${l}]} data={data_${l}} params={page.params}>
+				{@const Pyramid_${l} = constructors[${l}]}
+				<!-- svelte-ignore binding_property_non_reactive -->
+				<Pyramid_${l} bind:this={components[${l}]} data={data_${l}} {form} params={page.params}>
 					${pyramid}
-				</svelte:component>`
-				}
-
+				</Pyramid_${l}>
 			{:else}
-				${
-					isSvelte5Plus()
-						? dedent`
-					{@const Pyramid_${l} = constructors[${l}]}
-					<!-- svelte-ignore binding_property_non_reactive -->
-					<Pyramid_${l} bind:this={components[${l}]} data={data_${l}} {form} params={page.params} />
-					`
-						: dedent`<svelte:component this={constructors[${l}]} bind:this={components[${l}]} data={data_${l}} {form} params={page.params} />`
-				}
-
+				{@const Pyramid_${l} = constructors[${l}]}
+				<!-- svelte-ignore binding_property_non_reactive -->
+				<Pyramid_${l} bind:this={components[${l}]} data={data_${l}} {form} params={page.params} />
 			{/if}
 		`;
 		}
@@ -97,62 +79,34 @@ export function write_root(manifest_data, config, output) {
 		`${output}/root.svelte`,
 		dedent`
 			<!-- This file is generated by @sveltejs/kit — do not edit it! -->
-			${isSvelte5Plus() ? '<svelte:options runes={true} />' : ''}
+			<svelte:options runes={true} />
 			<script>
-				import { setContext, ${isSvelte5Plus() ? '' : 'afterUpdate, '}onMount, tick } from 'svelte';
+				import { setContext, onMount, tick } from 'svelte';
 				import { browser } from '$app/env';
 
 				// stores
-				${
-					isSvelte5Plus()
-						? dedent`
-							let { stores, page, constructors, components = [], form, ${use_boundaries ? 'errors = [], error, ' : ''}${levels
-								.map((l) => `data_${l} = null`)
-								.join(', ')} } = $props();
-							${use_boundaries ? `let data = $derived({${levels.map((l) => `'${l}': data_${l}`).join(', ')}})` : ''}
-						`
-						: dedent`
-							export let stores;
-							export let page;
-
-							export let constructors;
-							export let components = [];
-							export let form;
-							${levels.map((l) => `export let data_${l} = null;`).join('\n')}
-						`
-				}
-
-				if (!browser) {
+				let { stores, page, constructors, components = [], form, ${use_boundaries ? 'errors = [], error, ' : ''}${levels
+					.map((l) => `data_${l} = null`)
+					.join(', ')} } = $props();
+				${use_boundaries ? `let data = $derived({${levels.map((l) => `'${l}': data_${l}`).join(', ')}})` : ''}
+
+				if (browser) {
+					$effect.pre(() => stores.page.set(page));
+				} else {
 					// svelte-ignore state_referenced_locally
 					setContext('__svelte__', stores);
+					// svelte-ignore state_referenced_locally
+					stores.page.set(page);
 				}
 
-				${
-					isSvelte5Plus()
-						? dedent`
-							if (browser) {
-								$effect.pre(() => stores.page.set(page));
-							} else {
-								// svelte-ignore state_referenced_locally
-								stores.page.set(page);
-							}
-						`
-						: '$: stores.page.set(page);'
-				}
-				${
-					isSvelte5Plus()
-						? dedent`
-							$effect(() => {
-								stores;page;constructors;components;form;${use_boundaries ? 'errors;error;' : ''}${levels.map((l) => `data_${l}`).join(';')};
-								stores.page.notify();
-							});
-						`
-						: 'afterUpdate(stores.page.notify);'
-				}
+				$effect(() => {
+					stores;page;constructors;components;form;${use_boundaries ? 'errors;error;' : ''}${levels.map((l) => `data_${l}`).join(';')};
+					stores.page.notify();
+				});
 
-				let mounted = ${isSvelte5Plus() ? '$state(false)' : 'false'};
-				let navigated = ${isSvelte5Plus() ? '$state(false)' : 'false'};
-				let title = ${isSvelte5Plus() ? '$state(null)' : 'null'};
+				let mounted = $state(false);
+				let navigated = $state(false);
+				let title = $state(null);
 
 				onMount(() => {
 					const unsubscribe = stores.page.subscribe(() => {
@@ -168,7 +122,7 @@ export function write_root(manifest_data, config, output) {
 					return unsubscribe;
 				});
 
-				${isSvelte5Plus() ? `const Pyramid_${max_depth}=$derived(constructors[${max_depth}])` : ''}
+				const Pyramid_${max_depth} = $derived(constructors[${max_depth}]);
 			</script>
 
 			${pyramid}
@@ -183,14 +137,12 @@ export function write_root(manifest_data, config, output) {
 		`
 	);
 
-	if (isSvelte5Plus()) {
-		write_if_changed(
-			`${output}/root.js`,
-			dedent`
-			import { asClassComponent } from 'svelte/legacy';
-			import Root from './root.svelte';
-			export default asClassComponent(Root);
-		`
-		);
-	}
+	write_if_changed(
+		`${output}/root.js`,
+		dedent`
+		import { asClassComponent } from 'svelte/legacy';
+		import Root from './root.svelte';
+		export default asClassComponent(Root);
+	`
+	);
 }

package/src/core/sync/write_server.js

@@ -1,12 +1,11 @@
 import path from 'node:path';
-import process from 'node:process';
+import { styleText } from 'node:util';
 import { hash } from '../../utils/hash.js';
-import { posixify, resolve_entry } from '../../utils/filesystem.js';
+import { resolve_entry } from '../../utils/filesystem.js';
+import { posixify } from '../../utils/os.js';
 import { s } from '../../utils/misc.js';
 import { load_error_page, load_template } from '../config/index.js';
-import { runtime_directory } from '../utils.js';
-import { isSvelte5Plus, write_if_changed } from './utils.js';
-import colors from 'kleur';
+import { write_if_changed } from './utils.js';
 import { escape_html } from '../../utils/escape.js';
 
 /**
@@ -15,7 +14,6 @@ import { escape_html } from '../../utils/escape.js';
  *   universal_hooks: string | null;
  *   config: import('types').ValidatedConfig;
  *   has_service_worker: boolean;
- *   runtime_directory: string;
  *   template: string;
  *   error_page: string;
  * }} opts
@@ -25,29 +23,25 @@ const server_template = ({
 	server_hooks,
 	universal_hooks,
 	has_service_worker,
-	runtime_directory,
 	template,
 	error_page
 }) => `
-import root from '../root.${isSvelte5Plus() ? 'js' : 'svelte'}';
+import root from '../root.js';
 import { set_building, set_prerendering } from '$app/env/internal';
 import { set_assets } from '$app/paths/internal/server';
 import { set_manifest, set_read_implementation } from '__sveltekit/server';
 import { set_env } from '__sveltekit/env';
-import { set_private_env, set_public_env } from '${runtime_directory}/shared-server.js';
 
 export const options = {
 	app_template_contains_nonce: ${template.includes('%sveltekit.nonce%')},
 	async: ${s(!!config.compilerOptions?.experimental?.async)},
 	csp: ${s(config.kit.csp)},
-	csrf_check_origin: ${s(config.kit.csrf.checkOrigin && !config.kit.csrf.trustedOrigins.includes('*'))},
+	csrf_check_origin: ${s(!config.kit.csrf.trustedOrigins.includes('*'))},
 	csrf_trusted_origins: ${s(config.kit.csrf.trustedOrigins)},
 	embedded: ${config.kit.embedded},
-	env_public_prefix: '${config.kit.env.publicPrefix}',
-	env_private_prefix: '${config.kit.env.privatePrefix}',
 	hash_routing: ${s(config.kit.router.type === 'hash')},
 	hooks: null, // added lazily, via \`get_hooks\`
-	preload_strategy: ${s(config.kit.output.preloadStrategy)},
+	link_header_preload: ${s(config.kit.output.linkHeaderPreload)},
 	root,
 	service_worker: ${has_service_worker},
 	service_worker_options: ${config.kit.serviceWorker.register ? s(config.kit.serviceWorker.options) : 'null'},
@@ -93,7 +87,7 @@ export async function get_hooks() {
 	};
 }
 
-export { set_assets, set_building, set_env, set_manifest, set_prerendering, set_private_env, set_public_env, set_read_implementation };
+export { set_assets, set_building, set_env, set_manifest, set_prerendering, set_read_implementation };
 `;
 
 // TODO need to re-run this whenever src/app.html or src/error.html are
@@ -104,20 +98,20 @@ export { set_assets, set_building, set_env, set_manifest, set_prerendering, set_
  * Write server configuration to disk
  * @param {import('types').ValidatedConfig} config
  * @param {string} output
+ * @param {string} root The project root directory
  */
-export function write_server(config, output) {
+export function write_server(config, output, root) {
 	const server_hooks_file = resolve_entry(config.kit.files.hooks.server);
 	const universal_hooks_file = resolve_entry(config.kit.files.hooks.universal);
 
 	const typo = resolve_entry('src/+hooks.server');
 	if (typo) {
 		console.log(
-			colors
-				.bold()
-				.yellow(
-					`Unexpected + prefix. Did you mean ${typo.split('/').at(-1)?.slice(1)}?` +
-						` at ${path.resolve(typo)}`
-				)
+			styleText(
+				['bold', 'yellow'],
+				`Unexpected + prefix. Did you mean ${typo.split('/').at(-1)?.slice(1)}?` +
+					` at ${path.resolve(typo)}`
+			)
 		);
 	}
 
@@ -136,8 +130,7 @@ export function write_server(config, output) {
 			universal_hooks: universal_hooks_file ? relative(universal_hooks_file) : null,
 			has_service_worker:
 				config.kit.serviceWorker.register && !!resolve_entry(config.kit.files.serviceWorker),
-			runtime_directory: relative(runtime_directory),
-			template: load_template(process.cwd(), config),
+			template: load_template(root, config),
 			error_page: load_error_page(config)
 		})
 	);

package/src/core/sync/write_tsconfig.js

@@ -1,8 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import process from 'node:process';
-import colors from 'kleur';
-import { posixify } from '../../utils/filesystem.js';
+import { styleText } from 'node:util';
+import { posixify } from '../../utils/os.js';
 import { write_if_changed } from './utils.js';
 
 /**
@@ -17,10 +16,11 @@ function maybe_file(cwd, file) {
 }
 
 /**
+ * @param {string} cwd
  * @param {string} file
  */
-function project_relative(file) {
-	return posixify(path.relative('.', file));
+function project_relative(cwd, file) {
+	return posixify(path.relative(cwd, file));
 }
 
 /**
@@ -37,21 +37,23 @@ function remove_trailing_slashstar(file) {
 /**
  * Generates the tsconfig that the user's tsconfig inherits from.
  * @param {import('types').ValidatedKitConfig} kit
+ * @param {string} cwd
  */
-export function write_tsconfig(kit, cwd = process.cwd()) {
+export function write_tsconfig(kit, cwd) {
 	const out = path.join(kit.outDir, 'tsconfig.json');
 
 	const user_config = load_user_tsconfig(cwd);
 	if (user_config) validate_user_config(cwd, out, user_config);
 
-	write_if_changed(out, JSON.stringify(get_tsconfig(kit), null, '\t'));
+	write_if_changed(out, JSON.stringify(get_tsconfig(kit, cwd), null, '\t'));
 }
 
 /**
  * Generates the tsconfig that the user's tsconfig inherits from.
  * @param {import('types').ValidatedKitConfig} kit
+ * @param {string} cwd
  */
-export function get_tsconfig(kit) {
+export function get_tsconfig(kit, cwd) {
 	/** @param {string} file */
 	const config_relative = (file) => posixify(path.relative(kit.outDir, file));
 
@@ -60,6 +62,7 @@ export function get_tsconfig(kit) {
 		'env.d.ts',
 		'non-ambient.d.ts',
 		'./types/**/$types.d.ts',
+		config_relative('svelte.config.js'),
 		config_relative('vite.config.js'),
 		config_relative('vite.config.ts')
 	]);
@@ -75,11 +78,11 @@ export function get_tsconfig(kit) {
 
 	// Test folder is a special case - we advocate putting tests in a top-level test folder
 	// and it's not configurable (should we make it?)
-	const test_folder = project_relative('test');
+	const test_folder = project_relative(cwd, 'test');
 	include.add(config_relative(`${test_folder}/**/*.js`));
 	include.add(config_relative(`${test_folder}/**/*.ts`));
 	include.add(config_relative(`${test_folder}/**/*.svelte`));
-	const tests_folder = project_relative('tests');
+	const tests_folder = project_relative(cwd, 'tests');
 	include.add(config_relative(`${tests_folder}/**/*.js`));
 	include.add(config_relative(`${tests_folder}/**/*.ts`));
 	include.add(config_relative(`${tests_folder}/**/*.svelte`));
@@ -102,7 +105,7 @@ export function get_tsconfig(kit) {
 		compilerOptions: {
 			// generated options
 			paths: {
-				...get_tsconfig_paths(kit),
+				...get_tsconfig_paths(kit, cwd),
 				'$app/types': ['./types/index.d.ts']
 			},
 			rootDirs: [config_relative('.'), './types'],
@@ -170,22 +173,22 @@ function validate_user_config(cwd, out, config) {
 		// TODO: baseUrl will be removed in TypeScript 7.0
 		if (baseUrl || paths) {
 			console.warn(
-				colors
-					.bold()
-					.yellow(
-						`You have specified a baseUrl and/or paths in your ${config.kind} which interferes with SvelteKit's auto-generated tsconfig.json. ` +
-							'Remove it to avoid problems with intellisense. For path aliases, use `kit.alias` instead: https://svelte.dev/docs/kit/configuration#alias'
-					)
+				styleText(
+					['bold', 'yellow'],
+					`You have specified a baseUrl and/or paths in your ${config.kind} which interferes with SvelteKit's auto-generated tsconfig.json. ` +
+						'Remove it to avoid problems with intellisense. For path aliases, use `kit.alias` instead: https://svelte.dev/docs/kit/configuration#alias'
+				)
 			);
 		}
 	} else {
-		let relative = posixify(path.relative('.', out));
+		let relative = posixify(path.relative(cwd, out));
 		if (!relative.startsWith('./')) relative = './' + relative;
 
 		console.warn(
-			colors
-				.bold()
-				.yellow(`Your ${config.kind} should extend the configuration generated by SvelteKit:`)
+			styleText(
+				['bold', 'yellow'],
+				`Your ${config.kind} should extend the configuration generated by SvelteKit:`
+			)
 		);
 		console.warn(`{\n  "extends": "${relative}"\n}`);
 	}
@@ -201,8 +204,9 @@ const value_regex = /^(.*?)((\/\*)|(\.\w+))?$/;
  * Related to vite alias creation.
  *
  * @param {import('types').ValidatedKitConfig} config
+ * @param {string} cwd
  */
-function get_tsconfig_paths(config) {
+function get_tsconfig_paths(config, cwd) {
 	/** @param {string} file */
 	const config_relative = (file) => {
 		let relative_path = path.relative(config.outDir, file);
@@ -213,8 +217,8 @@ function get_tsconfig_paths(config) {
 	};
 
 	const alias = { ...config.alias };
-	if (fs.existsSync(project_relative(config.files.lib))) {
-		alias['$lib'] = project_relative(config.files.lib);
+	if (fs.existsSync(project_relative(cwd, config.files.lib))) {
+		alias['$lib'] = project_relative(cwd, config.files.lib);
 	}
 
 	/** @type {Record<string, string[]>} */