Merge branch 'svelte-4' of https://github.com/sveltejs/svelte into fix_login

xyzqm · xyzqm · commit 95ff9ed200c4 · 2024-02-08T19:14:32.000-08:00
diff --git a/documentation/blog/2024-02-01-whats-new-in-svelte-february-2024.md b/documentation/blog/2024-02-01-whats-new-in-svelte-february-2024.md
@@ -0,0 +1,77 @@
+---
+title: "What's new in Svelte: February 2024"
+description: 'New in Kit: `reroute`, `emulate` and more!'
+author: Dani Sandoval
+authorURL: https://dreamindani.com
+---
+
+Since SvelteKit 2.0 released late last year, there's been a bunch of new features to make the Kit dev experience even better! Meanwhile the Svelte team has been hard at work making Svelte 5 a reality.
+
+In case you missed it, Rich also posted [Tenets](https://github.com/sveltejs/svelte/discussions/10085#discussion-6029409), "an attempt to articulate the Svelte philosophy — our bedrock principles, that guide our design decisions."
+
+So let's dive in to check out what's new and see what the rest of the community has been up to...
+
+## What's new in SvelteKit
+
+- The client router is now tree shakeable (**2.1.0**, [#11340](https://github.com/sveltejs/kit/pull/11340))
+- `$env/static/public` is now exposed in service workers (**2.2.0**, [Docs](https://kit.svelte.dev/docs/modules#env-static-public), [#10994](https://github.com/sveltejs/kit/pull/10994))
+- `style-src-elem` is now supported in environments with a Content Security Policy (**2.2.1**, [Docs](https://kit.svelte.dev/docs/types#private-types-cspdirectives), [#11562](https://github.com/sveltejs/kit/pull/11562))
+- The new `reroute` hook allows you to change how URLs are translated into routes (**2.3.0**, [Docs](https://kit.svelte.dev/docs/hooks#universal-hooks-reroute), [#11537](https://github.com/sveltejs/kit/pull/11537))
+- The `read` function is now available in the `$app/server` module - allowing you to read assets from the filesystem (**2.4.0**, [Docs](https://kit.svelte.dev/docs/modules#app-server-read), [#11649](https://github.com/sveltejs/kit/pull/11649))
+- Adapters can now `emulate` the prod environment for dev and preview servers by implementing the corresponding functions. This is useful for providing access to e.g. KV namespaces in development (**2.5.0**, [Docs](https://kit.svelte.dev/docs/writing-adapters), [#11730](https://github.com/sveltejs/kit/pull/11730))
+
+
+## What's new in Svelte
+
+In case you missed it, [Svelte 5 is in preview](https://svelte-5-preview.vercel.app/docs/introduction). In the meantime, Svelte 4 (`@latest`) has had one bugfix release. There's just one new feature to highlight from the Svelte 5 changelog:
+
+- Snippets can now take multiple arguments (**5.0.0-next.42**, [Docs](https://svelte-5-preview.vercel.app/docs/snippets), [#9988](https://github.com/sveltejs/svelte/pull/9988))
+
+For all the bug fixes, chores and underlying work required to get Svelte 5 to release-ready, check out [the CHANGELOG on main](https://github.com/sveltejs/svelte/blob/main/packages/svelte/CHANGELOG.md).
+
+
+---
+
+## Community Showcase
+
+**Apps & Sites built with Svelte**
+
+- [Sprite Fusion](https://www.spritefusion.com/) is a free level design tool to craft beautiful 2D tilemaps right in your browser using any tileset
+- [TypeMeUp](https://github.com/bskdany/typemeup) a typing website that teaches you how to type faster
+- [Pathfinding Algorithm Visualizer](https://github.com/baterson/pathfinding-visualizer) is an interactive pathfinding algorithm visualizer with player functionality
+- [Roch Dog](https://rochdog.com/en) ranks businesses and hotels based on how dog-friendly they are
+- [highlight.cool](https://highlight.cool/) is a free, customizable, and real-time highlighting tool for your blog
+- [Nola Devs](https://www.noladevs.org/) is a vibrant and inclusive software developers group nestled in the heart of New Orleans. This site aggregates all their events across groups
+- [Startup Funding Simulator](https://www.fundingsimulator.com/) is a tool to help founders understand how modern fundraising (with safes) works, and how much dilution you can expect when raising money.
+
+**Learning Resources**
+
+_Featuring Svelte Contributors and Ambassadors_
+- [New SvelteKit feature: `import { read } from '$app/server'`](https://www.youtube.com/watch?v=m4G-6dyF1MU) by Rich Harris
+- [Reading assets on the server in SvelteKit](https://geoffrich.net/posts/sveltekit-read/) by Geoff Rich
+- [Tan Li Hau's new book](https://packt.link/Z4hXD), _Real-World Svelte_ is out now
+- [Svelte Society San Diego - January 2024](https://www.youtube.com/watch?v=oH7XFAKh6W8): Attila covers the latest updates on Svelte 5 and also SvelteKit.
+- [Svelte London - January 2024](https://www.youtube.com/watch?v=eswNQiq4T2w): featuring talks from both Rich Harris and pngwn
+- [Svelte 5: Speed, Simplicity & Size](https://syntax.fm/show/723/svelte-5-speed-simplicity-and-size) by Syntax.FM
+- This Week in Svelte:
+  - [12 Jan 2024](https://www.youtube.com/watch?v=86NNiIG_ncU): A deep dive into the SvelteKit Changelog
+  - [19 Jan 2024](https://www.youtube.com/watch?v=AWL_xCPT-5Q): Showcasing a new library from Paolo Ricciuti
+  - [26 Jan 2024](https://www.youtube.com/watch?v=_SraKYKkQAc): Featuring "Cells" - a functional and reactive programming library
+
+_To Read_
+
+- [Customise font in TailwindCSS with SvelteKit](https://www.launchnow.pro/blog/customise-font-tailwindcss-sveltekit) by Launchnow
+- [Svelte from the perspective of an Angular developer (for Svelte devs)](https://kylenazario.com/blog/svelte-from-angular-perspective-for-svelte) and [How to create a sitemap for your SvelteKit blog](https://kylenazario.com/blog/sveltekit-blog-sitemap) by Kyle Nazario
+- [Get Up and Running with Svelte on the Internet Computer](https://blog.icacademy.at/blog/svelte-ic-starter) by Roland BOLE
+- [SvelteKit + Socket.io server deployed on deno](https://devr.me/socket-io-deno) by Devr
+
+
+**Libraries, Tools & Components**
+
+- [Lucia](https://github.com/lucia-auth/lucia/discussions/1361) - an auth library written in TypeScript that abstracts away the complexity of handling sessions - has just released its 3.0 version
+- [Paraglide JS Adapter SvelteKit](https://inlang.com/m/dxnzrydw/library-inlang-paraglideJsAdapterSvelteKit) is a SvelteKit integration for ParaglideJS - a tool for i18n routing
+
+
+That's it for this month! Feel free to let us know if we missed anything on [Reddit](https://www.reddit.com/r/sveltejs/) or [Discord](https://discord.gg/svelte).
+
+See ya next month!
diff --git a/packages/svelte/CHANGELOG.md b/packages/svelte/CHANGELOG.md
@@ -1,5 +1,17 @@
 # svelte
 
+## 4.2.10
+
+### Patch Changes
+
+- fix: add `scrollend` event type ([#10336](https://github.com/sveltejs/svelte/pull/10336))
+
+- fix: add `fetchpriority` attribute type ([#10390](https://github.com/sveltejs/svelte/pull/10390))
+
+- fix: Add `miter-clip` and `arcs` to `stroke-linejoin` attribute ([#10377](https://github.com/sveltejs/svelte/pull/10377))
+
+- fix: make inline doc links valid ([#10366](https://github.com/sveltejs/svelte/pull/10366))
+
 ## 4.2.9
 
 ### Patch Changes
diff --git a/packages/svelte/elements.d.ts b/packages/svelte/elements.d.ts
@@ -179,6 +179,7 @@ export interface DOMAttributes<T extends EventTarget> {
 
 	// UI Events
 	'on:scroll'?: UIEventHandler<T> | undefined | null;
+	'on:scrollend'?: UIEventHandler<T> | undefined | null;
 	'on:resize'?: UIEventHandler<T> | undefined | null;
 
 	// Wheel Events
@@ -761,6 +762,7 @@ export interface HTMLImgAttributes extends HTMLAttributes<HTMLImageElement> {
 	alt?: string | undefined | null;
 	crossorigin?: 'anonymous' | 'use-credentials' | '' | undefined | null;
 	decoding?: 'async' | 'auto' | 'sync' | undefined | null;
+	fetchpriority?: 'auto' | 'high' | 'low' | undefined | null;
 	height?: number | string | undefined | null;
 	ismap?: boolean | undefined | null;
 	loading?: 'eager' | 'lazy' | undefined | null;
@@ -880,6 +882,7 @@ export interface HTMLLinkAttributes extends HTMLAttributes<HTMLLinkElement> {
 	sizes?: string | undefined | null;
 	type?: string | undefined | null;
 	charset?: string | undefined | null;
+	fetchpriority?: 'auto' | 'high' | 'low' | undefined | null;
 }
 
 export interface HTMLMapAttributes extends HTMLAttributes<HTMLMapElement> {
@@ -1014,6 +1017,7 @@ export interface HTMLScriptAttributes extends HTMLAttributes<HTMLScriptElement>
 	charset?: string | undefined | null;
 	crossorigin?: string | undefined | null;
 	defer?: boolean | undefined | null;
+	fetchpriority?: 'auto' | 'high' | 'low' | undefined | null;
 	integrity?: string | undefined | null;
 	nomodule?: boolean | undefined | null;
 	nonce?: string | undefined | null;
@@ -1402,7 +1406,15 @@ export interface SVGAttributes<T extends EventTarget> extends AriaAttributes, DO
 	'stroke-dasharray'?: string | number | undefined | null;
 	'stroke-dashoffset'?: string | number | undefined | null;
 	'stroke-linecap'?: 'butt' | 'round' | 'square' | 'inherit' | undefined | null;
-	'stroke-linejoin'?: 'miter' | 'round' | 'bevel' | 'inherit' | undefined | null;
+	'stroke-linejoin'?:
+		| 'arcs'
+		| 'miter-clip'
+		| 'miter'
+		| 'round'
+		| 'bevel'
+		| 'inherit'
+		| undefined
+		| null;
 	'stroke-miterlimit'?: string | undefined | null;
 	'stroke-opacity'?: number | string | undefined | null;
 	'stroke-width'?: number | string | undefined | null;
diff --git a/packages/svelte/package.json b/packages/svelte/package.json
@@ -1,6 +1,6 @@
 {
   "name": "svelte",
-  "version": "4.2.9",
+  "version": "4.2.10",
   "description": "Cybernetically enhanced web apps",
   "type": "module",
   "module": "src/runtime/index.js",
diff --git a/packages/svelte/scripts/generate-dts.js b/packages/svelte/scripts/generate-dts.js
@@ -35,6 +35,20 @@ await createBundle({
 
 // There's no way to tell in JS that a class can have arbitrary properties, so we need to add that manually
 const types = fs.readFileSync('types/index.d.ts', 'utf-8');
+
+const bad_links = [...types.matchAll(/\]\((\/[^)]+)\)/g)];
+if (bad_links.length > 0) {
+	console.error(
+		'The following links in JSDoc annotations should be prefixed with https://svelte.dev:'
+	);
+
+	for (const [, link] of bad_links) {
+		console.error(`- ${link}`);
+	}
+
+	process.exit(1);
+}
+
 fs.writeFileSync(
 	'types/index.d.ts',
 	// same line to not affect source map
diff --git a/packages/svelte/src/runtime/internal/lifecycle.js b/packages/svelte/src/runtime/internal/lifecycle.js
@@ -32,7 +32,7 @@ export function beforeUpdate(fn) {
  *
  * If a function is returned _synchronously_ from `onMount`, it will be called when the component is unmounted.
  *
- * `onMount` does not run inside a [server-side component](/docs#run-time-server-side-component-api).
+ * `onMount` does not run inside a [server-side component](https://svelte.dev/docs#run-time-server-side-component-api).
  *
  * https://svelte.dev/docs/svelte#onmount
  * @template T
@@ -71,7 +71,7 @@ export function onDestroy(fn) {
 }
 
 /**
- * Creates an event dispatcher that can be used to dispatch [component events](/docs#template-syntax-component-directives-on-eventname).
+ * Creates an event dispatcher that can be used to dispatch [component events](https://svelte.dev/docs#template-syntax-component-directives-on-eventname).
  * Event dispatchers are functions that can take two arguments: `name` and `detail`.
  *
  * Component events created with `createEventDispatcher` create a
diff --git a/packages/svelte/src/runtime/transition/index.js b/packages/svelte/src/runtime/transition/index.js
@@ -179,7 +179,7 @@ export function draw(node, { delay = 0, speed, duration, easing = cubicInOut } =
 }
 
 /**
- * The `crossfade` function creates a pair of [transitions](/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
+ * The `crossfade` function creates a pair of [transitions](https://svelte.dev/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
  *
  * https://svelte.dev/docs/svelte-transition#crossfade
  * @param {import('./public').CrossfadeParams & {
diff --git a/packages/svelte/src/shared/version.js b/packages/svelte/src/shared/version.js
@@ -6,5 +6,5 @@
  * https://svelte.dev/docs/svelte-compiler#svelte-version
  * @type {string}
  */
-export const VERSION = '4.2.9';
+export const VERSION = '4.2.10';
 export const PUBLIC_VERSION = '4';
diff --git a/packages/svelte/types/index.d.ts b/packages/svelte/types/index.d.ts
@@ -189,7 +189,7 @@ declare module 'svelte' {
 	 *
 	 * If a function is returned _synchronously_ from `onMount`, it will be called when the component is unmounted.
 	 *
-	 * `onMount` does not run inside a [server-side component](/docs#run-time-server-side-component-api).
+	 * `onMount` does not run inside a [server-side component](https://svelte.dev/docs#run-time-server-side-component-api).
 	 *
 	 * https://svelte.dev/docs/svelte#onmount
 	 * */
@@ -212,7 +212,7 @@ declare module 'svelte' {
 	 * */
 	export function onDestroy(fn: () => any): void;
 	/**
-	 * Creates an event dispatcher that can be used to dispatch [component events](/docs#template-syntax-component-directives-on-eventname).
+	 * Creates an event dispatcher that can be used to dispatch [component events](https://svelte.dev/docs#template-syntax-component-directives-on-eventname).
 	 * Event dispatchers are functions that can take two arguments: `name` and `detail`.
 	 *
 	 * Component events created with `createEventDispatcher` create a
@@ -1789,7 +1789,7 @@ declare module 'svelte/transition' {
 		getTotalLength(): number;
 	}, { delay, speed, duration, easing }?: DrawParams | undefined): TransitionConfig;
 	/**
-	 * The `crossfade` function creates a pair of [transitions](/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
+	 * The `crossfade` function creates a pair of [transitions](https://svelte.dev/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
 	 *
 	 * https://svelte.dev/docs/svelte-transition#crossfade
 	 * */

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "svelte",`
`3`		`- "version": "4.2.9",`
	`3`	`+ "version": "4.2.10",`
`4`	`4`	`"description": "Cybernetically enhanced web apps",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"module": "src/runtime/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ export function beforeUpdate(fn) {`
`32`	`32`	`*`
`33`	`33`	* If a function is returned _synchronously_ from `onMount`, it will be called when the component is unmounted.
`34`	`34`	`*`
`35`		- * `onMount` does not run inside a [server-side component](/docs#run-time-server-side-component-api).
	`35`	+ * `onMount` does not run inside a [server-side component](https://svelte.dev/docs#run-time-server-side-component-api).
`36`	`36`	`*`
`37`	`37`	`* https://svelte.dev/docs/svelte#onmount`
`38`	`38`	`* @template T`
`@@ -71,7 +71,7 @@ export function onDestroy(fn) {`
`71`	`71`	`}`
`72`	`72`
`73`	`73`	`/**`
`74`		`- * Creates an event dispatcher that can be used to dispatch [component events](/docs#template-syntax-component-directives-on-eventname).`
	`74`	`+ * Creates an event dispatcher that can be used to dispatch [component events](https://svelte.dev/docs#template-syntax-component-directives-on-eventname).`
`75`	`75`	* Event dispatchers are functions that can take two arguments: `name` and `detail`.
`76`	`76`	`*`
`77`	`77`	* Component events created with `createEventDispatcher` create a
Original file line number	Diff line number	Diff line change
`@@ -179,7 +179,7 @@ export function draw(node, { delay = 0, speed, duration, easing = cubicInOut } =`
`179`	`179`	`}`
`180`	`180`
`181`	`181`	`/**`
`182`		- * The `crossfade` function creates a pair of [transitions](/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
	`182`	+ * The `crossfade` function creates a pair of [transitions](https://svelte.dev/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
`183`	`183`	`*`
`184`	`184`	`* https://svelte.dev/docs/svelte-transition#crossfade`
`185`	`185`	`* @param {import('./public').CrossfadeParams & {`
Original file line number	Diff line number	Diff line change
`@@ -189,7 +189,7 @@ declare module 'svelte' {`
`189`	`189`	`*`
`190`	`190`	* If a function is returned _synchronously_ from `onMount`, it will be called when the component is unmounted.
`191`	`191`	`*`
`192`		- * `onMount` does not run inside a [server-side component](/docs#run-time-server-side-component-api).
	`192`	+ * `onMount` does not run inside a [server-side component](https://svelte.dev/docs#run-time-server-side-component-api).
`193`	`193`	`*`
`194`	`194`	`* https://svelte.dev/docs/svelte#onmount`
`195`	`195`	`* */`
`@@ -212,7 +212,7 @@ declare module 'svelte' {`
`212`	`212`	`* */`
`213`	`213`	`export function onDestroy(fn: () => any): void;`
`214`	`214`	`/**`
`215`		`- * Creates an event dispatcher that can be used to dispatch [component events](/docs#template-syntax-component-directives-on-eventname).`
	`215`	`+ * Creates an event dispatcher that can be used to dispatch [component events](https://svelte.dev/docs#template-syntax-component-directives-on-eventname).`
`216`	`216`	* Event dispatchers are functions that can take two arguments: `name` and `detail`.
`217`	`217`	`*`
`218`	`218`	* Component events created with `createEventDispatcher` create a
`@@ -1789,7 +1789,7 @@ declare module 'svelte/transition' {`
`1789`	`1789`	`getTotalLength(): number;`
`1790`	`1790`	`}, { delay, speed, duration, easing }?: DrawParams \| undefined): TransitionConfig;`
`1791`	`1791`	`/**`
`1792`		- * The `crossfade` function creates a pair of [transitions](/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
	`1792`	+ * The `crossfade` function creates a pair of [transitions](https://svelte.dev/docs#template-syntax-element-directives-transition-fn) called `send` and `receive`. When an element is 'sent', it looks for a corresponding element being 'received', and generates a transition that transforms the element to its counterpart's position and fades it out. When an element is 'received', the reverse happens. If there is no counterpart, the `fallback` transition is used.
`1793`	`1793`	`*`
`1794`	`1794`	`* https://svelte.dev/docs/svelte-transition#crossfade`
`1795`	`1795`	`* */`