npm - @sveltejs/kit - Versions diffs - 1.0.0-next.55 → 1.0.0-next.550 - Mend

@sveltejs/kit 1.0.0-next.55 → 1.0.0-next.550

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (128) hide show

package/README.md +5 -2
package/package.json +93 -67
package/postinstall.js +47 -0
package/scripts/special-types/$env+dynamic+private.md +10 -0
package/scripts/special-types/$env+dynamic+public.md +8 -0
package/scripts/special-types/$env+static+private.md +19 -0
package/scripts/special-types/$env+static+public.md +7 -0
package/scripts/special-types/$lib.md +5 -0
package/src/cli.js +108 -0
package/src/constants.js +5 -0
package/src/core/adapt/builder.js +212 -0
package/src/core/adapt/index.js +31 -0
package/src/core/config/default-error.html +56 -0
package/src/core/config/index.js +110 -0
package/src/core/config/options.js +516 -0
package/src/core/config/types.d.ts +1 -0
package/src/core/env.js +121 -0
package/src/core/generate_manifest/index.js +125 -0
package/src/core/prerender/crawl.js +207 -0
package/src/core/prerender/entities.js +2252 -0
package/src/core/prerender/prerender.js +460 -0
package/src/core/prerender/queue.js +80 -0
package/src/core/sync/create_manifest_data/conflict.js +0 -0
package/src/core/sync/create_manifest_data/index.js +513 -0
package/src/core/sync/create_manifest_data/sort.js +161 -0
package/src/core/sync/create_manifest_data/types.d.ts +37 -0
package/src/core/sync/sync.js +78 -0
package/src/core/sync/utils.js +33 -0
package/src/core/sync/write_ambient.js +53 -0
package/src/core/sync/write_client_manifest.js +106 -0
package/src/core/sync/write_matchers.js +25 -0
package/src/core/sync/write_root.js +91 -0
package/src/core/sync/write_tsconfig.js +195 -0
package/src/core/sync/write_types/index.js +809 -0
package/src/core/utils.js +67 -0
package/src/exports/hooks/index.js +1 -0
package/src/exports/hooks/sequence.js +44 -0
package/src/exports/index.js +45 -0
package/src/exports/node/index.js +172 -0
package/src/exports/node/polyfills.js +28 -0
package/src/exports/vite/build/build_server.js +384 -0
package/src/exports/vite/build/build_service_worker.js +92 -0
package/src/exports/vite/build/utils.js +195 -0
package/src/exports/vite/dev/index.js +588 -0
package/src/exports/vite/graph_analysis/index.js +107 -0
package/src/exports/vite/graph_analysis/types.d.ts +5 -0
package/src/exports/vite/graph_analysis/utils.js +6 -0
package/src/exports/vite/index.js +651 -0
package/src/exports/vite/preview/index.js +193 -0
package/src/exports/vite/types.d.ts +3 -0
package/src/exports/vite/utils.js +171 -0
package/src/runtime/app/env.js +1 -0
package/src/runtime/app/environment.js +11 -0
package/src/runtime/app/forms.js +141 -0
package/src/runtime/app/navigation.js +23 -0
package/src/runtime/app/paths.js +1 -0
package/src/runtime/app/stores.js +102 -0
package/src/runtime/client/ambient.d.ts +30 -0
package/src/runtime/client/client.js +1726 -0
package/src/runtime/client/fetcher.js +121 -0
package/src/runtime/client/parse.js +60 -0
package/src/runtime/client/singletons.js +21 -0
package/src/runtime/client/start.js +43 -0
package/src/runtime/client/types.d.ts +84 -0
package/src/runtime/client/utils.js +166 -0
package/src/runtime/components/error.svelte +16 -0
package/{assets → src/runtime}/components/layout.svelte +0 -0
package/src/runtime/control.js +98 -0
package/src/runtime/env/dynamic/private.js +1 -0
package/src/runtime/env/dynamic/public.js +1 -0
package/src/runtime/env-private.js +6 -0
package/src/runtime/env-public.js +6 -0
package/src/runtime/env.js +6 -0
package/src/runtime/hash.js +20 -0
package/src/runtime/paths.js +11 -0
package/src/runtime/server/cookie.js +231 -0
package/src/runtime/server/data/index.js +144 -0
package/src/runtime/server/endpoint.js +89 -0
package/src/runtime/server/fetch.js +164 -0
package/src/runtime/server/index.js +375 -0
package/src/runtime/server/page/actions.js +258 -0
package/src/runtime/server/page/crypto.js +239 -0
package/src/runtime/server/page/csp.js +250 -0
package/src/runtime/server/page/index.js +303 -0
package/src/runtime/server/page/load_data.js +258 -0
package/src/runtime/server/page/render.js +391 -0
package/src/runtime/server/page/respond_with_error.js +102 -0
package/src/runtime/server/page/serialize_data.js +87 -0
package/src/runtime/server/page/types.d.ts +35 -0
package/src/runtime/server/utils.js +205 -0
package/src/utils/array.js +9 -0
package/src/utils/error.js +22 -0
package/src/utils/escape.js +46 -0
package/src/utils/filesystem.js +166 -0
package/src/utils/functions.js +16 -0
package/src/utils/http.js +72 -0
package/src/utils/misc.js +1 -0
package/src/utils/promises.js +17 -0
package/src/utils/routing.js +168 -0
package/src/utils/unit_test.js +11 -0
package/src/utils/url.js +159 -0
package/svelte-kit.js +1 -1
package/types/ambient.d.ts +469 -0
package/types/index.d.ts +775 -0
package/types/internal.d.ts +381 -0
package/types/private.d.ts +229 -0
package/CHANGELOG.md +0 -519
package/assets/components/error.svelte +0 -13
package/assets/runtime/app/env.js +0 -5
package/assets/runtime/app/navigation.js +0 -48
package/assets/runtime/app/paths.js +0 -1
package/assets/runtime/app/stores.js +0 -93
package/assets/runtime/chunks/utils.js +0 -22
package/assets/runtime/internal/singletons.js +0 -23
package/assets/runtime/internal/start.js +0 -823
package/assets/runtime/paths.js +0 -12
package/dist/chunks/index.js +0 -3544
package/dist/chunks/index2.js +0 -572
package/dist/chunks/index3.js +0 -246
package/dist/chunks/index4.js +0 -569
package/dist/chunks/index5.js +0 -751
package/dist/chunks/index6.js +0 -323
package/dist/chunks/standard.js +0 -99
package/dist/chunks/utils.js +0 -83
package/dist/cli.js +0 -558
package/dist/ssr.js +0 -2620
package/types.d.ts +0 -74
package/types.internal.d.ts +0 -237

