@sveltejs/kit 1.0.0-next.38 → 1.0.0-next.382

package/README.md

@@ -1,15 +1,18 @@
-# @sveltejs/kit
+# The fastest way to build Svelte apps
 
-Here be dragons, etc etc.
+This is the [SvelteKit](https://kit.svelte.dev) framework and CLI.
 
-This project aims to replicate Sapper's functionality in its entirety, minus building for deployment (which can be handled by 'adapters' that do various opinionated things with the output of `snowpack build`).
+The quickest way to get started is via the [create-svelte](https://github.com/sveltejs/kit/tree/master/packages/create-svelte) package:
 
-It's currently missing a ton of stuff but I figured I'd throw it up on GitHub anyway partly for the sake of 'working in the open' but mostly because I need an issue tracker to organise my thoughts.
+```bash
+npm create svelte@latest my-app
+cd my-app
+npm install
+npm run dev
+```
 
-There are no tests yet or anything like that. Some of the code has just been straight copied over from the existing Sapper repo, but a pleasing amount of it can safely be left behind.
+See the [documentation](https://kit.svelte.dev/docs) to learn more.
 
-## Trying it out
+## Changelog
 
-Clone this repo, `npm install`, and `npm link`. That will create a global link to the `svelte` bin. You can then either `npm run build` or `npm run dev`, if you intend to make changes and see them immediately reflected.
-
-Then, clone the corresponding [svelte-app-demo](https://github.com/sveltejs/svelte-app-demo) repo and follow the instructions therein.
+[The Changelog for this package is available on GitHub](https://github.com/sveltejs/kit/blob/master/packages/kit/CHANGELOG.md).

package/assets/app/env.js

@@ -0,0 +1,28 @@
+export { prerendering } from '../env.js';
+
+/**
+ * @type {import('$app/env').browser}
+ */
+const browser = !import.meta.env.SSR;
+
+/**
+ * @type {import('$app/env').server}
+ */
+const server = !!import.meta.env.SSR;
+
+/**
+ * @type {import('$app/env').dev}
+ */
+const dev = !!import.meta.env.DEV;
+
+/**
+ * @type {import('$app/env').prod}
+ */
+const prod = !import.meta.env.DEV;
+
+/**
+ * @type {import('$app/env').mode}
+ */
+const mode = import.meta.env.MODE;
+
+export { browser, dev, mode, prod, server };

package/assets/app/navigation.js

@@ -0,0 +1,24 @@
+import { client } from '../client/singletons.js';
+
+/**
+ * @param {string} name
+ */
+function guard(name) {
+	return () => {
+		throw new Error(`Cannot call ${name}(...) on the server`);
+	};
+}
+
+const ssr = import.meta.env.SSR;
+
+const disableScrollHandling = ssr
+	? guard('disableScrollHandling')
+	: client.disable_scroll_handling;
+const goto = ssr ? guard('goto') : client.goto;
+const invalidate = ssr ? guard('invalidate') : client.invalidate;
+const prefetch = ssr ? guard('prefetch') : client.prefetch;
+const prefetchRoutes = ssr ? guard('prefetchRoutes') : client.prefetch_routes;
+const beforeNavigate = ssr ? () => {} : client.before_navigate;
+const afterNavigate = ssr ? () => {} : client.after_navigate;
+
+export { afterNavigate, beforeNavigate, disableScrollHandling, goto, invalidate, prefetch, prefetchRoutes };

package/assets/app/paths.js

@@ -0,0 +1 @@
+export { assets, base } from '../paths.js';

package/assets/{runtime/app → app}/stores.js

@@ -1,7 +1,6 @@
 import { getContext } from 'svelte';
-
-// const ssr = (import.meta as any).env.SSR;
-const ssr = typeof window === 'undefined'; // TODO why doesn't previous line work in build?
+import { browser } from './env.js';
+import '../env.js';
 
 // TODO remove this (for 1.0? after 1.0?)
 let warned = false;
@@ -13,37 +12,33 @@ function stores() {
 	return getStores();
 }
 
-/** @typedef {import('svelte/store').Readable<{
- *   host: string;
- *   path: string;
- *   query: URLSearchParams;
- *   params: Record<string, string | string[]>
- * }>} PageStore */
-
+/**
+ * @type {import('$app/stores').getStores}
+ */
 const getStores = () => {
 	const stores = getContext('__svelte__');
 
 	return {
-		/** @type {PageStore} */
 		page: {
 			subscribe: stores.page.subscribe
 		},
-		/** @type {import('svelte/store').Readable<boolean>} */
 		navigating: {
 			subscribe: stores.navigating.subscribe
 		},
+		// TODO remove this (for 1.0? after 1.0?)
+		// @ts-expect-error - deprecated, not part of type definitions, but still callable
 		get preloading() {
 			console.error('stores.preloading is deprecated; use stores.navigating instead');
 			return {
 				subscribe: stores.navigating.subscribe
 			};
 		},
-		/** @type {import('svelte/store').Writable<any>} */
-		session: stores.session
+		session: stores.session,
+		updated: stores.updated
 	};
 };
 
-/** @type {PageStore} */
+/** @type {typeof import('$app/stores').page} */
 const page = {
 	/** @param {(value: any) => void} fn */
 	subscribe(fn) {
@@ -52,9 +47,8 @@ const page = {
 	}
 };
 
-/** @type {import('svelte/store').Readable<boolean>} */
+/** @type {typeof import('$app/stores').navigating} */
 const navigating = {
-	/** @param {(value: any) => void} fn */
 	subscribe(fn) {
 		const store = getStores().navigating;
 		return store.subscribe(fn);
@@ -62,32 +56,42 @@ const navigating = {
 };
 
 /** @param {string} verb */
-const error = (verb) => {
+const throw_error = (verb) => {
 	throw new Error(
-		ssr
-			? `Can only ${verb} session store in browser`
-			: `Cannot ${verb} session store before subscribing`
+		browser
+			? `Cannot ${verb} session store before subscribing`
+			: `Can only ${verb} session store in browser`
 	);
 };
 
-/** @type {import('svelte/store').Writable<any>} */
+/** @type {typeof import('$app/stores').session} */
 const session = {
 	subscribe(fn) {
 		const store = getStores().session;
 
-		if (!ssr) {
+		if (browser) {
 			session.set = store.set;
 			session.update = store.update;
 		}
 
 		return store.subscribe(fn);
 	},
-	set: (value) => {
-		error('set');
+	set: () => throw_error('set'),
+	update: () => throw_error('update')
+};
+
+/** @type {typeof import('$app/stores').updated} */
+const updated = {
+	subscribe(fn) {
+		const store = getStores().updated;
+
+		if (browser) {
+			updated.check = store.check;
+		}
+
+		return store.subscribe(fn);
 	},
-	update: (updater) => {
-		error('update');
-	}
+	check: () => throw_error('check')
 };
 
-export { getStores, navigating, page, session, stores };
+export { getStores, navigating, page, session, stores, updated };

package/assets/client/singletons.js

@@ -0,0 +1,13 @@
+/** @type {import('./types').Client} */
+let client;
+
+/**
+ * @param {{
+ *   client: import('./types').Client;
+ * }} opts
+ */
+function init(opts) {
+	client = opts.client;
+}
+
+export { client, init };