Merge branch 'main' into fix-highlighting

Author: Ocean-OS

.github/workflows/docs-preview-create.yml

@@ -19,8 +19,8 @@ on:
         description: 'Branch (eg. my-feature-branch)'
         required: true
         type: string
-      check_id:
-        description: 'The ID of the check that triggered this workflow'
+      sha:
+        description: 'The commit SHA responsible for triggering this workflow'
         required: false
         type: string
 
@@ -66,9 +66,11 @@ jobs:
 
       - name: Push
         id: push
-        run: git add -A && git commit -m "sync docs for check run ${{ inputs.check_id }}" && git push -u origin ${{ env.BRANCH }} --force
+        continue-on-error: true
+        run: git add -A && git commit -m "sync docs for repo ${{ inputs.repo }}, pr ${{ inputs.pr }}, commit ${{ inputs.sha }}" && git push -u origin ${{ env.BRANCH }} --force
 
       - name: Request preview comment
+        if: ${{ steps.push.outcome == 'success' }}
         uses: peter-evans/repository-dispatch@v3
         with:
           event-type: 'request-preview-comment'
@@ -77,3 +79,15 @@ jobs:
               "repo": "${{ inputs.repo }}",
               "pr": "${{ inputs.pr }}"
             }
+
+      - name: Dispatch docs-unaffected
+        if: ${{ steps.push.outcome != 'success' }}
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          event-type: 'docs-unaffected'
+          client-payload: |-
+            {
+              "repo": "${{ inputs.repo }}",
+              "pr": "${{ inputs.pr }}",
+              "sha": "${{ inputs.sha }}"
+            }

apps/svelte.dev/content/blog/2025-09-01-whats-new-in-svelte-september-2025.md