package/src/core/config/default-error.html ADDED Viewed

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<title>%sveltekit.error.message%</title>
+		<style>
+			body {
+				font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen,
+					Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+				display: flex;
+				align-items: center;
+				justify-content: center;
+				height: 100vh;
+			}
+			.error {
+				display: flex;
+				align-items: center;
+				max-width: 32rem;
+				margin: 0 1rem;
+			}
+			.status {
+				font-weight: 200;
+				font-size: 3rem;
+				line-height: 1;
+				position: relative;
+				top: -0.05rem;
+			}
+			.message {
+				border-left: 1px solid #ccc;
+				padding: 0 0 0 1rem;
+				margin: 0 0 0 1rem;
+				min-height: 2.5rem;
+				display: flex;
+				align-items: center;
+			}
+			.message h1 {
+				font-weight: 400;
+				font-size: 1em;
+				margin: 0;
+			}
+		</style>
+	</head>
+	<body>
+		<div class="error">
+			<span class="status">%sveltekit.status%</span>
+			<div class="message">
+				<h1>%sveltekit.error.message%</h1>
+			</div>
+		</div>
+	</body>
+</html>

package/src/core/config/index.js ADDED Viewed

@@ -0,0 +1,110 @@
+import fs from 'fs';
+import path from 'path';
+import * as url from 'url';
+import options from './options.js';
+/**
+ * Loads the template (src/app.html by default) and validates that it has the
+ * required content.
+ * @param {string} cwd
+ * @param {import('types').ValidatedConfig} config
+ */
+export function load_template(cwd, config) {
+	const { appTemplate } = config.kit.files;
+	const relative = path.relative(cwd, appTemplate);
+	if (fs.existsSync(appTemplate)) {
+		const contents = fs.readFileSync(appTemplate, 'utf8');
+		// TODO remove this for 1.0
+		const match = /%svelte\.([a-z]+)%/.exec(contents);
+		if (match) {
+			throw new Error(
+				`%svelte.${match[1]}% in ${relative} should be replaced with %sveltekit.${match[1]}%`
+			);
+		}
+		const expected_tags = ['%sveltekit.head%', '%sveltekit.body%'];
+		expected_tags.forEach((tag) => {
+			if (contents.indexOf(tag) === -1) {
+				throw new Error(`${relative} is missing ${tag}`);
+			}
+		});
+	} else {
+		throw new Error(`${relative} does not exist`);
+	}
+	return fs.readFileSync(appTemplate, 'utf-8');
+}
+/**
+ * Loads the error page (src/error.html by default) if it exists.
+ * Falls back to a generic error page content.
+ * @param {import('types').ValidatedConfig} config
+ */
+export function load_error_page(config) {
+	const { errorTemplate } = config.kit.files;
+	return fs.readFileSync(errorTemplate, 'utf-8');
+}
+/**
+ * Loads and validates svelte.config.js
+ * @param {{ cwd?: string }} options
+ * @returns {Promise<import('types').ValidatedConfig>}
+ */
+export async function load_config({ cwd = process.cwd() } = {}) {
+	const config_file = path.join(cwd, 'svelte.config.js');
+	if (!fs.existsSync(config_file)) {
+		return process_config({}, { cwd });
+	}
+	const config = await import(`${url.pathToFileURL(config_file).href}?ts=${Date.now()}`);
+	return process_config(config.default, { cwd });
+}
+/**
+ * @param {import('types').Config} config
+ * @returns {import('types').ValidatedConfig}
+ */
+function process_config(config, { cwd = process.cwd() } = {}) {
+	const validated = validate_config(config);
+	validated.kit.outDir = path.resolve(cwd, validated.kit.outDir);
+	for (const key in validated.kit.files) {
+		// TODO remove for 1.0
+		if (key === 'template') continue;
+		if (key === 'hooks') {
+			validated.kit.files.hooks.client = path.resolve(cwd, validated.kit.files.hooks.client);
+			validated.kit.files.hooks.server = path.resolve(cwd, validated.kit.files.hooks.server);
+		} else {
+			// @ts-expect-error
+			validated.kit.files[key] = path.resolve(cwd, validated.kit.files[key]);
+		}
+	}
+	if (!fs.existsSync(validated.kit.files.errorTemplate)) {
+		validated.kit.files.errorTemplate = url.fileURLToPath(
+			new URL('./default-error.html', import.meta.url)
+		);
+	}
+	return validated;
+}
+/**
+ * @param {import('types').Config} config
+ * @returns {import('types').ValidatedConfig}
+ */
+export function validate_config(config) {
+	if (typeof config !== 'object') {
+		throw new Error(
+			'svelte.config.js must have a configuration object as its default export. See https://kit.svelte.dev/docs/configuration'
+		);
+	}
+	return options(config, 'config');
+}

