diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 7742aaa9..a137c165 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -63,33 +63,43 @@ In full runtime mode, Editable also supports a simple owner-only admin authentic
 2. **Edit-for-fun mode** — unauthenticated, can temporarily edit the currently open page in the browser UI, but cannot save changes or access private site-management features
 3. **Public browsing mode** — normal site visitor mode with no editing UI active
 
+## Language: TypeScript
+
+The codebase is written in TypeScript throughout — modules use `.ts` (or `.svelte.ts` when they use runes), and Svelte components use `<script lang="ts">`. This follows the decision in [michael/editable#144](https://github.com/michael/editable/issues/144): Svelte developers are the primary technical extenders, and a schema-driven system gains unusually much from types.
+
+Guidelines:
+
+- **Non-strict for now.** `tsconfig.json` keeps `strict: false`; implicit `any` is allowed. The goal of the conversion is consistency and schema-derived autocomplete, not exhaustive type coverage. Strictness can be ratcheted up later.
+- **Readable surface, ceremonial internals.** Customizable node components (e.g. `Paragraph.svelte`, `Figure.svelte`) must stay light: typed props plus a typed `node`, nothing more. Internal modules (server code, `api.remote.ts`, `PagesDrawer`, overlays, commands) may carry heavier type ceremony where it stabilizes things.
+- **Schema-derived node types.** `src/lib/document_schema.ts` exports `type Nodes = NodeMap<typeof document_schema>` (from svedit). Node components access the session through the typed `get_svedit_context()` helper in `src/routes/svedit_context.ts` and annotate their node as `let node: Nodes['paragraph'] = $derived(svedit.session.get(path));`, which gives property autocomplete and catches misspelled properties in `npm run check`.
+- **Import specifiers keep the `.js` extension** even when the target file is `.ts` (TypeScript's `bundler` resolution and Vite both resolve `./foo.js` → `./foo.ts`). This matches svedit's own convention.
+- **`npm run check` must stay at 0 errors** and is the required validation step after schema or component changes.
+
 ## SvelteKit configuration
 
-The app uses Svelte's experimental async features and SvelteKit's remote functions. Both are enabled in `svelte.config.js`:
+The app uses Svelte's experimental async features and SvelteKit's remote functions. All SvelteKit configuration is passed to the `sveltekit()` plugin in `vite.config.ts` (the newer configuration style, expected to become the default in SvelteKit 3); `svelte.config.js` stays an empty stub so tools that require its presence keep working. The "svelte.config.js is ignored" warning printed by dev/build/check commands is expected with this setup.
 
-```js
-const config = {
-	kit: {
-		adapter: adapter(),
-		experimental: {
-			remoteFunctions: true
-		}
+```ts
+sveltekit({
+	adapter: adapter(),
+	experimental: {
+		remoteFunctions: true
 	},
 	compilerOptions: {
 		experimental: {
 			async: true
 		}
 	}
-};
+});
 ```
 
 **Experimental async** allows `await` in Svelte markup and top-level `await` in `<script>` tags, enabling components to load data inline without separate `+page.server.js` load functions.
 
 **Remote functions** (`$app/server`) allow server-side functions to be called directly from components via `query()` and `action()`. This replaces traditional REST endpoints for document loading and saving:
 
-- **`src/lib/api.remote.js`** — server-side functions for document and asset operations, called directly from components. Uses `query()` for reads and `action()` for writes. Access to `locals` (e.g. for auth checks) via `getRequestEvent()`.
+- **`src/lib/api.remote.ts`** — server-side functions for document and asset operations, called directly from components. Uses `query()` for reads and `action()` for writes. Access to `locals` (e.g. for auth checks) via `getRequestEvent()`.
 
-**Server initialization** — `src/hooks.server.js` exports an `init()` function (SvelteKit's `ServerInit` hook) that runs once on server startup. This is where database migration runs:
+**Server initialization** — `src/hooks.server.ts` exports an `init()` function (SvelteKit's `ServerInit` hook) that runs once on server startup. This is where database migration runs:
 
 ```js
 import migrate from '$lib/server/migrate.js';
@@ -200,7 +210,7 @@ CREATE TABLE sessions (
 
 **`documents`**
 
-- `document_id` — a persistent identifier (nanoid with a custom alphabet — letters only, no numbers, no `_` or `-` — so ids are safe to use as HTML ids; see `src/routes/nanoid.js`)
+- `document_id` — a persistent identifier (nanoid with a custom alphabet — letters only, no numbers, no `_` or `-` — so ids are safe to use as HTML ids; see `src/routes/nanoid.ts`)
 - `type` — categorizes the document, e.g. `page`, `nav`, or `footer`
 - `data` — the full Svedit document serialized as JSON (`{ document_id, nodes }`)
 
diff --git a/CLAUDE.md b/CLAUDE.md
index ad82dd7a..9a6dae5d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,11 +5,13 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ## Commands
 
 **Development:**
+
 - `npm run dev` - Start development server
 - `npm run build` - Build for production
 - `npm run preview` - Preview production build
 
 **Implementation Guidelines:**
+
 - Before implementing any feature, read `ARCHITECTURE.md` for design decisions and `IMPLEMENTATION_PLAN.md` for the step-by-step implementation spec
 - Design decisions go in `ARCHITECTURE.md`, implementation steps go in `IMPLEMENTATION_PLAN.md`
 - New features must be specified before implementation begins — the spec should be concise but sufficient to derive the implementation from
@@ -22,22 +24,26 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - In home-route server files, import backend-only code lazily inside the `has_backend` guard so static/Vercel deployments do not evaluate database code at module load time
 
 **Refactoring Guidelines:**
+
 - During refactors, make ONLY the minimal changes needed (e.g., renaming APIs)
 - Do NOT "improve" or restructure logic while refactoring
 - If you see something that could be improved, note it separately for a future task
 - Refactoring and improving are two separate activities - never combine them
 
 **Code Style:**
+
 - Use snake_case for all variable names, function names, and identifiers
 - This applies to JavaScript/TypeScript code, test files, and any new code written
 
 **Styling:**
+
 - Use Tailwind CSS classes whenever possible
 - Minimize custom CSS - only use it for things Tailwind can't handle (e.g., CSS custom properties like `var(--svedit-editing-stroke)`)
 - Use Tailwind's arbitrary value syntax for custom properties: `text-(--svedit-editing-stroke)`, `border-(--svedit-editing-stroke)`
 - Do not use rounded corners (keep elements rectangular)
 
 **What to NOT change (keep camelCase):**
+
 - `window.getSelection()` - native API
 - `document.activeElement` - native API
 - `navigator.clipboard` - native API
@@ -51,9 +57,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 **Pattern**: If it's a web platform API or Svelte API, keep camelCase. If it's our custom variable/function name, use snake_case.
 
 **File Extensions:**
+
 - Files using Svelte runes (`$state`, `$derived`, `$effect`, etc.) must use `.svelte.js` or `.svelte.ts` extension
 
 **Documentation Style:**
+
 - Use sentence case for all headings in documentation (README.md, etc.)
 - Use sentence case for code comments
 - Sentence case means: capitalize only the first word and proper nouns
@@ -74,16 +82,19 @@ Svedit is a rich content editor template built with Svelte 5 that uses a graph-b
 ### Core Components
 
 **Document Model:**
+
 - `Document` - Central document class with state management, transactions, and history
 - `Tras` - Handles atomic operations on the document
 - Documents are represented as graphs of nodes with properties and references
 
 **Selection:**
+
 - Supports text, node, and property selections
 - Maps between internal selection model and DOM selection
 - Handles complex selection scenarios like backwards selections and multi-node selections
 
 **Key Components:**
+
 - `Svedit.svelte` - Main editor component with event handling and selection management
 - `NodeArrayProperty.svelte` - Renders containers that hold sequences of nodes
 - `AnnotatedTextProperty.svelte` - Handles annotated text rendering and editing
@@ -92,6 +103,7 @@ Svedit is a rich content editor template built with Svelte 5 that uses a graph-b
 ### Schema
 
 Content is defined through schemas that specify:
+
 - Node types and their properties
 - Property types: `string`, `integer`, `boolean`, `string_array`, `annotated_text`, `node`, `node_array`
 - Reference relationships between nodes
@@ -107,8 +119,9 @@ Content is defined through schemas that specify:
 ## Schema and Inserter
 
 When adding new properties to a node type:
-1. Add to schema in `create_session.js` (`document_schema`)
-2. Add to inserter in `create_session.js` (`inserters`)
+
+1. Add to schema in `src/lib/document_schema.ts` (`document_schema`)
+2. Add to inserter in `src/routes/create_session.ts` (`inserters`)
 
 ## Available MCP Tools
 
diff --git a/IMPLEMENTATION_PLAN.md b/IMPLEMENTATION_PLAN.md
index 16906a13..7dba666b 100644
--- a/IMPLEMENTATION_PLAN.md
+++ b/IMPLEMENTATION_PLAN.md
@@ -1,5 +1,16 @@
 # Implementation plan
 
+## TypeScript conversion
+
+Convert the whole codebase from JS+JSDoc to TypeScript per the "Language: TypeScript" section in [ARCHITECTURE.md](ARCHITECTURE.md). Non-strict; svelte-check must stay at 0 errors.
+
+1. Replace `jsconfig.json` with `tsconfig.json` (same options, `allowJs`/`checkJs` kept during transition) and point the `check` script at it.
+2. Convert `src/lib/document_schema.js` → `.ts`, export `type Nodes = NodeMap<typeof document_schema>`, and add a typed `get_svedit_context()` in `src/routes/svedit_context.ts` (mirrors the svedit demo app).
+3. Convert `src/lib` modules (root, `client/`, `server/`, `server/markdown/`, `server/migrations/`), translating existing JSDoc annotations to TS syntax.
+4. Convert `src/routes` modules (`hooks.server`, load functions, API endpoints, `app_utils`, `commands.svelte`, `create_session`, helpers).
+5. Convert all Svelte components to `<script lang="ts">`. Node components use the typed-node pattern; internal components get explicit prop types.
+6. Convert tests to `.ts`, update the vitest include glob and `vite.config` filename, then verify `npm run check`, `npm test`, `npm run build`, and `npm run lint` all pass.
+
 ## Node navigator and variant switcher
 
 - While editing at every viewport size, show the closest node with variants inside the main toolbar.
diff --git a/README.md b/README.md
index 28f3c8c3..2a59584e 100644
--- a/README.md
+++ b/README.md
@@ -121,14 +121,20 @@ path                           // the hero node
 Pass those paths to primitives and use the same paths to read values when layout depends on content:
 
 ```svelte
-<script>
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let hero = $derived(svedit.session.get(path));
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import type { DocumentPath } from 'svedit';
+	import type { Nodes } from '$lib/document_schema.js';
+
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let hero: Nodes['hero'] = $derived(svedit.session.get(path));
 	let media = $derived(svedit.session.get([...path, 'media']));
 </script>
 ```
 
+The `Nodes['hero']` annotation types the node against the schema, so `hero.` autocompletes its properties and a misspelled property fails `npm run check`.
+
 `session.get` follows node references for you, so the last expression returns the media node rather than its stored id. Components do not need to know whether they are on a page, inside another block, or nested several arrays deep.
 
 ### Node: establish the editing boundary
@@ -298,7 +304,7 @@ The first four come from `svedit`; the last two live in `src/routes/components`.
 
 A small, typed vocabulary for Editable's pages and shared site content.
 
-Editable's content model defines the nodes and properties available to pages and shared site content. Its schema lives in `src/lib/document_schema.js`; this section is the reference.
+Editable's content model defines the nodes and properties available to pages and shared site content. Its schema lives in `src/lib/document_schema.ts`; this section is the reference.
 
 Documents are graphs of nodes stored by id. Each node has an `id`, a `type`, and type-specific properties. A few naming conventions hold throughout: `content` is the string payload of text properties, `body` holds authored nested content, `items` holds repeated structured children, and `label`/`title`/`description`/`meta` are text properties with semantic meaning.
 
@@ -500,13 +506,13 @@ Each dropped video goes through this decision tree:
 
 1. **Filename escape hatch** — a file named `*_optimized.mp4` (or `*.optimized.mp4`) is uploaded byte-identical, bypassing all processing and all caps. Use this when you've deliberately prepared a file — say a high-bitrate 4K export — and want it kept exactly as exported.
 2. **Already good** — if the video is already H.264, within the resolution cap and within the size goal (with 25% tolerance, since re-encoding a marginally-over file costs quality and saves little), nothing is re-encoded: an MP4 is uploaded untouched, and other containers (e.g. an H.264 `.mov`) are losslessly repackaged into an MP4 container.
-3. **Everything else** is transcoded to fit the size goal: the bitrate is derived from the video's duration, and the resolution is chosen as the largest that still looks good at that bitrate — starting from the resolution cap (1080 means landscape 1920×1080 *and* portrait 1080×1920; videos are never upscaled) and stepping down (720, 540, …) for long videos where the size budget would otherwise spread too thin. Rotation is preserved.
+3. **Everything else** is transcoded to fit the size goal: the bitrate is derived from the video's duration, and the resolution is chosen as the largest that still looks good at that bitrate — starting from the resolution cap (1080 means landscape 1920×1080 _and_ portrait 1080×1920; videos are never upscaled) and stepping down (720, 540, …) for long videos where the size budget would otherwise spread too thin. Rotation is preserved.
 
-Two knobs in `src/lib/config.js`:
+Two knobs in `src/lib/config.ts`:
 
 ```js
-export const MAX_VIDEO_RESOLUTION = 1080;            // cap on the short side: 720, 1080, …
-export const MAX_VIDEO_FILESIZE = 50 * 1024 * 1024;  // size goal for transcoded videos
+export const MAX_VIDEO_RESOLUTION = 1080; // cap on the short side: 720, 1080, …
+export const MAX_VIDEO_FILESIZE = 50 * 1024 * 1024; // size goal for transcoded videos
 ```
 
 Things worth knowing:
@@ -526,7 +532,7 @@ Editable's built-in types are just a starting set. This walkthrough adds a `hero
 
 ### 1. Define the type in the schema
 
-In `src/lib/document_schema.js`, add the node type definition. A hero is a `block` with a `layout` variant, two text properties, and a media reference:
+In `src/lib/document_schema.ts`, add the node type definition. A hero is a `block` with a `layout` variant, two text properties, and a media reference:
 
 ```js
 hero: {
@@ -578,15 +584,17 @@ That's the whole data model. Documents containing heroes now validate, and every
 Create `src/routes/components/Hero.svelte`. It reads the node at `path`, renders each property through an editable primitive (`TextProperty` for text, `MediaProperty` for the image), and picks a snippet per layout:
 
 ```svelte
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
 	import { Node, TextProperty } from 'svedit';
+	import type { DocumentPath } from 'svedit';
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import MediaProperty from './MediaProperty.svelte';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['hero'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'side-by-side');
 </script>
 
@@ -630,7 +638,7 @@ There is no read-only twin to keep in sync: this one component is the live page
 
 ### 3. Register it in the session
 
-In `src/routes/create_session.js`, import the component and add it to `node_components`, so Svedit knows what to render:
+In `src/routes/create_session.ts`, import the component and add it to `node_components`, so Svedit knows what to render:
 
 ```js
 import Hero from './components/Hero.svelte';
@@ -912,7 +920,7 @@ A deployment can expose selected repository markdown files as read-only pages re
 
 ### Configuration
 
-Any markdown file in the repository can be mapped to a URL in `src/lib/content_config.js` (server/build-only — never import it from client code). Reference the file with a `?raw` import, so Vite inlines exactly the mapped files and a missing file fails the build:
+Any markdown file in the repository can be mapped to a URL in `src/lib/content_config.ts` (server/build-only — never import it from client code). Reference the file with a `?raw` import, so Vite inlines exactly the mapped files and a missing file fails the build:
 
 ```js
 import manual_md from '../../README.md?raw';
diff --git a/eslint.config.js b/eslint.config.js
index 3da30749..b470ffae 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -20,13 +20,52 @@ export default [
 	{
 		languageOptions: {
 			globals: { ...globals.browser, ...globals.node }
+		},
+		rules: {
+			'no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }]
+		}
+	},
+	{
+		files: ['**/*.svelte', '**/*.svelte.js', '**/*.svelte.ts'],
+		languageOptions: { parserOptions: { svelteConfig, parser: typescriptParser } },
+		plugins: {
+			'@typescript-eslint': typescript
+		},
+		rules: {
+			'svelte/no-navigation-without-resolve': 'off',
+			// The base rule reports parameters in type annotations; use the
+			// TypeScript-aware variant.
+			'no-unused-vars': 'off',
+			'@typescript-eslint/no-unused-vars': [
+				'error',
+				{ argsIgnorePattern: '^_', varsIgnorePattern: '^_' }
+			]
 		}
 	},
+	// TypeScript configuration for regular .ts modules (.svelte.ts files are
+	// handled by the svelte plugin configs above so runes stay defined)
 	{
-		files: ['**/*.svelte', '**/*.svelte.js'],
-		languageOptions: { parserOptions: { svelteConfig } },
+		files: ['**/*.ts'],
+		ignores: ['**/*.d.ts', '**/*.svelte.ts'],
+		languageOptions: {
+			parser: typescriptParser,
+			parserOptions: {
+				ecmaVersion: 2022,
+				sourceType: 'module'
+			}
+		},
+		plugins: {
+			'@typescript-eslint': typescript
+		},
 		rules: {
-			'svelte/no-navigation-without-resolve': 'off'
+			// TypeScript itself checks undefined names and unused variables of
+			// type-only constructs; use the TS-aware variants.
+			'no-undef': 'off',
+			'no-unused-vars': 'off',
+			'@typescript-eslint/no-unused-vars': [
+				'error',
+				{ argsIgnorePattern: '^_', varsIgnorePattern: '^_' }
+			]
 		}
 	},
 	// TypeScript configuration for .d.ts files
@@ -35,7 +74,7 @@ export default [
 		languageOptions: {
 			parser: typescriptParser,
 			parserOptions: {
-				project: './jsconfig.json',
+				project: './tsconfig.json',
 				ecmaVersion: 2022,
 				sourceType: 'module'
 			}
@@ -45,15 +84,14 @@ export default [
 		},
 		rules: {
 			// Enable TypeScript-specific rules for .d.ts files
+			'no-undef': 'off',
 			'@typescript-eslint/no-unused-vars': 'error',
 			'@typescript-eslint/consistent-type-definitions': ['error', 'type'],
 			'@typescript-eslint/no-explicit-any': 'warn',
 			'@typescript-eslint/prefer-namespace-keyword': 'error',
 			'@typescript-eslint/triple-slash-reference': 'error',
-			'@typescript-eslint/no-var-requires': 'off', // Often needed in .d.ts files
-			'@typescript-eslint/ban-types': 'error',
 			'@typescript-eslint/no-duplicate-enum-values': 'error',
-			'@typescript-eslint/no-empty-interface': 'error',
+			'@typescript-eslint/no-empty-object-type': 'error',
 			'@typescript-eslint/no-inferrable-types': 'off',
 			'@typescript-eslint/no-misused-new': 'error',
 			'@typescript-eslint/no-namespace': 'error',
diff --git a/package-lock.json b/package-lock.json
index 06200c5d..4a0d3d53 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -16,7 +16,7 @@
 				"mediabunny": "^1.50.9",
 				"nanoid": "^5.1.6",
 				"slugify": "^1.6.6",
-				"svedit": "^0.12.0",
+				"svedit": "^0.13.0",
 				"valibot": "^1.4.1"
 			},
 			"devDependencies": {
@@ -28,6 +28,8 @@
 				"@tailwindcss/forms": "^0.5.11",
 				"@tailwindcss/vite": "^4.2.2",
 				"@types/node": "^25",
+				"@typescript-eslint/eslint-plugin": "^8.64.0",
+				"@typescript-eslint/parser": "^8.64.0",
 				"eslint": "^10.0.3",
 				"eslint-config-prettier": "^10.1.8",
 				"eslint-plugin-svelte": "^3.15.1",
@@ -1595,6 +1597,236 @@
 			"integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==",
 			"license": "MIT"
 		},
+		"node_modules/@typescript-eslint/eslint-plugin": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.64.0.tgz",
+			"integrity": "sha512-CGvQPBxN3wZLu6Rz2kFUpZeoCm78xUic92ck39KPePkO1NPOwjCqdQnm5Q87tpWw9vcBvW8XLrDXjH9PWYtJ3Q==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@eslint-community/regexpp": "^4.12.2",
+				"@typescript-eslint/scope-manager": "8.64.0",
+				"@typescript-eslint/type-utils": "8.64.0",
+				"@typescript-eslint/utils": "8.64.0",
+				"@typescript-eslint/visitor-keys": "8.64.0",
+				"ignore": "^7.0.5",
+				"natural-compare": "^1.4.0",
+				"ts-api-utils": "^2.5.0"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"@typescript-eslint/parser": "^8.64.0",
+				"eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": {
+			"version": "7.0.6",
+			"resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.6.tgz",
+			"integrity": "sha512-BAg6QkE8W+TuQLrrw0Ugr7HegXduRuuj8/ti2kSOc+jz1dmx8/WNcjr6XGnq5YpDWxFwwaavqD0+jIUOKelTsw==",
+			"dev": true,
+			"license": "MIT",
+			"engines": {
+				"node": ">= 4"
+			}
+		},
+		"node_modules/@typescript-eslint/parser": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.64.0.tgz",
+			"integrity": "sha512-KA0OshtlcCCXmbfqyZkM5pV3/WNraJf7DkJRLpyrmwPtud57H5BDX7C3k0LPSPxpprfRL+cJDGabF10mvNCoCw==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@typescript-eslint/scope-manager": "8.64.0",
+				"@typescript-eslint/types": "8.64.0",
+				"@typescript-eslint/typescript-estree": "8.64.0",
+				"@typescript-eslint/visitor-keys": "8.64.0",
+				"debug": "^4.4.3"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/project-service": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.64.0.tgz",
+			"integrity": "sha512-tk4WpOJ6IEbGrVHaNmM0YRrwAD3exZlIK3iadQNAxh4YKk6jvUQ4ecq18n+v7+meh+cJ3j+D8nbk8sRKhlwLQg==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@typescript-eslint/tsconfig-utils": "^8.64.0",
+				"@typescript-eslint/types": "^8.64.0",
+				"debug": "^4.4.3"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/scope-manager": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.64.0.tgz",
+			"integrity": "sha512-CXEaFdYXjSTgKhisNkwCcJwTP8Pl+fmRrEQrri4nm3vU743bALrxzLmq7fHG/7e6a5xO0lDYeURpZmBuhHk54w==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@typescript-eslint/types": "8.64.0",
+				"@typescript-eslint/visitor-keys": "8.64.0"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			}
+		},
+		"node_modules/@typescript-eslint/tsconfig-utils": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.64.0.tgz",
+			"integrity": "sha512-2yo8rRNKuzbVWQp5kslhANqZ2uDAeROQHBRZNPu8JDsHmeFNj/XJJhX/FhNUWmkHHvoNsKa6+tHJiig87EzsQw==",
+			"dev": true,
+			"license": "MIT",
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/type-utils": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.64.0.tgz",
+			"integrity": "sha512-XWG4Fmmv/6SvyS9nH8jWrKs6terwJvE8cyRt1CzYYqzp9OrPhCT4cMc/f7C6RZCwG+qMmiffJS1/qJP8G1URtg==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@typescript-eslint/types": "8.64.0",
+				"@typescript-eslint/typescript-estree": "8.64.0",
+				"@typescript-eslint/utils": "8.64.0",
+				"debug": "^4.4.3",
+				"ts-api-utils": "^2.5.0"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/types": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.64.0.tgz",
+			"integrity": "sha512-qjhfuTfLXjA4IOzXvz0rTjT01BqEiIgPoUeMwiEjnaHKJMTNo8rH5pYW1a2L/0Dnux2fPC85AeyJoWaGa8WxTA==",
+			"devOptional": true,
+			"license": "MIT",
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			}
+		},
+		"node_modules/@typescript-eslint/typescript-estree": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.64.0.tgz",
+			"integrity": "sha512-Pztpsn1aCE1oWDvDEfUk31nngvvF7vUB5SwHFEaZIFpvw7WJtqUHHL4plBZDA9HfWJJjL13BdG0YrJInTUvoVA==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@typescript-eslint/project-service": "8.64.0",
+				"@typescript-eslint/tsconfig-utils": "8.64.0",
+				"@typescript-eslint/types": "8.64.0",
+				"@typescript-eslint/visitor-keys": "8.64.0",
+				"debug": "^4.4.3",
+				"minimatch": "^10.2.2",
+				"semver": "^7.7.3",
+				"tinyglobby": "^0.2.15",
+				"ts-api-utils": "^2.5.0"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/utils": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.64.0.tgz",
+			"integrity": "sha512-aJUGVB3+U0htrrCjoA8qukw8cm8fNCGAxK/tVoS70k8aeb7DETKeFozRiVFIwEeN9WJLsjaP3ph8I60tY2XZoQ==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@eslint-community/eslint-utils": "^4.9.1",
+				"@typescript-eslint/scope-manager": "8.64.0",
+				"@typescript-eslint/types": "8.64.0",
+				"@typescript-eslint/typescript-estree": "8.64.0"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			},
+			"peerDependencies": {
+				"eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+				"typescript": ">=4.8.4 <6.1.0"
+			}
+		},
+		"node_modules/@typescript-eslint/visitor-keys": {
+			"version": "8.64.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.64.0.tgz",
+			"integrity": "sha512-mrtuL8Nsn6gi2H4mo5KMTp823M+3Q19Ew/i+Zlikq20tIMm99C3Ez0dCmkWWnxut20esQvTg8aUSEhMcAOXhEw==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@typescript-eslint/types": "8.64.0",
+				"eslint-visitor-keys": "^5.0.0"
+			},
+			"engines": {
+				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/typescript-eslint"
+			}
+		},
 		"node_modules/@vitest/expect": {
 			"version": "4.1.10",
 			"resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.10.tgz",
@@ -4090,9 +4322,9 @@
 			}
 		},
 		"node_modules/svedit": {
-			"version": "0.12.0",
-			"resolved": "https://registry.npmjs.org/svedit/-/svedit-0.12.0.tgz",
-			"integrity": "sha512-I6niDShyOdN5Npv8azgqWhRx2bECC/P6/5eloP+2GPXOKXnpCnIR3P3M9AHvcF1uh6ln6ZBinXFe79S8M/quSA==",
+			"version": "0.13.0",
+			"resolved": "https://registry.npmjs.org/svedit/-/svedit-0.13.0.tgz",
+			"integrity": "sha512-CNlo6Biob6qP5GjpEWh8u/Jv0HjBmX0OG5+i5BkBsg/bdwQcZma/kWH3oZYxEVvK4vx5n9OLE1m7ZpOofc9tZA==",
 			"license": "MIT",
 			"peerDependencies": {
 				"svelte": "^5.0.0"
@@ -4311,6 +4543,19 @@
 				"node": ">=6"
 			}
 		},
+		"node_modules/ts-api-utils": {
+			"version": "2.5.0",
+			"resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
+			"integrity": "sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==",
+			"dev": true,
+			"license": "MIT",
+			"engines": {
+				"node": ">=18.12"
+			},
+			"peerDependencies": {
+				"typescript": ">=4.8.4"
+			}
+		},
 		"node_modules/tslib": {
 			"version": "2.8.1",
 			"resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
diff --git a/package.json b/package.json
index 024f80af..18c59624 100644
--- a/package.json
+++ b/package.json
@@ -11,8 +11,8 @@
 		"build": "vite build",
 		"preview": "vite preview",
 		"prepare": "svelte-kit sync || echo ''",
-		"check": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json",
-		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json --watch",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
 		"test": "vitest run",
 		"test:unit": "vitest",
 		"migration:create": "node scripts/create-migration.js",
@@ -40,6 +40,8 @@
 		"@tailwindcss/forms": "^0.5.11",
 		"@tailwindcss/vite": "^4.2.2",
 		"@types/node": "^25",
+		"@typescript-eslint/eslint-plugin": "^8.64.0",
+		"@typescript-eslint/parser": "^8.64.0",
 		"eslint": "^10.0.3",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-svelte": "^3.15.1",
@@ -63,7 +65,7 @@
 		"mediabunny": "^1.50.9",
 		"nanoid": "^5.1.6",
 		"slugify": "^1.6.6",
-		"svedit": "^0.12.0",
+		"svedit": "^0.13.0",
 		"valibot": "^1.4.1"
 	}
 }
diff --git a/scripts/create-migration.js b/scripts/create-migration.js
index 0e78e5f5..e9f808d8 100644
--- a/scripts/create-migration.js
+++ b/scripts/create-migration.js
@@ -37,7 +37,7 @@ if (!slug) fail('Migration name must contain a letter or number.');
 const timestamp = new Date().toISOString().replace(/[-:.]/g, '');
 const id = `${timestamp}_${namespace}_${slug}`;
 const migration_dir = join(process.cwd(), 'src/lib/server/migrations');
-const path = join(migration_dir, `${id}.js`);
+const path = join(migration_dir, `${id}.ts`);
 const before_property =
 	before.length > 0 ? `\n\tbefore: [${before.map((target) => `'${target}'`).join(', ')}],` : '';
 const source = `export default {${before_property}\n\tup({ db }) {\n\t\t// Transform the database here.\n\t}\n};\n`;
diff --git a/scripts/mirror-sweep.js b/scripts/mirror-sweep.js
index 5c9cc357..97c1a236 100644
--- a/scripts/mirror-sweep.js
+++ b/scripts/mirror-sweep.js
@@ -9,8 +9,8 @@
 
 import { readdirSync, statSync } from 'node:fs';
 import { join, sep } from 'node:path';
-import { s3_enabled, list_keys, put_file } from '../src/lib/server/s3.js';
-import { snapshot_if_stale } from '../src/lib/server/db_snapshot.js';
+import { s3_enabled, list_keys, put_file } from '../src/lib/server/s3.ts';
+import { snapshot_if_stale } from '../src/lib/server/db_snapshot.ts';
 
 const DATA_DIR = process.env.DATA_DIR || '/data';
 const ASSETS_DIR = join(DATA_DIR, 'assets');
@@ -31,9 +31,7 @@ function local_asset_files() {
 	}
 	return entries
 		.map(String)
-		.filter(
-			(rel) => !rel.endsWith('.DS_Store') && statSync(join(ASSETS_DIR, rel)).isFile()
-		)
+		.filter((rel) => !rel.endsWith('.DS_Store') && statSync(join(ASSETS_DIR, rel)).isFile())
 		.map((rel) => rel.split(sep).join('/'));
 }
 