@@ -0,0 +1,93 @@
+---
+title: "What's new in Svelte: September 2025"
+description: 'Deno support, await in consts and open telemetry support'
+author: Dani Sandoval
+authorURL: https://dreamindani.com
+---
+
+In case you missed it, the main Svelte blog covered how to use [SvelteKit's new OpenTelemetry traces](https://svelte.dev/blog/sveltekit-integrated-observability) to reliably set up observability instrumentation using instrumentation.server.ts. This month's round up covers that release and a few other features that rolled out before and after it.
+
+Plenty in the showcase, as well, so let's dive in!
+
+## What's new in Svelte and Svelte CLI (sv)
+
+- `await` is now allowed inside `@const` declarations (**[email protected]**, [Docs](https://svelte.dev/docs/svelte/await), [#16542](https://github.com/sveltejs/svelte/pull/16542))
+- The `sv add` command has been updated to remove the `--no-preconditions` and add `--no-git-check`. With this new flag, even if some files are dirty, no prompt will be shown (**[email protected]**, [Docs](https://svelte.dev/docs/cli/sv-add), [#650](https://github.com/sveltejs/cli/pull/650))
+
+## What's new in SvelteKit and its adapters
+
+- Deno is now supported as a supported package manager (**sveltejs/[email protected]**, [#14163](https://github.com/sveltejs/kit/pull/14163))
+- A new `instrumentation.server.ts` adds tracing and observability setup (**sveltejs/[email protected]**, [Docs](https://svelte.dev/docs/kit/observability), [#13899](https://github.com/sveltejs/kit/pull/13899))
+- The `--preserve-output` flag prevents deletion of the output directory before packaging (**sveltejs/[email protected]**, [Docs](https://svelte.dev/docs/kit/packaging), [#13055](https://github.com/sveltejs/kit/pull/13055))
+
+For a full list of bug fixes in Svelte, SvelteKit and its adapters, check out their CHANGELOGs [here](https://github.com/sveltejs/svelte/blob/main/packages/svelte/CHANGELOG.md) and [here](https://github.com/sveltejs/kit/tree/main/packages).
+
+---
+
+## Community Showcase
+
+### Apps & Sites built with Svelte
+
+- [Pollinate](https://apps.apple.com/us/app/pollinate-pollen-forecast/id6749463028) provides accurate forecasts designed for allergy sufferers who want to plan their day, or vacation, around pollen levels (Check out the [Reddit post](https://www.reddit.com/r/sveltejs/comments/1mk05ym/mobile_app_made_with_svelte_5_capacitor/) on how it was built)
+- [Ferndesk](https://ferndesk.com/) is a help center that is kept up to date automatically (the creator shared their demo on the [Svelte Reddit](https://www.reddit.com/r/sveltejs/comments/1mqe9ez/i_built_a_tool_that_keeps_your_help_center_up_to/))
+- [Wplace](https://wplace.live/) lets you paint whatever you want on a map of the world
+- [Domain Watcher](https://github.com/Scorpio3310/domain-watcher) is a domain availability monitor and expiration tracker built with SvelteKit & Cloudflare Workers
+- [Motley](https://trymotley.com/) is a local-first bookmarking/moodboard app
+- [TallyHo](https://tallyho.app/) is a simple time tracking for freelancers
+- [MenuScan](https://www.getmenuscan.app/) lets you take a picture of any restuarant menu and get access to the calorie and macro counts for each item
+- [Vibe Check](https://vibechecked.app/) provides quick, honest diagnostics for AI‑built apps
+- [Joyful](https://joyful.to/) is a simple way to write, design, and send beautiful newsletters
+- [Eagle Cite](https://eaglecite.com/) lets you highlight, organize, and search your citations in one place
+- [Volkara](https://volkara.stormlightlabs.org/) is a set of ADHD-Friendly Productivity Tools
+- [Simple Man Archive](https://simplemanarchive.com/) is an ASCII art archive where anyone can contribute by creating unique ASCII art
+- [Thirty](https://github.com/thirtycalendar/thirty) is an open-source AI calendar built on familiar foundations
+- [Timezones](https://time.tem.dev/) quickly shows and converts timezones across many locations
+
+### Learning Resources
+
+_Featuring Svelte Contributors and Ambassadors_
+
+- [Compile Svelte 5 in your head](https://lihautan.com/compile-svelte-5-in-your-head) by Tan Li Hau
+- [Introducing SvelteKit Remote Functions](https://www.youtube.com/watch?v=0hy7PCbXyqs) by Simon Holthausen
+- [The Svelte MCP server](https://www.reddit.com/r/sveltejs/comments/1mju9yj/new_features_in_the_svelte_mcp_server_directly/) now allows you to directly reference documentation sections, and prompt templates
+
+_This Week in Svelte_
+
+- [Ep. 112](https://www.youtube.com/watch?v=GQLgq09-knM) — Storybook for Svelte Part 1
+- [Ep. 113](https://www.youtube.com/watch?v=aerlBIuinFQ) — Storybook for Svelte Part 2 - Docs
+- [Ep. 114](https://www.youtube.com/watch?v=FnUWuLQDCfM) — Changelog Review
+
+_To Read_
+
+- [Securing the supply chain at scale: Starting with 71 important open source projects](https://github.blog/open-source/maintainers/securing-the-supply-chain-at-scale-starting-with-71-important-open-source-projects/) by GitHub
+- [Epicenter (YC S25)](https://www.reddit.com/r/sveltejs/comments/1mjqq3t/update_epicenter_yc_s25_just_sponsored_our_first/) is sponsoring Svelte maintainers to spend their time half pushing local-first OSS forward with Epicenter and half building their dream projects
+- [Project Two: Creating Mobile app using Tauri + Svelte](https://minosiants.com/blog/two-project) by Kaspar Minosiants
+- [Ways to use Anime.js with Svelte](https://brandonma.dev/blog/animejs-svelte/) by Brandon Ma
+- [Svelte, Markdown, and the Magic of Web Components](https://www.sh4jid.me/blog/svelte-markdown-and-the-magic-of-web-components) by Shajid Hasan
+
+_To Watch_
+
+- [SvelteKit Remote Functions are INSANE! Type-Safe Full Stack in Minutes](https://www.youtube.com/watch?v=Xbdiwq_88iE) by Tyler Codes
+- [Deploy a SvelteKit Application to Cloudflare Workers with Drizzle & D1](https://www.youtube.com/watch?v=ZZaExhqW5II) by Jilles Soeters
+
+### Libraries, Tools & Components
+
+- [EXE](https://github.com/Hugo-Dz/exe) is a build tool to distribute your full-stack web app as a single executable binary with zero runtime dependencies
+- [Svelte Sortable List](https://github.com/rodrigodagostino/svelte-sortable-list) is a comprehensive package for creating accessible, sortable lists in Svelte applications
+- [Markdown UI](https://github.com/BlueprintLabIO/markdown-ui) turns static docs into interactive experiences - instantly
+- [Tark UI](https://www.tarkui.com/) provides beautiful UI components built with Ark UI and Tailwind
+- [Uniface Element](https://github.com/ticatec/uniface-element) is a comprehensive enterprise-grade UI component library built with Svelte 5, designed for modern web applications
+- [microfolio](https://github.com/aker-dev/microfolio) is a modern static portfolio generator featuring a file-based content management system using folders and Markdown files
+- [Keycloakify](https://docs.keycloakify.dev/) is a tool for creating custom Keycloak themes, enabling you to modify the appearance and behavior of Keycloak's user interfaces
+- [PDJsonEditor](https://github.com/podosoft-dev/pdjsoneditor) is a powerful JSON visualization and editing tool with both a code editor and interactive graph views
+- [Show & Svelte](https://github.com/retrotheft/show-and-svelte) lets you create fully interactive presentations with Svelte
+- [wuchale](https://github.com/wuchalejs/wuchale) is a compile-time internationalization (i18n) toolkit that requires zero code changes
+- [svelte-overflow-fade](https://github.com/harshmandan/svelte-overflow-fade?tab=readme-ov-file) is a Svelte action and attachment for adding beautiful fade effects to overflowing content
+- [formshape](https://www.npmjs.com/package/formshape) is a type-safe form validation for SvelteKit Remote Functions using Standard Schema compatible validators
+- [vite-plugin-svelte-inline-component](https://github.com/hanielu/vite-plugin-svelte-inline-component) lets you write tiny Svelte components straight inside your JavaScript / TypeScript tests using tagged‑template literals.
+- [vite-plugin-sveltekit-decorators](https://github.com/KiraPC/vite-plugin-sveltekit-decorators) is a Vite plugin that automatically decorates SvelteKit functions with customizable wrappers for logging, analytics, error handling, and more
+- [jetbrains-svelte-templates](https://github.com/ruben-sprengel/jetbrains-svelte-templates) is a compact collection of Live Templates for JetBrains IDEs (like WebStorm and IntelliJ IDEA Ultimate) designed to speed up your Svelte & SvelteKit development
+
+That's it for this month! Let us know if we missed anything on [Reddit](https://www.reddit.com/r/sveltejs/) or [Discord](https://discord.gg/svelte).
+
+Until next time 👋🏼!

apps/svelte.dev/content/docs/kit/20-core-concepts/60-remote-functions.md

@@ -163,15 +163,15 @@ Both the argument and the return value are serialized with [devalue](https://git
 
 ### Refreshing queries
 
-Any query can be updated via its `refresh` method:
+Any query can be re-fetched via its `refresh` method, which retrieves the latest value from the server:
 
 ```svelte
 <button onclick={() => getPosts().refresh()}>
 	Check for new posts
 </button>
 ```
 
-> [!NOTE] Queries are cached while they're on the page, meaning `getPosts() === getPosts()`. This means you don't need a reference like `const posts = getPosts()` in order to refresh the query.
+> [!NOTE] Queries are cached while they're on the page, meaning `getPosts() === getPosts()`. This means you don't need a reference like `const posts = getPosts()` in order to update the query.
 
 ## form
 
@@ -271,6 +271,9 @@ import * as v from 'valibot';
 import { error, redirect } from '@sveltejs/kit';
 import { query, form } from '$app/server';
 const slug = '';
+const post = { id: '' };
+/** @type {any} */
+const externalApi = '';
 // ---cut---
 export const getPosts = query(async () => { /* ... */ });
 
@@ -286,6 +289,15 @@ export const createPost = form(async (data) => {
 	// Redirect to the newly created page
 	redirect(303, `/blog/${slug}`);
 });
+
+export const updatePost = form(async (data) => {
+	// form logic goes here...
+	const result = externalApi.update(post);
+
+	// The API already gives us the updated post,
+	// no need to refresh it, we can set it directly
+	+++await getPost(post.id).set(result);+++
+});
 ```
 
 The second is to drive the single-flight mutation from the client, which we'll see in the section on [`enhance`](#form-enhance).
@@ -542,6 +554,9 @@ export const addLike = command(v.string(), async (id) => {
 	`;
 
 	+++getLikes(id).refresh();+++
+	// Just like within form functions you can also do
+	// getLikes(id).set(...)
+	// in case you have the result already
 });
 ```
 

apps/svelte.dev/content/docs/kit/30-advanced/68-observability.md

@@ -4,7 +4,7 @@ title: Observability
 ---
 
 <blockquote class="since note">
-	<p>Available since 2.29</p>
+	<p>Available since 2.31</p>
 </blockquote>
 
 Sometimes, you may need to observe how your application is behaving in order to improve performance or find the root cause of a pesky bug. To help with this, SvelteKit can emit server-side [OpenTelemetry](https://opentelemetry.io) spans for the following:

apps/svelte.dev/content/docs/kit/60-appendix/10-faq.md

@@ -144,7 +144,7 @@ How to setup rewrites in production will depend on your deployment platform. If
 /// file: src/routes/api/[...path]/+server.js
 /** @type {import('./$types').RequestHandler} */
 export function GET({ params, url }) {
-	return fetch(`https://my-api-server.com/${params.path + url.search}`);
+	return fetch(`https://example.com/${params.path + url.search}`);
 }
 ```
 

apps/svelte.dev/content/docs/kit/98-reference/[email protected]

@@ -2191,6 +2191,13 @@ type RemotePrerenderFunction<Input, Output> = (
 
 ```dts
 type RemoteQuery<T> = RemoteResource<T> & {
+	/**
+	 * On the client, this function will update the value of the query without re-fetching it.
+	 *
+	 * On the server, this can be called in the context of a `command` or `form` and the specified data will accompany the action response back to the client.
+	 * This prevents SvelteKit needing to refresh all queries on the page in a second server round-trip.
+	 */
+	set(value: T): void;
 	/**
 	 * On the client, this function will re-fetch the query from the server.
 	 *
@@ -2211,7 +2218,7 @@ type RemoteQuery<T> = RemoteResource<T> & {
 	 *   await submit().updates(
 	 *     todos.withOverride((todos) => [...todos, { text: data.get('text') }])
 	 *   );
-	 * }}>
+	 * })}>
 	 *   <input type="text" name="text" />
 	 *   <button type="submit">Add Todo</button>
 	 * </form>

apps/svelte.dev/content/docs/kit/98-reference/27-$service-worker.md

@@ -44,7 +44,7 @@ const build: string[];
 
 ## files
 
-An array of URL strings representing the files in your static directory, or whatever directory is specified by `config.kit.files.assets`. You can customize which files are included from `static` directory using [`config.kit.serviceWorker.files`](/docs/kit/configuration)
+An array of URL strings representing the files in your static directory, or whatever directory is specified by `config.kit.files.assets`. You can customize which files are included from `static` directory using [`config.kit.serviceWorker.files`](/docs/kit/configuration#serviceWorker)
 
 <div class="ts-block">
 

apps/svelte.dev/content/docs/kit/98-reference/50-configuration.md

@@ -289,7 +289,9 @@ This is useful for allowing trusted third-party services like payment gateways o
 
 If the array contains `'*'`, all origins will be trusted. This is generally not recommended!
 
-**Warning**: Only add origins you completely trust, as this bypasses CSRF protection for those origins.
+> [!NOTE] Only add origins you completely trust, as this bypasses CSRF protection for those origins.
+
+CSRF checks only apply in production, not in local development.
 
 </div>
 </div>

apps/svelte.dev/content/docs/svelte/07-misc/04-custom-elements.md

@@ -5,7 +5,7 @@ title: Custom elements
 
 <!-- - [basically what we have today](https://svelte.dev/docs/custom-elements-api) -->
 
-Svelte components can also be compiled to custom elements (aka web components) using the `customElement: true` compiler option. You should specify a tag name for the component using the `<svelte:options>` [element](svelte-options).
+Svelte components can also be compiled to custom elements (aka web components) using the `customElement: true` compiler option. You should specify a tag name for the component using the `<svelte:options>` [element](svelte-options). Within the custom element you can access the host element via the [`$host`](https://svelte.dev/docs/svelte/$host) rune.
 
 ```svelte
 <svelte:options customElement="my-element" />

apps/svelte.dev/package.json

@@ -52,7 +52,7 @@
 		"@supabase/supabase-js": "^2.43.4",
 		"@sveltejs/adapter-vercel": "^5.10.2",
 		"@sveltejs/enhanced-img": "^0.8.1",
-		"@sveltejs/kit": "^2.34.0",
+		"@sveltejs/kit": "^2.37.0",
 		"@sveltejs/site-kit": "workspace:*",
 		"@sveltejs/vite-plugin-svelte": "^6.1.3",
 		"@types/cookie": "^0.6.0",