refactor: ♻️ update definitions

Author: spences10

definitions/$app.forms.md

@@ -16,7 +16,7 @@ action results.
 ## Example
 
 ```svelte
-<script>
+<script lang="ts">
   import { enhance } from '$app/forms';
 </script>
 

definitions/$app.paths.md

@@ -16,10 +16,10 @@ route IDs respecting `config.kit.paths`.
 ## Example
 
 ```svelte
-<script>
+<script lang="ts">
   import { asset, resolve } from '$app/paths';
-  const img = asset('/logo.png');
-  const url = resolve('/blog/[slug]', { slug: 'hello-world' });
+  const img: string = asset('/logo.png');
+  const url: string = resolve('/blog/[slug]', { slug: 'hello-world' });
 </script>
 
 <img src={img} alt="logo" />

definitions/$app.state.md

@@ -21,7 +21,7 @@ Note: `$app/state` values update reactively only via runes (e.g.
 ## Example
 
 ```svelte
-<script>
+<script lang="ts">
   import { page, navigating, updated } from '$app/state';
   const path = $derived(page.url.pathname);
 </script>

definitions/$app.stores.md

@@ -17,7 +17,7 @@ identical APIs via runes). Existing apps may still use `$app/stores`.
 ## Example
 
 ```svelte
-<script>
+<script lang="ts">
   import { page, navigating, updated } from '$app/stores';
   $: title = $page.url.pathname;
 </script>

definitions/$derived.by.md

@@ -12,10 +12,10 @@ computations
 
 ## Examples
 
-```js
+```ts
 // Expensive computation that should be memoized
-let items = $state([1, 2, 3, 4, 5]);
-let filter = $state('even');
+let items: number[] = $state([1, 2, 3, 4, 5]);
+let filter: 'even' | 'odd' = $state('even');
 
 const expensiveResult = $derived.by(() => {
 	console.log('Computing expensive result...');
@@ -47,7 +47,7 @@ const processedData = $derived.by(() => {
 
 // When you need multiple statements
 const validation = $derived.by(() => {
-	const errors = [];
+	const errors: string[] = [];
 
 	if (items.length === 0) {
 		errors.push('Items cannot be empty');
@@ -75,7 +75,7 @@ async function like() {
 }
 
 // Destructuring: each piece remains reactive
-let { a, b } = $derived(getPair()); // roughly equivalent to $derived(getPair().a) and ...b
+let { a, b } = $derived(getPair()); // each remains reactive
 
 // Dependency control
 let total2 = $derived.by(() => {

definitions/$state.md

@@ -1,37 +1,29 @@
 # $state Definition
 
-**Definition:** Creates reactive state that triggers UI updates when
-the value changes  
-**Syntax:** `$state<T>(initial: T): T` |
-`$state<T>(): T | undefined`  
-**Parameters:**
-
-- `initial` - The initial value (optional)  
-  **Returns:** Reactive proxy of the initial value  
-  **Variants:**
-- `$state.raw<T>(initial: T): T` - Non-deeply-reactive state
-- `$state.snapshot<T>(state: T): Snapshot<T>` - Static snapshot of
-  reactive state
+**Definition:** Declares reactive state. When the value changes, the
+UI updates. Arrays and plain objects become deeply reactive proxies;
+primitives (like numbers/strings/booleans) remain normal values.  
+**Also see:** `$state.raw`, `$state.snapshot`
 
 ## Examples
 
-```js
+```ts
 // Basic reactive state
 let count = $state(0);
-count++; // Triggers reactivity
+count++; // triggers an update
 
-// Object state (deeply reactive)
+// Object/array state (deeply reactive)
 let user = $state({ name: 'Alice', age: 30 });
-user.name = 'Bob'; // Triggers reactivity
+user.name = 'Bob'; // triggers an update of only the places that read `user.name`
 
-// Optional initial value
+// You can declare without an initial value with generics
 let data = $state<string>(); // undefined initially
 ```
 
 ## Notes
 
-- Deep reactivity: Arrays and simple objects are proxied deeply, so
-  property changes and array methods (e.g., `push`) trigger granular
+- Deep reactivity: Arrays and simple objects are proxied deeply;
+  property changes and array methods (e.g. `push`) trigger granular
   updates.
 - Raw state: Use `$state.raw` to avoid deep reactivity and update only
   on reassignment for performance with large data.

definitions/+layout.server.ts.md

@@ -22,7 +22,7 @@ import type { LayoutServerLoad } from './$types';
 import { error } from '@sveltejs/kit';
 
 export const load: LayoutServerLoad = async ({ locals }) => {
-	if (!locals.user) error(401, 'not logged in');
+	if (!locals.user) throw error(401, 'not logged in');
 	return { user: locals.user };
 };
 ```

definitions/+page.server.ts.md

@@ -29,9 +29,9 @@ export const load: PageServerLoad = async ({
 	locals,
 }) => {
 	const session = cookies.get('sessionid');
-	if (!session) redirect(307, '/login');
+	if (!session) throw redirect(307, '/login');
 	const user = await locals.db.getUser(session);
-	if (!user) error(401, 'not logged in');
+	if (!user) throw error(401, 'not logged in');
 	return { user };
 };
 

definitions/actions.md

@@ -20,15 +20,16 @@ to handle POSTed form data and mutations.
 
 ```ts
 // +page.server.ts
+import type { Actions } from './$types';
 import { fail, redirect } from '@sveltejs/kit';
 
-export const actions = {
+export const actions: Actions = {
 	login: async ({ request, locals }) => {
 		const data = await request.formData();
 		const email = data.get('email');
 		if (!email) return fail(400, { message: 'Email required' });
 		await locals.auth.login(email as string);
-		redirect(303, '/dashboard');
+		throw redirect(303, '/dashboard');
 	},
 };
 ```

definitions/cookies.md

@@ -7,9 +7,11 @@ requests.
 
 **API:**
 
-- `get(name)` — read a cookie
-- `set(name, value, options)` — set cookie
-- `delete(name, options)` — delete cookie
+- `get(name)` — read a cookie (optionally `getAll()`)
+- `set(name, value, { path, ...options })` — set cookie (path is
+  required)
+- `delete(name, { path, ...options })` — delete cookie (path must
+  match)
 
 **Returns:** Cookie helpers bound to the current request.
 
@@ -18,6 +20,7 @@ requests.
 ```ts
 export const load = ({ cookies }) => {
 	const theme = cookies.get('theme') ?? 'light';
+	cookies.set('seen', '1', { path: '/', httpOnly: true });
 	return { theme };
 };
 ```
@@ -28,5 +31,5 @@ export const load = ({ cookies }) => {
 
 Notes:
 
-- `event.fetch` forwards cookies for same-origin and certain
-  subdomains; otherwise add them in `handleFetch`.
+- `event.fetch` forwards cookies for same-origin requests; to forward
+  to other origins, add headers in `handleFetch`.