@@ -44,7 +42,9 @@ const missing = local.filter((rel) => !remote.has(`assets/${rel}`));
 if (missing.length === 0) {
 	console.log(`[backup] Sweep: bucket in sync (${plural(local.length, 'asset file')}).`);
 } else {
-	console.log(`[backup] Sweep: uploading ${plural(missing.length, 'asset file')} missing from bucket…`);
+	console.log(
+		`[backup] Sweep: uploading ${plural(missing.length, 'asset file')} missing from bucket…`
+	);
 	let failed = 0;
 	for (const rel of missing) {
 		try {
diff --git a/scripts/restore-assets.js b/scripts/restore-assets.js
index 7c9f139c..80913522 100644
--- a/scripts/restore-assets.js
+++ b/scripts/restore-assets.js
@@ -17,7 +17,7 @@ import { DatabaseSync } from 'node:sqlite';
 import { existsSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join, dirname, extname, resolve, sep } from 'node:path';
-import { s3_enabled, get_object, list_keys } from '../src/lib/server/s3.js';
+import { s3_enabled, get_object, list_keys } from '../src/lib/server/s3.ts';
 
 const DATA_DIR = process.env.DATA_DIR || '/data';
 const DB_PATH = process.argv[2] || join(DATA_DIR, 'db.sqlite3');
diff --git a/scripts/run-cloud-boot.js b/scripts/run-cloud-boot.js
index 4fba6019..f1b38e40 100644
--- a/scripts/run-cloud-boot.js
+++ b/scripts/run-cloud-boot.js
@@ -40,7 +40,10 @@ let backoff_ms = 1000;
 function start_replication() {
 	sidecar = spawn('litestream', ['replicate', '-config', CONFIG], { stdio: 'inherit' });
 	sidecar.on('error', (err) => {
-		console.error('[backup] Failed to start litestream (replication OFF, site stays up):', err.message);
+		console.error(
+			'[backup] Failed to start litestream (replication OFF, site stays up):',
+			err.message
+		);
 	});
 	sidecar.on('exit', (code) => {
 		if (shutting_down) return;
@@ -68,11 +71,9 @@ if (process.env.BUCKET_NAME) {
 		});
 		if (existsSync(DB_PATH)) {
 			console.log('[backup] Database restored — downloading referenced assets…');
-			spawnSync(
-				'node',
-				['--disable-warning=ExperimentalWarning', script('./restore-assets.js')],
-				{ stdio: 'inherit' }
-			);
+			spawnSync('node', ['--disable-warning=ExperimentalWarning', script('./restore-assets.js')], {
+				stdio: 'inherit'
+			});
 		} else {
 			console.log('[backup] Nothing to restore (empty bucket) — starting fresh.');
 		}
diff --git a/src/app.d.ts b/src/app.d.ts
index 136b47dd..941d3423 100644
--- a/src/app.d.ts
+++ b/src/app.d.ts
@@ -3,10 +3,11 @@
 declare global {
 	namespace App {
 		// interface Error {}
+		// SvelteKit's App types rely on declaration merging, so this must stay
+		// an interface.
+		// eslint-disable-next-line @typescript-eslint/consistent-type-definitions
 		interface Locals {
-			db: DatabaseSync,
-			user: string,
-			is_admin: boolean,
+			is_admin: boolean;
 		}
 		// interface PageData {}
 		// interface PageState {}
diff --git a/src/hooks.server.js b/src/hooks.server.ts
similarity index 80%
rename from src/hooks.server.js
rename to src/hooks.server.ts
index c5d62b30..84c8ff36 100644
--- a/src/hooks.server.js
+++ b/src/hooks.server.ts
@@ -1,4 +1,5 @@
 import { env } from '$env/dynamic/private';
+import type { Handle, ServerInit } from '@sveltejs/kit';
 import {
 	admin_session_cookie_name,
 	clear_admin_session_cookie,
@@ -8,8 +9,7 @@ import {
 	set_admin_session_cookie
 } from '$lib/server/auth.js';
 
-/** @type {import('@sveltejs/kit').ServerInit} */
-export async function init() {
+export const init: ServerInit = async () => {
 	if (!env.VERCEL && !env.ADMIN_PASSWORD) {
 		throw new Error('ADMIN_PASSWORD must be set');
 	}
@@ -18,10 +18,9 @@ export async function init() {
 		const { default: migrate } = await import('$lib/server/migrate.js');
 		migrate();
 	}
-}
+};
 
-/** @type {import('@sveltejs/kit').Handle} */
-export const handle = async ({ event, resolve }) => {
+export const handle: Handle = async ({ event, resolve }) => {
 	event.locals.is_admin = false;
 
 	if (!env.VERCEL) {
@@ -29,9 +28,9 @@ export const handle = async ({ event, resolve }) => {
 
 		if (session_id) {
 			const { default: db } = await import('$lib/server/db.js');
-			const row = /** @type {{ expires: number } | undefined } */ (
-				db.prepare('SELECT expires FROM sessions WHERE session_id = ?').get(session_id)
-			);
+			const row = db
+				.prepare('SELECT expires FROM sessions WHERE session_id = ?')
+				.get(session_id) as unknown as { expires: number } | undefined;
 
 			const now = Math.floor(Date.now() / 1000);
 
@@ -57,4 +56,4 @@ export const handle = async ({ event, resolve }) => {
 
 	const response = await resolve(event);
 	return response;
-};
\ No newline at end of file
+};
diff --git a/src/lib/api.remote.js b/src/lib/api.remote.ts
similarity index 72%
rename from src/lib/api.remote.js
rename to src/lib/api.remote.ts
index b78373d2..5ace0e96 100644
--- a/src/lib/api.remote.js
+++ b/src/lib/api.remote.ts
@@ -14,6 +14,9 @@ import {
 	extract_site_metadata,
 	collect_page_body_node_ids
 } from '$lib/page_metadata.js';
+import type { PreviewMediaNode } from '$lib/page_metadata.js';
+import type { Attachment, DocumentNode, NodeSchema, PropertyDefinition } from 'svedit';
+import type { StatementSync } from 'node:sqlite';
 import {
 	admin_session_cookie_name,
 	get_required_admin_password,
@@ -32,7 +35,7 @@ const admin_login_input_schema = v.object({
 	password: v.string()
 });
 
-function create_page_url_error_result(code, message) {
+function create_page_url_error_result(code: string, message: string) {
 	return {
 		ok: false,
 		code,
@@ -40,7 +43,7 @@ function create_page_url_error_result(code, message) {
 	};
 }
 
-function create_auth_error_result(code, message) {
+function create_auth_error_result(code: string, message: string) {
 	return {
 		ok: false,
 		code,
@@ -48,84 +51,60 @@ function create_auth_error_result(code, message) {
 	};
 }
 
-/**
- * @param {number} seconds
- * @returns {string}
- */
-function format_lockout_duration(seconds) {
+function format_lockout_duration(seconds: number): string {
 	if (seconds < 60) return `${seconds} seconds`;
 	const minutes = Math.ceil(seconds / 60);
 	return minutes === 1 ? '1 minute' : `${minutes} minutes`;
 }
 
-/**
- * @typedef {Object} DocumentRow
- * @property {string} document_id
- * @property {string} type
- * @property {string} data
- * @property {string | null | undefined} created_at
- * @property {string | null | undefined} updated_at
- */
-
-/**
- * @typedef {Object} DocumentData
- * @property {string} document_id
- * @property {Record<string, any>} nodes
- */
-
-/**
- * @typedef {Object} PageDocumentRecord
- * @property {string} document_id
- * @property {Record<string, any>} nodes
- * @property {string | null} created_at
- * @property {string | null} updated_at
- */
-
-/**
- * @typedef {Object} PreviewMediaNode
- * @property {string} type
- * @property {string} src
- * @property {number} width
- * @property {number} height
- * @property {string} alt
- * @property {number} scale
- * @property {number} focal_point_x
- * @property {number} focal_point_y
- * @property {string} object_fit
- * @property {string | undefined} mime_type
- */
-
-/**
- * @typedef {Object} PageSummary
- * @property {string} document_id
- * @property {string} title
- * @property {string | null} description
- * @property {PreviewMediaNode | null} preview_media_node
- * @property {string} page_href
- * @property {string} slug
- * @property {string | null} created_at
- * @property {string | null} updated_at
- */
-
-/**
- * @typedef {Object} InternalLinkPreview
- * @property {string} document_id
- * @property {string} title
- * @property {string | null} description
- * @property {PreviewMediaNode | null} preview_media_node
- */
-
-/**
- * @typedef {Object} PageTreeNode
- * @property {string} document_id
- * @property {string} title
- * @property {PreviewMediaNode | null} preview_media_node
- * @property {string} page_href
- * @property {string} slug
- * @property {string | null} created_at
- * @property {string | null} updated_at
- * @property {PageTreeNode[]} children
- */
+type DocumentRow = {
+	document_id: string;
+	type: string;
+	data: string;
+	created_at: string | null | undefined;
+	updated_at: string | null | undefined;
+};
+
+type DocumentData = {
+	document_id: string;
+	nodes: Record<string, DocumentNode>;
+};
+
+type PageDocumentRecord = {
+	document_id: string;
+	nodes: Record<string, DocumentNode>;
+	created_at: string | null;
+	updated_at: string | null;
+};
+
+export type PageSummary = {
+	document_id: string;
+	title: string;
+	description: string | null;
+	preview_media_node: PreviewMediaNode | null;
+	page_href: string;
+	slug: string;
+	created_at: string | null;
+	updated_at: string | null;
+};
+
+export type InternalLinkPreview = {
+	document_id: string;
+	title: string;
+	description: string | null;
+	preview_media_node: PreviewMediaNode | null;
+};
+
+export type PageTreeNode = {
+	document_id: string;
+	title: string;
+	preview_media_node: PreviewMediaNode | null;
+	page_href: string;
+	slug: string;
+	created_at: string | null;
+	updated_at: string | null;
+	children: PageTreeNode[];
+};
 
 const save_document_input_schema = v.object({
 	document_id: v.string(),
@@ -142,71 +121,28 @@ const delete_page_input_schema = v.object({
 	document_id: v.string()
 });
 
-function get_attached_ranges(value) {
+function get_attached_ranges(
+	value: { marks?: Attachment[]; annotations?: Attachment[] } | null | undefined
+): Attachment[] {
 	return [...(value?.marks ?? []), ...(value?.annotations ?? [])];
 }
 
 /**
  * Collect all node ids reachable from a root node by walking node/node_array
  * properties and mark/annotation references.
- *
- * @param {string} root_id
- * @param {Record<string, any>} nodes
- * @param {Set<string>} [exclude_roots]
- * @returns {Set<string>}
  */
-function collect_node_ids(root_id, nodes, exclude_roots) {
-	const collected = new Set();
-	const stack = [root_id];
-
-	while (stack.length > 0) {
-		const id = stack.pop();
-		if (!id || collected.has(id)) continue;
-		if (exclude_roots && exclude_roots.has(id) && id !== root_id) continue;
-
-		collected.add(id);
-
-		const node = nodes[id];
-		if (!node) continue;
-
-		const type_schema = document_schema[node.type];
-		if (!type_schema) continue;
-
-		for (const [prop_name, prop_def] of Object.entries(type_schema.properties)) {
-			const value = node[prop_name];
-			if (value == null) continue;
-
-			if (prop_def.type === 'node' && typeof value === 'string') {
-				stack.push(value);
-			} else if (prop_def.type === 'node_array') {
-				for (const child_id of value.nodes) {
-					stack.push(child_id);
-				}
-				for (const range of get_attached_ranges(value)) {
-					if (range.node_id) {
-						stack.push(range.node_id);
-					}
-				}
-			} else if (prop_def.type === 'text') {
-				for (const range of get_attached_ranges(value)) {
-					if (range.node_id) {
-						stack.push(range.node_id);
-					}
-				}
-			}
-		}
-	}
-
-	return collected;
+function collect_node_ids(
+	root_id: string,
+	nodes: Record<string, DocumentNode>,
+	exclude_roots?: Set<string>
+): Set<string> {
+	return new Set(collect_node_ids_in_order(root_id, nodes, exclude_roots));
 }
 
-/**
- * @returns {Set<string>}
- */
-function get_referenced_asset_ids() {
-	const rows = /** @type {Array<{ asset_id: string }>} */ (
-		db.prepare('SELECT DISTINCT asset_id FROM asset_refs').all()
-	);
+function get_referenced_asset_ids(): Set<string> {
+	const rows = db.prepare('SELECT DISTINCT asset_id FROM asset_refs').all() as unknown as Array<{
+		asset_id: string;
+	}>;
 	return new Set(rows.map((row) => row.asset_id));
 }
 
@@ -217,10 +153,9 @@ function get_referenced_asset_ids() {
  * Assets that lost their last reference in the write (refs_before minus
  * refs_after) get their orphan clock started via touch_asset, so the grace
  * period runs from dereferencing — not from upload.
- *
- * @param {Set<string>} refs_before - referenced asset ids captured before the write
+ * refs_before holds the referenced asset ids captured before the write.
  */
-async function cleanup_orphaned_assets(refs_before) {
+async function cleanup_orphaned_assets(refs_before: Set<string>) {
 	try {
 		const refs_after = get_referenced_asset_ids();
 
@@ -236,14 +171,12 @@ async function cleanup_orphaned_assets(refs_before) {
 	}
 }
 
-/**
- * @param {string} document_id
- * @param {Set<string>} node_ids
- * @param {Record<string, any>} all_nodes
- * @returns {DocumentData}
- */
-function extract_document(document_id, node_ids, all_nodes) {
-	const nodes = {};
+function extract_document(
+	document_id: string,
+	node_ids: Set<string>,
+	all_nodes: Record<string, DocumentNode>
+): DocumentData {
+	const nodes: Record<string, DocumentNode> = {};
 	for (const id of node_ids) {
 		if (all_nodes[id]) {
 			nodes[id] = all_nodes[id];
@@ -252,14 +185,10 @@ function extract_document(document_id, node_ids, all_nodes) {
 	return { document_id, nodes };
 }
 
-/**
- * @param {string} document_id
- * @returns {DocumentData}
- */
-function get_doc_from_db(document_id) {
-	const doc_row = /** @type {DocumentRow | undefined} */ (
-		db.prepare('SELECT * FROM documents WHERE document_id = ?').get(document_id)
-	);
+function get_doc_from_db(document_id: string): DocumentData {
+	const doc_row = db
+		.prepare('SELECT * FROM documents WHERE document_id = ?')
+		.get(document_id) as unknown as DocumentRow | undefined;
 
 	if (!doc_row) {
 		throw new Error(`Document not found: ${document_id}`);
@@ -268,60 +197,41 @@ function get_doc_from_db(document_id) {
 	return JSON.parse(doc_row.data);
 }
 
-/**
- * @param {string} document_id
- * @returns {DocumentData | null}
- */
-function get_optional_doc_from_db(document_id) {
-	const doc_row = /** @type {DocumentRow | undefined} */ (
-		db.prepare('SELECT * FROM documents WHERE document_id = ?').get(document_id)
-	);
+function get_optional_doc_from_db(document_id: string): DocumentData | null {
+	const doc_row = db
+		.prepare('SELECT * FROM documents WHERE document_id = ?')
+		.get(document_id) as unknown as DocumentRow | undefined;
 
 	if (!doc_row) return null;
 	return JSON.parse(doc_row.data);
 }
 
-/**
- * @returns {string | null}
- */
-function get_home_page_id_from_db() {
-	const row = /** @type {{ value: string } | undefined } */ (
-		db.prepare('SELECT value FROM site_settings WHERE key = ?').get('home_page_id')
-	);
+function get_home_page_id_from_db(): string | null {
+	const row = db.prepare('SELECT value FROM site_settings WHERE key = ?').get('home_page_id') as
+		| { value: string }
+		| undefined;
 
 	return row?.value ?? null;
 }
 
-/**
- * @param {string} document_id
- * @returns {boolean}
- */
-function is_home_page_document_id(document_id) {
+function is_home_page_document_id(document_id: string): boolean {
 	return get_home_page_id_from_db() === document_id;
 }
 
-/**
- * @param {string} document_id
- * @returns {string | null}
- */
-function get_active_slug_for_document_id(document_id) {
-	const row = /** @type {{ slug: string } | undefined } */ (
-		db
-			.prepare('SELECT slug FROM document_slugs WHERE document_id = ? AND is_active = 1')
-			.get(document_id)
-	);
+function get_active_slug_for_document_id(document_id: string): string | null {
+	const row = db
+		.prepare('SELECT slug FROM document_slugs WHERE document_id = ? AND is_active = 1')
+		.get(document_id) as unknown as { slug: string } | undefined;
 
 	return row?.slug ?? null;
 }
 
-/**
- * @param {string} slug
- * @returns {{ document_id: string, is_active: boolean, active_slug: string } | null}
- */
-function resolve_slug(slug) {
-	const row = /** @type {{ document_id: string, is_active: number } | undefined } */ (
-		db.prepare('SELECT document_id, is_active FROM document_slugs WHERE slug = ?').get(slug)
-	);
+function resolve_slug(
+	slug: string
+): { document_id: string; is_active: boolean; active_slug: string } | null {
+	const row = db
+		.prepare('SELECT document_id, is_active FROM document_slugs WHERE slug = ?')
+		.get(slug) as unknown as { document_id: string; is_active: number } | undefined;
 
 	if (!row) return null;
 
@@ -337,16 +247,13 @@ function resolve_slug(slug) {
 	};
 }
 
-/**
- * @returns {PageDocumentRecord[]}
- */
-function list_page_documents() {
-	const rows = /** @type {DocumentRow[]} */ (
-		db.prepare('SELECT * FROM documents WHERE type = ? ORDER BY document_id').all('page')
-	);
+function list_page_documents(): PageDocumentRecord[] {
+	const rows = db
+		.prepare('SELECT * FROM documents WHERE type = ? ORDER BY document_id')
+		.all('page') as unknown as DocumentRow[];
 
 	return rows.map((row) => {
-		const doc = /** @type {DocumentData} */ (JSON.parse(row.data));
+		const doc = JSON.parse(row.data) as DocumentData;
 		return {
 			document_id: doc.document_id,
 			nodes: doc.nodes,
@@ -356,39 +263,26 @@ function list_page_documents() {
 	});
 }
 
-/**
- * @param {string} title
- * @param {string} document_id
- * @returns {string}
- */
-function create_slug_candidate(title, document_id) {
+function create_slug_candidate(title: string, document_id: string): string {
 	const slug = slugify(title, { lower: true, strict: true, trim: true });
 	return slug || document_id;
 }
 
-/**
- * @param {string} base_slug
- * @returns {string}
- */
-function create_unique_slug(base_slug) {
+function create_unique_slug(base_slug: string): string {
 	const slug_exists_stmt = db.prepare('SELECT document_id FROM document_slugs WHERE slug = ?');
 
 	let slug = base_slug;
 	let suffix = 2;
 
 	while (true) {
-		const row = /** @type {{ document_id: string } | undefined } */ (slug_exists_stmt.get(slug));
+		const row = slug_exists_stmt.get(slug) as unknown as { document_id: string } | undefined;
 		if (!row) return slug;
 		slug = `${base_slug}-${suffix}`;
 		suffix += 1;
 	}
 }
 
-/**
- * @param {string} href
- * @returns {{ slug: string, fragment: string }} | null
- */
-function parse_internal_page_href(href) {
+function parse_internal_page_href(href: string): { slug: string; fragment: string } | null {
 	if (!href) return null;
 	if (/^[a-z][a-z0-9+.-]*:/i.test(href)) return null;
 	if (href.startsWith('//')) return null;
@@ -409,12 +303,10 @@ function parse_internal_page_href(href) {
 	};
 }
 
-/**
- * @param {string} href
- * @param {string | undefined} source_document_id
- * @returns {string | null}
- */
-function normalize_internal_page_href(href, source_document_id) {
+function normalize_internal_page_href(
+	href: string,
+	source_document_id: string | undefined
+): string | null {
 	const parsed = parse_internal_page_href(href);
 	if (!parsed) return null;
 
@@ -425,15 +317,13 @@ function normalize_internal_page_href(href, source_document_id) {
 	return resolved.document_id;
 }
 
-/**
- * @param {Record<string, any>} nodes
- * @param {Iterable<string>} node_ids
- * @param {string} source_document_id
- * @returns {string[]}
- */
-function collect_document_refs(nodes, node_ids, source_document_id) {
-	const refs = [];
-	const seen_refs = new Set();
+function collect_document_refs(
+	nodes: Record<string, DocumentNode>,
+	node_ids: Iterable<string>,
+	source_document_id: string
+): string[] {
+	const refs: string[] = [];
+	const seen_refs = new Set<string>();
 
 	for (const node_id of node_ids) {
 		const node = nodes[node_id];
@@ -447,10 +337,12 @@ function collect_document_refs(nodes, node_ids, source_document_id) {
 			}
 		}
 
-		const type_schema = document_schema[node.type];
+		const type_schema: NodeSchema | undefined = document_schema[node.type];
 		if (!type_schema) continue;
 
-		for (const [prop_name, prop_def] of Object.entries(type_schema.properties)) {
+		for (const [prop_name, prop_def] of Object.entries<PropertyDefinition>(
+			type_schema.properties
+		)) {
 			if (prop_def.type !== 'text') continue;
 
 			const value = node[prop_name];
@@ -476,15 +368,14 @@ function collect_document_refs(nodes, node_ids, source_document_id) {
 	return refs;
 }
 
-/**
- * @param {string} document_id
- * @param {Iterable<string>} node_ids
- * @param {Record<string, any>} all_nodes
- * @param {import('node:sqlite').StatementSync} delete_stmt
- * @param {import('node:sqlite').StatementSync} insert_stmt
- */
-function update_asset_refs(document_id, node_ids, all_nodes, delete_stmt, insert_stmt) {
-	const asset_ids = new Set();
+function update_asset_refs(
+	document_id: string,
+	node_ids: Iterable<string>,
+	all_nodes: Record<string, DocumentNode>,
+	delete_stmt: StatementSync,
+	insert_stmt: StatementSync
+) {
+	const asset_ids = new Set<string>();
 
 	for (const node_id of node_ids) {
 		const node = all_nodes[node_id];
@@ -505,24 +396,22 @@ function update_asset_refs(document_id, node_ids, all_nodes, delete_stmt, insert
 	}
 }
 
-/**
- * @param {string} source_document_id
- * @param {string[]} target_document_ids
- * @param {import('node:sqlite').StatementSync} delete_stmt
- * @param {import('node:sqlite').StatementSync} insert_stmt
- */
-function update_document_refs(source_document_id, target_document_ids, delete_stmt, insert_stmt) {
+function update_document_refs(
+	source_document_id: string,
+	target_document_ids: string[],
+	delete_stmt: StatementSync,
+	insert_stmt: StatementSync
+) {
 	delete_stmt.run(source_document_id);
 	for (const [ref_order, target_document_id] of target_document_ids.entries()) {
 		insert_stmt.run(target_document_id, source_document_id, ref_order);
 	}
 }
 
-/**
- * @param {DocumentData} page_doc
- * @returns {{ nav_root_id: string | null, footer_root_id: string | null }}
- */
-function get_shared_root_ids(page_doc) {
+function get_shared_root_ids(page_doc: DocumentData): {
+	nav_root_id: string | null;
+	footer_root_id: string | null;
+} {
 	const page_node = page_doc.nodes[page_doc.document_id];
 
 	return {
@@ -531,11 +420,7 @@ function get_shared_root_ids(page_doc) {
 	};
 }
 
-/**
- * @param {string} document_id
- * @returns {DocumentData}
- */
-function get_combined_document(document_id) {
+function get_combined_document(document_id: string): DocumentData {
 	const page_doc = get_doc_from_db(document_id);
 	const page_node = page_doc.nodes[page_doc.document_id];
 	const merged_nodes = { ...page_doc.nodes };
@@ -556,11 +441,7 @@ function get_combined_document(document_id) {
 	};
 }
 
-/**
- * @param {PageDocumentRecord} page_doc
- * @returns {PageSummary}
- */
-function summarize_page_document(page_doc) {
+function summarize_page_document(page_doc: PageDocumentRecord): PageSummary {
 	const metadata = extract_page_metadata({
 		document_id: page_doc.document_id,
 		nodes: page_doc.nodes
@@ -581,31 +462,23 @@ function summarize_page_document(page_doc) {
 	};
 }
 
-/**
- * @param {string} source_document_id
- * @returns {string[]}
- */
-function get_outgoing_refs(source_document_id) {
-	const rows = /** @type {Array<{ target_document_id: string }>} */ (
-		db
-			.prepare(
-				'SELECT target_document_id FROM document_refs WHERE source_document_id = ? ORDER BY ref_order, rowid'
-			)
-			.all(source_document_id)
-	);
+function get_outgoing_refs(source_document_id: string): string[] {
+	const rows = db
+		.prepare(
+			'SELECT target_document_id FROM document_refs WHERE source_document_id = ? ORDER BY ref_order, rowid'
+		)
+		.all(source_document_id) as unknown as Array<{ target_document_id: string }>;
 
 	return rows.map((row) => row.target_document_id);
 }
 
-/**
- * @param {string[]} refs
- * @param {Set<string>} assigned_page_ids
- * @param {Map<string, PageSummary>} summaries_by_id
- * @param {Map<string, string[]>} body_refs_by_page_id
- * @returns {PageTreeNode[]}
- */
-function build_tree_children(refs, assigned_page_ids, summaries_by_id, body_refs_by_page_id) {
-	const children = [];
+function build_tree_children(
+	refs: string[],
+	assigned_page_ids: Set<string>,
+	summaries_by_id: Map<string, PageSummary>,
+	body_refs_by_page_id: Map<string, string[]>
+): PageTreeNode[] {
+	const children: PageTreeNode[] = [];
 
 	for (const target_document_id of refs) {
 		if (assigned_page_ids.has(target_document_id)) continue;
@@ -635,21 +508,13 @@ function build_tree_children(refs, assigned_page_ids, summaries_by_id, body_refs
 	return children;
 }
 
-/**
- * @param {string} root_document_id
- * @param {Set<string>} assigned_page_ids
- * @param {Map<string, PageSummary>} summaries_by_id
- * @param {Map<string, string[]>} body_refs_by_page_id
- * @param {string[] | null} root_refs
- * @returns {PageTreeNode | null}
- */
 function build_page_tree_node(
-	root_document_id,
-	assigned_page_ids,
-	summaries_by_id,
-	body_refs_by_page_id,
-	root_refs = null
-) {
+	root_document_id: string,
+	assigned_page_ids: Set<string>,
+	summaries_by_id: Map<string, PageSummary>,
+	body_refs_by_page_id: Map<string, string[]>,
+	root_refs: string[] | null = null
+): PageTreeNode | null {
 	const summary = summaries_by_id.get(root_document_id);
 	if (!summary) return null;
 	if (assigned_page_ids.has(root_document_id)) return null;
@@ -673,14 +538,11 @@ function build_page_tree_node(
 	};
 }
 
-/**
- * @returns {{
- *   home_page_id: string | null,
- *   current_document_id: string | null,
- *   page_forest: PageTreeNode[]
- * }}
- */
-function build_page_browser_data() {
+function build_page_browser_data(): {
+	home_page_id: string | null;
+	current_document_id: string | null;
+	page_forest: PageTreeNode[];
+} {
 	const request_event = getRequestEvent();
 	const pathname = request_event.url.pathname;
 	const home_page_id = get_home_page_id_from_db();
@@ -696,7 +558,7 @@ function build_page_browser_data() {
 		? get_shared_root_ids(home_page_doc)
 		: { nav_root_id: null, footer_root_id: null };
 
-	const body_refs_by_page_id = new Map();
+	const body_refs_by_page_id = new Map<string, string[]>();
 	for (const page_doc of page_docs) {
 		const body_node_ids = collect_page_body_node_ids(page_doc);
 		body_refs_by_page_id.set(
@@ -705,9 +567,9 @@ function build_page_browser_data() {
 		);
 	}
 
-	const page_forest = [];
-	const assigned_page_ids = new Set();
-	const incoming_page_ref_counts = new Map();
+	const page_forest: PageTreeNode[] = [];
+	const assigned_page_ids = new Set<string>();
+	const incoming_page_ref_counts = new Map<string, number>();
 
 	for (const page_doc of page_docs) {
 		incoming_page_ref_counts.set(page_doc.document_id, 0);
@@ -723,7 +585,7 @@ function build_page_browser_data() {
 		}
 	}
 
-	let home_linked_page_ids = new Set();
+	let home_linked_page_ids = new Set<string>();
 
 	if (home_page_id && summaries_by_id.has(home_page_id)) {
 		const nav_refs = nav_root_id ? get_outgoing_refs(nav_root_id) : [];
@@ -1000,28 +862,29 @@ export const get_internal_link_preview = query(v.string(), async (href) => {
 		return null;
 	}
 
-	const doc_row = /** @type {DocumentRow | undefined} */ (
-		db.prepare('SELECT type, data FROM documents WHERE document_id = ?').get(resolved.document_id)
-	);
+	const doc_row = db
+		.prepare('SELECT type, data FROM documents WHERE document_id = ?')
+		.get(resolved.document_id) as unknown as DocumentRow | undefined;
 	if (!doc_row || doc_row.type !== 'page') {
 		return null;
 	}
 
-	const page_doc = /** @type {DocumentData} */ (JSON.parse(doc_row.data));
+	const page_doc = JSON.parse(doc_row.data) as DocumentData;
 	const metadata = extract_page_metadata(page_doc);
 
-	return /** @type {InternalLinkPreview} */ ({
+	const preview: InternalLinkPreview = {
 		document_id: resolved.document_id,
 		title: metadata.title || 'Untitled page',
 		description: metadata.description,
 		preview_media_node: metadata.preview_media_node
-	});
+	};
+	return preview;
 });
 
 /**
  * Save a document to the database, splitting shared documents (nav, footer) back out.
  */
-function rewrite_internal_page_href(href, target_document_id, new_slug) {
+function rewrite_internal_page_href(href: string, target_document_id: string, new_slug: string) {
 	const parsed = parse_internal_page_href(href);
 	if (!parsed) return href;
 
@@ -1031,7 +894,11 @@ function rewrite_internal_page_href(href, target_document_id, new_slug) {
 	return `/${new_slug}${parsed.fragment}`;
 }
 
-function rewrite_internal_page_hrefs(nodes, target_document_id, new_slug) {
+function rewrite_internal_page_hrefs(
+	nodes: Record<string, DocumentNode>,
+	target_document_id: string,
+	new_slug: string
+) {
 	for (const node of Object.values(nodes)) {
 		if (!node || typeof node !== 'object') continue;
 
@@ -1039,10 +906,12 @@ function rewrite_internal_page_hrefs(nodes, target_document_id, new_slug) {
 			node.href = rewrite_internal_page_href(node.href, target_document_id, new_slug);
 		}
 
-		const type_schema = document_schema[node.type];
+		const type_schema: NodeSchema | undefined = document_schema[node.type];
 		if (!type_schema) continue;
 
-		for (const [prop_name, prop_def] of Object.entries(type_schema.properties)) {
+		for (const [prop_name, prop_def] of Object.entries<PropertyDefinition>(
+			type_schema.properties
+		)) {
 			if (prop_def.type !== 'text') continue;
 
 			const value = node[prop_name];
@@ -1058,16 +927,21 @@ function rewrite_internal_page_hrefs(nodes, target_document_id, new_slug) {
 	}
 }
 
-function insert_active_slug(document_id, slug, insert_slug_stmt, deactivate_slug_stmt) {
+function insert_active_slug(
+	document_id: string,
+	slug: string,
+	insert_slug_stmt: StatementSync,
+	deactivate_slug_stmt: StatementSync
+) {
 	deactivate_slug_stmt.run(document_id);
 	insert_slug_stmt.run(slug, document_id, 1, new Date().toISOString());
 }
 
 function move_active_slug_to_history(
-	document_id,
-	insert_slug_stmt,
-	deactivate_slug_stmt,
-	delete_slug_stmt
+	document_id: string,
+	insert_slug_stmt: StatementSync,
+	deactivate_slug_stmt: StatementSync,
+	delete_slug_stmt: StatementSync
 ) {
 	const current_slug = get_active_slug_for_document_id(document_id);
 	if (!current_slug) return null;
@@ -1079,11 +953,11 @@ function move_active_slug_to_history(
 }
 
 function assign_active_slug(
-	document_id,
-	slug,
-	insert_slug_stmt,
-	deactivate_slug_stmt,
-	delete_slug_stmt
+	document_id: string,
+	slug: string,
+	insert_slug_stmt: StatementSync,
+	deactivate_slug_stmt: StatementSync,
+	delete_slug_stmt: StatementSync
 ) {
 	delete_slug_stmt.run(slug);
 	insert_active_slug(document_id, slug, insert_slug_stmt, deactivate_slug_stmt);
@@ -1119,12 +993,12 @@ export const save_document = command(save_document_input_schema, async (combined
 
 	const nav_node_ids = nav_root_id
 		? new Set(collect_node_ids_in_order(nav_root_id, all_nodes))
-		: new Set();
+		: new Set<string>();
 	const footer_node_ids = footer_root_id
 		? new Set(collect_node_ids_in_order(footer_root_id, all_nodes))
-		: new Set();
+		: new Set<string>();
 
-	const exclude_roots = new Set();
+	const exclude_roots = new Set<string>();
 	if (nav_root_id) exclude_roots.add(nav_root_id);
 	if (footer_root_id) exclude_roots.add(footer_root_id);
 
@@ -1145,7 +1019,6 @@ export const save_document = command(save_document_input_schema, async (combined
 		'INSERT OR REPLACE INTO document_refs (target_document_id, source_document_id, ref_order) VALUES (?, ?, ?)'
 	);
 
-	const delete_slug = db.prepare('DELETE FROM document_slugs WHERE slug = ?');
 	const deactivate_active_slug = db.prepare(
 		'UPDATE document_slugs SET is_active = 0 WHERE document_id = ? AND is_active = 1'
 	);
@@ -1156,11 +1029,9 @@ export const save_document = command(save_document_input_schema, async (combined
 	const refs_before = get_referenced_asset_ids();
 
 	with_transaction(() => {
-		const existing_page_row = /** @type {DocumentRow | undefined} */ (
-			db
-				.prepare('SELECT created_at FROM documents WHERE document_id = ?')
-				.get(combined_doc.document_id)
-		);
+		const existing_page_row = db
+			.prepare('SELECT created_at FROM documents WHERE document_id = ?')
+			.get(combined_doc.document_id) as unknown as DocumentRow | undefined;
 		const now_iso = new Date().toISOString();
 		const created_at = existing_page_row?.created_at ?? now_iso;
 
@@ -1181,9 +1052,9 @@ export const save_document = command(save_document_input_schema, async (combined
 
 		if (nav_root_id && nav_node_ids.size > 0) {
 			const nav_doc = extract_document(nav_root_id, nav_node_ids, all_nodes);
-			const existing_nav_row = /** @type {DocumentRow | undefined} */ (
-				db.prepare('SELECT created_at FROM documents WHERE document_id = ?').get(nav_root_id)
-			);
+			const existing_nav_row = db
+				.prepare('SELECT created_at FROM documents WHERE document_id = ?')
+				.get(nav_root_id) as unknown as DocumentRow | undefined;
 			const nav_created_at = existing_nav_row?.created_at ?? now_iso;
 			upsert.run(nav_root_id, 'nav', JSON.stringify(nav_doc), nav_created_at, now_iso);
 			update_asset_refs(nav_root_id, nav_node_ids, all_nodes, delete_asset_refs, insert_asset_ref);
@@ -1197,9 +1068,9 @@ export const save_document = command(save_document_input_schema, async (combined
 
 		if (footer_root_id && footer_node_ids.size > 0) {
 			const footer_doc = extract_document(footer_root_id, footer_node_ids, all_nodes);
-			const existing_footer_row = /** @type {DocumentRow | undefined} */ (
-				db.prepare('SELECT created_at FROM documents WHERE document_id = ?').get(footer_root_id)
-			);
+			const existing_footer_row = db
+				.prepare('SELECT created_at FROM documents WHERE document_id = ?')
+				.get(footer_root_id) as unknown as DocumentRow | undefined;
 			const footer_created_at = existing_footer_row?.created_at ?? now_iso;
 			upsert.run(footer_root_id, 'footer', JSON.stringify(footer_doc), footer_created_at, now_iso);
 			update_asset_refs(
@@ -1300,11 +1171,9 @@ export const update_page_slug = command(update_page_slug_input_schema, async (in
 		};
 	}
 
-	const existing_slug = /** @type {{ document_id: string, is_active: number } | undefined} */ (
-		db
-			.prepare('SELECT document_id, is_active FROM document_slugs WHERE slug = ?')
-			.get(normalized_slug)
-	);
+	const existing_slug = db
+		.prepare('SELECT document_id, is_active FROM document_slugs WHERE slug = ?')
+		.get(normalized_slug) as unknown as { document_id: string; is_active: number } | undefined;
 
 	if (
 		existing_slug &&
@@ -1345,11 +1214,9 @@ export const update_page_slug = command(update_page_slug_input_schema, async (in
 			throw new Error('Failed to assign new active slug');
 		}
 
-		const page_rows = /** @type {DocumentRow[]} */ (
-			db
-				.prepare('SELECT * FROM documents WHERE type IN (?, ?, ?) ORDER BY document_id')
-				.all('page', 'nav', 'footer')
-		);
+		const page_rows = db
+			.prepare('SELECT * FROM documents WHERE type IN (?, ?, ?) ORDER BY document_id')
+			.all('page', 'nav', 'footer') as unknown as DocumentRow[];
 
 		const upsert = db.prepare(
 			'INSERT INTO documents (document_id, type, data, created_at, updated_at) VALUES(?, ?, ?, ?, ?) ON CONFLICT(document_id) DO UPDATE SET data = excluded.data, updated_at = excluded.updated_at'
diff --git a/src/lib/client/asset_processor.js b/src/lib/client/asset_processor.ts
similarity index 78%
rename from src/lib/client/asset_processor.js
rename to src/lib/client/asset_processor.ts
index ee4e633d..22ab0576 100644
--- a/src/lib/client/asset_processor.js
+++ b/src/lib/client/asset_processor.ts
@@ -5,11 +5,8 @@ const WEBP_QUALITY = 80;
 /**
  * Decode an image file to ImageData using the browser's built-in decoding.
  * Works for JPEG, PNG, WebP, GIF, BMP, etc.
- *
- * @param {Blob} blob
- * @returns {Promise<ImageData>}
  */
-async function decode_to_image_data(blob) {
+async function decode_to_image_data(blob: Blob): Promise<ImageData> {
 	const bitmap = await createImageBitmap(blob);
 	const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
 	const ctx = canvas.getContext('2d');
@@ -21,11 +18,8 @@ async function decode_to_image_data(blob) {
 
 /**
  * Convert ImageData to a PNG blob using canvas.
- *
- * @param {ImageData} image_data
- * @returns {Promise<Blob>}
  */
-async function image_data_to_png_blob(image_data) {
+async function image_data_to_png_blob(image_data: ImageData): Promise<Blob> {
 	const canvas = new OffscreenCanvas(image_data.width, image_data.height);
 	const ctx = canvas.getContext('2d');
 	if (!ctx) throw new Error('Could not get OffscreenCanvas 2d context');
@@ -35,12 +29,8 @@ async function image_data_to_png_blob(image_data) {
 
 /**
  * Resize an image blob to a specific width using canvas, maintaining aspect ratio.
- *
- * @param {Blob} blob
- * @param {number} target_width
- * @returns {Promise<ImageData>}
  */
-async function resize_blob_to_width(blob, target_width) {
+async function resize_blob_to_width(blob: Blob, target_width: number): Promise<ImageData> {
 	const bitmap = await createImageBitmap(blob);
 	const scale = target_width / bitmap.width;
 	const target_height = Math.round(bitmap.height * scale);
@@ -58,12 +48,8 @@ async function resize_blob_to_width(blob, target_width) {
 /**
  * Resize ImageData to fit within max_width, preserving aspect ratio.
  * Returns the original ImageData if it already fits.
- *
- * @param {ImageData} image_data
- * @param {number} max_width
- * @returns {Promise<ImageData>}
  */
-async function resize_to_fit(image_data, max_width) {
+async function resize_to_fit(image_data: ImageData, max_width: number): Promise<ImageData> {
 	const { width } = image_data;
 	if (width <= max_width) return image_data;
 
@@ -73,40 +59,27 @@ async function resize_to_fit(image_data, max_width) {
 
 /**
  * Resize ImageData to a specific width, maintaining aspect ratio.
- *
- * @param {ImageData} image_data
- * @param {number} target_width
- * @returns {Promise<ImageData>}
  */
-async function resize_to_width(image_data, target_width) {
+async function resize_to_width(image_data: ImageData, target_width: number): Promise<ImageData> {
 	const png_blob = await image_data_to_png_blob(image_data);
 	return await resize_blob_to_width(png_blob, target_width);
 }
 
 /**
  * Encode ImageData to WebP ArrayBuffer.
- *
- * @param {ImageData} image_data
- * @param {number} [quality]
- * @returns {Promise<ArrayBuffer>}
  */
-async function encode_to_webp(image_data, quality = WEBP_QUALITY) {
+async function encode_to_webp(image_data: ImageData, quality = WEBP_QUALITY): Promise<ArrayBuffer> {
 	return await encodeWebP(image_data, { quality });
 }
 
-/**
- * @param {string} status
- */
-function post_status(status) {
+function post_status(status: string) {
 	self.postMessage({ type: 'status', status });
 }
 
 /**
  * Handle a process request from the main thread.
- *
- * @param {{ file: File, max_width: number, variant_widths: number[] }} data
  */
-async function handle_process(data) {
+async function handle_process(data: { file: File; max_width: number; variant_widths: number[] }) {
 	const { file, max_width, variant_widths } = data;
 
 	try {
@@ -129,8 +102,7 @@ async function handle_process(data) {
 
 		// 4. Generate size variants (only for widths smaller than the original)
 		const applicable_widths = variant_widths.filter((w) => w < original_width);
-		/** @type {Array<{ width: number, buffer: ArrayBuffer }>} */
-		const variants = [];
+		const variants: Array<{ width: number; buffer: ArrayBuffer }> = [];
 
 		for (let i = 0; i < applicable_widths.length; i++) {
 			const target_width = applicable_widths[i];
@@ -166,4 +138,4 @@ self.addEventListener('message', (e) => {
 	if (e.data?.type === 'process') {
 		handle_process(e.data);
 	}
-});
\ No newline at end of file
+});
diff --git a/src/lib/client/asset_upload.js b/src/lib/client/asset_upload.ts
similarity index 71%
rename from src/lib/client/asset_upload.js
rename to src/lib/client/asset_upload.ts
index 5cb12ce3..8b62aaa0 100644
--- a/src/lib/client/asset_upload.js
+++ b/src/lib/client/asset_upload.ts
@@ -1,40 +1,33 @@
 import { process_asset } from './process_asset.js';
 import { process_video } from './process_video.js';
-import {
-	EXT_TO_MIME,
-	MAX_IMAGE_WIDTH,
-	MAX_VIDEO_INPUT_BYTES,
-	OPTIMIZED_VIDEO_REGEX
-} from '$lib/config.js';
+import type { ProcessVideoOptions, ProcessedVideo } from './process_video.js';
+import { EXT_TO_MIME, MAX_VIDEO_INPUT_BYTES, OPTIMIZED_VIDEO_REGEX } from '$lib/config.js';
 import { get_video_dimensions, get_media_dimensions } from './media_dimensions.js';
+import type { DocumentNode } from 'svedit';
 
-/**
- * @typedef {{
- *   hash: string,
- *   asset_id: string,
- *   original: { blob: Blob, width: number, height: number },
- *   variants: Array<{ width: number, blob: Blob }>,
- *   status: 'processing' | 'ready' | 'error',
- *   progress: number,
- *   error: string | null
- * }} PendingAsset
- */
+export type PendingAsset = {
+	hash: string;
+	asset_id: string;
+	original: { blob: Blob; width: number; height: number };
+	variants: Array<{ width: number; blob: Blob }>;
+	status: 'processing' | 'ready' | 'error';
+	progress: number;
+	error: string | null;
+};
+
+/** The result of a successful asset upload. */
+export type UploadedAsset = { asset_id: string; width: number; height: number };
 
 /**
  * Map of blob URL → PendingAsset. Populated when images are pasted/dropped,
  * consulted during the save flow to upload and replace blob URLs.
- *
- * @type {Map<string, PendingAsset>}
  */
-const pending_assets = new Map();
+const pending_assets = new Map<string, PendingAsset>();
 
 /**
  * Compute SHA-256 hex hash of a Blob.
- *
- * @param {Blob} blob
- * @returns {Promise<string>}
  */
-async function hash_blob(blob) {
+async function hash_blob(blob: Blob): Promise<string> {
 	const buffer = await blob.arrayBuffer();
 	const hash_buffer = await crypto.subtle.digest('SHA-256', buffer);
 	const hash_array = Array.from(new Uint8Array(hash_buffer));
@@ -43,11 +36,8 @@ async function hash_blob(blob) {
 
 /**
  * Detect whether a GIF file is animated by counting Graphic Control Extension blocks.
- *
- * @param {File} file
- * @returns {Promise<boolean>}
  */
-async function is_animated_gif(file) {
+async function is_animated_gif(file: File): Promise<boolean> {
 	if (file.type !== 'image/gif') return false;
 	const buffer = await file.arrayBuffer();
 	const bytes = new Uint8Array(buffer);
@@ -63,12 +53,8 @@ async function is_animated_gif(file) {
 
 /**
  * Determine the stored file extension for a given file.
- *
- * @param {File} file
- * @param {boolean} animated
- * @returns {string}
  */
-function get_stored_extension(file, animated) {
+function get_stored_extension(file: File, animated: boolean): string {
 	if (file.type === 'image/svg+xml') return 'svg';
 	if (file.type === 'image/gif' && animated) return 'gif';
 	// All other raster images get converted to WebP
@@ -77,39 +63,29 @@ function get_stored_extension(file, animated) {
 
 /**
  * Check if a file is a video based on MIME type.
- *
- * @param {File} file
- * @returns {boolean}
  */
-function is_video(file) {
+function is_video(file: File): boolean {
 	return file.type.startsWith('video/');
 }
 
 /**
  * Check if a video file is marked as already web-optimized via the filename
  * convention (e.g. my_video_optimized.mp4). Such files are uploaded as-is.
- *
- * @param {File} file
- * @returns {boolean}
  */
-function is_preoptimized_video(file) {
+function is_preoptimized_video(file: File): boolean {
 	return file.type === 'video/mp4' && OPTIMIZED_VIDEO_REGEX.test(file.name);
 }
 
 /**
  * Serialize video transcode jobs: parallel transcodes would compete for
  * memory and hardware encoders, so run them one at a time.
- *
- * @type {Promise<any>}
  */
-let video_queue = Promise.resolve();
+let video_queue: Promise<unknown> = Promise.resolve();
 
-/**
- * @param {File} file
- * @param {import('./process_video.js').ProcessVideoOptions} options
- * @returns {Promise<import('./process_video.js').ProcessedVideo>}
- */
-function enqueue_video_processing(file, options) {
+function enqueue_video_processing(
+	file: File,
+	options: ProcessVideoOptions
+): Promise<ProcessedVideo> {
 	const job = video_queue.then(() => process_video(file, options));
 	// Keep the queue chain alive even if this job fails
 	video_queue = job.catch(() => {});
@@ -118,15 +94,12 @@ function enqueue_video_processing(file, options) {
 
 /**
  * Start background processing for a pasted/dropped media file.
- * Call this from handle_media_paste. The blob_url is used as the key
- * to look up the processing result during the save flow.
- *
- * @param {string} blob_url - The blob: URL set as the image node's src
- * @param {File} file - The original source file
+ * Call this from handle_media_paste. The blob_url (the blob: URL set as the
+ * media node's src) is used as the key to look up the processing result
+ * during the save flow.
  */
-export async function start_processing(blob_url, file) {
-	/** @type {PendingAsset} */
-	const entry = {
+export async function start_processing(blob_url: string, file: File) {
+	const entry: PendingAsset = {
 		hash: '',
 		asset_id: '',
 		original: { blob: file, width: 0, height: 0 },
@@ -142,10 +115,7 @@ export async function start_processing(blob_url, file) {
 			if (is_preoptimized_video(file)) {
 				// Escape hatch: filename marks the file as already optimized —
 				// upload the raw bytes without transcoding.
-				const [hash, dims] = await Promise.all([
-					hash_blob(file),
-					get_video_dimensions(file)
-				]);
+				const [hash, dims] = await Promise.all([hash_blob(file), get_video_dimensions(file)]);
 				entry.hash = hash;
 				entry.asset_id = `${hash}.mp4`;
 				entry.original = { blob: file, width: dims.width, height: dims.height };
@@ -210,31 +180,27 @@ export async function start_processing(blob_url, file) {
 
 /**
  * Check if there are any assets still being processed.
- *
- * @returns {boolean}
  */
-export function has_pending_processing() {
+export function has_pending_processing(): boolean {
 	for (const entry of pending_assets.values()) {
 		if (entry.status === 'processing') return true;
 	}
 	return false;
 }
 
-/**
- * @callback ProcessingProgressCallback
- * @param {{ done: number, total: number, progress: number }} progress
- */
+export type ProcessingProgressCallback = (progress: {
+	done: number;
+	total: number;
+	progress: number;
+}) => void;
 
 /**
  * Wait until all pending assets have finished processing.
  * The reported progress is the average completion across all entries (0–1);
  * video transcodes report incremental progress, other entries count as
  * 0 while processing and 1 when done.
- *
- * @param {ProcessingProgressCallback} [on_progress] - optional progress callback
- * @returns {Promise<void>}
  */
-export async function wait_for_processing(on_progress) {
+export async function wait_for_processing(on_progress?: ProcessingProgressCallback): Promise<void> {
 	while (has_pending_processing()) {
 		if (on_progress) {
 			let done = 0;
@@ -257,14 +223,13 @@ export async function wait_for_processing(on_progress) {
 
 /**
  * Upload a blob using XHR with progress tracking.
- *
- * @param {string} url
- * @param {Blob} blob
- * @param {Record<string, string>} headers
- * @param {(progress: number) => void} [on_progress]
- * @returns {Promise<any>}
  */
-function upload_blob(url, blob, headers, on_progress) {
+function upload_blob(
+	url: string,
+	blob: Blob,
+	headers: Record<string, string>,
+	on_progress?: (progress: number) => void
+): Promise<any> {
 	return new Promise((resolve, reject) => {
 		const xhr = new XMLHttpRequest();
 		if (on_progress) {
@@ -282,7 +247,9 @@ function upload_blob(url, blob, headers, on_progress) {
 				try {
 					const body = JSON.parse(xhr.responseText);
 					if (body.message) message = body.message;
-				} catch { /* ignore */ }
+				} catch {
+					/* ignore */
+				}
 				reject(new Error(message));
 			}
 		});
@@ -299,11 +266,8 @@ function upload_blob(url, blob, headers, on_progress) {
 /**
  * Upload a single asset (original + variants) to the server.
  * Returns the asset_id on success.
- *
- * @param {PendingAsset} entry
- * @returns {Promise<{ asset_id: string, width: number, height: number }>}
  */
-async function upload_asset(entry) {
+async function upload_asset(entry: PendingAsset): Promise<UploadedAsset> {
 	const ext = entry.asset_id.slice(entry.asset_id.lastIndexOf('.') + 1);
 	const content_type = EXT_TO_MIME[ext];
 
@@ -317,7 +281,11 @@ async function upload_asset(entry) {
 
 	// If deduplicated, skip variant uploads
 	if (result.deduplicated) {
-		return { asset_id: result.asset_id, width: entry.original.width, height: entry.original.height };
+		return {
+			asset_id: result.asset_id,
+			width: entry.original.width,
+			height: entry.original.height
+		};
 	}
 
 	// Upload variants sequentially
@@ -332,31 +300,35 @@ async function upload_asset(entry) {
 			// Clean up the partially uploaded asset
 			try {
 				await fetch(`/api/assets/${result.asset_id}`, { method: 'DELETE' });
-			} catch { /* best effort cleanup */ }
-			throw new Error(`Variant upload failed (w${variant.width}): ${err instanceof Error ? err.message : err}`);
+			} catch {
+				/* best effort cleanup */
+			}
+			throw new Error(
+				`Variant upload failed (w${variant.width}): ${err instanceof Error ? err.message : err}`,
+				{ cause: err }
+			);
 		}
 	}
 
 	return { asset_id: result.asset_id, width: entry.original.width, height: entry.original.height };
 }
 
-/**
- * @callback UploadProgressCallback
- * @param {{ phase: 'uploading', index: number, total: number }} progress
- */
+export type UploadProgressCallback = (progress: {
+	phase: 'uploading';
+	index: number;
+	total: number;
+}) => void;
 
 /**
  * Upload pending assets that are referenced in the document.
  * Only uploads entries whose blob URL appears in the provided list.
  * Throws on the first failure (after cleaning up the failed asset).
- *
- * @param {string[]} blob_urls - blob URLs currently in the document's image nodes
- * @param {UploadProgressCallback} [on_progress] - optional progress callback
- * @returns {Promise<Map<string, { asset_id: string, width: number, height: number }>>}
  */
-export async function upload_pending(blob_urls, on_progress) {
-	/** @type {Map<string, { asset_id: string, width: number, height: number }>} */
-	const mapping = new Map();
+export async function upload_pending(
+	blob_urls: string[],
+	on_progress?: UploadProgressCallback
+): Promise<Map<string, UploadedAsset>> {
+	const mapping = new Map<string, UploadedAsset>();
 	const total = blob_urls.length;
 
 	for (let i = 0; i < blob_urls.length; i++) {
@@ -387,13 +359,18 @@ export async function upload_pending(blob_urls, on_progress) {
  * Replace blob URLs in document nodes with asset ids using the upload mapping.
  * Also updates width, height and mime_type to the processed values (e.g. a
  * dropped .mov is stored as video/mp4 after transcoding).
- *
- * @param {Record<string, any>} nodes - The document's nodes map (mutated in place)
- * @param {Map<string, { asset_id: string, width: number, height: number }>} mapping
+ * The nodes map is mutated in place.
  */
-export function replace_blob_urls(nodes, mapping) {
+export function replace_blob_urls(
+	nodes: Record<string, DocumentNode>,
+	mapping: Map<string, UploadedAsset>
+) {
 	for (const node of Object.values(nodes)) {
-		if ((node.type === 'image' || node.type === 'video') && typeof node.src === 'string' && node.src.startsWith('blob:')) {
+		if (
+			(node.type === 'image' || node.type === 'video') &&
+			typeof node.src === 'string' &&
+			node.src.startsWith('blob:')
+		) {
 			const entry = mapping.get(node.src);
 			if (entry) {
 				const ext = entry.asset_id.slice(entry.asset_id.lastIndexOf('.') + 1);
@@ -413,11 +390,8 @@ export function replace_blob_urls(nodes, mapping) {
  * that's missing from the map (e.g. after undo brought back blob URLs
  * that were cleaned up after a previous save), re-fetch the blob and
  * restart processing.
- *
- * @param {string[]} blob_urls - blob URLs currently in the document's image nodes
- * @returns {Promise<void>}
  */
-export async function ensure_processing(blob_urls) {
+export async function ensure_processing(blob_urls: string[]): Promise<void> {
 	for (const blob_url of blob_urls) {
 		if (pending_assets.has(blob_url)) continue;
 
@@ -446,15 +420,16 @@ export async function ensure_processing(blob_urls) {
 }
 
 /**
- * Collect all blob URLs from image nodes in a document.
- *
- * @param {Record<string, any>} nodes
- * @returns {string[]}
+ * Collect all blob URLs from media nodes in a document.
  */
-export function collect_blob_urls(nodes) {
-	const blob_urls = [];
+export function collect_blob_urls(nodes: Record<string, DocumentNode>): string[] {
+	const blob_urls: string[] = [];
 	for (const node of Object.values(nodes)) {
-		if ((node.type === 'image' || node.type === 'video') && typeof node.src === 'string' && node.src.startsWith('blob:')) {
+		if (
+			(node.type === 'image' || node.type === 'video') &&
+			typeof node.src === 'string' &&
+			node.src.startsWith('blob:')
+		) {
 			blob_urls.push(node.src);
 		}
 	}
@@ -464,11 +439,9 @@ export function collect_blob_urls(nodes) {
 /**
  * Clean up completed entries from the pending map.
  * Call after a successful save.
- *
- * @param {Map<string, { asset_id: string, width: number, height: number }>} mapping
  */
-export function cleanup_pending(mapping) {
+export function cleanup_pending(mapping: Map<string, UploadedAsset>) {
 	for (const blob_url of mapping.keys()) {
 		pending_assets.delete(blob_url);
 	}
-}
\ No newline at end of file
+}
diff --git a/src/lib/client/media_dimensions.js b/src/lib/client/media_dimensions.ts
similarity index 81%
rename from src/lib/client/media_dimensions.js
rename to src/lib/client/media_dimensions.ts
index 6ec3e5f0..03b0db5f 100644
--- a/src/lib/client/media_dimensions.js
+++ b/src/lib/client/media_dimensions.ts
@@ -1,10 +1,7 @@
 /**
  * Extract image dimensions using an <img> element.
- *
- * @param {Blob} blob
- * @returns {Promise<{ width: number, height: number }>}
  */
-function get_image_dimensions(blob) {
+function get_image_dimensions(blob: Blob): Promise<{ width: number; height: number }> {
 	return new Promise((resolve, reject) => {
 		const img = new Image();
 		const object_url = URL.createObjectURL(blob);
@@ -26,11 +23,8 @@ function get_image_dimensions(blob) {
 /**
  * Extract dimensions from an SVG by parsing the viewBox attribute.
  * Falls back to get_image_dimensions if no viewBox is found.
- *
- * @param {Blob} blob
- * @returns {Promise<{ width: number, height: number }>}
  */
-async function get_svg_dimensions(blob) {
+async function get_svg_dimensions(blob: Blob): Promise<{ width: number; height: number }> {
 	try {
 		const text = await blob.text();
 		const match = text.match(/viewBox=["']([^"']+)["']/);
@@ -52,16 +46,13 @@ async function get_svg_dimensions(blob) {
 
 /**
  * Extract video dimensions using a temporary <video> element.
- *
- * @param {Blob} blob
- * @returns {Promise<{ width: number, height: number }>}
  */
-export function get_video_dimensions(blob) {
+export function get_video_dimensions(blob: Blob): Promise<{ width: number; height: number }> {
 	return new Promise((resolve, reject) => {
 		const video = document.createElement('video');
 		video.preload = 'metadata';
 		const object_url = URL.createObjectURL(blob);
-		let poll_id;
+		let poll_id: ReturnType<typeof setInterval>;
 
 		function cleanup() {
 			clearInterval(poll_id);
@@ -97,12 +88,9 @@ export function get_video_dimensions(blob) {
 
 /**
  * Extract dimensions from a media file (image or video).
- *
- * @param {File} file
- * @returns {Promise<{ width: number, height: number }>}
  */
-export function get_media_dimensions(file) {
+export function get_media_dimensions(file: File): Promise<{ width: number; height: number }> {
 	if (file.type.startsWith('video/')) return get_video_dimensions(file);
 	if (file.type === 'image/svg+xml') return get_svg_dimensions(file);
 	return get_image_dimensions(file);
-}
\ No newline at end of file
+}
diff --git a/src/lib/client/process_asset.js b/src/lib/client/process_asset.ts
similarity index 60%
rename from src/lib/client/process_asset.js
rename to src/lib/client/process_asset.ts
index 9ceb2a13..a3e6dd9b 100644
--- a/src/lib/client/process_asset.js
+++ b/src/lib/client/process_asset.ts
@@ -1,32 +1,25 @@
 import { MAX_IMAGE_WIDTH, VARIANT_WIDTHS } from '$lib/config.js';
 
-/**
- * @typedef {{
- *   original: { blob: Blob, width: number, height: number },
- *   variants: Array<{ width: number, blob: Blob }>
- * }} ProcessedAsset
- *
- * @typedef {{
- *   onStatus?: (status: string) => void
- * }} ProcessOptions
- */
+export type ProcessedAsset = {
+	original: { blob: Blob; width: number; height: number };
+	variants: Array<{ width: number; blob: Blob }>;
+};
+
+export type ProcessOptions = {
+	onStatus?: (status: string) => void;
+};
 
 /**
  * Process an image file off the main thread using a Web Worker.
  * Decodes, resizes, encodes to WebP, and generates all configured size variants.
- *
- * @param {File} file - The original image file
- * @param {ProcessOptions} [options]
- * @returns {Promise<ProcessedAsset>}
  */
-export function process_asset(file, options = {}) {
+export function process_asset(file: File, options: ProcessOptions = {}): Promise<ProcessedAsset> {
 	const { onStatus } = options;
 
 	return new Promise((resolve, reject) => {
-		const worker = new Worker(
-			new URL('./asset_processor.js', import.meta.url),
-			{ type: 'module' }
-		);
+		const worker = new Worker(new URL('./asset_processor.ts', import.meta.url), {
+			type: 'module'
+		});
 
 		worker.addEventListener('message', (e) => {
 			const msg = e.data;
@@ -46,12 +39,10 @@ export function process_asset(file, options = {}) {
 				worker.terminate();
 
 				const original_blob = new Blob([msg.original.buffer], { type: 'image/webp' });
-				const variants = msg.variants.map(
-					(/** @type {{ width: number, buffer: ArrayBuffer }} */ v) => ({
-						width: v.width,
-						blob: new Blob([v.buffer], { type: 'image/webp' })
-					})
-				);
+				const variants = msg.variants.map((v: { width: number; buffer: ArrayBuffer }) => ({
+					width: v.width,
+					blob: new Blob([v.buffer], { type: 'image/webp' })
+				}));
 
 				resolve({
 					original: {
@@ -76,4 +67,4 @@ export function process_asset(file, options = {}) {
 			variant_widths: VARIANT_WIDTHS
 		});
 	});
-}
\ No newline at end of file
+}
diff --git a/src/lib/client/process_video.js b/src/lib/client/process_video.ts
similarity index 73%
rename from src/lib/client/process_video.js
rename to src/lib/client/process_video.ts
index 922b60d5..ca888e89 100644
--- a/src/lib/client/process_video.js
+++ b/src/lib/client/process_video.ts
@@ -1,18 +1,16 @@
 import { MAX_VIDEO_RESOLUTION, MAX_VIDEO_FILESIZE } from '$lib/config.js';
 
-/**
- * @typedef {{
- *   blob: Blob,
- *   width: number,
- *   height: number,
- *   passthrough: boolean
- * }} ProcessedVideo
- *
- * @typedef {{
- *   onStatus?: (status: string) => void,
- *   onProgress?: (progress: number) => void
- * }} ProcessVideoOptions
- */
+export type ProcessedVideo = {
+	blob: Blob;
+	width: number;
+	height: number;
+	passthrough: boolean;
+};
+
+export type ProcessVideoOptions = {
+	onStatus?: (status: string) => void;
+	onProgress?: (progress: number) => void;
+};
 
 /**
  * Transcode a video file off the main thread using a Web Worker.
@@ -20,19 +18,15 @@ import { MAX_VIDEO_RESOLUTION, MAX_VIDEO_FILESIZE } from '$lib/config.js';
  * with bitrate and resolution chosen to land within MAX_VIDEO_FILESIZE.
  * Files that are already web-optimized are detected and passed through
  * (as-is for MP4, losslessly remuxed for other containers like MOV).
- *
- * @param {File} file - The original video file
- * @param {ProcessVideoOptions} [options]
- * @returns {Promise<ProcessedVideo>}
  */
-export function process_video(file, options = {}) {
+export function process_video(
+	file: File,
+	options: ProcessVideoOptions = {}
+): Promise<ProcessedVideo> {
 	const { onStatus, onProgress } = options;
 
 	return new Promise((resolve, reject) => {
-		const worker = new Worker(
-			new URL('./video_processor.js', import.meta.url),
-			{ type: 'module' }
-		);
+		const worker = new Worker(new URL('./video_processor.ts', import.meta.url), { type: 'module' });
 
 		worker.addEventListener('message', (e) => {
 			const msg = e.data;
diff --git a/src/lib/client/touch_drag.js b/src/lib/client/touch_drag.ts
similarity index 75%
rename from src/lib/client/touch_drag.js
rename to src/lib/client/touch_drag.ts
index 314f921e..4927cf15 100644
--- a/src/lib/client/touch_drag.js
+++ b/src/lib/client/touch_drag.ts
@@ -1,15 +1,16 @@
+import type { Attachment } from 'svelte/attachments';
+
 // --- Global cursor lock ---
 // Injects a single shared <style> into <head> that forces a cursor on every
 // element via `!important`.  Used by drag handles and pan controls so the
 // cursor stays locked even when the pointer leaves the drag zone.
 
-let _cursor_style = null;
+let _cursor_style: HTMLStyleElement | null = null;
 
 /**
- * Lock the cursor globally to the given CSS cursor value.
- * @param {string} cursor - e.g. 'ew-resize', 'grabbing'
+ * Lock the cursor globally to the given CSS cursor value (e.g. 'ew-resize', 'grabbing').
  */
-export function lock_cursor(cursor) {
+export function lock_cursor(cursor: string) {
 	if (!_cursor_style) {
 		_cursor_style = document.createElement('style');
 		document.head.appendChild(_cursor_style);
@@ -39,32 +40,29 @@ export function unlock_cursor() {
  * Usage:
  *
  *   <div {@attach touch_drag({ on_move, on_down, on_up })}>
- *
- * @param {{
- *   should_start?: () => boolean,
- *   on_down?: (client_x: number, client_y: number) => void,
- *   on_move: (client_x: number, client_y: number) => void,
- *   on_up?: () => void,
- * }} callbacks
- * @returns {import('svelte/attachments').Attachment}
  */
-export function touch_drag(callbacks) {
+export function touch_drag(callbacks: {
+	should_start?: () => boolean;
+	on_down?: (client_x: number, client_y: number) => void;
+	on_move: (client_x: number, client_y: number) => void;
+	on_up?: () => void;
+}): Attachment<HTMLElement> {
 	const HOLD_MS = 300;
 	const MOVE_TOL = 8;
 
-	return (node) => {
+	return (node: HTMLElement) => {
 		let dragging = false;
 		let locked = false;
-		let timer = null;
+		let timer: ReturnType<typeof setTimeout> | null = null;
 		let start_x = 0;
 		let start_y = 0;
 
-		function set_dragging(v) {
+		function set_dragging(v: boolean) {
 			dragging = v;
 			node.classList.toggle('dragging', v);
 		}
 
-		function set_locked(v) {
+		function set_locked(v: boolean) {
 			locked = v;
 			node.classList.toggle('touch-locked', v);
 		}
@@ -82,12 +80,15 @@ export function touch_drag(callbacks) {
 		}
 
 		function clear_timer() {
-			if (timer) { clearTimeout(timer); timer = null; }
+			if (timer) {
+				clearTimeout(timer);
+				timer = null;
+			}
 		}
 
 		// --- Pointer (mouse / pen — immediate) ---
 
-		function on_pointer_down(e) {
+		function on_pointer_down(e: PointerEvent) {
 			if (e.pointerType === 'touch' || !can_start()) return;
 			e.preventDefault();
 			e.stopPropagation();
@@ -95,12 +96,12 @@ export function touch_drag(callbacks) {
 			callbacks.on_down?.(e.clientX, e.clientY);
 		}
 
-		function on_pointer_move(e) {
+		function on_pointer_move(e: PointerEvent) {
 			if (e.pointerType === 'touch' || !dragging) return;
 			callbacks.on_move(e.clientX, e.clientY);
 		}
 
-		function on_pointer_up(e) {
+		function on_pointer_up(e: PointerEvent) {
 			if (e?.pointerType === 'touch' || !dragging) return;
 			set_dragging(false);
 			callbacks.on_up?.();
@@ -108,7 +109,7 @@ export function touch_drag(callbacks) {
 
 		// --- Touch (hold-then-drag) ---
 
-		function on_touch_start(e) {
+		function on_touch_start(e: TouchEvent) {
 			if (e.touches.length !== 1 || !can_start()) return;
 			const t = e.touches[0];
 			start_x = t.clientX;
@@ -122,13 +123,17 @@ export function touch_drag(callbacks) {
 			}, HOLD_MS);
 		}
 
-		function on_touch_move(e) {
-			if (e.touches.length !== 1) { end_drag(); return; }
+		function on_touch_move(e: TouchEvent) {
+			if (e.touches.length !== 1) {
+				end_drag();
+				return;
+			}
 			const t = e.touches[0];
 			if (!locked) {
-				if (timer
-					&& (Math.abs(t.clientX - start_x) > MOVE_TOL
-						|| Math.abs(t.clientY - start_y) > MOVE_TOL)) {
+				if (
+					timer &&
+					(Math.abs(t.clientX - start_x) > MOVE_TOL || Math.abs(t.clientY - start_y) > MOVE_TOL)
+				) {
 					clear_timer();
 				}
 				return;
@@ -158,4 +163,4 @@ export function touch_drag(callbacks) {
 			window.removeEventListener('pointerup', on_pointer_up);
 		};
 	};
-}
\ No newline at end of file
+}
diff --git a/src/lib/client/video_processor.js b/src/lib/client/video_processor.ts
similarity index 85%
rename from src/lib/client/video_processor.js
rename to src/lib/client/video_processor.ts
index 2158a261..a5d2cf7d 100644
--- a/src/lib/client/video_processor.js
+++ b/src/lib/client/video_processor.ts
@@ -11,6 +11,7 @@ import {
 	canEncodeAudio
 } from 'mediabunny';
 import { registerAacEncoder } from '@mediabunny/aac-encoder';
+import type { ConversionVideoOptions } from 'mediabunny';
 
 /**
  * Tolerance factor applied to the size budget when deciding whether a video
@@ -48,10 +49,7 @@ const RESOLUTION_LADDER = [2160, 1440, 1080, 720, 540, 360, 240];
  */
 const MIN_VIDEO_BITRATE = 100_000;
 
-/**
- * @param {string} status
- */
-function post_status(status) {
+function post_status(status: string) {
 	self.postMessage({ type: 'status', status });
 }
 
@@ -59,12 +57,8 @@ function post_status(status) {
  * Candidate short-side resolutions: the source resolution capped at
  * max_resolution (never upscale), then every ladder step below it,
  * largest first.
- *
- * @param {number} source_short_side
- * @param {number} max_resolution
- * @returns {number[]}
  */
-function build_candidate_resolutions(source_short_side, max_resolution) {
+function build_candidate_resolutions(source_short_side: number, max_resolution: number): number[] {
 	const top = Math.min(source_short_side, max_resolution);
 	const candidates = [top];
 	for (const step of RESOLUTION_LADDER) {
@@ -80,14 +74,16 @@ function build_candidate_resolutions(source_short_side, max_resolution) {
  * above the floor (very long videos), it is used anyway — the file size
  * goal wins and the quality tradeoff is left to the user.
  *
- * @param {number} display_width
- * @param {number} display_height
- * @param {number} frame_rate - frames per second
- * @param {number} budget_bitrate - bits/second available for video
- * @param {number} max_resolution - cap on the short side
- * @returns {{ short_side: number, bitrate: number }}
+ * frame_rate is in frames per second, budget_bitrate in bits/second, and
+ * max_resolution caps the short side.
  */
-function choose_encoding(display_width, display_height, frame_rate, budget_bitrate, max_resolution) {
+function choose_encoding(
+	display_width: number,
+	display_height: number,
+	frame_rate: number,
+	budget_bitrate: number,
+	max_resolution: number
+): { short_side: number; bitrate: number } {
 	const source_short_side = Math.min(display_width, display_height);
 	const aspect = Math.max(display_width, display_height) / source_short_side;
 	const candidates = build_candidate_resolutions(source_short_side, max_resolution);
@@ -110,27 +106,23 @@ function choose_encoding(display_width, display_height, frame_rate, budget_bitra
  * Build resize options for a target short side. Only one dimension is
  * passed so mediabunny deduces the other from the aspect ratio — this
  * avoids letterboxing and rounding mismatches.
- *
- * @param {number} display_width
- * @param {number} display_height
- * @param {number} short_side - target short side
- * @returns {{ width?: number, height?: number }}
  */
-function build_resize_options(display_width, display_height, short_side) {
+function build_resize_options(
+	display_width: number,
+	display_height: number,
+	short_side: number
+): { width?: number; height?: number } {
 	if (Math.min(display_width, display_height) <= short_side) return {};
-	return display_width < display_height
-		? { width: short_side }
-		: { height: short_side };
+	return display_width < display_height ? { width: short_side } : { height: short_side };
 }
 
 /**
  * Read the display dimensions of the primary video track from a transcoded
  * buffer, so the reported dimensions exactly match the stored file.
- *
- * @param {ArrayBuffer} buffer
- * @returns {Promise<{ width: number, height: number } | null>}
  */
-async function read_output_dimensions(buffer) {
+async function read_output_dimensions(
+	buffer: ArrayBuffer
+): Promise<{ width: number; height: number } | null> {
 	const output_input = new Input({ source: new BufferSource(buffer), formats: ALL_FORMATS });
 	const track = await output_input.getPrimaryVideoTrack();
 	if (!track) return null;
@@ -141,10 +133,8 @@ async function read_output_dimensions(buffer) {
 
 /**
  * Handle a transcode request from the main thread.
- *
- * @param {{ file: File, max_resolution: number, max_filesize: number }} data
  */
-async function handle_process(data) {
+async function handle_process(data: { file: File; max_resolution: number; max_filesize: number }) {
 	const { file, max_resolution, max_filesize } = data;
 
 	try {
@@ -223,8 +213,7 @@ async function handle_process(data) {
 		// For an already-good video in a non-MP4 container (e.g. an H.264 .mov),
 		// omit codec/bitrate so mediabunny losslessly copies the tracks into the
 		// MP4 container instead of re-encoding.
-		/** @type {import('mediabunny').ConversionVideoOptions} */
-		const video_options = already_good
+		const video_options: ConversionVideoOptions = already_good
 			? {}
 			: { ...resize, codec: 'avc', bitrate: encoding.bitrate };
 
diff --git a/src/lib/code_comments.test.js b/src/lib/code_comments.test.ts
similarity index 94%
rename from src/lib/code_comments.test.js
rename to src/lib/code_comments.test.ts
index 07478ac2..ad897e7f 100644
--- a/src/lib/code_comments.test.js
+++ b/src/lib/code_comments.test.ts
@@ -1,13 +1,11 @@
 import { describe, it, expect } from 'vitest';
 import { split_code_comments } from './code_comments.js';
 
-/** @param {{ text: string, comment: boolean }[] | null} segments */
-function comments(segments) {
+function comments(segments: { text: string; comment: boolean }[] | null) {
 	return (segments ?? []).filter((segment) => segment.comment).map((segment) => segment.text);
 }
 
-/** @param {{ text: string, comment: boolean }[] | null} segments */
-function joined(segments) {
+function joined(segments: { text: string; comment: boolean }[] | null) {
 	return (segments ?? []).map((segment) => segment.text).join('');
 }
 
diff --git a/src/lib/code_comments.js b/src/lib/code_comments.ts
similarity index 88%
rename from src/lib/code_comments.js
rename to src/lib/code_comments.ts
index dfb62d04..ce2ed2de 100644
--- a/src/lib/code_comments.js
+++ b/src/lib/code_comments.ts
@@ -12,24 +12,19 @@
  * comments — callers then render the text as-is. Strings (quoted with
  * ', ", or `) are skipped so a `//` inside them is not mistaken for a
  * comment, and `://` (URLs) never starts one.
- *
- * @param {string} text
- * @returns {{ text: string, comment: boolean }[] | null}
  */
-export function split_code_comments(text) {
+export function split_code_comments(text: string): { text: string; comment: boolean }[] | null {
 	// `#` comments are only recognized in shell-ish blocks, so hex colors,
 	// config files, and markdown headings inside code blocks stay untouched.
 	const allow_hash_comments = looks_like_shell(text);
 	if (!allow_hash_comments && !looks_like_code(text)) return null;
 
-	/** @type {{ text: string, comment: boolean }[]} */
-	const segments = [];
+	const segments: { text: string; comment: boolean }[] = [];
 	let normal_start = 0;
 	let has_comment = false;
 	let i = 0;
 
-	/** @param {number} end */
-	function push_normal(end) {
+	function push_normal(end: number) {
 		if (end > normal_start) segments.push({ text: text.slice(normal_start, end), comment: false });
 	}
 
@@ -104,11 +99,8 @@ export function split_code_comments(text) {
 
 /**
  * Heuristic: does this text read as source code?
- *
- * @param {string} text
- * @returns {boolean}
  */
-function looks_like_code(text) {
+function looks_like_code(text: string): boolean {
 	return (
 		/(^|\n)\s*(\/\/|\/\*|import\s|export\s|const\s|let\s|function\s|class\s|interface\s)/.test(
 			text
@@ -122,11 +114,8 @@ function looks_like_code(text) {
 
 /**
  * Heuristic: does this text read as a shell session or script?
- *
- * @param {string} text
- * @returns {boolean}
  */
-function looks_like_shell(text) {
+function looks_like_shell(text: string): boolean {
 	return /(^|\n)\s*(\$ |#!|npm\s|npx\s|node\s|git\s|gh\s|fly\s|cd\s|cp\s|mv\s|rm\s|mkdir\s|echo\s|curl\s|docker\s|brew\s|sh\s|bash\s)/.test(
 		text
 	);
diff --git a/src/lib/config.js b/src/lib/config.ts
similarity index 91%
rename from src/lib/config.js
rename to src/lib/config.ts
index b9b503e7..8ffe4d14 100644
--- a/src/lib/config.js
+++ b/src/lib/config.ts
@@ -93,18 +93,18 @@ export const MEDIA_DEFAULTS = {
  * Landscape ratios are listed first; portrait inversions are auto-generated.
  * The natural (original) ratio is always included at snap time, so it doesn't need to be here.
  */
- const LANDSCAPE_RATIOS = [
+const LANDSCAPE_RATIOS = [
 	{ ratio: 1 / 1, label: '1:1' },
 	{ ratio: 4 / 3, label: '4:3' },
 	{ ratio: 16 / 9, label: '16:9' },
-	{ ratio: 21 / 9, label: '21:9' },
- ];
+	{ ratio: 21 / 9, label: '21:9' }
+];
 
-/** @type {{ ratio: number, label: string }[]} */
-export const SNAP_ASPECT_RATIOS = [
+export const SNAP_ASPECT_RATIOS: { ratio: number; label: string }[] = [
 	...LANDSCAPE_RATIOS,
 	// Add portrait inversions (skip 1:1 — its inverse is itself)
-	...LANDSCAPE_RATIOS
-		.filter(r => r.ratio !== 1)
-		.map(r => ({ ratio: 1 / r.ratio, label: r.label.split(':').reverse().join(':') })),
+	...LANDSCAPE_RATIOS.filter((r) => r.ratio !== 1).map((r) => ({
+		ratio: 1 / r.ratio,
+		label: r.label.split(':').reverse().join(':')
+	}))
 ];
diff --git a/src/lib/content_config.js b/src/lib/content_config.ts
similarity index 99%
rename from src/lib/content_config.js
rename to src/lib/content_config.ts
index dc270159..e0d25b09 100644
--- a/src/lib/content_config.js
+++ b/src/lib/content_config.ts
@@ -28,5 +28,5 @@ export const MARKDOWN_SOURCES = [
 		source: 'TARGET_GROUPS.md',
 		pathname: '/solutions',
 		toc: true
-	},
+	}
 ];
diff --git a/src/lib/demo_doc.js b/src/lib/demo_doc.ts
similarity index 100%
rename from src/lib/demo_doc.js
rename to src/lib/demo_doc.ts
diff --git a/src/lib/document_graph.js b/src/lib/document_graph.ts
similarity index 65%
rename from src/lib/document_graph.js
rename to src/lib/document_graph.ts
index aa35fab6..704f09fa 100644
--- a/src/lib/document_graph.js
+++ b/src/lib/document_graph.ts
@@ -1,22 +1,24 @@
 import { document_schema } from '$lib/document_schema.js';
+import type { Attachment, DocumentNode, NodeSchema, PropertyDefinition } from 'svedit';
 
-function get_attached_ranges(value) {
+function get_attached_ranges(
+	value: { marks?: Attachment[]; annotations?: Attachment[] } | null | undefined
+): Attachment[] {
 	return [...(value?.marks ?? []), ...(value?.annotations ?? [])];
 }
 
 /**
  * Collect all node ids reachable from a root node by walking node/node_array
  * properties and mark/annotation references, preserving first-seen traversal order.
- *
- * @param {string} root_id
- * @param {Record<string, any>} nodes
- * @param {Set<string>} [exclude_roots]
- * @returns {string[]}
  */
-export function collect_node_ids_in_order(root_id, nodes, exclude_roots) {
-	const collected = [];
-	const seen_ids = new Set();
-	const stack = [root_id];
+export function collect_node_ids_in_order(
+	root_id: string,
+	nodes: Record<string, DocumentNode>,
+	exclude_roots?: Set<string>
+): string[] {
+	const collected: string[] = [];
+	const seen_ids = new Set<string>();
+	const stack: string[] = [root_id];
 
 	while (stack.length > 0) {
 		const id = stack.pop();
@@ -29,12 +31,14 @@ export function collect_node_ids_in_order(root_id, nodes, exclude_roots) {
 		const node = nodes[id];
 		if (!node) continue;
 
-		const type_schema = document_schema[node.type];
+		const type_schema: NodeSchema | undefined = document_schema[node.type];
 		if (!type_schema) continue;
 
-		const next_ids = [];
+		const next_ids: string[] = [];
 
-		for (const [prop_name, prop_def] of Object.entries(type_schema.properties)) {
+		for (const [prop_name, prop_def] of Object.entries<PropertyDefinition>(
+			type_schema.properties
+		)) {
 			const value = node[prop_name];
 			if (value == null) continue;
 
diff --git a/src/lib/document_schema.js b/src/lib/document_schema.ts
similarity index 97%
rename from src/lib/document_schema.js
rename to src/lib/document_schema.ts
index 6755df0d..68689398 100644
--- a/src/lib/document_schema.js
+++ b/src/lib/document_schema.ts
@@ -1,4 +1,4 @@
-import { define_document_schema } from 'svedit';
+import { define_document_schema, type NodeMap } from 'svedit';
 import { MEDIA_DEFAULTS } from '$lib/config.js';
 
 const ALL_MARKS = ['strong', 'emphasis', 'code', 'highlight', 'link'];
@@ -627,3 +627,9 @@ export const document_schema = define_document_schema({
 		properties: {}
 	}
 });
+
+/**
+ * Map from node type name to its schema-derived runtime shape,
+ * e.g. `Nodes['paragraph']` — gives property autocomplete in components.
+ */
+export type Nodes = NodeMap<typeof document_schema>;
diff --git a/src/lib/index.js b/src/lib/index.ts
similarity index 100%
rename from src/lib/index.js
rename to src/lib/index.ts
diff --git a/src/lib/new_page.js b/src/lib/new_page.ts
similarity index 87%
rename from src/lib/new_page.js
rename to src/lib/new_page.ts
index cb85531b..d96a9c44 100644
--- a/src/lib/new_page.js
+++ b/src/lib/new_page.ts
@@ -1,5 +1,6 @@
 import nanoid from '../routes/nanoid.js';
 import { MEDIA_DEFAULTS } from '$lib/config.js';
+import type { Document } from 'svedit';
 
 /**
  * Create a new unsaved page document for the `/new` route.
@@ -11,14 +12,11 @@ import { MEDIA_DEFAULTS } from '$lib/config.js';
  * The shared nav/footer nodes are provided by the server so the new page is
  * composed from the current database-backed shared documents rather than the
  * demo seed data.
- *
- * @param {{
- *   nav_document: { document_id: string, nodes: Record<string, any> },
- *   footer_document: { document_id: string, nodes: Record<string, any> }
- * }} shared_documents
- * @returns {{ document_id: string, nodes: Record<string, any> }}
  */
-export function create_empty_doc(shared_documents) {
+export function create_empty_doc(shared_documents: {
+	nav_document: Document;
+	footer_document: Document;
+}): Document {
 	const page_id = nanoid();
 	const page_image_id = nanoid();
 	const prose_id = nanoid();
diff --git a/src/lib/page_metadata.js b/src/lib/page_metadata.ts
similarity index 68%
rename from src/lib/page_metadata.js
rename to src/lib/page_metadata.ts
index d751f771..2ac3b9e4 100644
--- a/src/lib/page_metadata.js
+++ b/src/lib/page_metadata.ts
@@ -1,5 +1,6 @@
 import { ASSET_BASE, ASSET_ID_REGEX, VARIANT_WIDTHS_SET } from '$lib/config.js';
 import { collect_node_ids_in_order } from '$lib/document_graph.js';
+import type { Document } from 'svedit';
 
 // Shared helpers for deriving page and site metadata from documents.
 //
@@ -22,69 +23,54 @@ const DESCRIPTION_NODE_TYPES = [
 ];
 
 /** Width of the resized variant used for social preview images (og:image). */
-export const SOCIAL_IMAGE_WIDTH = 1536;
+const SOCIAL_IMAGE_WIDTH = 1536;
 
 /** Width of the resized variant used for the favicon. */
-export const FAVICON_WIDTH = 320;
-
-/**
- * @typedef {Object} PreviewMediaNode
- * @property {string} type
- * @property {string} src
- * @property {number} width
- * @property {number} height
- * @property {string} alt
- * @property {number} scale
- * @property {number} focal_point_x
- * @property {number} focal_point_y
- * @property {string} object_fit
- * @property {string | undefined} mime_type
- */
-
-/**
- * @typedef {Object} PageMetadata
- * @property {string} title
- * @property {string | null} description
- * @property {PreviewMediaNode | null} preview_media_node
- */
-
-/**
- * @typedef {Object} SocialImage
- * @property {string} url
- * @property {number | null} width
- * @property {number | null} height
- * @property {string} alt
- */
-
-/**
- * @typedef {Object} SiteMetadata
- * @property {{ href: string, type: string | null } | null} favicon
- */
-
-/**
- * @param {{ content?: string } | null | undefined} text
- * @returns {string}
- */
-export function extract_plain_text(text) {
+const FAVICON_WIDTH = 320;
+
+export type PreviewMediaNode = {
+	type: string;
+	src: string;
+	width: number;
+	height: number;
+	alt: string;
+	scale: number;
+	focal_point_x: number;
+	focal_point_y: number;
+	object_fit: string;
+	mime_type: string | undefined;
+};
+
+export type PageMetadata = {
+	title: string;
+	description: string | null;
+	preview_media_node: PreviewMediaNode | null;
+};
+
+export type SocialImage = {
+	url: string;
+	width: number | null;
+	height: number | null;
+	alt: string;
+};
+
+export type SiteMetadata = {
+	favicon: { href: string; type: string | null } | null;
+};
+
+function extract_plain_text(text: { content?: string } | null | undefined): string {
 	if (!text || typeof text.content !== 'string') return '';
 	return text.content.trim();
 }
 
-/**
- * @param {PreviewMediaNode | null | undefined} media_node
- * @returns {boolean}
- */
-function is_saved_media(media_node) {
+function is_saved_media(media_node: PreviewMediaNode | null | undefined): boolean {
 	return !!media_node?.src && !media_node.src.startsWith('blob:');
 }
 
 /**
  * Resized variants exist only for saved raster images (not SVGs, not GIFs).
- *
- * @param {PreviewMediaNode} media_node
- * @returns {boolean}
  */
-function has_variants(media_node) {
+function has_variants(media_node: PreviewMediaNode): boolean {
 	if (!ASSET_ID_REGEX.test(media_node.src)) return false;
 	const mime_type = media_node.mime_type;
 	if (mime_type) return mime_type !== 'image/svg+xml' && mime_type !== 'image/gif';
@@ -94,15 +80,14 @@ function has_variants(media_node) {
 /**
  * Resolve the asset URL for a media node, preferring a resized variant when
  * one exists for the given target width.
- *
- * @param {PreviewMediaNode | null | undefined} media_node
- * @param {number} [target_width]
- * @returns {string | null}
  */
-export function get_media_asset_url(media_node, target_width) {
+function get_media_asset_url(
+	media_node: PreviewMediaNode | null | undefined,
+	target_width?: number
+): string | null {
 	if (!is_saved_media(media_node)) return null;
 
-	const node = /** @type {PreviewMediaNode} */ (media_node);
+	const node = media_node as PreviewMediaNode;
 
 	if (
 		target_width &&
@@ -120,11 +105,10 @@ export function get_media_asset_url(media_node, target_width) {
 /**
  * Resolve the social preview image (og:image) for a preview media node.
  * Videos are skipped — social cards need a raster image.
- *
- * @param {PreviewMediaNode | null | undefined} media_node
- * @returns {SocialImage | null}
  */
-export function get_social_image(media_node) {
+export function get_social_image(
+	media_node: PreviewMediaNode | null | undefined
+): SocialImage | null {
 	if (media_node?.type !== 'image' || !is_saved_media(media_node)) return null;
 
 	const url = get_media_asset_url(media_node, SOCIAL_IMAGE_WIDTH);
@@ -144,11 +128,7 @@ export function get_social_image(media_node) {
 	};
 }
 
-/**
- * @param {{ document_id: string, nodes: Record<string, any> } | null | undefined} page_doc
- * @returns {string[]}
- */
-export function collect_page_body_node_ids(page_doc) {
+export function collect_page_body_node_ids(page_doc: Document | null | undefined): string[] {
 	if (!page_doc?.document_id || !page_doc.nodes) {
 		return [];
 	}
@@ -174,11 +154,7 @@ export function collect_page_body_node_ids(page_doc) {
 	return body_node_ids;
 }
 
-/**
- * @param {{ document_id: string, nodes: Record<string, any> } | null | undefined} page_doc
- * @returns {PageMetadata}
- */
-export function extract_page_metadata(page_doc) {
+export function extract_page_metadata(page_doc: Document | null | undefined): PageMetadata {
 	if (!page_doc?.document_id || !page_doc.nodes) {
 		return { title: '', description: null, preview_media_node: null };
 	}
@@ -186,26 +162,26 @@ export function extract_page_metadata(page_doc) {
 	const page_root = page_doc.nodes[page_doc.document_id];
 	const explicit_title = extract_plain_text(page_root?.title);
 	const explicit_description = extract_plain_text(page_root?.description);
-	const explicit_image_node =
-		typeof page_root?.image === 'string' ? (page_doc.nodes[page_root.image] ?? null) : null;
+	const explicit_image_node = (typeof page_root?.image === 'string'
+		? (page_doc.nodes[page_root.image] ?? null)
+		: null) as unknown as PreviewMediaNode | null;
 
 	let heading_title = '';
 	let text_title = '';
-	let text_title_node_id = null;
-	let first_image_node = null;
-	let first_video_node = null;
+	let text_title_node_id: string | null = null;
+	let first_image_node: PreviewMediaNode | null = null;
+	let first_video_node: PreviewMediaNode | null = null;
 
-	/** @type {Array<{ node_id: string, text: string }>} */
-	const description_candidates = [];
+	const description_candidates: Array<{ node_id: string; text: string }> = [];
 
 	for (const node_id of collect_page_body_node_ids(page_doc)) {
 		const node = page_doc.nodes[node_id];
 		if (!node) continue;
 
 		if (!first_image_node && node.type === 'image') {
-			first_image_node = node;
+			first_image_node = node as unknown as PreviewMediaNode;
 		} else if (!first_video_node && node.type === 'video') {
-			first_video_node = node;
+			first_video_node = node as unknown as PreviewMediaNode;
 		}
 
 		if (!heading_title && TITLE_NODE_TYPES.includes(node.type)) {
@@ -249,15 +225,14 @@ export function extract_page_metadata(page_doc) {
 /**
  * Derive site-level metadata from the home page document. The favicon is the
  * home page's explicit page.image — by convention a square logo.
- *
- * @param {{ document_id: string, nodes: Record<string, any> } | null | undefined} home_page_doc
- * @returns {SiteMetadata}
  */
-export function extract_site_metadata(home_page_doc) {
+export function extract_site_metadata(home_page_doc: Document | null | undefined): SiteMetadata {
 	const page_root = home_page_doc?.nodes?.[home_page_doc.document_id];
 	const image_node =
 		typeof page_root?.image === 'string' ? home_page_doc.nodes[page_root.image] : null;
-	const favicon_media_node = image_node?.type === 'image' ? image_node : null;
+	const favicon_media_node = (image_node?.type === 'image'
+		? image_node
+		: null) as unknown as PreviewMediaNode | null;
 	const favicon_href = get_media_asset_url(favicon_media_node, FAVICON_WIDTH);
 
 	if (!favicon_media_node || !favicon_href) {
diff --git a/src/lib/server/asset_storage.js b/src/lib/server/asset_storage.ts
similarity index 66%
rename from src/lib/server/asset_storage.js
rename to src/lib/server/asset_storage.ts
index 40340af7..2acc2782 100644
--- a/src/lib/server/asset_storage.js
+++ b/src/lib/server/asset_storage.ts
@@ -1,5 +1,6 @@
 import crypto from 'node:crypto';
 import { createReadStream, createWriteStream, existsSync } from 'node:fs';
+import type { ReadStream } from 'node:fs';
 import { mkdir, readdir, unlink, rm, stat, utimes } from 'node:fs/promises';
 import { join, extname } from 'node:path';
 import { pipeline } from 'node:stream/promises';
@@ -13,44 +14,32 @@ import { mirror_file } from './s3.js';
 mkdirSync(ASSET_PATH, { recursive: true });
 
 /**
- * Get the full filesystem path for an original asset.
- *
- * @param {string} asset_id - e.g. "c4b519da...fabdb.webp"
- * @returns {string}
+ * Get the full filesystem path for an original asset (asset_id is
+ * e.g. "c4b519da...fabdb.webp").
  */
-export function asset_path(asset_id) {
+function asset_path(asset_id: string): string {
 	return join(ASSET_PATH, asset_id);
 }
 
 /**
  * Get the stem (asset id without extension) for building variant paths.
- *
- * @param {string} asset_id
- * @returns {string}
  */
-function stem(asset_id) {
+function stem(asset_id: string): string {
 	const ext = extname(asset_id);
 	return ext ? asset_id.slice(0, -ext.length) : asset_id;
 }
 
 /**
  * Get the directory path for an asset's variants.
- *
- * @param {string} asset_id
- * @returns {string}
  */
-export function variant_dir(asset_id) {
+function variant_dir(asset_id: string): string {
 	return join(ASSET_PATH, stem(asset_id));
 }
 
 /**
  * Get the full filesystem path for a width variant.
- *
- * @param {string} asset_id
- * @param {number} width
- * @returns {string}
  */
-export function variant_path(asset_id, width) {
+export function variant_path(asset_id: string, width: number): string {
 	return join(variant_dir(asset_id), `w${width}.webp`);
 }
 
@@ -58,19 +47,17 @@ export function variant_path(asset_id, width) {
  * Stream a ReadableStream (web), Buffer, or Uint8Array to a file on disk,
  * counting bytes and hashing the content. Size limiting is the deployment's
  * job (BODY_SIZE_LIMIT), enforced by the adapter while streaming.
- *
- * @param {string} file_path
- * @param {ReadableStream | Buffer | Uint8Array} data
- * @returns {Promise<{ bytes_written: number, sha256: string }>}
  */
-async function stream_to_file(file_path, data) {
-	/** @type {import('node:stream').Readable} */
-	let source;
+async function stream_to_file(
+	file_path: string,
+	data: ReadableStream | Buffer | Uint8Array
+): Promise<{ bytes_written: number; sha256: string }> {
+	let source: Readable;
 
 	if (Buffer.isBuffer(data) || data instanceof Uint8Array) {
 		source = Readable.from([data]);
 	} else {
-		source = Readable.fromWeb(/** @type {import('node:stream/web').ReadableStream} */ (data));
+		source = Readable.fromWeb(data as import('node:stream/web').ReadableStream);
 	}
 
 	let bytes_written = 0;
@@ -92,12 +79,11 @@ async function stream_to_file(file_path, data) {
 
 /**
  * Write an original asset to disk, streaming.
- *
- * @param {string} asset_id
- * @param {ReadableStream | Buffer | Uint8Array} data
- * @returns {Promise<{ bytes_written: number, sha256: string }>}
  */
-export async function write_asset(asset_id, data) {
+export async function write_asset(
+	asset_id: string,
+	data: ReadableStream | Buffer | Uint8Array
+): Promise<{ bytes_written: number; sha256: string }> {
 	const result = await stream_to_file(asset_path(asset_id), data);
 	mirror_file(`assets/${asset_id}`, asset_path(asset_id));
 	return result;
@@ -106,13 +92,12 @@ export async function write_asset(asset_id, data) {
 /**
  * Write a width variant to disk, streaming.
  * Creates the variant directory if needed.
- *
- * @param {string} asset_id
- * @param {number} width
- * @param {ReadableStream | Buffer | Uint8Array} data
- * @returns {Promise<{ bytes_written: number, sha256: string }>}
  */
-export async function write_variant(asset_id, width, data) {
+export async function write_variant(
+	asset_id: string,
+	width: number,
+	data: ReadableStream | Buffer | Uint8Array
+): Promise<{ bytes_written: number; sha256: string }> {
 	const dir = variant_dir(asset_id);
 	await mkdir(dir, { recursive: true });
 	const result = await stream_to_file(variant_path(asset_id, width), data);
@@ -122,21 +107,15 @@ export async function write_variant(asset_id, width, data) {
 
 /**
  * Check if an original asset exists on disk.
- *
- * @param {string} asset_id
- * @returns {boolean}
  */
-export function asset_exists(asset_id) {
+export function asset_exists(asset_id: string): boolean {
 	return existsSync(asset_path(asset_id));
 }
 
 /**
  * Delete an asset and all its variants from disk.
- *
- * @param {string} asset_id
- * @returns {Promise<void>}
  */
-export async function delete_asset(asset_id) {
+export async function delete_asset(asset_id: string): Promise<void> {
 	// Delete the original file
 	try {
 		await unlink(asset_path(asset_id));
@@ -153,34 +132,29 @@ export async function delete_asset(asset_id) {
 
 /**
  * Create a Node.js ReadStream for an original asset.
- *
- * @param {string} asset_id
- * @param {{ start?: number, end?: number }} [options]
- * @returns {import('node:fs').ReadStream}
  */
-export function create_asset_read_stream(asset_id, options = {}) {
+export function create_asset_read_stream(
+	asset_id: string,
+	options: { start?: number; end?: number } = {}
+): ReadStream {
 	return createReadStream(asset_path(asset_id), options);
 }
 
 /**
  * Create a Node.js ReadStream for a width variant.
- *
- * @param {string} asset_id
- * @param {number} width
- * @param {{ start?: number, end?: number }} [options]
- * @returns {import('node:fs').ReadStream}
  */
-export function create_variant_read_stream(asset_id, width, options = {}) {
+export function create_variant_read_stream(
+	asset_id: string,
+	width: number,
+	options: { start?: number; end?: number } = {}
+): ReadStream {
 	return createReadStream(variant_path(asset_id, width), options);
 }
 
 /**
  * Get the size of an original asset in bytes.
- *
- * @param {string} asset_id
- * @returns {Promise<number>}
  */
-export async function asset_size(asset_id) {
+export async function asset_size(asset_id: string): Promise<number> {
 	const s = await stat(asset_path(asset_id));
 	return s.size;
 }
@@ -197,11 +171,8 @@ const ORPHAN_GRACE_PERIOD_MS = ASSET_GRACE_PERIOD_DAYS * 24 * 60 * 60 * 1000;
 /**
  * Start the orphan clock for an asset by setting its mtime to now. Called
  * when an asset loses its last reference. Missing files are ignored.
- *
- * @param {string} asset_id
- * @returns {Promise<void>}
  */
-export async function touch_asset(asset_id) {
+export async function touch_asset(asset_id: string): Promise<void> {
 	const now = new Date();
 	try {
 		await utimes(asset_path(asset_id), now, now);
@@ -212,12 +183,9 @@ export async function touch_asset(asset_id) {
 
 /**
  * Delete asset files (and their variants) that are no longer referenced by
- * any document.
- *
- * @param {Set<string>} referenced_asset_ids
- * @returns {Promise<number>} number of deleted assets
+ * any document. Returns the number of deleted assets.
  */
-export async function delete_orphaned_assets(referenced_asset_ids) {
+export async function delete_orphaned_assets(referenced_asset_ids: Set<string>): Promise<number> {
 	const entries = await readdir(ASSET_PATH, { withFileTypes: true });
 	let deleted = 0;
 
diff --git a/src/lib/server/auth.js b/src/lib/server/auth.ts
similarity index 62%
rename from src/lib/server/auth.js
rename to src/lib/server/auth.ts
index 44e4cceb..386edab8 100644
--- a/src/lib/server/auth.js
+++ b/src/lib/server/auth.ts
@@ -1,4 +1,6 @@
 import crypto from 'node:crypto';
+import type { DatabaseSync } from 'node:sqlite';
+import type { Cookies } from '@sveltejs/kit';
 import { error } from '@sveltejs/kit';
 import { env } from '$env/dynamic/private';
 
@@ -24,33 +26,27 @@ const LOGIN_THROTTLE_KEY = 'login_throttle';
 
 /**
  * Constant-time password comparison over SHA-256 digests.
- *
- * @param {string} a
- * @param {string} b
- * @returns {boolean}
  */
-export function passwords_match(a, b) {
-	const digest = (/** @type {string} */ s) => crypto.createHash('sha256').update(s).digest();
+export function passwords_match(a: string, b: string): boolean {
+	const digest = (s: string) => crypto.createHash('sha256').update(s).digest();
 	return crypto.timingSafeEqual(digest(a), digest(b));
 }
 
-/**
- * @param {import('node:sqlite').DatabaseSync} db
- * @returns {{ failed_count: number, locked_until: number }}
- */
-function get_login_throttle_state(db) {
-	const row = /** @type {{ value: string } | undefined} */ (
-		db.prepare('SELECT value FROM site_settings WHERE key = ?').get(LOGIN_THROTTLE_KEY)
-	);
+function get_login_throttle_state(db: DatabaseSync): {
+	failed_count: number;
+	locked_until: number;
+} {
+	const row = db
+		.prepare('SELECT value FROM site_settings WHERE key = ?')
+		.get(LOGIN_THROTTLE_KEY) as { value: string } | undefined;
 
 	return row ? JSON.parse(row.value) : { failed_count: 0, locked_until: 0 };
 }
 
-/**
- * @param {import('node:sqlite').DatabaseSync} db
- * @param {{ failed_count: number, locked_until: number }} state
- */
-function set_login_throttle_state(db, state) {
+function set_login_throttle_state(
+	db: DatabaseSync,
+	state: { failed_count: number; locked_until: number }
+) {
 	db.prepare('INSERT OR REPLACE INTO site_settings (key, value) VALUES (?, ?)').run(
 		LOGIN_THROTTLE_KEY,
 		JSON.stringify(state)
@@ -59,19 +55,13 @@ function set_login_throttle_state(db, state) {
 
 /**
  * Seconds until login attempts are accepted again (0 when unlocked).
- *
- * @param {import('node:sqlite').DatabaseSync} db
- * @returns {number}
  */
-export function get_login_lockout_seconds(db) {
+export function get_login_lockout_seconds(db: DatabaseSync): number {
 	const { locked_until } = get_login_throttle_state(db);
 	return Math.max(locked_until - Math.floor(Date.now() / 1000), 0);
 }
 
-/**
- * @param {import('node:sqlite').DatabaseSync} db
- */
-export function register_failed_login(db) {
+export function register_failed_login(db: DatabaseSync) {
 	const state = get_login_throttle_state(db);
 	state.failed_count += 1;
 
@@ -87,17 +77,11 @@ export function register_failed_login(db) {
 	set_login_throttle_state(db, state);
 }
 
-/**
- * @param {import('node:sqlite').DatabaseSync} db
- */
-export function reset_login_throttle(db) {
+export function reset_login_throttle(db: DatabaseSync) {
 	set_login_throttle_state(db, { failed_count: 0, locked_until: 0 });
 }
 
-/**
- * @returns {string}
- */
-export function get_required_admin_password() {
+export function get_required_admin_password(): string {
 	const admin_password = env.ADMIN_PASSWORD;
 	if (!admin_password) {
 		throw new Error('ADMIN_PASSWORD must be set');
@@ -106,17 +90,11 @@ export function get_required_admin_password() {
 	return admin_password;
 }
 
-/**
- * @returns {number}
- */
-export function get_session_expires_at() {
+export function get_session_expires_at(): number {
 	return Math.floor(Date.now() / 1000) + session_duration_seconds;
 }
 
-/**
- * @param {import('@sveltejs/kit').Cookies} cookies
- */
-export function clear_admin_session_cookie(cookies) {
+export function clear_admin_session_cookie(cookies: Cookies) {
 	cookies.set(admin_session_cookie_name, '', {
 		path: '/',
 		httpOnly: true,
@@ -126,11 +104,7 @@ export function clear_admin_session_cookie(cookies) {
 	});
 }
 
-/**
- * @param {import('@sveltejs/kit').Cookies} cookies
- * @param {string} session_id
- */
-export function set_admin_session_cookie(cookies, session_id) {
+export function set_admin_session_cookie(cookies: Cookies, session_id: string) {
 	cookies.set(admin_session_cookie_name, session_id, {
 		path: '/',
 		httpOnly: true,
@@ -140,19 +114,13 @@ export function set_admin_session_cookie(cookies, session_id) {
 	});
 }
 
-/**
- * @param {string} session_id
- */
-export async function delete_session(session_id) {
+export async function delete_session(session_id: string) {
 	const { default: db } = await import('$lib/server/db.js');
 	db.prepare('DELETE FROM sessions WHERE session_id = ?').run(session_id);
 }
 
-/**
- * @param {{ is_admin?: boolean }} locals
- */
-export function require_admin_session(locals) {
+export function require_admin_session(locals: { is_admin?: boolean }) {
 	if (!locals.is_admin) {
 		error(401, 'Unauthorized');
 	}
-}
\ No newline at end of file
+}
diff --git a/src/lib/server/db.js b/src/lib/server/db.ts
similarity index 86%
rename from src/lib/server/db.js
rename to src/lib/server/db.ts
index 089f9653..b654399f 100644
--- a/src/lib/server/db.js
+++ b/src/lib/server/db.ts
@@ -13,12 +13,8 @@ db.exec('PRAGMA journal_mode=WAL');
 /**
  * Run fn inside an immediate transaction, committing on return and
  * rolling back on error.
- *
- * @template T
- * @param {() => T} fn
- * @returns {T}
  */
-export function with_transaction(fn) {
+export function with_transaction<T>(fn: () => T): T {
 	db.exec('BEGIN IMMEDIATE');
 	try {
 		const result = fn();
diff --git a/src/lib/server/db_snapshot.js b/src/lib/server/db_snapshot.ts
similarity index 83%
rename from src/lib/server/db_snapshot.js
rename to src/lib/server/db_snapshot.ts
index abcb3614..d435f9f5 100644
--- a/src/lib/server/db_snapshot.js
+++ b/src/lib/server/db_snapshot.ts
@@ -5,13 +5,14 @@
 // tooling at all.
 //
 // Triggered by writes (debounced, from the document save path) and at boot
-// (from the reconciliation sweep). Also imported by plain-node scripts —
-// keep this file free of $lib imports (see s3.js).
+// (from the reconciliation sweep). Also imported by plain-node scripts,
+// which don't remap .js specifiers to .ts files — so the s3 import uses an
+// explicit .ts extension, and this file must stay free of $lib imports.
 
 import { DatabaseSync } from 'node:sqlite';
 import { readFile, unlink } from 'node:fs/promises';
 import { join } from 'node:path';
-import { backup_enabled, list_keys, put_object } from './s3.js';
+import { backup_enabled, list_keys, put_object } from './s3.ts';
 
 const SNAPSHOT_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 const PREFIX = 'snapshots/';
@@ -19,7 +20,7 @@ const PREFIX = 'snapshots/';
 let running = false; // collapse concurrent triggers within this process
 
 // "snapshots/20260712T210000Z.sqlite3" → epoch ms (0 if not a snapshot key)
-function key_time(key) {
+function key_time(key: string): number {
 	const m = key.match(/(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z\.sqlite3$/);
 	return m ? Date.parse(`${m[1]}-${m[2]}-${m[3]}T${m[4]}:${m[5]}:${m[6]}Z`) : 0;
 }
@@ -28,10 +29,8 @@ function key_time(key) {
  * Upload a full-database snapshot to the bucket, unless one from the last
  * 24 hours is already there. Never throws — failures are logged and the
  * next trigger retries.
- *
- * @returns {Promise<void>}
  */
-export async function snapshot_if_stale() {
+export async function snapshot_if_stale(): Promise<void> {
 	if (!backup_enabled() || running) return;
 	running = true;
 	try {
@@ -39,7 +38,10 @@ export async function snapshot_if_stale() {
 		if (Date.now() - newest < SNAPSHOT_MAX_AGE_MS) return;
 
 		const db_path = join(process.env.DATA_DIR || '/data', 'db.sqlite3');
-		const ts = new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d+Z$/, 'Z');
+		const ts = new Date()
+			.toISOString()
+			.replace(/[-:]/g, '')
+			.replace(/\.\d+Z$/, 'Z');
 		const tmp = `${db_path}.snapshot-${process.pid}`;
 
 		// Consistent snapshot, safe under concurrent writes (WAL).
diff --git a/src/lib/server/layout_ids_migration.test.js b/src/lib/server/layout_ids_migration.test.ts
similarity index 100%
rename from src/lib/server/layout_ids_migration.test.js
rename to src/lib/server/layout_ids_migration.test.ts
diff --git a/src/lib/server/markdown/compose.js b/src/lib/server/markdown/compose.ts
similarity index 75%
rename from src/lib/server/markdown/compose.js
rename to src/lib/server/markdown/compose.ts
index b88a96cf..37e38fe9 100644
--- a/src/lib/server/markdown/compose.js
+++ b/src/lib/server/markdown/compose.ts
@@ -4,17 +4,16 @@
 
 import { fill_document_defaults, validate_document } from 'svedit';
 import { document_schema } from '$lib/document_schema.js';
+import type { Document } from 'svedit';
 
 /**
- * @param {{ document_id: string, nodes: Record<string, any> }} page_doc -
- *   Converted markdown document (without nav/footer)
- * @param {{
- *   nav_document: { document_id: string, nodes: Record<string, any> },
- *   footer_document: { document_id: string, nodes: Record<string, any> }
- * }} shared_documents
- * @returns {{ document_id: string, nodes: Record<string, any> }}
+ * Compose a converted markdown page document (without nav/footer) with the
+ * site's shared nav and footer documents.
  */
-export function compose_markdown_document(page_doc, shared_documents) {
+export function compose_markdown_document(
+	page_doc: Document,
+	shared_documents: { nav_document: Document; footer_document: Document }
+): Document {
 	const nav_document = shared_documents?.nav_document;
 	const footer_document = shared_documents?.footer_document;
 
diff --git a/src/lib/server/markdown/config.test.js b/src/lib/server/markdown/config.test.ts
similarity index 100%
rename from src/lib/server/markdown/config.test.js
rename to src/lib/server/markdown/config.test.ts
diff --git a/src/lib/server/markdown/config.js b/src/lib/server/markdown/config.ts
similarity index 81%
rename from src/lib/server/markdown/config.js
rename to src/lib/server/markdown/config.ts
index abf926c8..ff84380a 100644
--- a/src/lib/server/markdown/config.js
+++ b/src/lib/server/markdown/config.ts
@@ -5,21 +5,24 @@
 
 const ALLOWED_ENTRY_KEYS = new Set(['markdown', 'source', 'pathname', 'toc']);
 
+export type MarkdownSource = {
+	markdown: string;
+	source: string;
+	pathname: string;
+	toc: boolean;
+};
+
 /**
- * Validate and normalize markdown source mappings.
- *
- * @param {unknown} sources - The raw MARKDOWN_SOURCES value
- * @returns {{ markdown: string, source: string, pathname: string, toc: boolean }[]}
- * @throws {Error} Throws when the configuration is invalid
+ * Validate and normalize markdown source mappings. Throws when the
+ * configuration is invalid.
  */
-export function validate_markdown_sources(sources) {
+export function validate_markdown_sources(sources: unknown): MarkdownSource[] {
 	if (!Array.isArray(sources)) {
 		throw new Error('MARKDOWN_SOURCES must be an array.');
 	}
 
-	/** @type {{ markdown: string, source: string, pathname: string, toc: boolean }[]} */
-	const normalized = [];
-	const seen_pathnames = new Set();
+	const normalized: MarkdownSource[] = [];
+	const seen_pathnames = new Set<string>();
 
 	for (const [index, entry] of sources.entries()) {
 		const label = `MARKDOWN_SOURCES[${index}]`;
@@ -68,12 +71,7 @@ export function validate_markdown_sources(sources) {
 	return normalized;
 }
 
-/**
- * @param {unknown} pathname
- * @param {string} label
- * @returns {string}
- */
-function validate_pathname(pathname, label) {
+function validate_pathname(pathname: unknown, label: string): string {
 	if (typeof pathname !== 'string' || pathname.length === 0) {
 		throw new Error(`${label}.pathname must be a non-empty string.`);
 	}
diff --git a/src/lib/server/markdown/convert.test.js b/src/lib/server/markdown/convert.test.ts
similarity index 96%
rename from src/lib/server/markdown/convert.test.js
rename to src/lib/server/markdown/convert.test.ts
index ff3a09e2..4f4a3c50 100644
--- a/src/lib/server/markdown/convert.test.js
+++ b/src/lib/server/markdown/convert.test.ts
@@ -12,20 +12,22 @@ const SHARED_DOCUMENTS = {
 	}
 };
 
-/** @param {string} markdown */
-function convert(markdown, mapping = MAPPING) {
+import type { Document } from 'svedit';
+
+function convert(
+	markdown: string,
+	mapping: { source: string; pathname: string; toc?: boolean } = MAPPING
+) {
 	return convert_markdown(markdown, mapping);
 }
 
-/** @param {{ document_id: string, nodes: Record<string, any> }} doc */
-function page_body_nodes(doc) {
-	return doc.nodes[doc.document_id].body.nodes.map((id) => doc.nodes[id]);
+function page_body_nodes(doc: Document) {
+	return doc.nodes[doc.document_id].body.nodes.map((id: string) => doc.nodes[id]);
 }
 
-/** @param {{ document_id: string, nodes: Record<string, any> }} doc */
-function flat_text_nodes(doc) {
-	return page_body_nodes(doc).flatMap((block) =>
-		block.type === 'prose' ? block.body.nodes.map((id) => doc.nodes[id]) : [block]
+function flat_text_nodes(doc: Document) {
+	return page_body_nodes(doc).flatMap((block: any) =>
+		block.type === 'prose' ? block.body.nodes.map((id: string) => doc.nodes[id]) : [block]
 	);
 }
 
@@ -401,8 +403,6 @@ describe('compose_markdown_document', () => {
 	});
 
 	it('fails without shared documents', () => {
-		expect(() => compose_markdown_document(convert('# Hi'), /** @type {any} */ ({}))).toThrow(
-			/nav document/
-		);
+		expect(() => compose_markdown_document(convert('# Hi'), {} as any)).toThrow(/nav document/);
 	});
 });
diff --git a/src/lib/server/markdown/convert.js b/src/lib/server/markdown/convert.ts
similarity index 80%
rename from src/lib/server/markdown/convert.js
rename to src/lib/server/markdown/convert.ts
index a598f3e2..bac37470 100644
--- a/src/lib/server/markdown/convert.js
+++ b/src/lib/server/markdown/convert.ts
@@ -11,36 +11,40 @@ import { fromMarkdown } from 'mdast-util-from-markdown';
 import { MEDIA_DEFAULTS } from '$lib/config.js';
 import { document_schema } from '$lib/document_schema.js';
 import { select_toc_headings } from './toc.js';
+import type { TocHeading } from './toc.js';
+import type { Document, DocumentNode } from 'svedit';
 
 const SAFE_LINK_SCHEMES = new Set(['http', 'https', 'mailto']);
 
+/** Shared conversion state threaded through the converter functions. */
+type Ctx = {
+	source: string;
+	doc_id: string;
+	counter: number;
+	nodes: Record<string, DocumentNode>;
+	used_ids: Set<string>;
+};
+
 /**
  * Whether the schema allows newlines in a node type's content property.
- *
- * @param {string} node_type
- * @returns {boolean}
  */
-function content_allows_newlines(node_type) {
+function content_allows_newlines(node_type: string): boolean {
 	return document_schema[node_type]?.properties?.content?.allow_newlines === true;
 }
 
 /**
  * Whether an html node consists only of comments (which render as nothing in
  * every markdown renderer, so skipping them drops no visible content).
- *
- * @param {string} value
- * @returns {boolean}
  */
-function is_html_comment(value) {
+function is_html_comment(value: string): boolean {
 	return value.replace(/<!--[\s\S]*?-->/g, '').trim() === '';
 }
 
 export class MarkdownConversionError extends Error {
-	/**
-	 * @param {string} message
-	 * @param {{ source?: string, position?: any }} [options]
-	 */
-	constructor(message, { source, position } = {}) {
+	source: string | undefined;
+	position: any;
+
+	constructor(message: string, { source, position }: { source?: string; position?: any } = {}) {
 		const location = position?.start
 			? `${source ?? 'markdown'}:${position.start.line}:${position.start.column}`
 			: (source ?? 'markdown');
@@ -53,41 +57,33 @@ export class MarkdownConversionError extends Error {
 
 /**
  * Convert markdown text to a page document graph (without nav/footer).
- *
- * @param {string} markdown_text
- * @param {{ source: string, pathname: string, toc?: boolean }} mapping
- * @returns {{ document_id: string, nodes: Record<string, any> }}
- * @throws {MarkdownConversionError}
+ * Throws MarkdownConversionError on unsupported constructs.
  */
-export function convert_markdown(markdown_text, mapping) {
+export function convert_markdown(
+	markdown_text: string,
+	mapping: { source: string; pathname: string; toc?: boolean }
+): Document {
 	const { source, pathname, toc = false } = mapping;
 	const tree = fromMarkdown(markdown_text);
 
-	const ctx = {
+	const ctx: Ctx = {
 		source,
 		doc_id: `md_${pathname.slice(1).replaceAll('-', '_')}`,
 		counter: 0,
-		/** @type {Record<string, any>} */
 		nodes: {},
-		/** @type {Set<string>} */
 		used_ids: new Set()
 	};
 
-	/** @type {string[]} */
-	const body_ids = [];
-	/** @type {string[] | null} */
-	let prose_items = null;
-	/** @type {{ id: string, depth: number, container: string[], subtitle: string }[]} */
-	const headings = [];
+	const body_ids: string[] = [];
+	let prose_items: string[] | null = null;
+	const headings: TocHeading[] = [];
 	// Headings whose section has not yet seen a paragraph — the first paragraph
 	// becomes their subtitle, used as the toc description.
-	/** @type {{ subtitle: string }[]} */
-	let pending_subtitle_headings = [];
+	let pending_subtitle_headings: { subtitle: string }[] = [];
 	// Body indexes where a Markdown level-2 heading starts a new section.
-	/** @type {number[]} */
-	const section_boundaries = [];
-	/** @type {Map<string[], string>} prose body array -> prose node id */
-	const prose_ids_by_container = new Map();
+	const section_boundaries: number[] = [];
+	// Prose body array -> prose node id
+	const prose_ids_by_container = new Map<string[], string>();
 
 	function flush_prose() {
 		if (!prose_items || prose_items.length === 0) {
@@ -106,8 +102,7 @@ export function convert_markdown(markdown_text, mapping) {
 		prose_items = null;
 	}
 
-	/** @param {string} node_id */
-	function push_prose_item(node_id) {
+	function push_prose_item(node_id: string) {
 		if (!prose_items) prose_items = [];
 		prose_items.push(node_id);
 	}
@@ -215,8 +210,7 @@ export function convert_markdown(markdown_text, mapping) {
 	// Wrap each section's body range (its prose plus interleaved code blocks,
 	// up to the next section) in a section mark, so it renders as one visual
 	// group. Content before the first Markdown level-2 heading stays unwrapped.
-	/** @type {{ start_offset: number, end_offset: number, node_id: string }[]} */
-	const body_marks = [];
+	const body_marks: { start_offset: number; end_offset: number; node_id: string }[] = [];
 	for (const [boundary_index, start] of section_boundaries.entries()) {
 		const end = section_boundaries[boundary_index + 1] ?? body_ids.length;
 		if (end <= start) continue;
@@ -240,12 +234,8 @@ export function convert_markdown(markdown_text, mapping) {
 	return { document_id: ctx.doc_id, nodes: ctx.nodes };
 }
 
-/**
- * @param {any} ctx
- * @returns {string}
- */
-function next_id(ctx) {
-	let id;
+function next_id(ctx: Ctx): string {
+	let id: string;
 	do {
 		ctx.counter += 1;
 		id = `${ctx.doc_id}_${ctx.counter}`;
@@ -263,12 +253,8 @@ function next_id(ctx) {
  * same fragment links work in the repo view and on the website. One
  * divergence: node ids must start with a letter or underscore, so slugs with
  * a leading digit get an "h-" prefix.
- *
- * @param {any} ctx
- * @param {any} block - mdast heading node
- * @returns {string}
  */
-function heading_id(ctx, block) {
+function heading_id(ctx: Ctx, block: any): string {
 	const text = collect_plain_text(block.children);
 	let slug = text
 		.toLowerCase()
@@ -287,11 +273,7 @@ function heading_id(ctx, block) {
 	return id;
 }
 
-/**
- * @param {any[]} children - mdast inline nodes
- * @returns {string}
- */
-function collect_plain_text(children) {
+function collect_plain_text(children: any[]): string {
 	let text = '';
 	for (const child of children) {
 		if (typeof child.value === 'string') text += child.value;
@@ -311,16 +293,11 @@ function collect_plain_text(children) {
  * listing node id, or null when the list does not match — it then converts as
  * a plain list. `descriptive_listing` lives at the page body level, next to
  * prose and preformatted blocks.
- *
- * @param {any} ctx
- * @param {any} block - mdast list node
- * @returns {string | null} the descriptive_listing node id, or null
  */
-function convert_descriptive_listing(ctx, block) {
+function convert_descriptive_listing(ctx: Ctx, block: any): string | null {
 	if (block.ordered === true) return null;
 
-	/** @type {{ title: string, description: string, meta: string }[]} */
-	const rows = [];
+	const rows: { title: string; description: string; meta: string }[] = [];
 
 	for (const item of block.children) {
 		const blocks = item.children ?? [];
@@ -328,12 +305,12 @@ function convert_descriptive_listing(ctx, block) {
 
 		const [first, ...rest] = blocks[0].children;
 		if (first?.type !== 'strong') return null;
-		if (!first.children.every((child) => child.type === 'text')) return null;
-		if (!rest.every((child) => child.type === 'text')) return null;
+		if (!first.children.every((child: any) => child.type === 'text')) return null;
+		if (!rest.every((child: any) => child.type === 'text')) return null;
 
 		const title = collect_plain_text(first.children).replaceAll('\n', ' ');
 		const remainder = rest
-			.map((child) => child.value)
+			.map((child: any) => child.value)
 			.join('')
 			.replaceAll('\n', ' ');
 		if (!remainder.startsWith(' — ')) return null;
@@ -350,8 +327,7 @@ function convert_descriptive_listing(ctx, block) {
 
 	if (rows.length === 0) return null;
 
-	/** @type {string[]} */
-	const item_ids = [];
+	const item_ids: string[] = [];
 	for (const row of rows) {
 		const id = next_id(ctx);
 		ctx.nodes[id] = {
@@ -374,18 +350,12 @@ function convert_descriptive_listing(ctx, block) {
 	return listing_id;
 }
 
-/**
- * @param {any} ctx
- * @param {any} block - mdast list node
- * @returns {string} the list node id
- */
-function convert_list(ctx, block) {
-	/** @type {string[]} */
-	const item_ids = [];
+function convert_list(ctx: Ctx, block: any): string {
+	const item_ids: string[] = [];
 
 	for (const item of block.children) {
 		const blocks = item.children ?? [];
-		const nested_list = blocks.find((child) => child.type === 'list');
+		const nested_list = blocks.find((child: any) => child.type === 'list');
 		if (nested_list) {
 			throw new MarkdownConversionError(
 				'Nested lists are not supported (list items are single lines).',
@@ -431,22 +401,17 @@ function convert_list(ctx, block) {
  * `{ start_offset, end_offset, node_id }` ranges, with offsets counted in
  * grapheme clusters, and requires ranges to be mutually exclusive — nested
  * inline formatting cannot be represented and is rejected.
- *
- * @param {any} ctx
- * @param {any[]} children - mdast inline nodes
- * @param {{ allow_newlines: boolean }} options
- * @returns {{ content: string, marks: any[], annotations: any[] }}
  */
-function convert_inline(ctx, children, { allow_newlines }) {
+function convert_inline(
+	ctx: Ctx,
+	children: any[],
+	{ allow_newlines }: { allow_newlines: boolean }
+): { content: string; marks: any[]; annotations: any[] } {
 	let content = '';
-	/** @type {{ start: number, end: number, type: string, data?: Record<string, any> }[]} */
-	const utf16_ranges = [];
-
-	/**
-	 * @param {any[]} inline_nodes
-	 * @param {boolean} inside_mark
-	 */
-	function walk(inline_nodes, inside_mark) {
+	const utf16_ranges: { start: number; end: number; type: string; data?: Record<string, any> }[] =
+		[];
+
+	function walk(inline_nodes: any[], inside_mark: boolean) {
 		for (const inline of inline_nodes) {
 			switch (inline.type) {
 				case 'text':
@@ -507,13 +472,7 @@ function convert_inline(ctx, children, { allow_newlines }) {
 		}
 	}
 
-	/**
-	 * @param {number} start
-	 * @param {number} end
-	 * @param {string} type
-	 * @param {Record<string, any>} [data]
-	 */
-	function add_range(start, end, type, data) {
+	function add_range(start: number, end: number, type: string, data?: Record<string, any>) {
 		if (start === end) return;
 		utf16_ranges.push({ start, end, type, data });
 	}
@@ -524,12 +483,7 @@ function convert_inline(ctx, children, { allow_newlines }) {
 	return { content, marks, annotations: [] };
 }
 
-/**
- * @param {any} ctx
- * @param {any} inline
- * @param {boolean} inside_mark
- */
-function assert_not_nested(ctx, inline, inside_mark) {
+function assert_not_nested(ctx: Ctx, inline: any, inside_mark: boolean) {
 	if (inside_mark) {
 		throw new MarkdownConversionError(
 			'Nested inline formatting (e.g. bold inside a link) is not supported — marks are mutually exclusive in the content model.',
@@ -538,12 +492,7 @@ function assert_not_nested(ctx, inline, inside_mark) {
 	}
 }
 
-/**
- * @param {any} ctx
- * @param {any} inline - mdast link node
- * @returns {string}
- */
-function validate_href(ctx, inline) {
+function validate_href(ctx: Ctx, inline: any): string {
 	const href = inline.url ?? '';
 	const scheme_match = href.match(/^([a-zA-Z][a-zA-Z0-9+.-]*):/);
 
@@ -567,18 +516,17 @@ function validate_href(ctx, inline) {
 /**
  * Convert UTF-16 code-unit ranges to grapheme-cluster mark ranges and mint the
  * mark nodes (svedit counts text offsets in grapheme clusters).
- *
- * @param {any} ctx
- * @param {string} content
- * @param {{ start: number, end: number, type: string, data?: Record<string, any> }[]} utf16_ranges
- * @returns {{ start_offset: number, end_offset: number, node_id: string }[]}
  */
-function to_grapheme_marks(ctx, content, utf16_ranges) {
+function to_grapheme_marks(
+	ctx: Ctx,
+	content: string,
+	utf16_ranges: { start: number; end: number; type: string; data?: Record<string, any> }[]
+): { start_offset: number; end_offset: number; node_id: string }[] {
 	if (utf16_ranges.length === 0) return [];
 
 	const segmenter = new Intl.Segmenter();
-	/** @type {Map<number, number>} grapheme index at each UTF-16 boundary */
-	const boundaries = new Map([[0, 0]]);
+	// Grapheme index at each UTF-16 boundary
+	const boundaries = new Map<number, number>([[0, 0]]);
 	let grapheme_index = 0;
 	for (const segment of segmenter.segment(content)) {
 		grapheme_index += 1;
@@ -608,17 +556,24 @@ function to_grapheme_marks(ctx, content, utf16_ranges) {
  * first sentence of the chapter's first paragraph. It is inserted at the page
  * body level, before the block holding the first chapter heading (between the
  * intro and the first section in the typical `#` title + `##` chapters case).
- *
- * @param {any} ctx
- * @param {{ id: string, depth: number, container: string[], subtitle: string }[]} headings
- * @param {{ body_ids: string[], prose_ids_by_container: Map<string[], string>, section_boundaries: number[] }} body
  */
-function insert_toc(ctx, headings, { body_ids, prose_ids_by_container, section_boundaries }) {
+function insert_toc(
+	ctx: Ctx,
+	headings: TocHeading[],
+	{
+		body_ids,
+		prose_ids_by_container,
+		section_boundaries
+	}: {
+		body_ids: string[];
+		prose_ids_by_container: Map<string[], string>;
+		section_boundaries: number[];
+	}
+) {
 	const selection = select_toc_headings(headings);
 	if (!selection) return;
 
-	/** @type {string[]} */
-	const item_ids = [];
+	const item_ids: string[] = [];
 	for (const heading of selection.targets) {
 		const item_id = next_id(ctx);
 		ctx.nodes[item_id] = {
@@ -656,11 +611,7 @@ function insert_toc(ctx, headings, { body_ids, prose_ids_by_container, section_b
 	}
 }
 
-/**
- * @param {string} text
- * @returns {string}
- */
-function first_sentence(text) {
+function first_sentence(text: string): string {
 	const match = text.match(/^[\s\S]*?[.!?](?=\s|$)/);
 	return (match ? match[0] : text).trim();
 }
diff --git a/src/lib/server/markdown/registry.test.js b/src/lib/server/markdown/registry.test.ts
similarity index 100%
rename from src/lib/server/markdown/registry.test.js
rename to src/lib/server/markdown/registry.test.ts
diff --git a/src/lib/server/markdown/registry.js b/src/lib/server/markdown/registry.ts
similarity index 63%
rename from src/lib/server/markdown/registry.js
rename to src/lib/server/markdown/registry.ts
index ad224224..86822a0d 100644
--- a/src/lib/server/markdown/registry.js
+++ b/src/lib/server/markdown/registry.ts
@@ -7,17 +7,15 @@
 
 import { MARKDOWN_SOURCES } from '$lib/content_config.js';
 import { validate_markdown_sources } from './config.js';
+import type { MarkdownSource } from './config.js';
 
 /**
  * Build a pathname index from validated mappings.
  * Exported for tests; the module-level registry below is built at startup so
  * configuration errors fail the dev server or production deploy immediately.
- *
- * @param {unknown} sources - Raw MARKDOWN_SOURCES value
- * @returns {Map<string, { markdown: string, source: string, pathname: string, toc: boolean }>}
  */
-export function build_registry(sources) {
-	const registry = new Map();
+export function build_registry(sources: unknown): Map<string, MarkdownSource> {
+	const registry = new Map<string, MarkdownSource>();
 	for (const entry of validate_markdown_sources(sources)) {
 		registry.set(entry.pathname, entry);
 	}
@@ -27,11 +25,9 @@ export function build_registry(sources) {
 const registry = build_registry(MARKDOWN_SOURCES);
 
 /**
- * Look up a configured markdown page by URL pathname.
- *
- * @param {string} pathname - Normalized pathname such as "/manual"
- * @returns {{ markdown: string, source: string, pathname: string, toc: boolean } | null}
+ * Look up a configured markdown page by URL pathname (normalized, such
+ * as "/manual").
  */
-export function get_markdown_page(pathname) {
+export function get_markdown_page(pathname: string): MarkdownSource | null {
 	return registry.get(pathname) ?? null;
 }
diff --git a/src/lib/server/markdown/toc.js b/src/lib/server/markdown/toc.ts
similarity index 57%
rename from src/lib/server/markdown/toc.js
rename to src/lib/server/markdown/toc.ts
index bf038c18..76c7a9d1 100644
--- a/src/lib/server/markdown/toc.js
+++ b/src/lib/server/markdown/toc.ts
@@ -5,17 +5,24 @@
 // inserted directly before the first of those headings — after the title and
 // any intro prose.
 
+export type TocHeading = {
+	id: string;
+	depth: number;
+	/** The prose body array holding the heading id. */
+	container: string[];
+	/** The first paragraph of the heading's section. */
+	subtitle: string;
+};
+
 /**
- * Pick the headings a table of contents should link to.
- *
- * @param {{ id: string, depth: number, container: string[], subtitle: string }[]} headings -
- *   Converted headings in document order; `container` is the prose body array
- *   holding the heading id, `subtitle` the first paragraph of its section.
- * @returns {{ targets: { id: string, depth: number, container: string[], subtitle: string }[], insert_before: { id: string, container: string[] } } | null}
- *   Null when the document has no meaningful TOC (fewer than two chapter
- *   headings).
+ * Pick the headings a table of contents should link to, from the converted
+ * headings in document order. Returns null when the document has no
+ * meaningful TOC (fewer than two chapter headings).
  */
-export function select_toc_headings(headings) {
+export function select_toc_headings(headings: TocHeading[]): {
+	targets: TocHeading[];
+	insert_before: { id: string; container: string[] };
+} | null {
 	if (headings.length === 0) return null;
 
 	const first_depth = headings[0].depth;
diff --git a/src/lib/server/migrate.js b/src/lib/server/migrate.ts
similarity index 96%
rename from src/lib/server/migrate.js
rename to src/lib/server/migrate.ts
index 9e4e6060..73dd3385 100644
--- a/src/lib/server/migrate.js
+++ b/src/lib/server/migrate.ts
@@ -30,7 +30,7 @@ export default function migrate() {
 		`);
 
 		const applied = new Set(
-			/** @type {Array<{ id: string }>} */ (db.prepare('SELECT id FROM _migrations').all()).map(
+			(db.prepare('SELECT id FROM _migrations').all() as unknown as Array<{ id: string }>).map(
 				(row) => row.id
 			)
 		);
diff --git a/src/lib/server/migration_plan.test.js b/src/lib/server/migration_plan.test.ts
similarity index 95%
rename from src/lib/server/migration_plan.test.js
rename to src/lib/server/migration_plan.test.ts
index 7d0b1142..0889df38 100644
--- a/src/lib/server/migration_plan.test.js
+++ b/src/lib/server/migration_plan.test.ts
@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import { plan_pending_migrations } from './migration_plan.js';
 
-const migration = (id, before) => ({ id, before, up() {} });
+const migration = (id: string, before?: string[]) => ({ id, before, up() {} });
 
 describe('plan_pending_migrations', () => {
 	it('uses timestamp ids as the default order', () => {
diff --git a/src/lib/server/migration_plan.js b/src/lib/server/migration_plan.ts
similarity index 84%
rename from src/lib/server/migration_plan.js
rename to src/lib/server/migration_plan.ts
index 90b5ec09..78a1ac38 100644
--- a/src/lib/server/migration_plan.js
+++ b/src/lib/server/migration_plan.ts
@@ -1,11 +1,13 @@
+import type { Migration } from './migrations.js';
+
 /**
  * Order pending migrations by timestamp, with narrowly scoped `before`
  * constraints allowed to override that default order.
- *
- * @param {Array<{ id: string, before?: string[], up: (context: { db: any }) => unknown }>} migrations
- * @param {Set<string>} applied
  */
-export function plan_pending_migrations(migrations, applied) {
+export function plan_pending_migrations(
+	migrations: Migration[],
+	applied: Set<string>
+): Migration[] {
 	const by_id = new Map(migrations.map((migration) => [migration.id, migration]));
 
 	for (const migration of migrations) {
@@ -29,8 +31,8 @@ export function plan_pending_migrations(migrations, applied) {
 
 	const pending = migrations.filter((migration) => !applied.has(migration.id));
 	const pending_by_id = new Map(pending.map((migration) => [migration.id, migration]));
-	const outgoing = new Map(pending.map((migration) => [migration.id, []]));
-	const incoming_count = new Map(pending.map((migration) => [migration.id, 0]));
+	const outgoing = new Map<string, string[]>(pending.map((migration) => [migration.id, []]));
+	const incoming_count = new Map<string, number>(pending.map((migration) => [migration.id, 0]));
 
 	for (const migration of pending) {
 		for (const target_id of migration.before ?? []) {
@@ -48,7 +50,7 @@ export function plan_pending_migrations(migrations, applied) {
 	const ready = pending
 		.filter((migration) => incoming_count.get(migration.id) === 0)
 		.sort(compare_migrations);
-	const ordered = [];
+	const ordered: Migration[] = [];
 
 	while (ready.length > 0) {
 		const migration = ready.shift();
@@ -75,6 +77,6 @@ export function plan_pending_migrations(migrations, applied) {
 	return ordered;
 }
 
-function compare_migrations(left, right) {
+function compare_migrations(left: Migration, right: Migration) {
 	return left.id.localeCompare(right.id);
 }
diff --git a/src/lib/server/migrations.js b/src/lib/server/migrations.ts
similarity index 69%
rename from src/lib/server/migrations.js
rename to src/lib/server/migrations.ts
index 4fa12252..a6bdbaf6 100644
--- a/src/lib/server/migrations.js
+++ b/src/lib/server/migrations.ts
@@ -1,14 +1,12 @@
-const MIGRATION_FILENAME_PATTERN = /^\d{8}T\d{9}Z_[a-z][a-z0-9-]*_[a-z0-9]+(?:_[a-z0-9]+)*\.js$/;
+const MIGRATION_FILENAME_PATTERN = /^\d{8}T\d{9}Z_[a-z][a-z0-9-]*_[a-z0-9]+(?:_[a-z0-9]+)*\.ts$/;
 
-/** @typedef {{ before?: string[], up: (context: { db: any }) => unknown }} MigrationModule */
-/** @typedef {MigrationModule & { id: string }} Migration */
+type MigrationModule = { before?: string[]; up: (context: { db: any }) => unknown };
+export type Migration = MigrationModule & { id: string };
 
-const migration_modules = /** @type {Record<string, MigrationModule>} */ (
-	import.meta.glob('./migrations/*.js', {
-		eager: true,
-		import: 'default'
-	})
-);
+const migration_modules = import.meta.glob('./migrations/*.ts', {
+	eager: true,
+	import: 'default'
+}) as Record<string, MigrationModule>;
 
 // Vite resolves this literal glob at build time. Sorting the paths gives
 // timestamp order without a central registry that custom migrations must edit.
@@ -30,5 +28,5 @@ export default Object.entries(migration_modules)
 			);
 		}
 
-		return { id: filename.slice(0, -'.js'.length), ...migration };
+		return { id: filename.slice(0, -'.ts'.length), ...migration };
 	});
diff --git a/src/lib/server/migrations/20260712T125641366Z_editable_initial_schema.js b/src/lib/server/migrations/20260712T125641366Z_editable_initial_schema.ts
similarity index 100%
rename from src/lib/server/migrations/20260712T125641366Z_editable_initial_schema.js
rename to src/lib/server/migrations/20260712T125641366Z_editable_initial_schema.ts
diff --git a/src/lib/server/migrations/20260712T125641379Z_editable_add_page_metadata_fields.js b/src/lib/server/migrations/20260712T125641379Z_editable_add_page_metadata_fields.ts
similarity index 100%
rename from src/lib/server/migrations/20260712T125641379Z_editable_add_page_metadata_fields.js
rename to src/lib/server/migrations/20260712T125641379Z_editable_add_page_metadata_fields.ts
diff --git a/src/lib/server/migrations/20260712T125641382Z_editable_add_page_image_nodes.js b/src/lib/server/migrations/20260712T125641382Z_editable_add_page_image_nodes.ts
similarity index 100%
rename from src/lib/server/migrations/20260712T125641382Z_editable_add_page_image_nodes.js
rename to src/lib/server/migrations/20260712T125641382Z_editable_add_page_image_nodes.ts
diff --git a/src/lib/server/migrations/20260712T125641383Z_editable_add_document_timestamps.js b/src/lib/server/migrations/20260712T125641383Z_editable_add_document_timestamps.ts
similarity index 100%
rename from src/lib/server/migrations/20260712T125641383Z_editable_add_document_timestamps.js
rename to src/lib/server/migrations/20260712T125641383Z_editable_add_document_timestamps.ts
diff --git a/src/lib/server/migrations/20260715T120000000Z_editable_use_layout_ids.js b/src/lib/server/migrations/20260715T120000000Z_editable_use_layout_ids.ts
similarity index 96%
rename from src/lib/server/migrations/20260715T120000000Z_editable_use_layout_ids.js
rename to src/lib/server/migrations/20260715T120000000Z_editable_use_layout_ids.ts
index 97ffe1bc..a9009954 100644
--- a/src/lib/server/migrations/20260715T120000000Z_editable_use_layout_ids.js
+++ b/src/lib/server/migrations/20260715T120000000Z_editable_use_layout_ids.ts
@@ -45,7 +45,7 @@ export default {
 			const doc = JSON.parse(row.data);
 			let did_change = false;
 
-			for (const node of Object.values(doc?.nodes ?? {})) {
+			for (const node of Object.values(doc?.nodes ?? {}) as any[]) {
 				if (!Number.isInteger(node?.layout)) continue;
 
 				const layout_ids = LEGACY_LAYOUT_IDS[node.type];
diff --git a/src/lib/server/s3.js b/src/lib/server/s3.ts
similarity index 79%
rename from src/lib/server/s3.js
rename to src/lib/server/s3.ts
index 0f22763b..7940984f 100644
--- a/src/lib/server/s3.js
+++ b/src/lib/server/s3.ts
@@ -22,14 +22,13 @@ export function backup_enabled() {
 	return s3_enabled() && process.env.EDITABLE_DEPLOYED === '1';
 }
 
-/** @type {AwsClient | undefined} */
-let client;
+let client: AwsClient | undefined;
 
 function aws() {
 	if (!client) {
 		client = new AwsClient({
-			accessKeyId: /** @type {string} */ (process.env.AWS_ACCESS_KEY_ID),
-			secretAccessKey: /** @type {string} */ (process.env.AWS_SECRET_ACCESS_KEY),
+			accessKeyId: process.env.AWS_ACCESS_KEY_ID as string,
+			secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY as string,
 			region: process.env.AWS_REGION || 'auto',
 			service: 's3'
 		});
@@ -47,36 +46,27 @@ function bucket_url(suffix = '') {
 
 /**
  * Upload a buffer to the bucket.
- *
- * @param {string} key
- * @param {Buffer | Uint8Array} body
  */
-export async function put_object(key, body) {
+export async function put_object(key: string, body: Buffer | Uint8Array) {
 	// Buffer is a Uint8Array at runtime; TS's BodyInit just doesn't name it.
 	const res = await aws().fetch(bucket_url(key), {
 		method: 'PUT',
-		body: /** @type {BodyInit} */ (/** @type {unknown} */ (body))
+		body: body as unknown as BodyInit
 	});
 	if (!res.ok) throw new Error(`S3 PUT ${key}: ${res.status} ${await res.text()}`);
 }
 
 /**
  * Upload a file from disk to the bucket.
- *
- * @param {string} key
- * @param {string} file_path
  */
-export async function put_file(key, file_path) {
+export async function put_file(key: string, file_path: string) {
 	await put_object(key, await readFile(file_path));
 }
 
 /**
  * Download an object as a buffer.
- *
- * @param {string} key
- * @returns {Promise<Buffer>}
  */
-export async function get_object(key) {
+export async function get_object(key: string): Promise<Buffer> {
 	const res = await aws().fetch(bucket_url(key));
 	if (!res.ok) throw new Error(`S3 GET ${key}: ${res.status}`);
 	return Buffer.from(await res.arrayBuffer());
@@ -84,13 +74,10 @@ export async function get_object(key) {
 
 /**
  * List all object keys under a prefix (paginated).
- *
- * @param {string} prefix
- * @returns {Promise<string[]>}
  */
-export async function list_keys(prefix) {
-	const keys = [];
-	let token;
+export async function list_keys(prefix: string): Promise<string[]> {
+	const keys: string[] = [];
+	let token: string | undefined;
 	do {
 		const params = new URLSearchParams({ 'list-type': '2', prefix, 'max-keys': '1000' });
 		if (token) params.set('continuation-token', token);
@@ -104,7 +91,7 @@ export async function list_keys(prefix) {
 }
 
 // Asset keys are hex hashes and "w<width>.webp" — this covers the general case anyway.
-function decode_xml(s) {
+function decode_xml(s: string) {
 	return s
 		.replaceAll('&lt;', '<')
 		.replaceAll('&gt;', '>')
@@ -117,11 +104,8 @@ function decode_xml(s) {
  * Fire-and-forget mirror of a file to the bucket, used by the upload path.
  * Never throws and never blocks — a bucket hiccup must not fail the user's
  * upload; the boot sweep repairs any miss.
- *
- * @param {string} key
- * @param {string} file_path
  */
-export function mirror_file(key, file_path) {
+export function mirror_file(key: string, file_path: string) {
 	if (!backup_enabled()) return;
 	put_file(key, file_path).catch((err) => {
 		console.error(`[backup] Asset mirror failed for ${key} (boot sweep will retry):`, err.message);
diff --git a/src/lib/server/seed_initial_documents.js b/src/lib/server/seed_initial_documents.ts
similarity index 82%
rename from src/lib/server/seed_initial_documents.js
rename to src/lib/server/seed_initial_documents.ts
index 20043e15..1aa83ea6 100644
--- a/src/lib/server/seed_initial_documents.js
+++ b/src/lib/server/seed_initial_documents.ts
@@ -1,11 +1,13 @@
 import { NAV_1, FOOTER_1, PAGE_1 } from '$lib/demo_doc.js';
 import { MEDIA_DEFAULTS } from '$lib/config.js';
+import type { DatabaseSync } from 'node:sqlite';
+import type { Document } from 'svedit';
 
 /**
  * Deep clone a document and reset all image/video nodes, since a fresh
  * database has no uploaded assets yet.
  */
-function reset_media_nodes(doc) {
+function reset_media_nodes(doc: Document): Document {
 	const cloned = structuredClone(doc);
 	for (const node of Object.values(cloned.nodes)) {
 		if ('src' in node) Object.assign(node, MEDIA_DEFAULTS);
@@ -14,7 +16,7 @@ function reset_media_nodes(doc) {
 }
 
 /** Seed current demo content after a fresh database reaches the current schema. */
-export default function seed_initial_documents({ db }) {
+export default function seed_initial_documents({ db }: { db: DatabaseSync }) {
 	const now = new Date().toISOString();
 	const insert_doc = db.prepare(
 		'INSERT INTO documents (document_id, type, data, created_at, updated_at) VALUES (?, ?, ?, ?, ?)'
diff --git a/src/lib/server_config.js b/src/lib/server_config.ts
similarity index 100%
rename from src/lib/server_config.js
rename to src/lib/server_config.ts
diff --git a/src/routes/+layout.server.js b/src/routes/+layout.server.ts
similarity index 83%
rename from src/routes/+layout.server.js
rename to src/routes/+layout.server.ts
index 38a493e7..10e4c823 100644
--- a/src/routes/+layout.server.js
+++ b/src/routes/+layout.server.ts
@@ -1,9 +1,9 @@
 import { env } from '$env/dynamic/private';
 import { demo_doc } from '$lib/demo_doc.js';
 import { extract_site_metadata } from '$lib/page_metadata.js';
+import type { LayoutServerLoad } from './$types';
 
-/** @type {import('./$types').LayoutServerLoad} */
-export async function load({ locals, depends }) {
+export const load: LayoutServerLoad = async ({ locals, depends }) => {
 	// Re-derived after saving a page, so favicon and site name update live.
 	depends('app:site_metadata');
 
@@ -23,4 +23,4 @@ export async function load({ locals, depends }) {
 		origin: env.ORIGIN ?? '',
 		favicon: site_metadata.favicon
 	};
-}
+};
diff --git a/src/routes/+layout.svelte b/src/routes/+layout.svelte
index 592e81b9..044c24ee 100644
--- a/src/routes/+layout.svelte
+++ b/src/routes/+layout.svelte
@@ -1,4 +1,4 @@
-<script>
+<script lang="ts">
 	import '../app.css';
 	import '../custom.css';
 
diff --git a/src/routes/+page.server.js b/src/routes/+page.server.ts
similarity index 83%
rename from src/routes/+page.server.js
rename to src/routes/+page.server.ts
index 09f7ca30..f7ae6c1d 100644
--- a/src/routes/+page.server.js
+++ b/src/routes/+page.server.ts
@@ -1,11 +1,11 @@
 import { env } from '$env/dynamic/private';
+import type { PageServerLoad } from './$types';
 
 // Deliberately no `await parent()` here: depending on layout data would rerun
 // this load (and rebuild the editing session) whenever the layout is
 // invalidated, e.g. for the favicon refresh after a save. has_backend and
 // is_admin reach the page via the layout data merge.
-/** @type {import('./$types').PageServerLoad} */
-export async function load() {
+export const load: PageServerLoad = async () => {
 	if (env.VERCEL) {
 		return {
 			document: null,
@@ -15,4 +15,4 @@ export async function load() {
 
 	const { get_home_document } = await import('$lib/api.remote.js');
 	return await get_home_document();
-}
+};
diff --git a/src/routes/+page.svelte b/src/routes/+page.svelte
index 07c35014..36065b17 100644
--- a/src/routes/+page.svelte
+++ b/src/routes/+page.svelte
@@ -1,8 +1,16 @@
-<script>
+<script lang="ts">
 	import App from './components/App.svelte';
 
-	/** @type {{ data: { has_backend?: boolean, is_admin?: boolean, origin?: string | null, document: any, slug: string | null, is_new?: boolean } }} */
-	const props = $props();
+	const props: {
+		data: {
+			has_backend?: boolean;
+			is_admin?: boolean;
+			origin?: string | null;
+			document: any;
+			slug: string | null;
+			is_new?: boolean;
+		};
+	} = $props();
 </script>
 
 <!--
diff --git a/src/routes/[page_id]/+page.server.js b/src/routes/[page_id]/+page.server.ts
similarity index 91%
rename from src/routes/[page_id]/+page.server.js
rename to src/routes/[page_id]/+page.server.ts
index 8c4c881d..c6abcae8 100644
--- a/src/routes/[page_id]/+page.server.js
+++ b/src/routes/[page_id]/+page.server.ts
@@ -4,15 +4,16 @@ import { env } from '$env/dynamic/private';
 import { get_markdown_page } from '$lib/server/markdown/registry.js';
 import { convert_markdown } from '$lib/server/markdown/convert.js';
 import { compose_markdown_document } from '$lib/server/markdown/compose.js';
+import type { PageServerLoad } from './$types';
+import type { Document } from 'svedit';
 
-// Deliberately no `await parent()` here — see routes/+page.server.js.
-/** @type {import('./$types').PageServerLoad} */
-export async function load({ params }) {
+// Deliberately no `await parent()` here — see routes/+page.server.ts.
+export const load: PageServerLoad = async ({ params }) => {
 	// Configured markdown pages win over database slugs.
 	const markdown_page = get_markdown_page(`/${params.page_id}`);
 
 	if (markdown_page) {
-		let document;
+		let document: Document;
 		try {
 			const shared_documents = await get_shared_site_documents();
 			const page_doc = convert_markdown(markdown_page.markdown, markdown_page);
@@ -50,7 +51,7 @@ export async function load({ params }) {
 		}
 		throw error(404, 'Page not found');
 	}
-}
+};
 
 /**
  * Shared nav/footer documents for composing markdown pages: the live database
diff --git a/src/routes/[page_id]/+page.svelte b/src/routes/[page_id]/+page.svelte
index 33dbfb71..94965ed2 100644
--- a/src/routes/[page_id]/+page.svelte
+++ b/src/routes/[page_id]/+page.svelte
@@ -1,4 +1,4 @@
-<script>
+<script lang="ts">
 	import App from '../components/App.svelte';
 
 	/** @type {{ data: { document: any, slug: string | null, is_admin?: boolean, has_backend?: boolean, is_new?: boolean, can_edit?: boolean, origin?: string | null } }} */
diff --git a/src/routes/api/assets/+server.js b/src/routes/api/assets/+server.ts
similarity index 92%
rename from src/routes/api/assets/+server.js
rename to src/routes/api/assets/+server.ts
index a0ca7963..8d8e925a 100644
--- a/src/routes/api/assets/+server.js
+++ b/src/routes/api/assets/+server.ts
@@ -2,9 +2,9 @@ import { json, error } from '@sveltejs/kit';
 import { UPLOAD_MIME_TO_EXT } from '$lib/config.js';
 import { asset_exists, write_asset, delete_asset } from '$lib/server/asset_storage.js';
 import { require_admin_session } from '$lib/server/auth.js';
+import type { RequestHandler } from './$types';
 
-/** @type {import('./$types').RequestHandler} */
-export async function POST({ request, locals }) {
+export const POST: RequestHandler = async ({ request, locals }) => {
 	require_admin_session(locals);
 
 	const content_type_raw = request.headers.get('content-type') ?? '';
@@ -36,7 +36,9 @@ export async function POST({ request, locals }) {
 		// Drain the request body without buffering
 		if (request.body) {
 			const reader = request.body.getReader();
-			while (!(await reader.read()).done) { /* drain */ }
+			while (!(await reader.read()).done) {
+				/* drain */
+			}
 		}
 
 		return json({ asset_id, width, height, deduplicated: true });
@@ -68,4 +70,4 @@ export async function POST({ request, locals }) {
 	}
 
 	return json({ asset_id, width, height, deduplicated: false });
-}
\ No newline at end of file
+};
diff --git a/src/routes/api/assets/[asset_id]/+server.js b/src/routes/api/assets/[asset_id]/+server.ts
similarity index 80%
rename from src/routes/api/assets/[asset_id]/+server.js
rename to src/routes/api/assets/[asset_id]/+server.ts
index 0283c927..3aa40da7 100644
--- a/src/routes/api/assets/[asset_id]/+server.js
+++ b/src/routes/api/assets/[asset_id]/+server.ts
@@ -2,9 +2,9 @@ import { json, error } from '@sveltejs/kit';
 import { ASSET_ID_REGEX } from '$lib/config.js';
 import { delete_asset, asset_exists } from '$lib/server/asset_storage.js';
 import { require_admin_session } from '$lib/server/auth.js';
+import type { RequestHandler } from './$types';
 
-/** @type {import('./$types').RequestHandler} */
-export async function DELETE({ params, locals }) {
+export const DELETE: RequestHandler = async ({ params, locals }) => {
 	require_admin_session(locals);
 
 	const { asset_id } = params;
@@ -19,4 +19,4 @@ export async function DELETE({ params, locals }) {
 
 	await delete_asset(asset_id);
 	return json({ ok: true });
-}
+};
diff --git a/src/routes/api/assets/[asset_id]/variants/+server.js b/src/routes/api/assets/[asset_id]/variants/+server.ts
similarity index 90%
rename from src/routes/api/assets/[asset_id]/variants/+server.js
rename to src/routes/api/assets/[asset_id]/variants/+server.ts
index fc349484..fd2d5cd2 100644
--- a/src/routes/api/assets/[asset_id]/variants/+server.js
+++ b/src/routes/api/assets/[asset_id]/variants/+server.ts
@@ -3,9 +3,9 @@ import { error, json } from '@sveltejs/kit';
 import { ASSET_ID_REGEX, VARIANT_WIDTHS_SET } from '$lib/config.js';
 import { asset_exists, write_variant, variant_path } from '$lib/server/asset_storage.js';
 import { require_admin_session } from '$lib/server/auth.js';
+import type { RequestHandler } from './$types';
 
-/** @type {import('./$types').RequestHandler} */
-export async function POST({ params, request, locals }) {
+export const POST: RequestHandler = async ({ params, request, locals }) => {
 	require_admin_session(locals);
 
 	const { asset_id } = params;
@@ -20,7 +20,10 @@ export async function POST({ params, request, locals }) {
 	}
 
 	// Validate content type
-	const content_type = (request.headers.get('content-type') ?? '').split(';')[0].trim().toLowerCase();
+	const content_type = (request.headers.get('content-type') ?? '')
+		.split(';')[0]
+		.trim()
+		.toLowerCase();
 	if (content_type !== 'image/webp') {
 		error(400, 'Variant must be image/webp');
 	}
@@ -61,4 +64,4 @@ export async function POST({ params, request, locals }) {
 
 	const variant = `w${width}.webp`;
 	return json({ ok: true, variant });
-}
\ No newline at end of file
+};
diff --git a/src/routes/app_context.ts b/src/routes/app_context.ts
new file mode 100644
index 00000000..bb506d08
--- /dev/null
+++ b/src/routes/app_context.ts
@@ -0,0 +1,26 @@
+import { getContext } from 'svelte';
+
+/**
+ * The app-level context provided by App.svelte: server-derived flags plus
+ * the auth dialog state and its handlers.
+ */
+export type AppContext = {
+	readonly has_backend: boolean;
+	readonly can_edit: boolean;
+	readonly is_admin: boolean;
+	readonly origin: string | null;
+	readonly slug: string | null;
+	readonly is_new: boolean;
+	auth_dialog_open: boolean;
+	close_auth_dialog: () => void;
+	edit_for_fun: () => void;
+	handle_auth_success: () => Promise<void>;
+};
+
+/**
+ * Typed accessor for the app context. Use inside components rendered under
+ * App.svelte instead of `getContext('app')`.
+ */
+export function get_app_context(): AppContext {
+	return getContext('app') as AppContext;
+}
diff --git a/src/routes/app_utils.test.js b/src/routes/app_utils.test.ts
similarity index 54%
rename from src/routes/app_utils.test.js
rename to src/routes/app_utils.test.ts
index ed4ced54..196f6622 100644
--- a/src/routes/app_utils.test.js
+++ b/src/routes/app_utils.test.ts
@@ -4,33 +4,32 @@ import {
 	get_cycle_node_state,
 	get_selection_node_ancestors
 } from './app_utils.js';
+import type { Session } from 'svedit';
 
 describe('get_selection_node_ancestors', () => {
 	it('finds nodes reached through both node properties and node arrays', () => {
-		const values = new Map([
+		const values = new Map<string, any>([
 			[JSON.stringify(['page_1']), { id: 'page_1', type: 'page' }],
 			[JSON.stringify(['page_1', 'nav']), { id: 'nav_1', type: 'nav' }],
 			[JSON.stringify(['page_1', 'nav', 'start_items']), { nodes: ['nav_link_1'] }],
 			[JSON.stringify(['page_1', 'nav', 'start_items', 0]), { id: 'nav_link_1', type: 'nav_link' }]
 		]);
-		const session = /** @type {import('svedit').Session} */ (
-			/** @type {unknown} */ ({
-				selection: {
-					type: 'node',
-					path: ['page_1', 'nav', 'start_items'],
-					anchor_offset: 0,
-					focus_offset: 1
-				},
-				schema: {
-					page: { kind: 'document' },
-					nav: { kind: 'block' },
-					nav_link: { kind: 'block' }
-				},
-				get(path) {
-					return values.get(JSON.stringify(path));
-				}
-			})
-		);
+		const session = {
+			selection: {
+				type: 'node',
+				path: ['page_1', 'nav', 'start_items'],
+				anchor_offset: 0,
+				focus_offset: 1
+			},
+			schema: {
+				page: { kind: 'document' },
+				nav: { kind: 'block' },
+				nav_link: { kind: 'block' }
+			},
+			get(path: any) {
+				return values.get(JSON.stringify(path));
+			}
+		} as unknown as Session;
 
 		expect(get_selection_node_ancestors(session)).toEqual([
 			{ node: { id: 'nav_1', type: 'nav' }, path: ['page_1', 'nav'] },
@@ -48,46 +47,42 @@ describe('get_selection_node_ancestors', () => {
 			type: 'prose',
 			layout: 'narrow-left'
 		};
-		const values = new Map(
-			/** @type {[string, any][]} */ ([
-				[JSON.stringify(['page_1']), page],
-				[JSON.stringify(['page_1', 'body']), { nodes: ['prose_1'] }],
-				[JSON.stringify(['page_1', 'body', 0]), prose]
-			])
-		);
-		const session = /** @type {import('svedit').Session} */ (
-			/** @type {unknown} */ ({
-				selection: {
-					type: 'node',
-					path: ['page_1', 'body', 0, 'body'],
-					anchor_offset: 0,
-					focus_offset: 0
-				},
-				schema: {
-					page: { kind: 'document', properties: {} },
-					prose: {
-						kind: 'block',
-						properties: {
-							layout: {
-								type: 'string',
-								values: ['narrow-left', 'narrow-center'],
-								default: 'narrow-left'
-							}
+		const values = new Map<string, any>([
+			[JSON.stringify(['page_1']), page],
+			[JSON.stringify(['page_1', 'body']), { nodes: ['prose_1'] }],
+			[JSON.stringify(['page_1', 'body', 0]), prose]
+		]);
+		const session = {
+			selection: {
+				type: 'node',
+				path: ['page_1', 'body', 0, 'body'],
+				anchor_offset: 0,
+				focus_offset: 0
+			},
+			schema: {
+				page: { kind: 'document', properties: {} },
+				prose: {
+					kind: 'block',
+					properties: {
+						layout: {
+							type: 'string',
+							values: ['narrow-left', 'narrow-center'],
+							default: 'narrow-left'
 						}
-					},
-					figure: { kind: 'block', properties: {} }
-				},
-				get(path) {
-					return values.get(JSON.stringify(path));
-				},
-				inspect(path) {
-					if (JSON.stringify(path) === JSON.stringify(['page_1', 'body'])) {
-						return { type: 'node_array', node_types: ['prose', 'figure'] };
 					}
-					return null;
+				},
+				figure: { kind: 'block', properties: {} }
+			},
+			get(path: any) {
+				return values.get(JSON.stringify(path));
+			},
+			inspect(path: any) {
+				if (JSON.stringify(path) === JSON.stringify(['page_1', 'body'])) {
+					return { type: 'node_array', node_types: ['prose', 'figure'] };
 				}
-			})
-		);
+				return null;
+			}
+		} as unknown as Session;
 
 		expect(get_selection_node_ancestors(session)).toEqual([
 			{ node: page, path: ['page_1'] },
diff --git a/src/routes/app_utils.js b/src/routes/app_utils.ts
similarity index 79%
rename from src/routes/app_utils.js
rename to src/routes/app_utils.ts
index c89d0f53..91a95a1f 100644
--- a/src/routes/app_utils.js
+++ b/src/routes/app_utils.ts
@@ -1,4 +1,5 @@
 import { get_property_default } from 'svedit';
+import type { Session, DocumentNode, DocumentPath, PropertyDefinition } from 'svedit';
 
 /**
  * Build the full path (including selected node index) and the starting
@@ -7,11 +8,10 @@ import { get_property_default } from 'svedit';
  * For node selections the selected node index is the lower edge of a single-node
  * range. A collapsed node selection points at the node that owns the selected gap.
  * For text/property selections the path already contains all indices.
- *
- * @param {import('svedit').Session} session
- * @returns {{ full_path: (string|number)[], start_path: (string|number)[] } | null}
  */
-function get_ancestor_walk_paths(session) {
+function get_ancestor_walk_paths(
+	session: Session
+): { full_path: DocumentPath; start_path: DocumentPath } | null {
 	if (!session.selection) return null;
 
 	if (session.selection.type === 'node') {
@@ -52,18 +52,17 @@ function get_ancestor_walk_paths(session) {
  * Return the nodes between the document root and the current canonical selection.
  * The document node itself is normally omitted because it is editor infrastructure.
  * It is retained as the owning-node fallback for a collapsed top-level node gap.
- *
- * @param {import('svedit').Session} session
- * @returns {{ node: object, path: (string|number)[] }[]}
  */
-export function get_selection_node_ancestors(session) {
+export function get_selection_node_ancestors(
+	session: Session
+): { node: DocumentNode; path: DocumentPath }[] {
 	const paths = get_ancestor_walk_paths(session);
 	if (!paths) return [];
 	const include_document =
 		session.selection?.type === 'node' &&
 		session.selection.anchor_offset === session.selection.focus_offset;
 
-	const ancestors = [];
+	const ancestors: { node: DocumentNode; path: DocumentPath }[] = [];
 	for (let path_length = 1; path_length <= paths.full_path.length; path_length += 1) {
 		const path = paths.full_path.slice(0, path_length);
 		const node = session.get(path);
@@ -77,24 +76,16 @@ export function get_selection_node_ancestors(session) {
 
 /**
  * Extract the numeric node index from full_path at the given ancestor level.
- *
- * @param {(string|number)[]} full_path
- * @param {(string|number)[]} ancestor_path
- * @returns {number | null}
  */
-function get_node_index_at(full_path, ancestor_path) {
+function get_node_index_at(full_path: DocumentPath, ancestor_path: DocumentPath): number | null {
 	if (full_path.length <= ancestor_path.length) return null;
 	return parseInt(String(full_path[ancestor_path.length]));
 }
 
 /**
  * Compare schema/value objects deeply. Object key order is ignored, array order is not.
- *
- * @param {any} left
- * @param {any} right
- * @returns {boolean}
  */
-function are_values_equal(left, right) {
+function are_values_equal(left: any, right: any): boolean {
 	if (Object.is(left, right)) return true;
 	if (typeof left !== typeof right) return false;
 	if (left === null || right === null) return false;
@@ -119,11 +110,8 @@ function are_values_equal(left, right) {
 
 /**
  * Check if a primitive or custom extra value is empty without schema context.
- *
- * @param {any} value
- * @returns {boolean}
  */
-function is_empty_literal(value) {
+function is_empty_literal(value: any): boolean {
 	if (value === undefined || value === null || value === '') return true;
 	if (Array.isArray(value)) return value.length === 0;
 	return false;
@@ -131,13 +119,12 @@ function is_empty_literal(value) {
 
 /**
  * Check if a property value is empty/default, recursing through child nodes.
- *
- * @param {import('svedit').Session} session
- * @param {object} property_definition
- * @param {any} value
- * @returns {boolean}
  */
-function is_property_value_empty(session, property_definition, value) {
+function is_property_value_empty(
+	session: Session,
+	property_definition: PropertyDefinition,
+	value: any
+): boolean {
 	if (property_definition.type === 'node') {
 		if (is_empty_literal(value)) return true;
 		const child_node = session.get(value);
@@ -146,7 +133,7 @@ function is_property_value_empty(session, property_definition, value) {
 
 	if (property_definition.type === 'node_array') {
 		if (!value?.nodes) return false;
-		return value.nodes.every((node_id) => {
+		return value.nodes.every((node_id: string) => {
 			const child_node = session.get(node_id);
 			return child_node ? is_node_subtree_empty(session, child_node) : false;
 		});
@@ -158,16 +145,14 @@ function is_property_value_empty(session, property_definition, value) {
 
 /**
  * Check whether a node and all descendants contain only empty/default values.
- *
- * @param {import('svedit').Session} session
- * @param {object} node
- * @returns {boolean}
  */
-export function is_node_subtree_empty(session, node) {
+export function is_node_subtree_empty(session: Session, node: DocumentNode): boolean {
 	const node_schema = session.schema[node.type];
 	if (!node_schema) return false;
 
-	for (const [property_name, property_definition] of Object.entries(node_schema.properties)) {
+	for (const [property_name, property_definition] of Object.entries<PropertyDefinition>(
+		node_schema.properties
+	)) {
 		if (property_name === 'layout') continue;
 		if (!is_property_value_empty(session, property_definition, node[property_name])) return false;
 	}
@@ -183,13 +168,12 @@ export function is_node_subtree_empty(session, node) {
 
 /**
  * Check whether two node types have exactly equivalent property schemas.
- *
- * @param {object} schema
- * @param {string} source_type
- * @param {string} target_type
- * @returns {boolean}
  */
-function have_same_property_schema(schema, source_type, target_type) {
+function have_same_property_schema(
+	schema: Record<string, any>,
+	source_type: string,
+	target_type: string
+): boolean {
 	const source_properties = schema[source_type]?.properties;
 	const target_properties = schema[target_type]?.properties;
 	return (
@@ -202,11 +186,10 @@ function have_same_property_schema(schema, source_type, target_type) {
 /**
  * Find the closest ancestor node whose type can be switched
  * (lives in a node_array with multiple node_types).
- *
- * @param {import('svedit').Session} session - The session instance
- * @returns {{ node: object, node_array_path: (string|number)[], node_index: number } | null}
  */
-export function get_closest_switchable_type(session) {
+function get_closest_switchable_type(
+	session: Session
+): { node: DocumentNode; node_array_path: DocumentPath; node_index: number } | null {
 	const paths = get_ancestor_walk_paths(session);
 	if (!paths) return null;
 
@@ -238,11 +221,13 @@ export function get_closest_switchable_type(session) {
 
 /**
  * Get the current cycle node state, including compatible target types.
- *
- * @param {import('svedit').Session} session - The session instance
- * @returns {{ node: object, node_array_path: (string|number)[], node_index: number, available_types: string[] } | null}
  */
-export function get_cycle_node_state(session) {
+export function get_cycle_node_state(session: Session): {
+	node: DocumentNode;
+	node_array_path: DocumentPath;
+	node_index: number;
+	available_types: string[];
+} | null {
 	const closest_switchable_type = get_closest_switchable_type(session);
 	if (!closest_switchable_type) return null;
 
@@ -262,7 +247,7 @@ export function get_cycle_node_state(session) {
 	const node_is_empty = is_node_subtree_empty(session, node);
 	const available_types = node_is_empty
 		? cycle_ordered_types
-		: cycle_ordered_types.filter((node_type) =>
+		: cycle_ordered_types.filter((node_type: string) =>
 				have_same_property_schema(session.schema, node.type, node_type)
 			);
 
@@ -272,11 +257,10 @@ export function get_cycle_node_state(session) {
 /**
  * Find the closest ancestor node whose layout can be switched
  * (has a layout property with more than one allowed value).
- *
- * @param {import('svedit').Session} session - The session instance
- * @returns {{ node: object, node_array_path: (string|number)[], node_index: number } | null}
  */
-export function get_closest_switchable_layout(session) {
+export function get_closest_switchable_layout(
+	session: Session
+): { node: DocumentNode; node_array_path: DocumentPath; node_index: number } | null {
 	const paths = get_ancestor_walk_paths(session);
 	if (!paths) return null;
 
diff --git a/src/routes/assets/[...path]/+server.js b/src/routes/assets/[...path]/+server.ts
similarity index 85%
rename from src/routes/assets/[...path]/+server.js
rename to src/routes/assets/[...path]/+server.ts
index 65be2339..687b3ad6 100644
--- a/src/routes/assets/[...path]/+server.js
+++ b/src/routes/assets/[...path]/+server.ts
@@ -10,6 +10,7 @@ import {
 	create_variant_read_stream,
 	variant_path
 } from '$lib/server/asset_storage.js';
+import type { RequestHandler } from './$types';
 
 // Served assets are user-uploaded content and must be inert: `sandbox` puts
 // directly-opened files (e.g. SVGs with scripts) in an opaque origin so they
@@ -20,37 +21,29 @@ const INERT_CONTENT_HEADERS = {
 };
 
 /** Extensions a variant's original can have (variants exist only for images). */
-const IMAGE_EXTS = Object.keys(EXT_TO_MIME).filter((ext) =>
-	EXT_TO_MIME[ext].startsWith('image/')
-);
+const IMAGE_EXTS = Object.keys(EXT_TO_MIME).filter((ext) => EXT_TO_MIME[ext].startsWith('image/'));
 
 /**
  * Convert a Node.js Readable stream to a Web ReadableStream.
- * @param {import('node:stream').Readable} node_stream
- * @returns {ReadableStream<Uint8Array>}
  */
-function to_web_stream(node_stream) {
-	return /** @type {ReadableStream<Uint8Array>} */ (Readable.toWeb(node_stream));
+function to_web_stream(node_stream: Readable): ReadableStream<Uint8Array> {
+	return Readable.toWeb(node_stream) as ReadableStream<Uint8Array>;
 }
 
 /**
  * Extract the first 8 hex characters from an asset id for Content-Disposition filename.
- * @param {string} asset_id
- * @param {string} ext
- * @returns {string}
  */
-function short_filename(asset_id, ext) {
+function short_filename(asset_id: string, ext: string): string {
 	return `${asset_id.slice(0, 8)}${ext}`;
 }
 
 /**
  * Parse a single HTTP byte range header.
- *
- * @param {string | null} range_header
- * @param {number} size
- * @returns {{ start: number, end: number } | null}
  */
-function parse_byte_range(range_header, size) {
+function parse_byte_range(
+	range_header: string | null,
+	size: number
+): { start: number; end: number } | null {
 	if (!range_header) return null;
 
 	const match = range_header.trim().match(/^bytes=(\d*)-(\d*)$/);
@@ -82,8 +75,7 @@ function parse_byte_range(range_header, size) {
 	return { start, end };
 }
 
-/** @type {import('./$types').RequestHandler} */
-export async function GET({ params, request }) {
+export const GET: RequestHandler = async ({ params, request }) => {
 	const path = params.path;
 
 	if (!path) {
@@ -97,7 +89,7 @@ export async function GET({ params, request }) {
 		const width = parseInt(variant_match[2], 10);
 
 		// Find the original asset id by checking known image extensions
-		let original_id = null;
+		let original_id: string | null = null;
 		for (const ext of IMAGE_EXTS) {
 			if (asset_exists(`${asset_stem}.${ext}`)) {
 				original_id = `${asset_stem}.${ext}`;
@@ -144,7 +136,7 @@ export async function GET({ params, request }) {
 	const is_video = mime_type.startsWith('video/');
 	const byte_range = is_video ? parse_byte_range(range_header, size) : null;
 
-	const headers = {
+	const headers: Record<string, string> = {
 		...INERT_CONTENT_HEADERS,
 		'Content-Type': mime_type,
 		'Cache-Control': 'public, max-age=31536000, immutable',
@@ -188,4 +180,4 @@ export async function GET({ params, request }) {
 			'Content-Length': String(size)
 		}
 	});
-}
\ No newline at end of file
+};
diff --git a/src/routes/commands.svelte.js b/src/routes/commands.svelte.ts
similarity index 91%
rename from src/routes/commands.svelte.js
rename to src/routes/commands.svelte.ts
index 71cc2b85..03514890 100644
--- a/src/routes/commands.svelte.js
+++ b/src/routes/commands.svelte.ts
@@ -1,4 +1,5 @@
 import { Command, is_selection_collapsed, serialize_path } from 'svedit';
+import type { CommandContext, DocumentNode, DocumentPath, Transaction } from 'svedit';
 import {
 	get_closest_switchable_layout,
 	get_cycle_node_state,
@@ -7,25 +8,18 @@ import {
 
 /**
  * Replace a node with a schema-equivalent node type while preserving property values.
- *
- * @param {import('svedit').Transaction} tr
- * @param {(string|number)[]} node_array_path
- * @param {number} node_index
- * @param {object} node
- * @param {string} new_type
- * @param {string | null} [new_layout]
  */
 function replace_node_with_equivalent_type(
-	tr,
-	node_array_path,
-	node_index,
-	node,
-	new_type,
-	new_layout = null
+	tr: Transaction,
+	node_array_path: DocumentPath,
+	node_index: number,
+	node: DocumentNode,
+	new_type: string,
+	new_layout: string | null = null
 ) {
 	const node_schema = tr.schema[node.type];
 	const new_node_schema = tr.schema[new_type];
-	const new_node = {
+	const new_node: DocumentNode = {
 		id: tr.generate_id(),
 		type: new_type
 	};
@@ -55,9 +49,11 @@ function replace_node_with_equivalent_type(
  * Direction can be 'next' or 'previous'.
  */
 export class CycleLayoutCommand extends Command {
+	direction: 'next' | 'previous';
+
 	closest_switchable_layout = $derived(get_closest_switchable_layout(this.context.session));
 
-	constructor(direction, context) {
+	constructor(direction: 'next' | 'previous', context: CommandContext) {
 		super(context);
 		this.direction = direction;
 	}
@@ -68,7 +64,7 @@ export class CycleLayoutCommand extends Command {
 
 	execute() {
 		const session = this.context.session;
-		const { node, node_array_path, node_index } = this.closest_switchable_layout;
+		const { node } = this.closest_switchable_layout;
 		const layouts = session.schema[node.type].properties.layout.values;
 		const current_layout_index = layouts.indexOf(node.layout);
 		if (current_layout_index === -1) return;
@@ -80,8 +76,7 @@ export class CycleLayoutCommand extends Command {
 		this.execute_with_layout(new_layout);
 	}
 
-	/** @param {string} new_layout */
-	execute_with_layout(new_layout) {
+	execute_with_layout(new_layout: string) {
 		const session = this.context.session;
 		const closest_switchable_layout = this.closest_switchable_layout;
 		if (!closest_switchable_layout) return;
@@ -108,9 +103,11 @@ export class CycleLayoutCommand extends Command {
  * Direction can be 'next' or 'previous'.
  */
 export class CycleNodeTypeCommand extends Command {
+	direction: 'next' | 'previous';
+
 	cycle_node_state = $derived(get_cycle_node_state(this.context.session));
 
-	constructor(direction, context) {
+	constructor(direction: 'next' | 'previous', context: CommandContext) {
 		super(context);
 		this.direction = direction;
 	}
@@ -130,11 +127,8 @@ export class CycleNodeTypeCommand extends Command {
 
 	/**
 	 * Replace the derived switchable node with an explicitly chosen type/variant.
-	 *
-	 * @param {string} new_type
-	 * @param {string | null} [new_layout]
 	 */
-	execute_with_type(new_type, new_layout = null) {
+	execute_with_type(new_type: string, new_layout: string | null = null) {
 		const session = this.context.session;
 		const cycle_node_state = this.cycle_node_state;
 		if (!cycle_node_state?.available_types.includes(new_type)) return;
@@ -187,9 +181,9 @@ export class ReplaceMediaCommand extends Command {
 		if (!selection_path) return;
 
 		document.documentElement.dataset.replaceMediaPath = JSON.stringify(selection_path);
-		const replace_media_input = /** @type {HTMLInputElement | null} */ (
-			document.getElementById('replace-media-input')
-		);
+		const replace_media_input = document.getElementById(
+			'replace-media-input'
+		) as HTMLInputElement | null;
 		replace_media_input?.click();
 	}
 }
@@ -197,7 +191,7 @@ export class ReplaceMediaCommand extends Command {
 export class EditImageCommand extends Command {
 	show_prompt = $state(false);
 
-	constructor(context) {
+	constructor(context: CommandContext) {
 		super(context);
 
 		$effect(() => {
@@ -230,7 +224,7 @@ export class ToggleLinkCommand extends Command {
 	active = $derived(this.is_active());
 	show_prompt = $state(false);
 
-	constructor(context) {
+	constructor(context: CommandContext) {
 		super(context);
 
 		// Reset show_prompt when selection changes
@@ -305,7 +299,7 @@ export class ToggleAccordionCommand extends Command {
 export class EditLinkCommand extends Command {
 	show_prompt = $state(false);
 
-	constructor(context) {
+	constructor(context: CommandContext) {
 		super(context);
 
 		// Reset show_prompt when selection changes
diff --git a/src/routes/components/Accordion.svelte b/src/routes/components/Accordion.svelte
index bb668046..2302a71e 100644
--- a/src/routes/components/Accordion.svelte
+++ b/src/routes/components/Accordion.svelte
@@ -1,11 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['accordion'] = $derived(svedit.session.get(path));
 	let accordion_layout = $derived(node.layout || 'narrow-left');
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
diff --git a/src/routes/components/AccordionItem.svelte b/src/routes/components/AccordionItem.svelte
index d35f555a..94982561 100644
--- a/src/routes/components/AccordionItem.svelte
+++ b/src/routes/components/AccordionItem.svelte
@@ -1,9 +1,10 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty, TextProperty } from 'svedit';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
 </script>
 
 <Node class="ew-accordion-item border-b border-(--border)" {path}>
diff --git a/src/routes/components/App.svelte b/src/routes/components/App.svelte
index abf51da4..ae1a9f22 100644
--- a/src/routes/components/App.svelte
+++ b/src/routes/components/App.svelte
@@ -1,4 +1,4 @@
-<script>
+<script lang="ts">
 	import { setContext } from 'svelte';
 	import { goto, invalidate, invalidateAll } from '$app/navigation';
 	import { resolve } from '$app/paths';
@@ -9,10 +9,10 @@
 	import { EXT_TO_MIME } from '$lib/config.js';
 	import { create_session } from '../create_session.js';
 	import { create_page_browser, set_page_browser } from './page_browser_context.svelte.js';
+	import type { PageBrowser } from './page_browser_context.svelte.js';
 
 	import { demo_doc } from '$lib/demo_doc.js';
 
-	/** @type {{ document?: any, slug?: string | null, has_backend?: boolean, is_new?: boolean, is_admin?: boolean, can_edit?: boolean, origin?: string | null }} */
 	let {
 		document: doc,
 		slug = null,
@@ -21,6 +21,14 @@
 		is_admin: server_is_admin = false,
 		can_edit = true,
 		origin = null
+	}: {
+		document?: any;
+		slug?: string | null;
+		has_backend?: boolean;
+		is_new?: boolean;
+		is_admin?: boolean;
+		can_edit?: boolean;
+		origin?: string | null;
 	} = $props();
 
 	// Backend availability and document editability are independent: read-only
@@ -30,8 +38,8 @@
 
 	let initial_doc_json = $derived(JSON.stringify(initial_doc));
 
-	let app_el = $state();
-	let svedit_ref = $state();
+	let app_el = $state<HTMLElement>();
+	let svedit_ref = $state<{ focus_canvas: () => void }>();
 	let editable = $state(false);
 	let current_is_new = $state(false);
 	let is_admin = $derived(server_is_admin);
@@ -81,7 +89,7 @@
 
 	setContext('app', app);
 
-	const page_browser = create_page_browser({
+	const page_browser: PageBrowser = create_page_browser({
 		goto,
 		is_admin: () => app.is_admin
 	});
@@ -173,7 +181,14 @@
 	}
 
 	function handle_mobile_overscroll_check() {
-		if (!can_edit || !is_mobile_touch_device() || editable || is_admin || auth_dialog_open || !mobile_touch_active) {
+		if (
+			!can_edit ||
+			!is_mobile_touch_device() ||
+			editable ||
+			is_admin ||
+			auth_dialog_open ||
+			!mobile_touch_active
+		) {
 			clear_mobile_overscroll_timeout();
 			return;
 		}
@@ -186,7 +201,11 @@
 			return;
 		}
 
-		if (!mobile_touch_started_at_page_end || mobile_overscroll_triggered || mobile_overscroll_timeout_id) {
+		if (
+			!mobile_touch_started_at_page_end ||
+			mobile_overscroll_triggered ||
+			mobile_overscroll_timeout_id
+		) {
 			return;
 		}
 
@@ -302,16 +321,12 @@
 
 			const save_start = Date.now();
 
-			const [
-				api_module,
-				asset_upload_module
-			] = await Promise.all([
+			const [api_module, asset_upload_module] = await Promise.all([
 				import('$lib/api.remote.js'),
 				import('$lib/client/asset_upload.js')
 			]);
 
-			/** @type {any} */
-			const save_document = api_module.save_document;
+			const save_document: any = api_module.save_document;
 
 			const {
 				collect_blob_urls,
@@ -364,11 +379,11 @@
 					replace_blob_urls(doc_json.nodes, mapping);
 				}
 
-				/** @type {{ ok: boolean, document_id?: string, slug?: string, created?: boolean }} */
-				const result = await save_document({
-					...doc_json,
-					create: current_is_new
-				});
+				const result: { ok: boolean; document_id?: string; slug?: string; created?: boolean } =
+					await save_document({
+						...doc_json,
+						create: current_is_new
+					});
 
 				if (mapping) {
 					const tr = session.tr;
@@ -506,12 +521,7 @@
 />
 
 <div class="antialiased" bind:this={app_el}>
-	<Toolbar
-		{session}
-		{app_commands}
-		{editable}
-		{focus_canvas}
-	/>
+	<Toolbar {session} {app_commands} {editable} {focus_canvas} />
 	<Svedit {session} bind:editable bind:this={svedit_ref} path={[session.doc.document_id]} />
 
 	{#if has_backend}
diff --git a/src/routes/components/AuthDialog.svelte b/src/routes/components/AuthDialog.svelte
index 833b1fcb..fa377f90 100644
--- a/src/routes/components/AuthDialog.svelte
+++ b/src/routes/components/AuthDialog.svelte
@@ -1,16 +1,17 @@
-<script>
-	/** @type {{
-		onclose?: () => void,
-		onedit_for_fun?: () => void,
-		onlogin_success?: () => Promise<void> | void
-	}} */
-	let { onclose = () => {}, onedit_for_fun = () => {}, onlogin_success = () => {} } = $props();
+<script lang="ts">
+	let {
+		onedit_for_fun = () => {},
+		onlogin_success = () => {}
+	}: {
+		onedit_for_fun?: () => void;
+		onlogin_success?: () => Promise<void> | void;
+	} = $props();
 
 	let password = $state('');
 	let error = $state('');
 	let pending = $state(false);
 	let step = $state('choice');
-	let password_input_ref = $state();
+	let password_input_ref = $state<HTMLInputElement>();
 	let should_focus_password_input = $state(false);
 
 	$effect(() => {
@@ -41,11 +42,6 @@
 		should_focus_password_input = false;
 	}
 
-	function close_auth_dialog() {
-		reset_dialog();
-		onclose();
-	}
-
 	function handle_edit_for_fun() {
 		reset_dialog();
 		onedit_for_fun();
diff --git a/src/routes/components/Button.svelte b/src/routes/components/Button.svelte
index 511910c4..51f7dcff 100644
--- a/src/routes/components/Button.svelte
+++ b/src/routes/components/Button.svelte
@@ -1,10 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['button'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 	let layout = $derived(node.layout || 'primary');
 </script>
diff --git a/src/routes/components/ButtonGroup.svelte b/src/routes/components/ButtonGroup.svelte
index c4d9b613..f0da71b1 100644
--- a/src/routes/components/ButtonGroup.svelte
+++ b/src/routes/components/ButtonGroup.svelte
@@ -1,16 +1,19 @@
-<script>
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
 	import { getContext } from 'svelte';
 	import { Node, NodeArrayProperty } from 'svedit';
 
-	const prose = getContext('prose');
-	let { path } = $props();
+	const prose = getContext<{ is_centered: boolean } | undefined>('prose');
+	let { path }: { path: DocumentPath } = $props();
 	// The Prose or ProseGridItem node's layout determines alignment
 	let is_centered = $derived(prose?.is_centered);
 </script>
 
 <Node class="ew-button-group" {path}>
 	<NodeArrayProperty
-		class="[--row:1] button-group-buttons flex flex-wrap items-center gap-4{is_centered ? ' w-fit mx-auto' : ''}"
+		class="button-group-buttons flex flex-wrap items-center [--row:1] gap-4{is_centered
+			? ' mx-auto w-fit'
+			: ''}"
 		path={[...path, 'buttons']}
 	/>
 </Node>
diff --git a/src/routes/components/CaptionedFigure.svelte b/src/routes/components/CaptionedFigure.svelte
index e4a7517b..cbac2549 100644
--- a/src/routes/components/CaptionedFigure.svelte
+++ b/src/routes/components/CaptionedFigure.svelte
@@ -1,12 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 	import MediaProperty from './MediaProperty.svelte';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['captioned_figure'] = $derived(svedit.session.get(path));
 	let media_node = $derived(svedit.session.get([...path, 'media']));
 	let render_as_link = $derived(!svedit.editable && node.href);
 	let padding_top_wide = $derived(!section || section?.is_start);
diff --git a/src/routes/components/Code.svelte b/src/routes/components/Code.svelte
index ac7254a9..1cad7d93 100644
--- a/src/routes/components/Code.svelte
+++ b/src/routes/components/Code.svelte
@@ -1,12 +1,15 @@
-<script>
-	import { getContext } from 'svelte';
-	const svedit = getContext('svedit');
-	let { path, content } = $props();
-	let node = $derived(svedit.session.get(path));
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
+	const svedit = get_svedit_context();
+	let { path, content }: { path: DocumentPath; content: string } = $props();
+	let node: Nodes['code'] = $derived(svedit.session.get(path));
 </script>
 
 <code
 	id={node.id}
 	data-node-id={node.id}
-	class="rounded bg-(--foreground)/8 px-1 py-0.5 font-mono text-sm subpixel-antialiased text-[0.9em]">{content}</code
+	class="rounded bg-(--foreground)/8 px-1 py-0.5 font-mono text-sm text-[0.9em] subpixel-antialiased"
+	>{content}</code
 >
diff --git a/src/routes/components/CreateLink.svelte b/src/routes/components/CreateLink.svelte
index b835a4ba..f6f173b8 100644
--- a/src/routes/components/CreateLink.svelte
+++ b/src/routes/components/CreateLink.svelte
@@ -1,16 +1,17 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import { get_app_context } from '../app_context.js';
 	import { get_page_browser } from './page_browser_context.svelte.js';
 
-	const svedit = getContext('svedit');
-	const app = getContext('app');
+	const svedit = get_svedit_context();
+	const app = get_app_context();
 	const page_browser = get_page_browser();
 
 	let toggle_link_command = $derived(svedit.session.commands?.toggle_link);
 	let href_input_value = $state('https://');
 	let open_in_new_tab = $state(false);
-	let href_input_ref = $state();
-	let dialog_ref = $state();
+	let href_input_ref = $state<HTMLInputElement>();
+	let dialog_ref = $state<HTMLDialogElement>();
 
 	function create_link() {
 		if (href_input_value) {
diff --git a/src/routes/components/DescriptiveGallery.svelte b/src/routes/components/DescriptiveGallery.svelte
index 33ce313f..b977d1ed 100644
--- a/src/routes/components/DescriptiveGallery.svelte
+++ b/src/routes/components/DescriptiveGallery.svelte
@@ -1,11 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
 	let { path, mark: section = null } = $props();
-	const svedit = getContext('svedit');
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let node: Nodes['descriptive_gallery'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'cards');
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
diff --git a/src/routes/components/DescriptiveGalleryItem.svelte b/src/routes/components/DescriptiveGalleryItem.svelte
index 4f46b659..9daaf4b4 100644
--- a/src/routes/components/DescriptiveGalleryItem.svelte
+++ b/src/routes/components/DescriptiveGalleryItem.svelte
@@ -1,12 +1,14 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import MediaProperty from './MediaProperty.svelte';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['descriptive_gallery_item'] = $derived(svedit.session.get(path));
 	let gallery = $derived(svedit.session.get(path.slice(0, -2)));
 	let layout = $derived(gallery?.layout || 'cards');
 	let render_as_link = $derived(!svedit.editable && node.href);
diff --git a/src/routes/components/DescriptiveListing.svelte b/src/routes/components/DescriptiveListing.svelte
index 08272ed9..d70df16d 100644
--- a/src/routes/components/DescriptiveListing.svelte
+++ b/src/routes/components/DescriptiveListing.svelte
@@ -1,11 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['descriptive_listing'] = $derived(svedit.session.get(path));
 	let listing_layout = $derived(node.layout || 'narrow-left');
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
diff --git a/src/routes/components/DescriptiveListingItem.svelte b/src/routes/components/DescriptiveListingItem.svelte
index a3c3a219..145e1914 100644
--- a/src/routes/components/DescriptiveListingItem.svelte
+++ b/src/routes/components/DescriptiveListingItem.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['descriptive_listing_item'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 	let display_meta = $derived(svedit.editable || !!node.meta?.content?.trim());
 </script>
diff --git a/src/routes/components/Display.svelte b/src/routes/components/Display.svelte
deleted file mode 100644
index 8e434599..00000000
--- a/src/routes/components/Display.svelte
+++ /dev/null
@@ -1,11 +0,0 @@
-<script>
-	import { TextProperty } from 'svedit';
-	let { path, tag = 'h2', placeholder = 'Heading 1', class: css_class = '' } = $props();
-</script>
-
-<TextProperty
-	{tag}
-	class="{css_class} ew-display text-4xl tracking-tight text-balance lg:text-5xl"
-	{path}
-	{placeholder}
-/>
diff --git a/src/routes/components/Drawer.svelte b/src/routes/components/Drawer.svelte
index 1bb41712..7992f0c4 100644
--- a/src/routes/components/Drawer.svelte
+++ b/src/routes/components/Drawer.svelte
@@ -1,4 +1,4 @@
-<script>
+<script lang="ts">
 	/**
 	 * Reusable bottom drawer / bottom sheet backed by a dialog element so it
 	 * participates in the browser top layer when open.
@@ -18,10 +18,9 @@
 	const velocity_threshold = 0.5;
 	const auto_close_drag_distance = 96;
 
-	let dialog_ref = $state();
-	let handle_ref = $state();
+	let dialog_ref = $state<HTMLDialogElement>();
+	let handle_ref = $state<HTMLElement>();
 
-	let is_visible = $state(open);
 	let is_mounted = $state(false);
 	let is_closing = $state(false);
 	let is_dragging = $state(false);
@@ -181,7 +180,6 @@
 
 		if (!is_mounted && dialog_ref?.open) {
 			dialog_ref.close();
-			is_visible = false;
 			is_closing = false;
 			open = false;
 			drawer_height_ratio = last_open_drawer_height_ratio;
@@ -196,7 +194,6 @@
 			document.documentElement.classList.add('drawer-open');
 			document.body.classList.add('drawer-open');
 
-			is_visible = true;
 			is_closing = false;
 			drawer_height_ratio = last_open_drawer_height_ratio;
 
diff --git a/src/routes/components/EditLink.svelte b/src/routes/components/EditLink.svelte
index c609ff7c..133434f2 100644
--- a/src/routes/components/EditLink.svelte
+++ b/src/routes/components/EditLink.svelte
@@ -1,13 +1,15 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import { get_app_context } from '../app_context.js';
+	import type { DocumentPath } from 'svedit';
 	import { serialize_path } from 'svedit';
 	import { get_page_browser } from './page_browser_context.svelte.js';
 
-	const svedit = getContext('svedit');
-	const app = getContext('app');
+	const svedit = get_svedit_context();
+	const app = get_app_context();
 	const page_browser = get_page_browser();
 
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 
 	let edit_link_command = $derived(svedit.session.commands?.edit_link);
 	let target_node = $derived(get_target_node());
@@ -23,8 +25,8 @@
 	}
 	let href_input_value = $state('');
 	let open_in_new_tab = $state(false);
-	let href_input_ref = $state();
-	let dialog_ref = $state();
+	let href_input_ref = $state<HTMLInputElement>();
+	let dialog_ref = $state<HTMLDialogElement>();
 
 	function save() {
 		if (target_node && 'href' in target_node) {
diff --git a/src/routes/components/EditMedia.svelte b/src/routes/components/EditMedia.svelte
index e43a0eee..c5c07ead 100644
--- a/src/routes/components/EditMedia.svelte
+++ b/src/routes/components/EditMedia.svelte
@@ -1,16 +1,17 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { serialize_path } from 'svedit';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 
 	let edit_media_command = $derived(svedit.session.commands?.edit_image);
 	let target_node = $derived(svedit.session.get(path));
 	let alt_input_value = $state('');
-	let alt_input_ref = $state();
-	let dialog_ref = $state();
+	let alt_input_ref = $state<HTMLTextAreaElement>();
+	let dialog_ref = $state<HTMLDialogElement>();
 
 	function save() {
 		if (target_node?.type === 'image' || target_node?.type === 'video') {
diff --git a/src/routes/components/Emphasis.svelte b/src/routes/components/Emphasis.svelte
index adbcac03..9dd6ff21 100644
--- a/src/routes/components/Emphasis.svelte
+++ b/src/routes/components/Emphasis.svelte
@@ -1,8 +1,10 @@
-<script>
-	import { getContext } from 'svelte';
-	const svedit = getContext('svedit');
-	let { path, content } = $props();
-	let node = $derived(svedit.session.get(path));
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
+	const svedit = get_svedit_context();
+	let { path, content }: { path: DocumentPath; content: string } = $props();
+	let node: Nodes['emphasis'] = $derived(svedit.session.get(path));
 </script>
 
 <em id={node.id} data-node-id={node.id}>{content}</em>
diff --git a/src/routes/components/Feature.svelte b/src/routes/components/Feature.svelte
index 1cb9b906..fd1e1f7a 100644
--- a/src/routes/components/Feature.svelte
+++ b/src/routes/components/Feature.svelte
@@ -1,13 +1,14 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty } from 'svedit';
 	import MediaProperty from './MediaProperty.svelte';
 	import { TW_PAGE_PADDING_X, TW_LIMITER } from '../tailwind_theme.js';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['feature'] = $derived(svedit.session.get(path));
 	let media_node = $derived(svedit.session.get([...path, 'media']));
 	let render_as_link = $derived(!svedit.editable && node.href);
 	let media_aspect_ratio = $derived(
diff --git a/src/routes/components/Figure.svelte b/src/routes/components/Figure.svelte
index abf5a7b6..c6cbe55b 100644
--- a/src/routes/components/Figure.svelte
+++ b/src/routes/components/Figure.svelte
@@ -1,12 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 	import MediaProperty from './MediaProperty.svelte';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['figure'] = $derived(svedit.session.get(path));
 	let media_node = $derived(svedit.session.get([...path, 'media']));
 	let render_as_link = $derived(!svedit.editable && node.href);
 	let figure_layout = $derived(node.layout || 'wide');
diff --git a/src/routes/components/Footer.svelte b/src/routes/components/Footer.svelte
index 1eafb1cb..4660fff6 100644
--- a/src/routes/components/Footer.svelte
+++ b/src/routes/components/Footer.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { NodeArrayProperty, Node } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['footer'] = $derived(svedit.session.get(path));
 	let column_count = $derived(node.footer_link_columns.nodes.length);
 	let grid_cols_class = $derived(
 		column_count <= 1
diff --git a/src/routes/components/FooterLink.svelte b/src/routes/components/FooterLink.svelte
index e428a091..de0dba0b 100644
--- a/src/routes/components/FooterLink.svelte
+++ b/src/routes/components/FooterLink.svelte
@@ -1,10 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { TextProperty, Node } from 'svedit';
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['footer_link'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 </script>
 
diff --git a/src/routes/components/FooterLinkCategory.svelte b/src/routes/components/FooterLinkCategory.svelte
index 737e26d2..6772cbc0 100644
--- a/src/routes/components/FooterLinkCategory.svelte
+++ b/src/routes/components/FooterLinkCategory.svelte
@@ -1,6 +1,7 @@
-<script>
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
 	import { TextProperty, Node } from 'svedit';
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 </script>
 
 <Node {path} class="ew-footer-link-category">
diff --git a/src/routes/components/FooterLinkColumn.svelte b/src/routes/components/FooterLinkColumn.svelte
index 3637b9e7..0bf1a039 100644
--- a/src/routes/components/FooterLinkColumn.svelte
+++ b/src/routes/components/FooterLinkColumn.svelte
@@ -1,6 +1,7 @@
-<script>
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
 	import { NodeArrayProperty, Node } from 'svedit';
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 </script>
 
 <Node {path}>
diff --git a/src/routes/components/Gallery.svelte b/src/routes/components/Gallery.svelte
index e857e126..40b02eb8 100644
--- a/src/routes/components/Gallery.svelte
+++ b/src/routes/components/Gallery.svelte
@@ -1,11 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 	let { path, mark: section = null } = $props();
 
-	const svedit = getContext('svedit');
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let node: Nodes['gallery'] = $derived(svedit.session.get(path));
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
 	let grid_layout = $derived.by(get_grid_layout);
@@ -44,11 +45,6 @@
 
 		return layouts[node.layout ?? 'mixed'];
 	}
-	const heading_spacing = `
-		[&>div:has(h1)~div>h1]:pt-8
-		[&>div:has(h2)~div>h2]:pt-6
-		[&>div:has(h3)~div>h3]:pt-4
-	`;
 </script>
 
 <Node {path}>
diff --git a/src/routes/components/GalleryItem.svelte b/src/routes/components/GalleryItem.svelte
index 328f77b9..96c32f59 100644
--- a/src/routes/components/GalleryItem.svelte
+++ b/src/routes/components/GalleryItem.svelte
@@ -1,12 +1,14 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node } from 'svedit';
 	import MediaProperty from './MediaProperty.svelte';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['gallery_item'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 </script>
 
diff --git a/src/routes/components/Heading1.svelte b/src/routes/components/Heading1.svelte
index c13d2b47..d113804c 100644
--- a/src/routes/components/Heading1.svelte
+++ b/src/routes/components/Heading1.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['heading_1'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/Heading1XL.svelte b/src/routes/components/Heading1XL.svelte
index 3fdd23c4..6bcafde2 100644
--- a/src/routes/components/Heading1XL.svelte
+++ b/src/routes/components/Heading1XL.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['heading_1_xl'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/Heading2.svelte b/src/routes/components/Heading2.svelte
index 717be625..6fa6a5d6 100644
--- a/src/routes/components/Heading2.svelte
+++ b/src/routes/components/Heading2.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['heading_2'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/Heading3.svelte b/src/routes/components/Heading3.svelte
index 0ca72adc..4a382282 100644
--- a/src/routes/components/Heading3.svelte
+++ b/src/routes/components/Heading3.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['heading_3'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/Heading4.svelte b/src/routes/components/Heading4.svelte
index 7e520e01..f072bbf8 100644
--- a/src/routes/components/Heading4.svelte
+++ b/src/routes/components/Heading4.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['heading_4'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/Highlight.svelte b/src/routes/components/Highlight.svelte
index 86fe2adc..b962d1c8 100644
--- a/src/routes/components/Highlight.svelte
+++ b/src/routes/components/Highlight.svelte
@@ -1,15 +1,16 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { serialize_path } from 'svedit';
-	const svedit = getContext('svedit');
-	let { path, content } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path, content }: { path: DocumentPath; content: string } = $props();
+	let node: Nodes['highlight'] = $derived(svedit.session.get(path));
 </script>
 
 <span
 	id={node.id}
 	data-node-id={node.id}
 	class="bg-(--accent) text-(--accent-foreground) no-underline"
-	style="anchor-name: --{serialize_path(path)};">{content}</span>
-
-
+	style="anchor-name: --{serialize_path(path)};">{content}</span
+>
diff --git a/src/routes/components/Image.svelte b/src/routes/components/Image.svelte
index f536394c..9cb1df2e 100644
--- a/src/routes/components/Image.svelte
+++ b/src/routes/components/Image.svelte
@@ -1,19 +1,16 @@
-<script>
+<script lang="ts">
 	import { ASSET_BASE, VARIANT_WIDTHS } from '$lib/config.js';
 
-	/** @type {{ node: any }} */
-	let { node } = $props();
+	import type { PreviewMediaNode } from '$lib/page_metadata.js';
+
+	let { node }: { node: PreviewMediaNode } = $props();
 
 	// Determine if src is a blob URL (unsaved), a saved asset id, or empty
 	let is_blob = $derived(node.src?.startsWith('blob:'));
 	let is_saved = $derived(node.src && !is_blob);
 
 	// Resolve the display URL
-	let display_src = $derived(
-		is_blob ? node.src :
-		is_saved ? `${ASSET_BASE}/${node.src}` :
-		''
-	);
+	let display_src = $derived(is_blob ? node.src : is_saved ? `${ASSET_BASE}/${node.src}` : '');
 
 	// Use mime_type with fallback to file extension for legacy data
 	let is_svg = $derived(
@@ -23,7 +20,6 @@
 		node.mime_type ? node.mime_type === 'image/gif' : node.src?.endsWith('.gif')
 	);
 
-
 	// Build srcset for saved raster images (not SVGs, not GIFs, not blobs)
 	let srcset = $derived(build_srcset());
 
@@ -38,9 +34,7 @@
 
 		if (applicable.length === 0) return '';
 
-		const variant_entries = applicable.map(
-			(w) => `${ASSET_BASE}/${asset_stem}/w${w}.webp ${w}w`
-		);
+		const variant_entries = applicable.map((w) => `${ASSET_BASE}/${asset_stem}/w${w}.webp ${w}w`);
 		// The original is the largest entry
 		variant_entries.push(`${ASSET_BASE}/${node.src} ${node.width}w`);
 
@@ -54,8 +48,6 @@
 		transform-origin: ${node.focal_point_x * 100}% ${node.focal_point_y * 100}%;
 		object-fit: ${node.object_fit};
 	`);
-
-
 </script>
 
 {#if display_src}
@@ -63,7 +55,7 @@
 		contenteditable="false"
 		src={display_src}
 		srcset={srcset || undefined}
-		sizes={srcset ? "auto" : undefined}
+		sizes={srcset ? 'auto' : undefined}
 		loading="lazy"
 		alt={node.alt}
 		width={node.width}
diff --git a/src/routes/components/Link.svelte b/src/routes/components/Link.svelte
index d76998c5..94f15606 100644
--- a/src/routes/components/Link.svelte
+++ b/src/routes/components/Link.svelte
@@ -1,10 +1,12 @@
-<script>
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { resolve } from '$app/paths';
-	import { getContext } from 'svelte';
 	import { serialize_path } from 'svedit';
-	const svedit = getContext('svedit');
-	let { path, content } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path, content }: { path: DocumentPath; content: string } = $props();
+	let node: Nodes['link'] = $derived(svedit.session.get(path));
 
 	function get_link_href(href) {
 		if (!href) return undefined;
@@ -16,6 +18,6 @@
 	id={node.id}
 	data-node-id={node.id}
 	{...{ href: get_link_href(node?.href), target: node?.target || '_self' }}
-	class="underline underline-offset-2 transition-all duration-500 ease-in-out hover:decoration-(--foreground) hover:text-(--foreground) outline-1 outline-transparent focus-visible:outline-1 focus-visible:outline-(--svedit-editing-stroke) focus-visible:outline-offset-1"
+	class="underline underline-offset-2 outline-1 outline-transparent transition-all duration-500 ease-in-out hover:text-(--foreground) hover:decoration-(--foreground) focus-visible:outline-1 focus-visible:outline-offset-1 focus-visible:outline-(--svedit-editing-stroke)"
 	style="anchor-name: --{serialize_path(path)};">{content}</a
 >
diff --git a/src/routes/components/LinkPreview.svelte b/src/routes/components/LinkPreview.svelte
index 6c6172c4..02af574e 100644
--- a/src/routes/components/LinkPreview.svelte
+++ b/src/routes/components/LinkPreview.svelte
@@ -1,11 +1,12 @@
-<script>
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import { get_app_context } from '../app_context.js';
 	import { resolve } from '$app/paths';
-	import { getContext } from 'svelte';
 	import { serialize_path } from 'svedit';
 	import Media from './Media.svelte';
 
-	const svedit = getContext('svedit');
-	const app = getContext('app');
+	const svedit = get_svedit_context();
+	const app = get_app_context();
 
 	let { node, path } = $props();
 
@@ -52,11 +53,9 @@
 		return href;
 	}
 
-	function get_preview_href(href) {
+	function get_preview_href(href: unknown) {
 		if (typeof href !== 'string') return '';
-		return href.startsWith('/') && !href.startsWith('//')
-			? resolve(/** @type {any} */ (href))
-			: href;
+		return href.startsWith('/') && !href.startsWith('//') ? resolve(href as any) : href;
 	}
 </script>
 
diff --git a/src/routes/components/List.svelte b/src/routes/components/List.svelte
index ee7ad080..221ee9a4 100644
--- a/src/routes/components/List.svelte
+++ b/src/routes/components/List.svelte
@@ -1,7 +1,8 @@
-<script>
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
 	import { Node, NodeArrayProperty } from 'svedit';
 
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 </script>
 
 <Node {path}>
diff --git a/src/routes/components/ListItem.svelte b/src/routes/components/ListItem.svelte
index 452919e0..5926660d 100644
--- a/src/routes/components/ListItem.svelte
+++ b/src/routes/components/ListItem.svelte
@@ -1,10 +1,11 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 	let list_node = $derived(svedit.session.get(path.slice(0, -2)));
 	let item_index = $derived(Number(path.at(-1)) || 0);
 	let marker = $derived(get_marker(item_index + 1, list_node?.layout || 'decimal'));
diff --git a/src/routes/components/Media.svelte b/src/routes/components/Media.svelte
index 64e72880..d0c6756e 100644
--- a/src/routes/components/Media.svelte
+++ b/src/routes/components/Media.svelte
@@ -1,13 +1,16 @@
-<script>
+<script lang="ts">
 	import Image from './Image.svelte';
 	import Video from './Video.svelte';
 
-	/** @type {{ node: any, editable?: boolean }} */
-	let { node, editable = false } = $props();
+	import type { PreviewMediaNode } from '$lib/page_metadata.js';
+
+	// Accepts both document media nodes (Nodes['image'] / Nodes['video']) and
+	// derived preview nodes — anything with the media display shape.
+	let { node, editable = false }: { node: PreviewMediaNode; editable?: boolean } = $props();
 </script>
 
 {#if node?.type === 'video'}
 	<Video {node} {editable} />
 {:else if node}
 	<Image {node} />
-{/if}
\ No newline at end of file
+{/if}
diff --git a/src/routes/components/MediaControls.svelte b/src/routes/components/MediaControls.svelte
index 40c0a5f8..8a51695c 100644
--- a/src/routes/components/MediaControls.svelte
+++ b/src/routes/components/MediaControls.svelte
@@ -1,8 +1,8 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
 	import { touch_drag } from '$lib/client/touch_drag.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
 	// Zoom constraints
 	const MIN_SCALE = 0.1;
@@ -104,8 +104,7 @@
 		const current_scale = media_node.scale;
 		const next_scale = current_scale + zoom_delta;
 		const crosses_one =
-			(current_scale < 1.0 && next_scale > 1.0) ||
-			(current_scale > 1.0 && next_scale < 1.0);
+			(current_scale < 1.0 && next_scale > 1.0) || (current_scale > 1.0 && next_scale < 1.0);
 		const is_close_to_one = Math.abs(next_scale - 1.0) <= ZOOM_STEP;
 
 		const snapped_scale = crosses_one || is_close_to_one ? 1.0 : next_scale;
@@ -130,7 +129,6 @@
 
 <!-- Either the pan mode is armed (after a pointer selection) or there's no pointer involved -->
 {#if pan_mode_armed || !is_mouse_down}
-	<!-- svelte-ignore a11y_no_static_element_interactions -->
 	<div
 		bind:this={controls_ref}
 		class="media-controls"
@@ -148,8 +146,6 @@
 			></div>
 		{/if}
 	</div>
-
-
 {/if}
 
 <style>
@@ -209,6 +205,4 @@
 		background: var(--svedit-editing-stroke);
 		transform: translate(-50%, -50%);
 	}
-
-
 </style>
diff --git a/src/routes/components/MediaProperty.svelte b/src/routes/components/MediaProperty.svelte
index 39978076..d63aff43 100644
--- a/src/routes/components/MediaProperty.svelte
+++ b/src/routes/components/MediaProperty.svelte
@@ -1,20 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { CustomProperty, serialize_path } from 'svedit';
 	import Media from './Media.svelte';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	/**
-	 * @type {{
-	 *   path: any[],
-	 *   class?: string
-	 * }}
-	 */
-	let {
-		path,
-		class: css_class = ''
-	} = $props();
+	let { path, class: css_class = '' }: { path: DocumentPath; class?: string } = $props();
 	let node = $derived(svedit.session.get(path));
 
 	let is_selected = $derived(is_property_selected());
@@ -25,10 +17,10 @@
 	}
 </script>
 
-<CustomProperty class="h-full {css_class}" path={path}>
+<CustomProperty class="h-full {css_class}" {path}>
 	<div
 		contenteditable="false"
-		class="overflow-hidden h-full"
+		class="h-full overflow-hidden"
 		class:ew-bg-checkerboard={is_selected || !node.src}
 	>
 		<Media {node} editable={svedit.editable} />
diff --git a/src/routes/components/Nav.svelte b/src/routes/components/Nav.svelte
index bb9bd337..392fae81 100644
--- a/src/routes/components/Nav.svelte
+++ b/src/routes/components/Nav.svelte
@@ -1,15 +1,17 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { NodeArrayProperty, Node } from 'svedit';
 	import { slide } from 'svelte/transition';
 	import { TW_LIMITER } from '../tailwind_theme.js';
 	import NavMedia from './NavMedia.svelte';
 	import NavButton from './NavButton.svelte';
 
-	let { path } = $props();
+	let { path }: { path: DocumentPath } = $props();
 
-	const svedit = getContext('svedit');
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let node: Nodes['nav'] = $derived(svedit.session.get(path));
 	let middle_item_ids = $derived(node.middle_items.nodes);
 	let mobile_nav_media_path = $derived(find_mobile_nav_media_path());
 	let mobile_nav_cta_path = $derived(find_mobile_nav_cta_path());
diff --git a/src/routes/components/NavButton.svelte b/src/routes/components/NavButton.svelte
index dbbe5b3a..4102568c 100644
--- a/src/routes/components/NavButton.svelte
+++ b/src/routes/components/NavButton.svelte
@@ -1,10 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['nav_button'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 	let layout = $derived(node.layout || 'primary');
 </script>
diff --git a/src/routes/components/NavLink.svelte b/src/routes/components/NavLink.svelte
index 71de7aa2..bec188e7 100644
--- a/src/routes/components/NavLink.svelte
+++ b/src/routes/components/NavLink.svelte
@@ -1,10 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['nav_link'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 </script>
 
diff --git a/src/routes/components/NavMedia.svelte b/src/routes/components/NavMedia.svelte
index b9adc271..3c614e4e 100644
--- a/src/routes/components/NavMedia.svelte
+++ b/src/routes/components/NavMedia.svelte
@@ -1,21 +1,25 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node } from 'svedit';
 	import MediaProperty from './MediaProperty.svelte';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['nav_media'] = $derived(svedit.session.get(path));
 	let media_node = $derived(svedit.session.get([...path, 'media']));
 	let render_as_link = $derived(!svedit.editable && node.href);
 </script>
 
-<Node class="nav-media flex items-center shrink-0 min-w-10" {path}>
+<Node class="nav-media flex min-w-10 shrink-0 items-center" {path}>
 	<svelte:element
-		class="h-7 block min-w-0 outline-1 outline-transparent focus-visible:outline-1 focus-visible:outline-(--svedit-editing-stroke) focus-visible:outline-offset-1"
-		style:aspect-ratio={media_node.width && media_node.height ? `${media_node.width} / ${media_node.height}` : '1 / 1'}
 		this={render_as_link ? 'a' : 'div'}
+		class="block h-7 min-w-0 outline-1 outline-transparent focus-visible:outline-1 focus-visible:outline-offset-1 focus-visible:outline-(--svedit-editing-stroke)"
+		style:aspect-ratio={media_node.width && media_node.height
+			? `${media_node.width} / ${media_node.height}`
+			: '1 / 1'}
 		href={render_as_link ? node.href : undefined}
 		target={render_as_link ? node.target : undefined}
 	>
diff --git a/src/routes/components/NodeNavigator.svelte b/src/routes/components/NodeNavigator.svelte
index 0d9afe28..7125aea0 100644
--- a/src/routes/components/NodeNavigator.svelte
+++ b/src/routes/components/NodeNavigator.svelte
@@ -1,4 +1,4 @@
-<script>
+<script lang="ts">
 	import { serialize_path } from 'svedit';
 	import { get_selection_node_ancestors, is_node_subtree_empty } from '../app_utils.js';
 
@@ -176,9 +176,9 @@
 					onblur={restore_canvas_selection}
 					onkeydown={handle_variant_keydown}
 				>
-					{#each variant_item.groups as group}
+					{#each variant_item.groups as group (group.node_type)}
 						<optgroup label={humanize_node_id(group.node_type, true)}>
-							{#each group.options as option}
+							{#each group.options as option (option.value)}
 								<option value={option.value}>
 									{get_variant_label(group.node_type, option.layout)}
 								</option>
diff --git a/src/routes/components/Overlays.svelte b/src/routes/components/Overlays.svelte
index f32766ed..662b9106 100644
--- a/src/routes/components/Overlays.svelte
+++ b/src/routes/components/Overlays.svelte
@@ -1,5 +1,6 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import { get_app_context } from '../app_context.js';
 	import { deserialize_path, serialize_path } from 'svedit';
 	import { get_page_browser } from './page_browser_context.svelte.js';
 	import MediaControls from './MediaControls.svelte';
@@ -11,15 +12,15 @@
 	import AuthDialog from './AuthDialog.svelte';
 	import Drawer from './Drawer.svelte';
 
-	const svedit = getContext('svedit');
-	const app = getContext('app');
+	const svedit = get_svedit_context();
+	const app = get_app_context();
 
 	// True for the whole period the mouse button is down
 	let is_mouse_down = $state(false);
 	// Only becomes true when the mouse actually moves (=drag)
 	let is_dragging = $state(false);
 
-	let overlays_ref = $state();
+	let overlays_ref = $state<HTMLElement>();
 	const page_browser = get_page_browser();
 
 	// --- File drag-and-drop onto media properties ---
@@ -126,7 +127,7 @@
 		if (!sel) return null;
 		const media_path = sel.path;
 		const parent_path = media_path.slice(0, -1);
-		const media_property = /** @type {string} */ (media_path.at(-1));
+		const media_property = media_path.at(-1) as string;
 		const anchor_name = `--viewbox-${serialize_path(parent_path)}-${media_property}`;
 		if (document.querySelector(`[data-viewbox-anchor="${anchor_name}"]`)) {
 			return { parent_path, media_property };
@@ -208,7 +209,7 @@
 		{#if viewbox_context}
 			<SizableViewboxControls
 				path={viewbox_context.parent_path}
-				media_property={viewbox_context.media_property}
+				media_property={viewbox_context.media_property as string}
 			/>
 		{/if}
 	{/if}
@@ -231,11 +232,7 @@
 
 	{#if app.auth_dialog_open}
 		<Drawer bind:open={app.auth_dialog_open} label="Edit options" drawer_height_mode="auto">
-			<AuthDialog
-				onclose={app.close_auth_dialog}
-				onedit_for_fun={app.edit_for_fun}
-				onlogin_success={app.handle_auth_success}
-			/>
+			<AuthDialog onedit_for_fun={app.edit_for_fun} onlogin_success={app.handle_auth_success} />
 		</Drawer>
 	{/if}
 
diff --git a/src/routes/components/Page.svelte b/src/routes/components/Page.svelte
index 9c92b3bb..b3831cd5 100644
--- a/src/routes/components/Page.svelte
+++ b/src/routes/components/Page.svelte
@@ -1,5 +1,7 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import { get_app_context } from '../app_context.js';
+	import type { DocumentPath } from 'svedit';
 	import { TextProperty, Node, NodeArrayProperty } from 'svedit';
 	import Nav from './Nav.svelte';
 	import Footer from './Footer.svelte';
@@ -7,10 +9,9 @@
 	import { extract_page_metadata, get_social_image } from '$lib/page_metadata.js';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
-	const app = getContext('app');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	const app = get_app_context();
+	let { path }: { path: DocumentPath } = $props();
 	let head_metadata = $derived(extract_page_metadata(svedit.session.doc));
 	let page_title = $derived(head_metadata.title || 'Untitled page');
 	let canonical_url = $derived(
diff --git a/src/routes/components/PagesDrawer.svelte b/src/routes/components/PagesDrawer.svelte
index cfdc3691..44f307be 100644
--- a/src/routes/components/PagesDrawer.svelte
+++ b/src/routes/components/PagesDrawer.svelte
@@ -1,19 +1,19 @@
-<script>
-	import { goto, invalidateAll } from '$app/navigation';
+<script lang="ts">
+	import { get_app_context } from '../app_context.js';
+	import { invalidateAll } from '$app/navigation';
 	import { resolve } from '$app/paths';
-	import { getContext } from 'svelte';
 
 	import { get_page_browser_data } from '$lib/api.remote.js';
+	import type { PageTreeNode } from '$lib/api.remote.js';
 	import Media from './Media.svelte';
 	import { get_page_browser } from './page_browser_context.svelte.js';
 
-	const app = getContext('app');
+	const app = get_app_context();
 	const page_browser = get_page_browser();
 
 	let browser_data = $state(null);
 	let loading = $state(false);
 	let load_error = $state('');
-	let loaded_version = $state(-1);
 
 	let menu_item = $state(null);
 	let menu_anchor_name = $state('');
@@ -37,6 +37,10 @@
 
 	let search_query = $state('');
 	let search_input_ref = $state(null);
+	// selected_result_index is genuinely hybrid state: reset by search changes,
+	// clamped against visible results, and driven by keyboard navigation — a
+	// writable $derived would obscure those interacting writers.
+	// eslint-disable-next-line svelte/prefer-writable-derived
 	let selected_result_index = $state(0);
 	let tree_ref = $state(null);
 	let initialized_selection_version = $state(-1);
@@ -120,10 +124,9 @@
 		loading = query.loading;
 		load_error = query.error ? 'Failed to load pages.' : '';
 		browser_data = query.current ?? null;
-		loaded_version = page_browser?.version ?? 0;
 
 		const current_page_id = query.current
-			? /** @type {string | null} */ (query.current.current_document_id ?? null)
+			? ((query.current.current_document_id ?? null) as string | null)
 			: null;
 
 		if (
@@ -479,7 +482,6 @@ Updated: ${updated_at_label}`;
 
 			close_page_url_dialog();
 			browser_data = null;
-			loaded_version = -1;
 			page_browser.invalidate?.();
 			await invalidateAll();
 		} catch (err) {
@@ -511,7 +513,6 @@ Updated: ${updated_at_label}`;
 
 			close_confirm();
 			browser_data = null;
-			loaded_version = -1;
 
 			if (deleted_current_page) {
 				await page_browser.handle_page_deleted?.(
@@ -530,10 +531,6 @@ Updated: ${updated_at_label}`;
 		}
 	}
 
-	function get_count_label(count, singular_label, plural_label) {
-		return `${count} ${count === 1 ? singular_label : plural_label}`;
-	}
-
 	function normalize_search_text(value) {
 		return (value ?? '').trim().toLowerCase();
 	}
@@ -646,7 +643,7 @@ Updated: ${updated_at_label}`;
 		}));
 	}
 
-	function get_match_kind_class(match_kind) {
+	function get_match_kind_class(_match_kind) {
 		return '';
 	}
 
@@ -712,7 +709,7 @@ Updated: ${updated_at_label}`;
 			page_browser.handle_page_selected({
 				document_id: selected_result.document_id,
 				page_href: selected_result.page_href
-			});
+			} as PageTreeNode);
 		}
 	}
 
@@ -721,9 +718,7 @@ Updated: ${updated_at_label}`;
 	let filtered_page_forest = $derived(filter_page_forest(page_forest, normalized_search_query));
 	let visible_results = $derived(get_visible_results(filtered_page_forest));
 	let page_count = $derived(get_page_forest_count(page_forest));
-	let filtered_page_count = $derived(get_page_forest_count(filtered_page_forest));
 	let is_picker_mode = $derived(page_browser.state.mode === 'select');
-	let drawer_title = $derived(is_picker_mode ? 'Select page' : 'Pages');
 
 	$effect(() => {
 		normalized_search_query;
diff --git a/src/routes/components/Paragraph.svelte b/src/routes/components/Paragraph.svelte
index 7ac4a17d..d6b85ae8 100644
--- a/src/routes/components/Paragraph.svelte
+++ b/src/routes/components/Paragraph.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
 	import { Node, TextProperty } from 'svedit';
+	import type { DocumentPath } from 'svedit';
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['paragraph'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/ParagraphLG.svelte b/src/routes/components/ParagraphLG.svelte
index a93d10b0..2a8eb281 100644
--- a/src/routes/components/ParagraphLG.svelte
+++ b/src/routes/components/ParagraphLG.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['paragraph_lg'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/ParagraphSM.svelte b/src/routes/components/ParagraphSM.svelte
index 86a55667..f5cd71eb 100644
--- a/src/routes/components/ParagraphSM.svelte
+++ b/src/routes/components/ParagraphSM.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['paragraph_sm'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/ParagraphXL.svelte b/src/routes/components/ParagraphXL.svelte
index 7ffc5e71..c24388d5 100644
--- a/src/routes/components/ParagraphXL.svelte
+++ b/src/routes/components/ParagraphXL.svelte
@@ -1,11 +1,13 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { reveal } from '../reveal.js';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['paragraph_xl'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'default');
 </script>
 
diff --git a/src/routes/components/Preformatted.svelte b/src/routes/components/Preformatted.svelte
index c537e87e..e05c5cb9 100644
--- a/src/routes/components/Preformatted.svelte
+++ b/src/routes/components/Preformatted.svelte
@@ -1,5 +1,6 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, TextProperty } from 'svedit';
 	import { TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 	import { split_code_comments } from '$lib/code_comments.js';
@@ -8,9 +9,9 @@
 	// Set to false to render all preformatted text uniformly.
 	const dim_code_comments = true;
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['preformatted'] = $derived(svedit.session.get(path));
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
 	let comment_segments = $derived(
diff --git a/src/routes/components/Prose.svelte b/src/routes/components/Prose.svelte
index 8b38e9fa..e72c0f13 100644
--- a/src/routes/components/Prose.svelte
+++ b/src/routes/components/Prose.svelte
@@ -1,11 +1,17 @@
-<script>
-	import { getContext, setContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import type { Nodes } from '$lib/document_schema.js';
+	import { setContext } from 'svelte';
 	import { Node, NodeArrayProperty } from 'svedit';
+	import type { DocumentPath, NodeArrayAttachmentContext } from 'svedit';
 	import { TW_PAGE_PADDING_X, TW_LIMITER } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
-	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let {
+		path,
+		mark: section = null
+	}: { path: DocumentPath; mark?: NodeArrayAttachmentContext | null } = $props();
+	let node: Nodes['prose'] = $derived(svedit.session.get(path));
 	let layout = $derived(node.layout || 'narrow-left');
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
diff --git a/src/routes/components/ProseGrid.svelte b/src/routes/components/ProseGrid.svelte
index 246fffd1..dc786642 100644
--- a/src/routes/components/ProseGrid.svelte
+++ b/src/routes/components/ProseGrid.svelte
@@ -1,11 +1,12 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { Node, NodeArrayProperty } from 'svedit';
 	import { TW_LIMITER, TW_PAGE_PADDING_X } from '../tailwind_theme.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { path, mark: section = null } = $props();
-	let node = $derived(svedit.session.get(path));
+	let node: Nodes['prose_grid'] = $derived(svedit.session.get(path));
 	let item_count = $derived(node.items?.nodes.length || 0);
 	let padding_top_wide = $derived(!section || section?.is_start);
 	let padding_bottom_wide = $derived(!section || section?.is_end);
diff --git a/src/routes/components/ProseGridItem.svelte b/src/routes/components/ProseGridItem.svelte
index 929dc135..f784853b 100644
--- a/src/routes/components/ProseGridItem.svelte
+++ b/src/routes/components/ProseGridItem.svelte
@@ -1,13 +1,15 @@
-<script>
-	import { getContext, setContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { setContext } from 'svelte';
 	import { Node, NodeArrayProperty } from 'svedit';
 
-	const svedit = getContext('svedit');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	let { path }: { path: DocumentPath } = $props();
 
 	let prose_grid_path = $derived(path.slice(0, -2));
-	let prose_grid_node = $derived(svedit.session.get(prose_grid_path));
+	let prose_grid_node: Nodes['prose_grid'] = $derived(svedit.session.get(prose_grid_path));
 	let layout = $derived(prose_grid_node.layout || 'plain');
 
 	setContext('prose', {
diff --git a/src/routes/components/SaveProgressModal.svelte b/src/routes/components/SaveProgressModal.svelte
index eb31d9cc..23c43d0d 100644
--- a/src/routes/components/SaveProgressModal.svelte
+++ b/src/routes/components/SaveProgressModal.svelte
@@ -1,14 +1,11 @@
-<script>
+<script lang="ts">
 	import { fade } from 'svelte/transition';
 
-	/**
-	 * @type {{
-	 *   visible: boolean,
-	 *   message: string,
-	 *   done: boolean
-	 * }}
-	 */
-	let { visible = false, message = '', done = false } = $props();
+	let {
+		visible = false,
+		message = '',
+		done = false
+	}: { visible?: boolean; message?: string; done?: boolean } = $props();
 
 	let show_modal = $state(false);
 	let delay_timer;
diff --git a/src/routes/components/Section.svelte b/src/routes/components/Section.svelte
index 0a97d684..754bb372 100644
--- a/src/routes/components/Section.svelte
+++ b/src/routes/components/Section.svelte
@@ -1,7 +1,7 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 	let { children, ...rest } = $props();
 
 	const bracket_class =
@@ -23,7 +23,11 @@
 	{/if}
 	{#if svedit.editable}
 		<div class="relative">
-			<div class="{bracket_class} bottom-1.5 sm:bottom-4" contenteditable="false" aria-hidden="true">
+			<div
+				class="{bracket_class} bottom-1.5 sm:bottom-4"
+				contenteditable="false"
+				aria-hidden="true"
+			>
 				<div class="{corner_class} bottom-0 left-0 border-b border-l"></div>
 				<div class="{corner_class} right-0 bottom-0 border-r border-b"></div>
 			</div>
diff --git a/src/routes/components/SizableViewbox.svelte b/src/routes/components/SizableViewbox.svelte
index 2df7d260..f8792411 100644
--- a/src/routes/components/SizableViewbox.svelte
+++ b/src/routes/components/SizableViewbox.svelte
@@ -1,19 +1,11 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import type { DocumentPath } from 'svedit';
+	import type { Snippet } from 'svelte';
+	import { get_svedit_context } from '../svedit_context.js';
 	import { serialize_path } from 'svedit';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
-	/**
-	 * @type {{
-	 *   path: any[],
-	 *   media_property?: string,
-	 *   children: import('svelte').Snippet,
-	 *   placeholder_aspect_ratio?: number,
-	 *   class?: string,
-	 *   style?: string
-	 * }}
-	 */
 	let {
 		path,
 		media_property = 'media',
@@ -21,6 +13,13 @@
 		placeholder_aspect_ratio = 16 / 9,
 		class: css_class = '',
 		style: css_style = ''
+	}: {
+		path: DocumentPath;
+		media_property?: string;
+		children: Snippet;
+		placeholder_aspect_ratio?: number;
+		class?: string;
+		style?: string;
 	} = $props();
 
 	// Derive field names from media_property: e.g. 'media' -> 'media_max_width', 'media_aspect_ratio'
@@ -39,17 +38,11 @@
 
 	// Resolve aspect ratio: 0 means use natural ratio
 	let resolved_aspect_ratio = $derived(
-		node[aspect_ratio_field] > 0
-			? node[aspect_ratio_field]
-			: natural_aspect_ratio
+		node[aspect_ratio_field] > 0 ? node[aspect_ratio_field] : natural_aspect_ratio
 	);
 
 	// Resolve max-width style: 0 means full width (no constraint)
-	let max_width_style = $derived(
-		node[max_width_field] > 0
-			? `${node[max_width_field]}px`
-			: '100%'
-	);
+	let max_width_style = $derived(node[max_width_field] > 0 ? `${node[max_width_field]}px` : '100%');
 
 	// Anchor name for overlay handles to position against
 	let anchor_name = $derived(`--viewbox-${serialize_path(path)}-${media_property}`);
diff --git a/src/routes/components/SizableViewboxControls.svelte b/src/routes/components/SizableViewboxControls.svelte
index 969ed225..8b85f2b5 100644
--- a/src/routes/components/SizableViewboxControls.svelte
+++ b/src/routes/components/SizableViewboxControls.svelte
@@ -1,10 +1,11 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
 	import { serialize_path } from 'svedit';
+	import type { DocumentPath } from 'svedit';
 	import { touch_drag, lock_cursor, unlock_cursor } from '$lib/client/touch_drag.js';
 	import { SNAP_ASPECT_RATIOS } from '$lib/config.js';
 
-	const svedit = getContext('svedit');
+	const svedit = get_svedit_context();
 
 	const MIN_WIDTH = 40;
 	const MIN_HEIGHT = 20;
@@ -12,17 +13,14 @@
 	// Snap engages when the raw pixel value is within this many px of a snap target
 	const SNAP_PX = 12;
 
-	/**
-	 * @type {{
-	 *   path: any[],
-	 *   media_property?: string,
-	 *   placeholder_aspect_ratio?: number
-	 * }}
-	 */
 	let {
 		path,
 		media_property = 'media',
 		placeholder_aspect_ratio = 16 / 9
+	}: {
+		path: DocumentPath;
+		media_property?: string;
+		placeholder_aspect_ratio?: number;
 	} = $props();
 
 	// Derive field names from media_property
@@ -41,36 +39,30 @@
 
 	// Resolve aspect ratio: 0 means use natural ratio
 	let resolved_aspect_ratio = $derived(
-		node[aspect_ratio_field] > 0
-			? node[aspect_ratio_field]
-			: natural_aspect_ratio
+		node[aspect_ratio_field] > 0 ? node[aspect_ratio_field] : natural_aspect_ratio
 	);
 
 	// Anchor name must match what SizableViewbox sets
 	let anchor_name = $derived(`--viewbox-${serialize_path(path)}-${media_property}`);
 
 	// --- Snap label shown during drag ---
-	let snap_label = $state(/** @type {string | null} */ (null));
+	let snap_label = $state<string | null>(null);
 
 	// --- Snap candidates (all common ratios + natural) ---
 	function get_snap_candidates() {
-		return [
-			...SNAP_ASPECT_RATIOS,
-			{ ratio: natural_aspect_ratio, label: 'original' },
-		];
+		return [...SNAP_ASPECT_RATIOS, { ratio: natural_aspect_ratio, label: 'original' }];
 	}
 
 	/**
 	 * For width drags: given a fixed height, find the snap width closest to raw_width.
 	 * Returns { width, ratio, label } or null if nothing is close enough.
-	 *
-	 * @param {number} raw_width
-	 * @param {number} fixed_height
-	 * @returns {{ width: number, ratio: number, label: string } | null}
 	 */
-	function snap_width_for_height(raw_width, fixed_height) {
+	function snap_width_for_height(
+		raw_width: number,
+		fixed_height: number
+	): { width: number; ratio: number; label: string } | null {
 		const candidates = get_snap_candidates();
-		let best = null;
+		let best: { width: number; ratio: number; label: string } | null = null;
 		let best_distance = Infinity;
 
 		for (const c of candidates) {
@@ -88,14 +80,13 @@
 	/**
 	 * For height drags: given a fixed width, find the snap height closest to raw_height.
 	 * Returns { height, ratio, label } or null if nothing is close enough.
-	 *
-	 * @param {number} raw_height
-	 * @param {number} fixed_width
-	 * @returns {{ height: number, ratio: number, label: string } | null}
 	 */
-	function snap_height_for_width(raw_height, fixed_width) {
+	function snap_height_for_width(
+		raw_height: number,
+		fixed_width: number
+	): { height: number; ratio: number; label: string } | null {
 		const candidates = get_snap_candidates();
-		let best = null;
+		let best: { height: number; ratio: number; label: string } | null = null;
 		let best_distance = Infinity;
 
 		for (const c of candidates) {
@@ -114,14 +105,13 @@
 	 * For corner drags: find the snap ratio whose diagonal is closest to the raw diagonal.
 	 * The "diagonal" here is the angle (atan2) — we compare the angle of the raw w/h
 	 * to the angle each candidate ratio would produce at the same diagonal distance.
-	 *
-	 * @param {number} raw_width
-	 * @param {number} raw_height
-	 * @returns {{ ratio: number, label: string } | null}
 	 */
-	function snap_corner_ratio(raw_width, raw_height) {
+	function snap_corner_ratio(
+		raw_width: number,
+		raw_height: number
+	): { ratio: number; label: string } | null {
 		const candidates = get_snap_candidates();
-		let best = null;
+		let best: { ratio: number; label: string } | null = null;
 		let best_distance = Infinity;
 
 		// For corner: compute the diagonal length, then for each candidate ratio
@@ -131,7 +121,7 @@
 
 		for (const c of candidates) {
 			// w = diag * cos(atan(1/ratio)) = diag * ratio / sqrt(1 + ratio^2)
-			const snap_w = diag * c.ratio / Math.sqrt(1 + c.ratio * c.ratio);
+			const snap_w = (diag * c.ratio) / Math.sqrt(1 + c.ratio * c.ratio);
 			const snap_h = snap_w / c.ratio;
 			const dx = raw_width - snap_w;
 			const dy = raw_height - snap_h;
@@ -148,19 +138,16 @@
 	/**
 	 * Convert a snap ratio result into the stored aspect_ratio value.
 	 * 'original' maps to 0 (convention); otherwise store the exact ratio.
-	 *
-	 * @param {{ ratio: number, label: string }} snapped
-	 * @returns {number}
 	 */
-	function stored_ratio(snapped) {
+	function stored_ratio(snapped: { ratio: number; label: string }): number {
 		return snapped.label === 'original' ? 0 : snapped.ratio;
 	}
 
 	// --- Cursor lock during drag ---
 	const CURSOR_FOR_TYPE = {
 		'width-right': 'ew-resize',
-		'height': 'ns-resize',
-		'corner': 'nwse-resize',
+		height: 'ns-resize',
+		corner: 'nwse-resize'
 	};
 
 	// --- Drag state (shared across all handles) ---
@@ -184,12 +171,10 @@
 
 		const viewbox_el = get_viewbox_el();
 		const rect = viewbox_el?.getBoundingClientRect();
-		drag_start_max_width = node[max_width_field] > 0
-			? node[max_width_field]
-			: (rect?.width ?? 400);
+		drag_start_max_width = node[max_width_field] > 0 ? node[max_width_field] : (rect?.width ?? 400);
 		drag_start_aspect_ratio = resolved_aspect_ratio;
 		// Capture the current visual height so we can preserve it
-		drag_start_visual_height = rect?.height ?? (drag_start_max_width / resolved_aspect_ratio);
+		drag_start_visual_height = rect?.height ?? drag_start_max_width / resolved_aspect_ratio;
 		const parent_rect = viewbox_el?.parentElement?.getBoundingClientRect();
 		drag_container_width = parent_rect?.width ?? drag_start_max_width;
 
@@ -199,8 +184,8 @@
 			const gap_left = rect.left - parent_rect.left;
 			const gap_right = parent_rect.right - rect.right;
 			const total_gap = gap_left + gap_right;
-			const is_centered = total_gap > 0
-				&& Math.abs(gap_left - gap_right) < Math.max(5, total_gap * 0.1);
+			const is_centered =
+				total_gap > 0 && Math.abs(gap_left - gap_right) < Math.max(5, total_gap * 0.1);
 			drag_width_multiplier = is_centered ? 2 : 1;
 		} else {
 			drag_width_multiplier = 2;
@@ -227,12 +212,10 @@
 
 		const viewbox_el = get_viewbox_el();
 		const rect = viewbox_el?.getBoundingClientRect();
-		drag_start_max_width = node[max_width_field] > 0
-			? node[max_width_field]
-			: (rect?.width ?? 400);
+		drag_start_max_width = node[max_width_field] > 0 ? node[max_width_field] : (rect?.width ?? 400);
 		drag_start_aspect_ratio = resolved_aspect_ratio;
 		drag_start_visual_width = rect?.width ?? drag_start_max_width;
-		drag_start_visual_height = rect?.height ?? (drag_start_max_width / resolved_aspect_ratio);
+		drag_start_visual_height = rect?.height ?? drag_start_max_width / resolved_aspect_ratio;
 		const parent_rect = viewbox_el?.parentElement?.getBoundingClientRect();
 		drag_container_width = parent_rect?.width ?? drag_start_max_width;
 
@@ -241,8 +224,8 @@
 			const gap_left = rect.left - parent_rect.left;
 			const gap_right = parent_rect.right - rect.right;
 			const total_gap = gap_left + gap_right;
-			const is_centered = total_gap > 0
-				&& Math.abs(gap_left - gap_right) < Math.max(5, total_gap * 0.1);
+			const is_centered =
+				total_gap > 0 && Math.abs(gap_left - gap_right) < Math.max(5, total_gap * 0.1);
 			drag_width_multiplier = is_centered ? 2 : 1;
 		} else {
 			drag_width_multiplier = 1;
@@ -258,7 +241,10 @@
 		if (drag_type === 'width-right') {
 			const dx = client_x - drag_start_x;
 			// Clamp to container width — once you hit the edge, everything stops
-			const raw_width = Math.min(drag_container_width, Math.max(MIN_WIDTH, Math.round(drag_start_max_width + dx * drag_width_multiplier)));
+			const raw_width = Math.min(
+				drag_container_width,
+				Math.max(MIN_WIDTH, Math.round(drag_start_max_width + dx * drag_width_multiplier))
+			);
 
 			// Try to snap the width to a value that produces a common aspect ratio
 			// at the fixed visual height
@@ -312,7 +298,10 @@
 			const dy = client_y - drag_start_y;
 
 			// Both axes move freely; horizontal uses multiplier for centered images
-			const raw_width = Math.min(drag_container_width, Math.max(MIN_WIDTH, Math.round(drag_start_visual_width + dx * drag_width_multiplier)));
+			const raw_width = Math.min(
+				drag_container_width,
+				Math.max(MIN_WIDTH, Math.round(drag_start_visual_width + dx * drag_width_multiplier))
+			);
 			const raw_height = Math.max(MIN_HEIGHT, Math.round(drag_start_visual_height + dy));
 
 			// Try to snap to a common aspect ratio
@@ -372,7 +361,7 @@
 			capture_width_state('width-right');
 		},
 		on_move: handle_move,
-		on_up: handle_up,
+		on_up: handle_up
 	});
 
 	const drag_bottom = touch_drag({
@@ -382,7 +371,7 @@
 			capture_height_state();
 		},
 		on_move: handle_move,
-		on_up: handle_up,
+		on_up: handle_up
 	});
 
 	const drag_corner = touch_drag({
@@ -392,7 +381,7 @@
 			capture_corner_state();
 		},
 		on_move: handle_move,
-		on_up: handle_up,
+		on_up: handle_up
 	});
 
 	function handle_width_dblclick(e) {
@@ -422,39 +411,22 @@
 	}
 </script>
 
-<div
-	class="viewbox-handles"
-	style="position-anchor: {anchor_name};"
->
+<div class="viewbox-handles" style="position-anchor: {anchor_name};">
 	<!-- Right width handle -->
 	<!-- svelte-ignore a11y_no_static_element_interactions -->
-	<div
-		class="handle handle-right"
-		ondblclick={handle_width_dblclick}
-		{@attach drag_right}
-	>
+	<div class="handle handle-right" ondblclick={handle_width_dblclick} {@attach drag_right}>
 		<div class="handle-line"></div>
 	</div>
 
 	<!-- Bottom aspect ratio handle -->
 	<!-- svelte-ignore a11y_no_static_element_interactions -->
-	<div
-		class="handle handle-bottom"
-		ondblclick={handle_height_dblclick}
-		{@attach drag_bottom}
-	>
+	<div class="handle handle-bottom" ondblclick={handle_height_dblclick} {@attach drag_bottom}>
 		<div class="handle-line"></div>
 	</div>
 
 	<!-- Bottom-right corner handle (both axes) -->
 	<!-- svelte-ignore a11y_no_static_element_interactions -->
-	<div
-		class="handle handle-corner"
-		ondblclick={handle_corner_dblclick}
-		{@attach drag_corner}
-	>
-		
-	</div>
+	<div class="handle handle-corner" ondblclick={handle_corner_dblclick} {@attach drag_corner}></div>
 
 	<!-- Snap label tooltip -->
 	{#if snap_label}
@@ -541,8 +513,6 @@
 		opacity: 0.8;
 	}
 
-	
-
 	/* Snap label */
 	.snap-label {
 		position: absolute;
diff --git a/src/routes/components/Strong.svelte b/src/routes/components/Strong.svelte
index 084394c9..21a3cd5a 100644
--- a/src/routes/components/Strong.svelte
+++ b/src/routes/components/Strong.svelte
@@ -1,8 +1,10 @@
-<script>
-	import { getContext } from 'svelte';
-	const svedit = getContext('svedit');
-	let { path, content } = $props();
-	let node = $derived(svedit.session.get(path));
+<script lang="ts">
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
+	import { get_svedit_context } from '../svedit_context.js';
+	const svedit = get_svedit_context();
+	let { path, content }: { path: DocumentPath; content: string } = $props();
+	let node: Nodes['strong'] = $derived(svedit.session.get(path));
 </script>
 
 <strong class="font-semibold" id={node.id} data-node-id={node.id}>{content}</strong>
diff --git a/src/routes/components/SupportingMedia.svelte b/src/routes/components/SupportingMedia.svelte
index 7c89b67f..0a1920cd 100644
--- a/src/routes/components/SupportingMedia.svelte
+++ b/src/routes/components/SupportingMedia.svelte
@@ -1,13 +1,16 @@
-<script>
+<script lang="ts">
+	import { get_svedit_context } from '../svedit_context.js';
+	import type { Nodes } from '$lib/document_schema.js';
+	import type { DocumentPath } from 'svedit';
 	import { getContext } from 'svelte';
 	import { Node } from 'svedit';
 	import MediaProperty from './MediaProperty.svelte';
 	import SizableViewbox from './SizableViewbox.svelte';
 
-	const svedit = getContext('svedit');
-	const prose = getContext('prose');
-	let { path } = $props();
-	let node = $derived(svedit.session.get(path));
+	const svedit = get_svedit_context();
+	const prose = getContext<{ is_centered: boolean } | undefined>('prose');
+	let { path }: { path: DocumentPath } = $props();
+	let node: Nodes['supporting_media'] = $derived(svedit.session.get(path));
 	let render_as_link = $derived(!svedit.editable && node.href);
 
 	// The Prose or ProseGridItem node's layout determines alignment
diff --git a/src/routes/components/Toolbar.svelte b/src/routes/components/Toolbar.svelte
index b5516cb9..2b9d4432 100644
--- a/src/routes/components/Toolbar.svelte
+++ b/src/routes/components/Toolbar.svelte
@@ -1,5 +1,5 @@
-<script>
-	import { getContext } from 'svelte';
+<script lang="ts">
+	import { get_app_context } from '../app_context.js';
 	import { resolve } from '$app/paths';
 	import { get_page_browser } from './page_browser_context.svelte.js';
 	import { is_node_subtree_empty } from '../app_utils.js';
@@ -8,7 +8,7 @@
 	let { session, app_commands, editable, focus_canvas } = $props();
 
 	const page_browser = get_page_browser();
-	const app = getContext('app');
+	const app = get_app_context();
 
 	let cancel_command = $derived(app_commands.cancel_editing ?? null);
 	let cancel_button_label = $derived(cancel_command?.label || 'Cancel');
@@ -22,14 +22,14 @@
 	let is_media_selected = $derived(
 		selected_property?.type === 'image' || selected_property?.type === 'video'
 	);
-	let is_multi_node_selection = $derived(
-		session.selection?.type === 'node' &&
-			Math.abs(session.selection.focus_offset - session.selection.anchor_offset) > 1
-	);
 	let is_single_node_selection = $derived(
 		session.selection?.type === 'node' &&
 			Math.abs(session.selection.focus_offset - session.selection.anchor_offset) === 1
 	);
+	// The cycle-type/-layout buttons stay implemented (commands and shortcuts
+	// remain registered), but the variant selector is the primary visible UI.
+	const SHOW_CYCLE_TOOLS = false;
+
 	let can_show_cycle_tools = $derived(
 		is_single_node_selection ||
 			session.selection?.type === 'text' ||
@@ -472,7 +472,7 @@
 					<!-- Type / Layout group (always visible, disabled when not applicable) -->
 					<div class="flex items-center gap-1">
 						<!-- Keep these commands/keybindings, but use the variant selector as the visible UI. -->
-						{#if false && can_show_cycle_tools}
+						{#if SHOW_CYCLE_TOOLS && can_show_cycle_tools}
 							<!-- Type: cycle to next node type -->
 							<button
 								class="{TW_TOOLBAR_BTN} {should_pulse_cycle_type
diff --git a/src/routes/components/Video.svelte b/src/routes/components/Video.svelte
index 5064bc4b..02965afd 100644
--- a/src/routes/components/Video.svelte
+++ b/src/routes/components/Video.svelte
@@ -1,19 +1,16 @@
-<script>
+<script lang="ts">
 	import { ASSET_BASE } from '$lib/config.js';
 
-	/** @type {{ node: any, editable?: boolean }} */
-	let { node, editable = false } = $props();
+	import type { PreviewMediaNode } from '$lib/page_metadata.js';
+
+	let { node, editable = false }: { node: PreviewMediaNode; editable?: boolean } = $props();
 
 	// Determine if src is a blob URL (unsaved), a saved asset id, or empty
 	let is_blob = $derived(node.src?.startsWith('blob:'));
 	let is_saved = $derived(node.src && !is_blob);
 
 	// Resolve the display URL
-	let display_src = $derived(
-		is_blob ? node.src :
-		is_saved ? `${ASSET_BASE}/${node.src}` :
-		''
-	);
+	let display_src = $derived(is_blob ? node.src : is_saved ? `${ASSET_BASE}/${node.src}` : '');
 
 	// Apply scale to video (same as Image.svelte)
 	let video_style = $derived(`
@@ -23,8 +20,7 @@
 		object-fit: ${node.object_fit};
 	`);
 
-	/** @type {HTMLVideoElement | null} */
-	let video_el = $state(null);
+	let video_el = $state<HTMLVideoElement | null>(null);
 	let is_fullscreen = $state(false);
 
 	// Autoplay handling — try multiple strategies since the element may be
@@ -59,8 +55,7 @@
 		};
 	});
 
-	/** @param {MouseEvent} e */
-	function enter_fullscreen(e) {
+	function enter_fullscreen(e: MouseEvent) {
 		// Only allow fullscreen in published view (not editable)
 		if (editable) return;
 		e.preventDefault();
@@ -73,10 +68,10 @@
 
 		if (v.requestFullscreen) {
 			v.requestFullscreen();
-		} else if (/** @type {any} */ (v).webkitEnterFullscreen) {
-			/** @type {any} */ (v).webkitEnterFullscreen();
-		} else if (/** @type {any} */ (v).webkitRequestFullscreen) {
-			/** @type {any} */ (v).webkitRequestFullscreen();
+		} else if ((v as any).webkitEnterFullscreen) {
+			(v as any).webkitEnterFullscreen();
+		} else if ((v as any).webkitRequestFullscreen) {
+			(v as any).webkitRequestFullscreen();
 		}
 	}
 
@@ -106,8 +101,7 @@
 		// Standard Fullscreen API (Chrome, Firefox, Safari desktop)
 		function handle_fullscreen_change() {
 			if (!v) return;
-			const fs = document.fullscreenElement
-				|| /** @type {any} */ (document).webkitFullscreenElement;
+			const fs = document.fullscreenElement || (document as any).webkitFullscreenElement;
 			if (fs === v) {
 				is_fullscreen = true;
 			} else if (!fs) {
@@ -140,7 +134,6 @@
 </script>
 
 {#if display_src}
-	<!-- svelte-ignore a11y_media_has_caption -->
 	<video
 		bind:this={video_el}
 		contenteditable="false"
@@ -170,4 +163,4 @@
 	video.clickable {
 		cursor: zoom-in;
 	}
-</style>
\ No newline at end of file
+</style>
diff --git a/src/routes/components/page_browser_context.svelte.js b/src/routes/components/page_browser_context.svelte.ts
similarity index 55%
rename from src/routes/components/page_browser_context.svelte.js
rename to src/routes/components/page_browser_context.svelte.ts
index 6b3bc7fd..ddfaafc6 100644
--- a/src/routes/components/page_browser_context.svelte.js
+++ b/src/routes/components/page_browser_context.svelte.ts
@@ -1,17 +1,25 @@
 import { createContext } from 'svelte';
+import type { PageTreeNode } from '$lib/api.remote.js';
 
-export const [get_page_browser, set_page_browser] = createContext();
+export type PageBrowser = ReturnType<typeof create_page_browser> & {
+	/** Reactive data version, installed by App.svelte (bumped on invalidation). */
+	version?: number;
+	/** Refetches page browser data, installed by App.svelte. */
+	invalidate?: () => void;
+};
 
-/**
- * @param {{ goto: (href: string) => Promise<void> | void, is_admin: () => boolean }} options
- */
-export function create_page_browser(options) {
+export const [get_page_browser, set_page_browser] = createContext<PageBrowser>();
+
+export function create_page_browser(options: {
+	goto: (href: string) => Promise<void> | void;
+	is_admin: () => boolean;
+}) {
 	const { goto, is_admin } = options;
 
 	const state = $state({
 		open: false,
-		mode: 'navigate',
-		on_select_page: null
+		mode: 'navigate' as 'navigate' | 'select',
+		on_select_page: null as ((page: PageTreeNode) => void) | null
 	});
 
 	function reset() {
@@ -27,7 +35,7 @@ export function create_page_browser(options) {
 		state.open = true;
 	}
 
-	function open_select(on_select_page) {
+	function open_select(on_select_page: (page: PageTreeNode) => void) {
 		if (!is_admin()) return;
 		state.mode = 'select';
 		state.on_select_page = on_select_page;
@@ -38,7 +46,7 @@ export function create_page_browser(options) {
 		reset();
 	}
 
-	function handle_page_selected(page) {
+	function handle_page_selected(page: PageTreeNode) {
 		if (state.mode === 'select' && state.on_select_page) {
 			state.on_select_page(page);
 			reset();
@@ -51,7 +59,11 @@ export function create_page_browser(options) {
 		}
 	}
 
-	async function handle_page_deleted(document_id, home_page_id, current_document_id) {
+	async function handle_page_deleted(
+		document_id: string,
+		home_page_id: string | null,
+		current_document_id: string | null
+	) {
 		if (current_document_id !== document_id) return;
 
 		reset();
@@ -70,4 +82,4 @@ export function create_page_browser(options) {
 		handle_page_selected,
 		handle_page_deleted
 	};
-}
\ No newline at end of file
+}
diff --git a/src/routes/create_session.js b/src/routes/create_session.ts
similarity index 93%
rename from src/routes/create_session.js
rename to src/routes/create_session.ts
index fcdbd163..3084f711 100644
--- a/src/routes/create_session.js
+++ b/src/routes/create_session.ts
@@ -11,6 +11,14 @@ import {
 	SelectParentCommand,
 	fill_document_defaults
 } from 'svedit';
+import type {
+	Document,
+	DocumentNode,
+	DocumentPath,
+	NodeSelection,
+	Text,
+	Transaction
+} from 'svedit';
 import nanoid from './nanoid.js';
 import {
 	CycleLayoutCommand,
@@ -82,25 +90,30 @@ import { MEDIA_DEFAULTS } from '$lib/config.js';
 import { set_properties } from 'svedit';
 import { get_media_dimensions } from '$lib/client/media_dimensions.js';
 
-/** @returns {'image' | 'video'} */
-function get_media_type(file) {
+function get_media_type(file: File): 'image' | 'video' {
 	if (file.type.startsWith('video/')) return 'video';
 	return 'image';
 }
 
-function select_inserted_text_property(tr, property_name = 'label', child_path = []) {
+function select_inserted_text_property(
+	tr: Transaction,
+	property_name = 'label',
+	child_path: DocumentPath = []
+) {
+	// Right after an insert the selection is a node selection over the new node.
+	const selection = tr.selection as NodeSelection;
 	tr.set_selection({
 		type: 'text',
-		path: [...tr.selection.path, tr.selection.focus_offset - 1, ...child_path, property_name],
+		path: [...selection.path, selection.focus_offset - 1, ...child_path, property_name],
 		anchor_offset: 0,
 		focus_offset: 0
 	});
 }
 
 function insert_text_node(
-	tr,
-	node_type,
-	content = { content: '', marks: [], annotations: [] },
+	tr: Transaction,
+	node_type: string,
+	content: Text = { content: '', marks: [], annotations: [] },
 	layout = 'default'
 ) {
 	const new_text = {
@@ -111,9 +124,11 @@ function insert_text_node(
 	};
 	tr.create(new_text);
 	tr.insert_nodes([new_text.id]);
+	// Right after an insert the selection is a node selection over the new node.
+	const selection = tr.selection as NodeSelection;
 	tr.set_selection({
 		type: 'text',
-		path: [...tr.selection.path, tr.selection.focus_offset - 1, 'content'],
+		path: [...selection.path, selection.focus_offset - 1, 'content'],
 		anchor_offset: 0,
 		focus_offset: 0
 	});
@@ -122,13 +137,14 @@ function insert_text_node(
 /**
  * Replace a media node at the given path with a new file.
  * Reused by handle_media_paste and the toolbar's replace-image button.
- *
- * @param {import('svedit').Session} session
- * @param {any[]} path - path to the media node (image/video)
- * @param {File} file
- * @param {string} blob_url - a blob: or data: URL for immediate display
+ * blob_url is a blob: or data: URL for immediate display.
  */
-async function replace_media(session, path, file, blob_url) {
+async function replace_media(
+	session: AppSession,
+	path: DocumentPath,
+	file: File,
+	blob_url: string
+) {
 	const node = session.get(path);
 	if (node.type !== 'image' && node.type !== 'video') return;
 
@@ -253,7 +269,10 @@ const session_config = {
 			}
 			return null;
 		} else {
-			const pasted_json = { main_nodes: [], nodes: {} };
+			const pasted_json: { main_nodes: string[]; nodes: Record<string, DocumentNode> } = {
+				main_nodes: [],
+				nodes: {}
+			};
 
 			// When cursor inside an image grid we want to insert a gallery_item,
 			// otherwise insert a figure.
@@ -333,9 +352,6 @@ const session_config = {
 	/**
 	 * Factory function to create Svedit commands and keymap.
 	 * Called by Svedit component with the svedit context.
-	 *
-	 * @param {object} context - The svedit context with session, editable, canvas.
-	 * @returns {{ commands: object, keymap: object }}
 	 */
 	create_commands_and_keymap: (context) => {
 		// Create command instances with the provided context
@@ -607,7 +623,7 @@ const session_config = {
 
 			tr.insert_nodes([new_feature_id]);
 		},
-		figure: function (tr, content = { content: '', marks: [], annotations: [] }, layout = 'wide') {
+		figure: function (tr, _content = { content: '', marks: [], annotations: [] }, layout = 'wide') {
 			const new_figure_id = tr.build('new_figure', {
 				image_one: {
 					id: 'image_one',
@@ -628,8 +644,8 @@ const session_config = {
 		},
 		captioned_figure: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
-			layout = 'default'
+			_content = { content: '', marks: [], annotations: [] },
+			_layout = 'default'
 		) {
 			const new_captioned_figure_id = tr.build('new_captioned_figure', {
 				image_one: {
@@ -651,8 +667,8 @@ const session_config = {
 		},
 		supporting_media: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
-			layout = 'default'
+			_content = { content: '', marks: [], annotations: [] },
+			_layout = 'default'
 		) {
 			const new_supporting_media_id = tr.build('new_supporting_media', {
 				image_one: {
@@ -673,8 +689,8 @@ const session_config = {
 		},
 		nav_link: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
-			layout = 'default'
+			_content = { content: '', marks: [], annotations: [] },
+			_layout = 'default'
 		) {
 			const new_nav_link_id = tr.build('new_nav_link', {
 				new_nav_link: {
@@ -688,7 +704,7 @@ const session_config = {
 		},
 		nav_button: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
+			_content = { content: '', marks: [], annotations: [] },
 			layout = 'primary'
 		) {
 			const new_nav_button_id = tr.build('new_nav_button', {
@@ -723,8 +739,8 @@ const session_config = {
 
 		button: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
-			layout = 'primary'
+			_content = { content: '', marks: [], annotations: [] },
+			_layout = 'primary'
 		) {
 			const new_button_id = tr.build('new_button', {
 				new_button: {
@@ -765,8 +781,8 @@ const session_config = {
 		},
 		footer_link: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
-			layout = 'default'
+			_content = { content: '', marks: [], annotations: [] },
+			_layout = 'default'
 		) {
 			const new_footer_link_id = tr.build('new_footer_link', {
 				new_footer_link: {
@@ -781,7 +797,7 @@ const session_config = {
 		footer_link_category: function (
 			tr,
 			content = { content: '', marks: [], annotations: [] },
-			layout = 'default'
+			_layout = 'default'
 		) {
 			const new_footer_link_category_id = tr.build('new_footer_link_category', {
 				new_footer_link_category: {
@@ -796,8 +812,8 @@ const session_config = {
 		},
 		footer_link_column: function (
 			tr,
-			content = { content: '', marks: [], annotations: [] },
-			layout = 'default'
+			_content = { content: '', marks: [], annotations: [] },
+			_layout = 'default'
 		) {
 			const new_footer_link_column_id = tr.build('new_footer_link_column', {
 				new_footer_link_category: {
@@ -1046,7 +1062,10 @@ const session_config = {
 	}
 };
 
-export function create_session(doc) {
+/** The app's concrete schema-typed session type. */
+export type AppSession = Session<typeof document_schema>;
+
+export function create_session(doc: Document): AppSession {
 	const migrated_doc = fill_document_defaults(doc, document_schema);
 	const session = new Session(document_schema, migrated_doc, session_config);
 	return session;
diff --git a/src/routes/nanoid.js b/src/routes/nanoid.js
deleted file mode 100644
index 5924a9d9..00000000
--- a/src/routes/nanoid.js
+++ /dev/null
@@ -1,11 +0,0 @@
-import { customAlphabet } from "nanoid";
-
-const _nanoid = customAlphabet(
-  "ABCDEFGHJKMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz",
-  23
-);
-
-// A custom nanoid of length 23 with no numbers and no "_" or "-" to be used as HTML ids
-export default function nanoid() {
-  return _nanoid();
-}
diff --git a/src/routes/nanoid.ts b/src/routes/nanoid.ts
new file mode 100644
index 00000000..6dfa8174
--- /dev/null
+++ b/src/routes/nanoid.ts
@@ -0,0 +1,8 @@
+import { customAlphabet } from 'nanoid';
+
+const _nanoid = customAlphabet('ABCDEFGHJKMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz', 23);
+
+// A custom nanoid of length 23 with no numbers and no "_" or "-" to be used as HTML ids
+export default function nanoid() {
+	return _nanoid();
+}
diff --git a/src/routes/new/+page.server.js b/src/routes/new/+page.server.ts
similarity index 78%
rename from src/routes/new/+page.server.js
rename to src/routes/new/+page.server.ts
index 34d73fcf..e3136fd6 100644
--- a/src/routes/new/+page.server.js
+++ b/src/routes/new/+page.server.ts
@@ -1,9 +1,9 @@
 import { redirect } from '@sveltejs/kit';
 import { env } from '$env/dynamic/private';
+import type { PageServerLoad } from './$types';
 
-// Deliberately no `await parent()` here — see routes/+page.server.js.
-/** @type {import('./$types').PageServerLoad} */
-export async function load({ locals }) {
+// Deliberately no `await parent()` here — see routes/+page.server.ts.
+export const load: PageServerLoad = async ({ locals }) => {
 	if (env.VERCEL) {
 		return {
 			shared_documents: null
@@ -20,4 +20,4 @@ export async function load({ locals }) {
 	return {
 		shared_documents
 	};
-}
+};
diff --git a/src/routes/new/+page.svelte b/src/routes/new/+page.svelte
index 651f9fd4..d9df8b08 100644
--- a/src/routes/new/+page.svelte
+++ b/src/routes/new/+page.svelte
@@ -1,4 +1,4 @@
-<script>
+<script lang="ts">
 	import App from '../components/App.svelte';
 	import { create_empty_doc } from '$lib/new_page.js';
 
diff --git a/src/routes/reveal.js b/src/routes/reveal.ts
similarity index 86%
rename from src/routes/reveal.js
rename to src/routes/reveal.ts
index f536df98..649eea86 100644
--- a/src/routes/reveal.js
+++ b/src/routes/reveal.ts
@@ -3,12 +3,15 @@
 // Optionally pass a custom threshold: <div use:reveal={{ threshold: 0.2 }}>...</div>
 // Optionally pass a delay (ms): <div use:reveal={{ delay: 200 }}>...</div>
 
-export function reveal(node, options = {}) {
+export function reveal(
+	node: HTMLElement,
+	options: { threshold?: number; once?: boolean; delay?: number } = {}
+) {
 	const { threshold = 0.1, once = true, delay = 0 } = options;
 
 	node.classList.add('reveal-hidden');
 
-	let timeout_id;
+	let timeout_id: ReturnType<typeof setTimeout> | undefined;
 
 	const observer = new IntersectionObserver(
 		(entries) => {
@@ -44,4 +47,4 @@ export function reveal(node, options = {}) {
 			observer.disconnect();
 		}
 	};
-}
\ No newline at end of file
+}
diff --git a/src/routes/svedit_context.ts b/src/routes/svedit_context.ts
new file mode 100644
index 00000000..78b25215
--- /dev/null
+++ b/src/routes/svedit_context.ts
@@ -0,0 +1,19 @@
+import { getContext } from 'svelte';
+import type { SveditContext as BaseSveditContext } from 'svedit';
+import type { document_schema } from '$lib/document_schema.js';
+
+/**
+ * The svedit context as provided by Svedit.svelte, with the session typed
+ * against this app's document schema.
+ */
+export type SveditContext = BaseSveditContext<typeof document_schema>;
+
+/**
+ * Typed accessor for the svedit context. Use inside components rendered
+ * under a Svedit instance instead of `getContext('svedit')` — the returned
+ * session is schema-typed, so values returned from `session.get(path)` can be
+ * annotated with the app's `Nodes` map.
+ */
+export function get_svedit_context(): SveditContext {
+	return getContext('svedit') as SveditContext;
+}
diff --git a/src/routes/tailwind_theme.js b/src/routes/tailwind_theme.ts
similarity index 70%
rename from src/routes/tailwind_theme.js
rename to src/routes/tailwind_theme.ts
index e8dac92c..c0369888 100644
--- a/src/routes/tailwind_theme.js
+++ b/src/routes/tailwind_theme.ts
@@ -3,5 +3,3 @@
 
 export const TW_LIMITER = 'mx-auto max-w-7xl'; // px-2 md:px-4 lg:px-6 xl:px-8
 export const TW_PAGE_PADDING_X = 'px-5 sm:px-7';
-// When you want to sync vertical padding with the horizontal page padding
-export const TW_PAGE_PADDING = 'p-5 sm:p-7';
diff --git a/jsconfig.json b/tsconfig.json
similarity index 86%
rename from jsconfig.json
rename to tsconfig.json
index 8f745c39..9d2830db 100644
--- a/jsconfig.json
+++ b/tsconfig.json
@@ -10,7 +10,6 @@
 		"sourceMap": false,
 		"strict": false,
 		"moduleResolution": "bundler",
-		"declarationMap": true,
-		"declaration": true
+		"allowImportingTsExtensions": true
 	}
 }
diff --git a/vite.config.js b/vite.config.ts
similarity index 86%
rename from vite.config.js
rename to vite.config.ts
index d4664f1f..5ed73e9d 100644
--- a/vite.config.js
+++ b/vite.config.ts
@@ -15,9 +15,9 @@ export default defineConfig({
 			experimental: {
 				remoteFunctions: true
 			},
-			alias: {
-				'svedit': '../svedit/src/lib/index.js',
-			},
+			// alias: {
+			// 	svedit: '../svedit/src/lib/index.ts'
+			// },
 			compilerOptions: {
 				experimental: {
 					async: true
@@ -32,6 +32,6 @@ export default defineConfig({
 		format: 'es'
 	},
 	test: {
-		include: ['src/**/*.test.js']
+		include: ['src/**/*.test.ts']
 	}
 });