package/src/core/config/options.js ADDED Viewed

@@ -0,0 +1,516 @@
+import { join } from 'path';
+/** @typedef {import('./types').Validator} Validator */
+const directives = object({
+	'child-src': string_array(),
+	'default-src': string_array(),
+	'frame-src': string_array(),
+	'worker-src': string_array(),
+	'connect-src': string_array(),
+	'font-src': string_array(),
+	'img-src': string_array(),
+	'manifest-src': string_array(),
+	'media-src': string_array(),
+	'object-src': string_array(),
+	'prefetch-src': string_array(),
+	'script-src': string_array(),
+	'script-src-elem': string_array(),
+	'script-src-attr': string_array(),
+	'style-src': string_array(),
+	'style-src-elem': string_array(),
+	'style-src-attr': string_array(),
+	'base-uri': string_array(),
+	sandbox: string_array(),
+	'form-action': string_array(),
+	'frame-ancestors': string_array(),
+	'navigate-to': string_array(),
+	'report-uri': string_array(),
+	'report-to': string_array(),
+	'require-trusted-types-for': string_array(),
+	'trusted-types': string_array(),
+	'upgrade-insecure-requests': boolean(false),
+	'require-sri-for': string_array(),
+	'block-all-mixed-content': boolean(false),
+	'plugin-types': string_array(),
+	referrer: string_array()
+});
+/** @type {Validator} */
+const options = object(
+	{
+		extensions: validate(['.svelte'], (input, keypath) => {
+			if (!Array.isArray(input) || !input.every((page) => typeof page === 'string')) {
+				throw new Error(`${keypath} must be an array of strings`);
+			}
+			input.forEach((extension) => {
+				if (extension[0] !== '.') {
+					throw new Error(`Each member of ${keypath} must start with '.' — saw '${extension}'`);
+				}
+				if (!/^(\.[a-z0-9]+)+$/i.test(extension)) {
+					throw new Error(`File extensions must be alphanumeric — saw '${extension}'`);
+				}
+			});
+			return input;
+		}),
+		kit: object({
+			adapter: validate(null, (input, keypath) => {
+				if (typeof input !== 'object' || !input.adapt) {
+					let message = `${keypath} should be an object with an "adapt" method`;
+					if (Array.isArray(input) || typeof input === 'string') {
+						// for the early adapter adopters
+						message += ', rather than the name of an adapter';
+					}
+					throw new Error(`${message}. See https://kit.svelte.dev/docs/adapters`);
+				}
+				return input;
+			}),
+			alias: validate({}, (input, keypath) => {
+				if (typeof input !== 'object') {
+					throw new Error(`${keypath} should be an object`);
+				}
+				for (const key in input) {
+					assert_string(input[key], `${keypath}.${key}`);
+				}
+				return input;
+			}),
+			// TODO: remove this for the 1.0 release
+			amp: error(
+				(keypath) =>
+					`${keypath} has been removed. See https://kit.svelte.dev/docs/seo#manual-setup-amp for details on how to support AMP`
+			),
+			appDir: validate('_app', (input, keypath) => {
+				assert_string(input, keypath);
+				if (input) {
+					if (input.startsWith('/') || input.endsWith('/')) {
+						throw new Error(
+							"config.kit.appDir cannot start or end with '/'. See https://kit.svelte.dev/docs/configuration"
+						);
+					}
+				} else {
+					throw new Error(`${keypath} cannot be empty`);
+				}
+				return input;
+			}),
+			// TODO: remove this for the 1.0 release
+			browser: object({
+				hydrate: error(
+					(keypath) =>
+						`${keypath} has been removed. You can set \`export const csr = false\` inside the top level +layout.js instead. See the PR for more information: https://github.com/sveltejs/kit/pull/6197`
+				),
+				router: error(
+					(keypath) =>
+						`${keypath} has been removed. You can set \`export const csr = false\` inside the top level +layout.js instead. See the PR for more information: https://github.com/sveltejs/kit/pull/6197`
+				)
+			}),
+			csp: object({
+				mode: list(['auto', 'hash', 'nonce']),
+				directives,
+				reportOnly: directives
+			}),
+			csrf: object({
+				checkOrigin: boolean(true)
+			}),
+			// TODO: remove this for the 1.0 release
+			endpointExtensions: error(
+				(keypath) => `${keypath} has been renamed to config.kit.moduleExtensions`
+			),
+			env: object({
+				dir: string(process.cwd()),
+				publicPrefix: string('PUBLIC_')
+			}),
+			files: object({
+				assets: string('static'),
+				hooks: (input, keypath) => {
+					// TODO remove this for the 1.0 release
+					if (typeof input === 'string') {
+						throw new Error(
+							`${keypath} is an object with { server: string, client: string } now. See the PR for more information: https://github.com/sveltejs/kit/pull/6586`
+						);
+					}
+					return object({
+						client: string(join('src', 'hooks.client')),
+						server: string(join('src', 'hooks.server'))
+					})(input, keypath);
+				},
+				lib: string(join('src', 'lib')),
+				params: string(join('src', 'params')),
+				routes: string(join('src', 'routes')),
+				serviceWorker: string(join('src', 'service-worker')),
+				appTemplate: string(join('src', 'app.html')),
+				errorTemplate: string(join('src', 'error.html')),
+				// TODO: remove this for the 1.0 release
+				template: error(
+					() => 'config.kit.files.template has been renamed to config.kit.files.appTemplate'
+				)
+			}),
+			// TODO: remove this for the 1.0 release
+			headers: error(
+				(keypath) =>
+					`${keypath} has been removed. See https://github.com/sveltejs/kit/pull/3384 for details`
+			),
+			// TODO: remove this for the 1.0 release
+			host: error(
+				(keypath) =>
+					`${keypath} has been removed. See https://github.com/sveltejs/kit/pull/3384 for details`
+			),
+			// TODO remove for 1.0
+			hydrate: error((keypath) => `${keypath} has been moved to config.kit.browser.hydrate`),
+			inlineStyleThreshold: number(0),
+			methodOverride: error(
+				() =>
+					'Method overrides have been removed in favor of actions. See the PR for more information: https://github.com/sveltejs/kit/pull/6469'
+			),
+			moduleExtensions: string_array(['.js', '.ts']),
+			outDir: string('.svelte-kit'),
+			package: error((keypath) => `${keypath} has been removed — use @sveltejs/package instead`),
+			paths: object({
+				base: validate('', (input, keypath) => {
+					assert_string(input, keypath);
+					if (input !== '' && (input.endsWith('/') || !input.startsWith('/'))) {
+						throw new Error(
+							`${keypath} option must either be the empty string or a root-relative path that starts but doesn't end with '/'. See https://kit.svelte.dev/docs/configuration#paths`
+						);
+					}
+					return input;
+				}),
+				assets: validate('', (input, keypath) => {
+					assert_string(input, keypath);
+					if (input) {
+						if (!/^[a-z]+:\/\//.test(input)) {
+							throw new Error(
+								`${keypath} option must be an absolute path, if specified. See https://kit.svelte.dev/docs/configuration#paths`
+							);
+						}
+						if (input.endsWith('/')) {
+							throw new Error(
+								`${keypath} option must not end with '/'. See https://kit.svelte.dev/docs/configuration#paths`
+							);
+						}
+					}
+					return input;
+				})
+			}),
+			prerender: object({
+				concurrency: number(1),
+				crawl: boolean(true),
+				createIndexFiles: error(
+					(keypath) =>
+						`${keypath} has been removed — it is now controlled by the trailingSlash option. See https://kit.svelte.dev/docs/configuration#trailingslash`
+				),
+				default: error(
+					(keypath) =>
+						`${keypath} has been removed. You can set it inside the top level +layout.js instead. See the PR for more information: https://github.com/sveltejs/kit/pull/6197`
+				),
+				enabled: boolean(true),
+				entries: validate(['*'], (input, keypath) => {
+					if (!Array.isArray(input) || !input.every((page) => typeof page === 'string')) {
+						throw new Error(`${keypath} must be an array of strings`);
+					}
+					input.forEach((page) => {
+						if (page !== '*' && page[0] !== '/') {
+							throw new Error(
+								`Each member of ${keypath} must be either '*' or an absolute path beginning with '/' — saw '${page}'`
+							);
+						}
+					});
+					return input;
+				}),
+				// TODO: remove this for the 1.0 release
+				force: validate(undefined, (input, keypath) => {
+					const new_input = input ? 'warn' : 'fail';
+					const needs_option = new_input === 'warn';
+					throw new Error(
+						`${keypath} has been removed in favor of \`handleHttpError\`. In your case, set \`handleHttpError\` to "${new_input}"${
+							needs_option ? '' : ' (or leave it undefined)'
+						} to get the same behavior as you would with \`force: ${JSON.stringify(input)}\``
+					);
+				}),
+				handleHttpError: validate('fail', (input, keypath) => {
+					if (typeof input === 'function') return input;
+					if (['fail', 'warn', 'ignore'].includes(input)) return input;
+					throw new Error(`${keypath} should be "fail", "warn", "ignore" or a custom function`);
+				}),
+				handleMissingId: validate('fail', (input, keypath) => {
+					if (typeof input === 'function') return input;
+					if (['fail', 'warn', 'ignore'].includes(input)) return input;
+					throw new Error(`${keypath} should be "fail", "warn", "ignore" or a custom function`);
+				}),
+				// TODO: remove this for the 1.0 release
+				onError: validate(undefined, (input, keypath) => {
+					let message = `${keypath} has been renamed to \`handleHttpError\``;
+					if (input === 'continue') {
+						message += ', and "continue" has been renamed to "warn"';
+					}
+					throw new Error(message);
+				}),
+				origin: validate('http://sveltekit-prerender', (input, keypath) => {
+					assert_string(input, keypath);
+					let origin;
+					try {
+						origin = new URL(input).origin;
+					} catch (e) {
+						throw new Error(`${keypath} must be a valid origin`);
+					}
+					if (input !== origin) {
+						throw new Error(`${keypath} must be a valid origin (${origin} rather than ${input})`);
+					}
+					return origin;
+				}),
+				// TODO: remove this for the 1.0 release
+				pages: error((keypath) => `${keypath} has been renamed to \`entries\`.`)
+			}),
+			// TODO: remove this for the 1.0 release
+			protocol: error(
+				(keypath) =>
+					`${keypath} has been removed. See https://github.com/sveltejs/kit/pull/3384 for details`
+			),
+			// TODO remove for 1.0
+			router: error(
+				(keypath) =>
+					`${keypath} has been removed. You can set \`export const csr = false\` inside the top level +layout.js instead. See the PR for more information: https://github.com/sveltejs/kit/pull/6197`
+			),
+			// TODO remove for 1.0
+			routes: error(
+				(keypath) =>
+					`${keypath} has been removed. See https://github.com/sveltejs/kit/discussions/5774 for details`
+			),
+			serviceWorker: object({
+				register: boolean(true),
+				files: fun((filename) => !/\.DS_Store/.test(filename))
+			}),
+			// TODO remove this for 1.0
+			ssr: error(
+				(keypath) =>
+					`${keypath} has been removed — use the handle hook instead: https://kit.svelte.dev/docs/hooks#server-hooks-handle`
+			),
+			// TODO remove this for 1.0
+			target: error((keypath) => `${keypath} is no longer required, and should be removed`),
+			trailingSlash: list(['never', 'always', 'ignore']),
+			version: object({
+				name: string(Date.now().toString()),
+				pollInterval: number(0)
+			}),
+			// TODO remove this for 1.0
+			vite: error((keypath) => `${keypath} has been removed — use vite.config.js instead`)
+		})
+	},
+	true
+);
+/**
+ * @param {Record<string, Validator>} children
+ * @param {boolean} [allow_unknown]
+ * @returns {Validator}
+ */
+function object(children, allow_unknown = false) {
+	return (input, keypath) => {
+		/** @type {Record<string, any>} */
+		const output = {};
+		if ((input && typeof input !== 'object') || Array.isArray(input)) {
+			throw new Error(`${keypath} should be an object`);
+		}
+		for (const key in input) {
+			if (!(key in children)) {
+				if (allow_unknown) {
+					output[key] = input[key];
+				} else {
+					let message = `Unexpected option ${keypath}.${key}`;
+					// special case
+					if (keypath === 'config.kit' && key in options) {
+						message += ` (did you mean config.${key}?)`;
+					}
+					throw new Error(message);
+				}
+			}
+		}
+		for (const key in children) {
+			const validator = children[key];
+			output[key] = validator(input && input[key], `${keypath}.${key}`);
+		}
+		return output;
+	};
+}
+/**
+ * @param {any} fallback
+ * @param {(value: any, keypath: string) => any} fn
+ * @returns {Validator}
+ */
+function validate(fallback, fn) {
+	return (input, keypath) => {
+		return input === undefined ? fallback : fn(input, keypath);
+	};
+}
+/**
+ * @param {string | null} fallback
+ * @param {boolean} allow_empty
+ * @returns {Validator}
+ */
+function string(fallback, allow_empty = true) {
+	return validate(fallback, (input, keypath) => {
+		assert_string(input, keypath);
+		if (!allow_empty && input === '') {
+			throw new Error(`${keypath} cannot be empty`);
+		}
+		return input;
+	});
+}
+/**
+ * @param {string[] | undefined} [fallback]
+ * @returns {Validator}
+ */
+function string_array(fallback) {
+	return validate(fallback, (input, keypath) => {
+		if (!Array.isArray(input) || input.some((value) => typeof value !== 'string')) {
+			throw new Error(`${keypath} must be an array of strings, if specified`);
+		}
+		return input;
+	});
+}
+/**
+ * @param {number} fallback
+ * @returns {Validator}
+ */
+function number(fallback) {
+	return validate(fallback, (input, keypath) => {
+		if (typeof input !== 'number') {
+			throw new Error(`${keypath} should be a number, if specified`);
+		}
+		return input;
+	});
+}
+/**
+ * @param {boolean} fallback
+ * @returns {Validator}
+ */
+function boolean(fallback) {
+	return validate(fallback, (input, keypath) => {
+		if (typeof input !== 'boolean') {
+			throw new Error(`${keypath} should be true or false, if specified`);
+		}
+		return input;
+	});
+}
+/**
+ * @param {string[]} options
+ * @returns {Validator}
+ */
+function list(options, fallback = options[0]) {
+	return validate(fallback, (input, keypath) => {
+		if (!options.includes(input)) {
+			// prettier-ignore
+			const msg = options.length > 2
+				? `${keypath} should be one of ${options.slice(0, -1).map(input => `"${input}"`).join(', ')} or "${options[options.length - 1]}"`
+				: `${keypath} should be either "${options[0]}" or "${options[1]}"`;
+			throw new Error(msg);
+		}
+		return input;
+	});
+}
+/**
+ * @param {(filename: string) => boolean} fallback
+ * @returns {Validator}
+ */
+function fun(fallback) {
+	return validate(fallback, (input, keypath) => {
+		if (typeof input !== 'function') {
+			throw new Error(`${keypath} should be a function, if specified`);
+		}
+		return input;
+	});
+}
+/**
+ * @param {string} input
+ * @param {string} keypath
+ */
+function assert_string(input, keypath) {
+	if (typeof input !== 'string') {
+		throw new Error(`${keypath} should be a string, if specified`);
+	}
+}
+/** @param {(keypath?: string) => string} fn */
+function error(fn) {
+	return validate(undefined, (_, keypath) => {
+		throw new Error(fn(keypath));
+	});
+}
+export default options;

package/src/core/config/types.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export type Validator<T = any> = (input: T, keypath: string) => T;