@sveltejs/kit 1.0.0-next.34 → 1.0.0-next.342

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 init svelte 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,16 @@
+export { prerendering } from '../env.js';
+
+/**
+ * @type {import('$app/env').browser}
+ */
+const browser = !import.meta.env.SSR;
+/**
+ * @type {import('$app/env').dev}
+ */
+const dev = !!import.meta.env.DEV;
+/**
+ * @type {import('$app/env').mode}
+ */
+const mode = import.meta.env.MODE;
+
+export { browser, dev, mode };

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/app/stores.js

@@ -0,0 +1,97 @@
+import { getContext } from 'svelte';
+import { browser } from './env.js';
+import '../env.js';
+
+// TODO remove this (for 1.0? after 1.0?)
+let warned = false;
+function stores() {
+	if (!warned) {
+		console.error('stores() is deprecated; use getStores() instead');
+		warned = true;
+	}
+	return getStores();
+}
+
+/**
+ * @type {import('$app/stores').getStores}
+ */
+const getStores = () => {
+	const stores = getContext('__svelte__');
+
+	return {
+		page: {
+			subscribe: stores.page.subscribe
+		},
+		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
+			};
+		},
+		session: stores.session,
+		updated: stores.updated
+	};
+};
+
+/** @type {typeof import('$app/stores').page} */
+const page = {
+	/** @param {(value: any) => void} fn */
+	subscribe(fn) {
+		const store = getStores().page;
+		return store.subscribe(fn);
+	}
+};
+
+/** @type {typeof import('$app/stores').navigating} */
+const navigating = {
+	subscribe(fn) {
+		const store = getStores().navigating;
+		return store.subscribe(fn);
+	}
+};
+
+/** @param {string} verb */
+const throw_error = (verb) => {
+	throw new Error(
+		browser
+			? `Cannot ${verb} session store before subscribing`
+			: `Can only ${verb} session store in browser`
+	);
+};
+
+/** @type {typeof import('$app/stores').session} */
+const session = {
+	subscribe(fn) {
+		const store = getStores().session;
+
+		if (browser) {
+			session.set = store.set;
+			session.update = store.update;
+		}
+
+		return store.subscribe(fn);
+	},
+	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);
+	},
+	check: () => throw_error('check')
+};
+
+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 };