hono-decks 1.0.4 → 1.2.0

package/dist/node.js

@@ -1,4 +1,5 @@
-import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { mkdir, mkdtemp, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
 import { unified } from "unified";
 import remarkGfm from "remark-gfm";
@@ -7,8 +8,8 @@ import remarkParse from "remark-parse";
 import { compile } from "@mdx-js/mdx";
 import remarkDirective from "remark-directive";
 import { codeToHtml } from "shiki";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { existsSync, watch } from "node:fs";
-import { fileURLToPath } from "node:url";
 import { build } from "esbuild";
 import { lookup } from "node:dns/promises";
 import { isIP } from "node:net";
@@ -17,23 +18,23 @@ import { raw } from "hono/html";
 import { jsx } from "hono/jsx/jsx-runtime";
 import { HtmlEscapedCallbackPhase, resolveCallback } from "hono/utils/html";
 //#region src/routing/file-routing.ts
-function resolveDeckFiles(paths, root = "decks") {
+function resolveDeckFiles(paths, root = "decks", options = {}) {
 	const normalizedRoot = normalizePath$3(root).replace(/\/$/, "");
 	const decks = /* @__PURE__ */ new Map();
 	const assetsBySlug = /* @__PURE__ */ new Map();
 	for (const inputPath of paths.map(normalizePath$3).sort()) {
 		assertInsideRoot(inputPath, normalizedRoot);
 		const segments = inputPath.slice(normalizedRoot.length + 1).split("/");
-		if (segments.length === 1 && segments[0].endsWith(".mdx")) {
+		if (segments.length === 1 && (segments[0].endsWith(".mdx") || options.markdown && segments[0].endsWith(".md"))) {
 			addDeck(decks, {
-				slug: segments[0].replace(/\.mdx$/, ""),
+				slug: segments[0].replace(/\.mdx?$/, ""),
 				sourcePath: inputPath,
 				kind: "single-file",
 				assetPaths: []
 			});
 			continue;
 		}
-		if (segments.length === 2 && segments[1] === "deck.mdx") {
+		if (segments.length === 2 && (segments[1] === "deck.mdx" || options.markdown && segments[1] === "deck.md")) {
 			addDeck(decks, {
 				slug: segments[0],
 				sourcePath: inputPath,
@@ -51,7 +52,7 @@ function resolveDeckFiles(paths, root = "decks") {
 			if (deck?.kind === "directory") deck.assetPaths = assetPaths;
 			continue;
 		}
-		if (inputPath.endsWith(".mdx")) throw new Error(`Nested deck slugs are not supported in this slice: ${inputPath}`);
+		if (inputPath.endsWith(".mdx") || options.markdown && inputPath.endsWith(".md")) throw new Error(`Nested deck slugs are not supported in this slice: ${inputPath}`);
 	}
 	return [...decks.values()].map((deck) => ({
 		...deck,
@@ -1184,8 +1185,8 @@ import { configureDecks, defineDecks } from ${JSON.stringify(DECKS_ADVANCED_ENTR
 import type { ConfiguredDecks, DecksConfig } from ${runtimeEntry};
 import type { Env } from "hono";
 import { decksClientEntry } from "./client-entry";
-${input.decks.flatMap((deck) => deck.slideModules.map((slide, index) => `import ${slideImportName(deck.deck.slug, index)} from ${JSON.stringify(slide.importPath)};`)).join("\n")}
-${input.decks.filter((deck) => deck.componentModulePath).map((deck) => `import * as ${componentImportName(deck.deck.slug)} from ${JSON.stringify(deck.componentModulePath)};`).join("\n")}
+${input.decks.flatMap((deck, deckIndex) => deck.slideModules.map((slide, index) => `import ${slideImportName(deckIndex, index)} from ${JSON.stringify(slide.importPath)};`)).join("\n")}
+${input.decks.flatMap((deck, deckIndex) => deck.componentModulePath ? [`import * as ${componentImportName(deckIndex)} from ${JSON.stringify(deck.componentModulePath)};`] : []).join("\n")}
 
 function withClientComponentIds(module, clientIds) {
   const registry = {};
@@ -1205,7 +1206,7 @@ function withClientComponentIds(module, clientIds) {
 const generatedDecks = defineDecks({
   clientEntryAsset: decksClientEntry,
   decks: [
-${input.decks.map(emitDeckObject).join(",\n")}
+${input.decks.map((deck, deckIndex) => emitDeckObject(deck, deckIndex)).join(",\n")}
   ]
 });
 
@@ -1218,15 +1219,16 @@ function definedDecksFor<E extends Env>() {
 }
 `;
 }
-function emitDeckObject(deck) {
+function emitDeckObject(deck, deckIndex) {
 	return `    {
       slug: ${JSON.stringify(deck.deck.slug)},
       sourcePath: ${JSON.stringify(deck.deck.sourcePath)},
       kind: ${JSON.stringify(deck.deck.kind)},
       meta: ${serializeValue(deck.deck.meta, 3)},
+${typeof deck.deck.clientEntryRequired === "boolean" ? `      clientEntryRequired: ${deck.deck.clientEntryRequired},\n` : ""}
 ${deck.deck.themeStyle ? `      "themeStyle": ${serializeValue(deck.deck.themeStyle, 3)},\n` : ""}${deck.deck.themeSourcePath ? `      "themeSourcePath": ${JSON.stringify(deck.deck.themeSourcePath)},\n` : ""}
       assets: ${serializeValue(deck.deck.assets, 3)},
-      componentRegistry: ${deck.componentModulePath ? `withClientComponentIds(${componentImportName(deck.deck.slug)}, ${serializeValue(deck.clientComponentIds ?? {}, 3)})` : "{}"},
+      componentRegistry: ${deck.componentModulePath ? `withClientComponentIds(${componentImportName(deckIndex)}, ${serializeValue(deck.clientComponentIds ?? {}, 3)})` : "{}"},
       warnings: ${serializeValue(deck.deck.warnings, 3)},
       slides: [
 ${deck.deck.slides.map((slide) => `        {
@@ -1235,19 +1237,16 @@ ${deck.deck.slides.map((slide) => `        {
           html: "",
           components: [],
           notes: ${serializeValue(slide.notes, 5)},
-          render: ${slideImportName(deck.deck.slug, slide.index)}
+          render: ${slideImportName(deckIndex, slide.index)}
         }`).join(",\n")}
       ]
     }`;
 }
-function slideImportName(slug, index) {
-	return `Slide_${safeIdentifier$1(slug)}_${index}`;
+function slideImportName(deckIndex, slideIndex) {
+	return `Slide_${deckIndex}_${slideIndex}`;
 }
-function componentImportName(slug) {
-	return `Components_${safeIdentifier$1(slug)}`;
-}
-function safeIdentifier$1(value) {
-	return value.replace(/[^A-Za-z0-9_$]+/g, "_").replace(/^[^A-Za-z_$]+/, "_") || "_";
+function componentImportName(deckIndex) {
+	return `Components_${deckIndex}`;
 }
 function serializeValue(value, depth) {
 	const indent = "  ".repeat(depth);
@@ -1699,6 +1698,191 @@ function extractDeckPrelude(source) {
 	};
 }
 //#endregion
+//#region src/node/markdown-decks.ts
+async function compileMarkdownDecks(input, adapter) {
+	const markdownEntries = input.decks.filter((entry) => entry.sourcePath.endsWith(".md"));
+	const mdx = await compileMdxModuleDecks({
+		...input,
+		decks: input.decks.filter((entry) => !entry.sourcePath.endsWith(".md"))
+	});
+	if (!markdownEntries.length) return mdx;
+	const decks = [...mdx.decks];
+	const clients = /* @__PURE__ */ new Set();
+	const markdownIslands = /* @__PURE__ */ new Map();
+	for (const entry of markdownEntries) try {
+		const source = await input.readText(entry.sourcePath);
+		const parsed = adapter.read(source);
+		if (input.clientComponentIds?.[entry.slug] && Object.keys(input.clientComponentIds[entry.slug]).length) throw new Error("Void Markdown slides support static components only; use MDX for hono-decks client components.");
+		const warnings = [];
+		const meta = toDeckFrontmatter(parsed.frontmatter, warnings);
+		addUnknownFrontmatterWarnings(warnings, meta.meta, "deck");
+		const assets = [...await buildAssetRefs(entry.slug, entry.assetPaths, input), ...buildExternalAssetRefs([
+			...collectMarkdownAssetCandidates(parsed.content),
+			...collectFrontmatterAssetCandidates(meta.assets),
+			...collectFrontmatterAssetCandidates(parsed.frontmatter.background)
+		])];
+		const candidates = [
+			...collectMarkdownAssetCandidates(parsed.content),
+			...collectFrontmatterAssetCandidates(parsed.frontmatter.assets),
+			...collectFrontmatterAssetCandidates(parsed.frontmatter.background)
+		];
+		if (entry.kind === "single-file" && candidates.some(isLocalRelativeAssetCandidate)) throw new Error("Single-file Markdown decks cannot reference local relative assets; use a directory deck.");
+		let clientEntryRequired = false;
+		const slideModules = [];
+		const slides = [];
+		for (const [index, slideSource] of splitMarkdownSlides(parsed.content).entries()) {
+			const prelude = parsed.script ? `<script>\n${parsed.script}\n<\/script>\n` : "";
+			const slide = adapter.read(prelude + slideSource);
+			const path = `${input.outDir}/decks/${entry.slug}/slide-${index}.ts`;
+			const rewritten = rewriteAssetUrls(`${prelude}---\n${JSON.stringify({
+				...parsed.frontmatter,
+				...slide.frontmatter
+			})}\n---\n${slide.content}`, assets);
+			const result = await adapter.compile(rewritten, { sourcePath: resolve(input.cwd ?? process.cwd(), entry.sourcePath) });
+			clientEntryRequired ||= Boolean(result.clientCode || result.islands?.length);
+			if (result.clientCode) clients.add(result.clientCode);
+			for (const island of result.islands ?? []) markdownIslands.set(island.id, island);
+			const slideMeta = toSlideFrontmatter(slide.frontmatter, warnings, {
+				slideIndex: index,
+				fallbackTitle: result.headings[0]?.text,
+				fallbackTransition: meta.transition,
+				fallbackTransitionDuration: meta.transitionDuration,
+				fallbackTransitionEasing: meta.transitionEasing
+			});
+			addUnknownFrontmatterWarnings(warnings, slideMeta.meta, "slide", index);
+			slideModules.push({
+				path,
+				importPath: `./decks/${entry.slug}/slide-${index}`,
+				code: `// @ts-nocheck\n${rewriteRelativeMdxImports(result.code, dirname$1(entry.sourcePath), dirname$1(path))}`
+			});
+			slides.push({
+				index,
+				meta: slideMeta,
+				html: "",
+				components: [],
+				notes: slideMeta.notes
+			});
+		}
+		addExternalAssetWarnings(warnings, assets);
+		const themeStyle = input.themeStyles?.[entry.slug];
+		decks.push({
+			deck: {
+				slug: entry.slug,
+				sourcePath: entry.sourcePath,
+				kind: entry.kind,
+				clientEntryRequired,
+				meta,
+				slides,
+				assets,
+				warnings,
+				themeStyle: themeStyle?.style,
+				themeSourcePath: themeStyle?.sourcePath
+			},
+			slideModules
+		});
+	} catch (error) {
+		throw new CompileError(`Void Markdown compile failed in ${entry.sourcePath}: ${error instanceof Error ? error.message : String(error)}`, "void-markdown-compile-error");
+	}
+	decks.sort((a, b) => a.deck.slug.localeCompare(b.deck.slug));
+	return {
+		decks,
+		routerModule: emitModuleDecksRouter({ decks }),
+		clientCode: [...clients].join("\n"),
+		clientModules: [adapter.client([...markdownIslands.values()])].filter(Boolean),
+		markdownIslands: [...markdownIslands.values()]
+	};
+}
+/** Protect fenced code from the deck separator parser. */
+function splitMarkdownSlides(source) {
+	const fences = [];
+	let prefix = "HONO_DECKS_FENCE_";
+	while (source.includes(prefix)) prefix += "_";
+	const lines = source.replace(/\r\n/g, "\n").split("\n");
+	const protectedLines = [];
+	for (let index = 0; index < lines.length; index++) {
+		const open = /^ {0,3}(`{3,}|~{3,})/.exec(lines[index]);
+		if (/^[ \t]+---[ \t]*$/.test(lines[index])) {
+			protectedLines.push(`${prefix}${fences.push(lines[index]) - 1}_END`);
+			continue;
+		}
+		if (!open) {
+			protectedLines.push(lines[index]);
+			continue;
+		}
+		const block = [lines[index]];
+		const close = new RegExp(`^ {0,3}${open[1][0]}{${open[1].length},}[ \\t]*$`);
+		let closed = false;
+		while (++index < lines.length) {
+			block.push(lines[index]);
+			if (close.test(lines[index])) {
+				closed = true;
+				break;
+			}
+		}
+		if (!closed) throw new Error("Markdown code fence is not closed.");
+		protectedLines.push(`${prefix}${fences.push(block.join("\n")) - 1}_END`);
+	}
+	return splitSlideSources(protectedLines.join("\n")).map((slide) => slide.replace(new RegExp(`${prefix}(\\d+)_END`, "g"), (_, id) => fences[Number(id)]));
+}
+//#endregion
+//#region src/adapters/hono-markdown.ts
+/** Node-only bridge. Existing Void configs retain their original compiler/runtime pair. */
+async function createHonoMarkdownAdapter(cwd, legacy = false, options) {
+	const require = createRequire(resolve(cwd, "package.json"));
+	const entry = legacy ? "void-plugin-hono-jsx/markdown/compiler" : "@ts-76/hono-markdown/compiler";
+	let compiler;
+	try {
+		compiler = await import(pathToFileURL(require.resolve(entry)).href);
+	} catch (cause) {
+		throw new Error(`Hono Markdown requires ${legacy ? "its public /markdown/compiler API" : "@ts-76/hono-markdown/compiler"} and Markdown peers installed in the app.`, { cause });
+	}
+	const read = compiler.readMarkdownModule ?? compiler.readStaticMarkdown;
+	const compile = compiler.compileMarkdownModule ?? compiler.compileStaticMarkdown;
+	if (typeof read !== "function" || typeof compile !== "function") throw new Error("Missing standalone compiler API");
+	const runtime = entry.startsWith("void-plugin") ? "void-plugin-hono-jsx/markdown/client" : "@ts-76/hono-markdown/client";
+	return {
+		read,
+		compile: (source, input) => compile(source, {
+			...input,
+			options
+		}),
+		client: (islands) => emitMarkdownClient(islands, runtime)
+	};
+}
+function emitMarkdownClient(islands, runtime) {
+	if (!islands.length) return "";
+	const literal = (value) => JSON.stringify(value).replace(/</g, "\\u003c");
+	return `import { hydrateMarkdownIslands } from ${literal(runtime)};
+hydrateMarkdownIslands({ ${islands.map((island) => `${literal(island.id)}: () => import(${literal(island.modulePath)})`).join(",")} }, {
+  ready(element, start) {
+    const slide = element.closest('section[data-slide-state]');
+    if (!slide || slide.dataset.slideState === 'active') { start(); return; }
+    const observer = new MutationObserver(() => {
+      if (slide.dataset.slideState === 'active') { observer.disconnect(); start(); }
+    });
+    observer.observe(slide, { attributes: true, attributeFilter: ['data-slide-state'] });
+  }
+});`;
+}
+//#endregion
+//#region src/node/markdown-adapter.ts
+async function loadMarkdownAdapter(selection, cwd) {
+	if (selection === "void") return createHonoMarkdownAdapter(cwd, true);
+	if (selection.adapter === "hono-decks/adapters/hono-markdown") return createHonoMarkdownAdapter(cwd, false, selection.options);
+	const module = await import(pathToFileURL(createRequire(resolve(cwd, "package.json")).resolve(selection.adapter)).href);
+	if (typeof module.createMarkdownAdapter !== "function") throw new Error("Markdown adapter must export createMarkdownAdapter.");
+	const adapter = await module.createMarkdownAdapter({
+		cwd,
+		options: selection.options
+	});
+	if (![
+		adapter?.read,
+		adapter?.compile,
+		adapter?.client
+	].every((value) => typeof value === "function")) throw new Error("Markdown adapter must provide read, compile and client functions.");
+	return adapter;
+}
+//#endregion
 //#region src/generator/component-registry.ts
 function applyDeckComponentRegistry(input) {
 	const components = input.components.map((component) => ({
@@ -1809,10 +1993,12 @@ async function emitClientEntryModule(input) {
 			registrations.push(`${JSON.stringify(clientId)}: ${localName}`);
 		}
 	}
-	if (registrations.length === 0) return "export const decksClientEntry = \"\";\n";
-	const output = (await build({
+	const clientModules = input.clientModules ?? [];
+	if (registrations.length === 0 && clientModules.length === 0) return `export const decksClientEntry = ${JSON.stringify(input.extraCode ?? "")};\n`;
+	const result = await build({
 		stdin: {
-			contents: `import { hydrateSlideIslands } from "hono-decks/client";
+			contents: `${clientModules.join("\n")}
+import { hydrateSlideIslands } from "hono-decks/client";
 ${imports.join("\n")}
 
 hydrateSlideIslands({
@@ -1827,6 +2013,15 @@ hydrateSlideIslands({
 		},
 		bundle: true,
 		write: false,
+		outdir: join(input.cwd, ".hono-decks-client"),
+		loader: {
+			".svg": "dataurl",
+			".png": "dataurl",
+			".jpg": "dataurl",
+			".webp": "dataurl",
+			".woff2": "dataurl",
+			".woff": "dataurl"
+		},
 		format: "esm",
 		platform: "browser",
 		target: "es2022",
@@ -1836,9 +2031,12 @@ hydrateSlideIslands({
 		alias: { "hono-decks/client": resolveClientRuntimeEntry() },
 		sourcemap: false,
 		minify: false
-	})).outputFiles[0];
+	});
+	const output = result.outputFiles.find((file) => file.path.endsWith(".js"));
+	const css = result.outputFiles.filter((file) => file.path.endsWith(".css")).map((file) => file.text).join("\n");
+	input.onCss?.(css);
 	if (!output) throw new Error("Client entry did not produce output.");
-	return `export const decksClientEntry = ${JSON.stringify(output.text)};\n`;
+	return `export const decksClientEntry = ${JSON.stringify(output.text + (input.extraCode ? "\n" + input.extraCode : ""))};\n`;
 }
 function resolveClientRuntimeEntry() {
 	const built = fileURLToPath(new URL("./client.js", import.meta.url));
@@ -1966,6 +2164,63 @@ function slugForDeckPath(path, root) {
 	if (segments.length >= 3 && segments[1] === "assets") return segments[0];
 }
 //#endregion
+//#region src/node/file-transaction.ts
+/** Stage every file before publishing; restore the previous files on an I/O error.
+* Individual renames are atomic. This is rollback on failure, not a cross-process
+* or crash-atomic filesystem transaction. Failed rollback retains recovery files.
+*/
+async function publishGeneratedFiles(files, renameFile = rename) {
+	const staged = [];
+	const published = [];
+	let keepRecovery = false;
+	try {
+		if (new Set(files.map((file) => file.path)).size !== files.length) throw new Error("Generated output paths must be unique.");
+		for (const file of files) {
+			const parent = dirname(file.path);
+			await mkdir(parent, { recursive: true });
+			const dir = await mkdtemp(join(parent, ".hono-decks-"));
+			const entry = {
+				path: file.path,
+				dir,
+				next: join(dir, "next")
+			};
+			staged.push(entry);
+			await writeFile(entry.next, file.content, "utf8");
+			let previous;
+			try {
+				previous = await readFile(file.path);
+			} catch (error) {
+				if (error.code === "ENOENT") continue;
+				throw error;
+			}
+			entry.backup = join(dir, "previous");
+			await writeFile(entry.backup, previous);
+		}
+		for (const entry of staged) {
+			await renameFile(entry.next, entry.path);
+			published.push(entry);
+		}
+	} catch (error) {
+		const failures = [];
+		for (const entry of published.reverse()) try {
+			if (entry.backup) await renameFile(entry.backup, entry.path);
+			else await rm(entry.path, { force: true });
+		} catch (failure) {
+			failures.push(failure);
+		}
+		if (failures.length) {
+			keepRecovery = true;
+			throw new AggregateError([error, ...failures], `Generated output rollback failed. Recovery files remain in: ${staged.map((entry) => entry.dir).join(", ")}`);
+		}
+		throw error;
+	} finally {
+		if (!keepRecovery) await Promise.allSettled(staged.map((entry) => rm(entry.dir, {
+			recursive: true,
+			force: true
+		})));
+	}
+}
+//#endregion
 //#region src/node/ogp.ts
 const MAX_OGP_BYTES = 256 * 1024;
 const MAX_OGP_REDIRECTS = 3;
@@ -2152,10 +2407,16 @@ function isHttpUrl(value) {
 //#endregion
 //#region src/node/compile-decks.ts
 async function compileDecks(input) {
+	const compiled = await compileDeckModules(input);
+	await publishGeneratedFiles([...compiled.modules, ...compiled.cacheFile ? [compiled.cacheFile] : []]);
+	return compiled.result;
+}
+/** Shared by file output and Vite's in-memory module graph. Does not write files. */
+async function compileDeckModules(input) {
 	const out = normalizeRelativePath(input.out, "Output directory");
 	const root = normalizeDeckRoot(input.root);
 	const paths = await listFiles(input.cwd, join(input.cwd, root));
-	const resolved = resolveDeckFiles(paths, root);
+	const resolved = resolveDeckFiles(paths, root, { markdown: Boolean(input.markdown) });
 	const componentModulePaths = Object.fromEntries(resolved.flatMap((deck) => {
 		const path = deck.kind === "directory" ? findComponentModule(paths, root, deck.slug) : void 0;
 		return path ? [[deck.slug, path]] : [];
@@ -2183,7 +2444,9 @@ async function compileDecks(input) {
 		refresh: input.refreshOgp,
 		resolveOgp: input.resolveOgp ?? resolveOgpMetadata
 	});
-	const generated = await compileMdxModuleDecks({
+	const adapter = input.markdown && resolved.some((entry) => entry.sourcePath.endsWith(".md")) ? await loadMarkdownAdapter(input.markdown, input.cwd) : void 0;
+	const generated = await (adapter ? (value) => compileMarkdownDecks(value, adapter) : compileMdxModuleDecks)({
+		cwd: input.cwd,
 		root,
 		outDir: out,
 		mountPath: input.mountPath,
@@ -2195,20 +2458,57 @@ async function compileDecks(input) {
 		readText: (path) => readFile(join(input.cwd, path), "utf8"),
 		readBinary: (path) => readFile(join(input.cwd, path))
 	});
-	for (const deck of generated.decks) for (const slide of deck.slideModules) await writeTextFile(join(input.cwd, slide.path), slide.code);
-	await writeTextFile(join(input.cwd, out, "decks.ts"), generated.routerModule);
-	await writeTextFile(join(input.cwd, out, "client-entry.ts"), await emitClientEntryModule({
+	let clientCss = "";
+	const clientEntry = await emitClientEntryModule({
 		cwd: input.cwd,
 		clientEntries: clientEntryPaths,
-		clientComponentIds
-	}));
-	await ogpCache.write();
-	return { decks: generated.decks.map((deck) => deck.deck) };
+		clientComponentIds,
+		extraCode: generated.clientCode,
+		clientModules: generated.clientModules,
+		onCss: (css) => {
+			clientCss = css;
+		}
+	});
+	if (clientCss) {
+		for (const deck of generated.decks) if (deck.deck.clientEntryRequired || Object.keys(deck.clientComponentIds ?? {}).length) deck.deck.themeStyle = [deck.deck.themeStyle, clientCss].filter(Boolean).join("\n");
+		generated.routerModule = emitModuleDecksRouter({ decks: generated.decks });
+	}
+	const files = generated.decks.flatMap((deck) => deck.slideModules.map((slide) => ({
+		path: join(input.cwd, slide.path),
+		content: slide.code
+	})));
+	files.push({
+		path: join(input.cwd, out, "decks.ts"),
+		content: generated.routerModule
+	}, {
+		path: join(input.cwd, out, "client-entry.ts"),
+		content: clientEntry
+	});
+	return {
+		modules: files,
+		cacheFile: ogpCache.output(),
+		result: {
+			outDir: out,
+			routerModulePath: `${out}/decks.ts`,
+			decks: generated.decks.map(({ deck, slideModules }) => {
+				const { slides, componentRegistry: _componentRegistry, ...metadata } = deck;
+				return {
+					...metadata,
+					slides: slides.map((slide, index) => ({
+						index: slide.index,
+						meta: slide.meta,
+						notes: slide.notes,
+						modulePath: slideModules[index].path
+					}))
+				};
+			})
+		}
+	};
 }
 async function createOgpCacheResolver(input) {
 	if (!input.cacheFile) return {
 		resolveOgp: input.resolveOgp,
-		write: async () => void 0
+		output: () => void 0
 	};
 	const cachePath = join(input.cwd, normalizeRelativePath(input.cacheFile, "OGP cache file"));
 	const cache = await readOgpCache(cachePath);
@@ -2224,9 +2524,11 @@ async function createOgpCacheResolver(input) {
 			}
 			return metadata;
 		},
-		async write() {
-			if (!dirty) return;
-			await writeTextFile(cachePath, `${JSON.stringify(cache, null, 2)}\n`);
+		output() {
+			return dirty ? {
+				path: cachePath,
+				content: `${JSON.stringify(cache, null, 2)}\n`
+			} : void 0;
 		}
 	};
 }
@@ -2288,10 +2590,6 @@ async function buildDeckManifestFromPaths(input) {
 		readBinary: (path) => readFile(join(input.cwd, path))
 	});
 }
-async function writeTextFile(path, contents) {
-	await mkdir(dirname(path), { recursive: true });
-	await writeFile(path, contents, "utf8");
-}
 function findComponentModule(paths, root, slug) {
 	const base = `${normalizePath(root).replace(/\/$/, "")}/${slug}/components/index`;
 	return paths.find((path) => {
@@ -3087,6 +3385,108 @@ function controlIconPaths(name) {
 	}
 }
 //#endregion
+//#region src/renderer/presentation-style.ts
+const PRESENTATION_DESIGN_WIDTH = 1920;
+const PRESENTATION_DESIGN_HEIGHT = 1080;
+function presentationDesignCssVariables() {
+	return `--hono-decks-width:${PRESENTATION_DESIGN_WIDTH}px;--hono-decks-height:${PRESENTATION_DESIGN_HEIGHT}px`;
+}
+function basePresentationStyle() {
+	return `
+:root{color-scheme:light;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;font-size:32px;${presentationDesignCssVariables()};--hono-decks-transition-duration:.24s;--hono-decks-transition-easing:ease;--hono-decks-background:#fff;--hono-decks-color:#172033;--hono-decks-muted-color:#475569;--hono-decks-accent-color:#0369a1;--hono-decks-border-color:#cbd5e1;--hono-decks-inline-code-background:#f1f5f9;--hono-decks-code-background:#f1f5f9;--hono-decks-card-background:#f1f5f9;--hono-decks-card-image-background:#e2e8f0;--hono-decks-warning-background:#fef3c7;--hono-decks-warning-color:#854d0e;background:var(--hono-decks-background);color:var(--hono-decks-color)}
+html,body{margin:0;width:100%;height:100%;overflow:hidden}
+.hono-decks-stage{width:100vw;height:100vh;overflow:hidden;position:relative;display:grid;grid-template-columns:minmax(0,1fr);grid-template-rows:minmax(0,1fr);place-items:center}
+.hono-decks-deck{display:grid;gap:1rem;width:var(--hono-decks-width);height:var(--hono-decks-height);box-sizing:border-box;transform-origin:center}
+.slide{box-sizing:border-box;aspect-ratio:16/9;background:var(--hono-decks-background);color:var(--hono-decks-color);padding:1.8rem;overflow:hidden}
+.hono-decks-slide-content{width:100%;height:100%}
+.slide.layout-cover,.slide.layout-statement{display:flex;flex-direction:column;justify-content:center}
+.slide.layout-cover>.hono-decks-slide-content,.slide.layout-statement>.hono-decks-slide-content{display:flex;flex-direction:column;justify-content:center}
+.slide code{font-family:"SFMono-Regular","Cascadia Code","Liberation Mono",Menlo,Consolas,monospace;font-size:.9em;line-height:1.45}
+.slide :not(pre)>code{border-radius:6px;background:var(--hono-decks-inline-code-background);padding:.12em .34em}
+.slide pre{max-width:100%;overflow:auto;box-sizing:border-box;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-code-background);padding:1rem;tab-size:2;white-space:pre}
+.slide pre code{display:block;min-width:max-content;background:transparent;padding:0}
+.slide table{width:100%;margin:1rem 0;border-collapse:collapse}
+.slide th,.slide td{border:1px solid var(--hono-decks-border-color);padding:.4em .75em;text-align:left}
+.slide th{background:var(--hono-decks-card-background);font-weight:700}
+.slide del{color:var(--hono-decks-muted-color)}
+.slide li.task-list-item{list-style:none;margin-left:-1.4em}
+.slide li.task-list-item input[type=checkbox]{margin-right:.5em;vertical-align:middle}
+.hono-decks-code-block{margin:1rem 0;max-width:100%}
+.hono-decks-code-caption{display:inline-flex;margin:0 0 .4rem;border:1px solid var(--hono-decks-border-color);border-radius:6px;padding:.2rem .5rem;background:var(--hono-decks-inline-code-background);color:var(--hono-decks-muted-color);font-size:.82rem}
+.hono-decks-embed-frame{margin:1rem 0;max-width:100%}
+.hono-decks-embed-viewport{width:min(100%,72rem);overflow:hidden}
+.hono-decks-embed-viewport iframe{display:block;width:100%;height:100%;border:0}
+.hono-decks-embed-print-fallback{display:none}
+.hono-decks-embed-print-poster{display:block;width:100%;height:100%;object-fit:cover}
+.hono-decks-embed-fallback{margin:.45rem 0 0;color:var(--hono-decks-muted-color);font-size:.84rem}
+.hono-decks-embed-fallback a{color:inherit}
+.hono-decks-social-embed{margin:1rem 0;max-width:min(100%,42rem)}
+.hono-decks-social-card{margin:0;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);padding:1rem}
+.hono-decks-social-card p{margin:0 0 .75rem;line-height:1.55}
+.hono-decks-social-card footer{display:flex;flex-wrap:wrap;gap:.65rem;align-items:center;color:var(--hono-decks-muted-color);font-size:.9rem}
+.hono-decks-social-card a{color:inherit}
+.hono-decks-tweet-embed{margin:1rem 0;max-width:min(100%,42rem)}
+.hono-decks-tweet-embed .twitter-tweet{margin:0;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);padding:1rem}
+.hono-decks-tweet-embed .twitter-tweet a{color:inherit}
+.hono-decks-tweet-print-fallback{display:none}
+.hono-decks-link-card{margin:1rem 0;max-width:min(100%,42rem)}
+.hono-decks-link-card-anchor{display:grid;grid-template-columns:minmax(9rem,32%) minmax(0,1fr);gap:.75rem;align-items:stretch;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);padding:1rem;color:inherit;text-decoration:none}
+.hono-decks-link-card-body{display:grid;gap:.35rem;min-width:0}
+.hono-decks-link-card-image{width:100%;height:100%;max-height:10rem;aspect-ratio:16/9;object-fit:cover;border-radius:6px;background:var(--hono-decks-card-image-background)}
+.hono-decks-link-card-site{color:var(--hono-decks-accent-color);font-size:.8rem;text-transform:uppercase}
+.hono-decks-link-card-title{font-weight:700}
+.hono-decks-link-card-description{color:var(--hono-decks-muted-color);line-height:1.45}
+.hono-decks-link-card-label{color:var(--hono-decks-accent-color);font-size:.88rem}
+.mdx-hero{height:100%;display:grid;grid-template-columns:minmax(0,1fr) minmax(280px,42%);gap:1.8rem;align-items:center}
+.mdx-hero:not(.has-image){grid-template-columns:1fr}
+.mdx-hero-copy{min-width:0}
+.mdx-hero-eyebrow{margin:0 0 .75rem;color:var(--hono-decks-accent-color);text-transform:uppercase;font-size:.85rem;letter-spacing:0}
+.mdx-hero h1{margin:0;font-size:3rem;line-height:1.02}
+.mdx-hero-subtitle{margin:1rem 0 0;font-size:1.125rem;line-height:1.45;color:var(--hono-decks-muted-color)}
+.mdx-hero-image{width:100%;height:auto;max-height:756px;object-fit:contain;border-radius:8px}
+[data-hono-decks-fire]{--fire-duration:.18s;--fire-easing:ease;--fire-opacity:0;--fire-transform:translateY(.35rem);--fire-filter:none;visibility:visible;opacity:1;transform:none;filter:none;transition:visibility 0s linear 0s,opacity var(--fire-duration) var(--fire-easing),transform var(--fire-duration) var(--fire-easing),filter var(--fire-duration) var(--fire-easing)}
+[data-hono-decks-fire][data-fire-hidden]{visibility:hidden;opacity:var(--fire-opacity);transform:var(--fire-transform);filter:var(--fire-filter);transition-delay:var(--fire-duration),0s,0s,0s}
+[data-fire-effect=none]{--fire-duration:0s;--fire-transform:none}
+[data-fire-effect=fade]{--fire-transform:none}
+[data-fire-effect=fade-up]{--fire-transform:translateY(.85rem)}
+[data-fire-effect=scale]{--fire-transform:scale(.96)}
+body:not([data-overview-mode]) .hono-decks-deck{position:relative}
+body:not([data-overview-mode]) .slide{position:absolute;inset:0;width:100%;height:100%}
+.slide[data-active-transition]{transition:opacity var(--hono-decks-active-transition-duration,var(--hono-decks-slide-transition-duration,var(--hono-decks-transition-duration))) var(--hono-decks-active-transition-easing,var(--hono-decks-slide-transition-easing,var(--hono-decks-transition-easing))),transform var(--hono-decks-active-transition-duration,var(--hono-decks-slide-transition-duration,var(--hono-decks-transition-duration))) var(--hono-decks-active-transition-easing,var(--hono-decks-slide-transition-easing,var(--hono-decks-transition-easing)));will-change:opacity,transform}
+.slide[data-slide-state="inactive"]{visibility:hidden;pointer-events:none}
+.slide[data-slide-state="active"]{visibility:visible;opacity:1;transform:translate3d(0,0,0) scale(1)}
+.slide[data-active-transition="fade"][data-slide-state="entering"],.slide[data-active-transition="fade"][data-slide-state="leaving"],.slide[data-active-transition="view-transition"][data-slide-state="entering"],.slide[data-active-transition="view-transition"][data-slide-state="leaving"]{opacity:0}
+.slide[data-active-transition="fade-out"][data-slide-state="entering"]{opacity:1}
+.slide[data-active-transition="fade-out"][data-slide-state="leaving"]{opacity:0}
+.slide[data-active-transition="slide-left"][data-slide-direction="forward"][data-slide-state="entering"],.slide[data-active-transition="slide-right"][data-slide-direction="backward"][data-slide-state="leaving"]{transform:translate3d(100%,0,0)}
+.slide[data-active-transition="slide-left"][data-slide-direction="forward"][data-slide-state="leaving"],.slide[data-active-transition="slide-right"][data-slide-direction="backward"][data-slide-state="entering"]{transform:translate3d(-100%,0,0)}
+.slide[data-active-transition="slide-left"][data-slide-direction="backward"][data-slide-state="entering"],.slide[data-active-transition="slide-right"][data-slide-direction="forward"][data-slide-state="leaving"]{transform:translate3d(-100%,0,0)}
+.slide[data-active-transition="slide-left"][data-slide-direction="backward"][data-slide-state="leaving"],.slide[data-active-transition="slide-right"][data-slide-direction="forward"][data-slide-state="entering"]{transform:translate3d(100%,0,0)}
+.slide[data-active-transition="slide-up"][data-slide-direction="forward"][data-slide-state="entering"],.slide[data-active-transition="slide-down"][data-slide-direction="backward"][data-slide-state="leaving"]{transform:translate3d(0,100%,0)}
+.slide[data-active-transition="slide-up"][data-slide-direction="forward"][data-slide-state="leaving"],.slide[data-active-transition="slide-down"][data-slide-direction="backward"][data-slide-state="entering"]{transform:translate3d(0,-100%,0)}
+.slide[data-active-transition="slide-up"][data-slide-direction="backward"][data-slide-state="entering"],.slide[data-active-transition="slide-down"][data-slide-direction="forward"][data-slide-state="leaving"]{transform:translate3d(0,-100%,0)}
+.slide[data-active-transition="slide-up"][data-slide-direction="backward"][data-slide-state="leaving"],.slide[data-active-transition="slide-down"][data-slide-direction="forward"][data-slide-state="entering"]{transform:translate3d(0,100%,0)}
+body:not([data-overview-mode]) .slide[hidden]{display:none}
+body[data-overview-mode] .hono-decks-deck{grid-template-columns:repeat(auto-fit,minmax(260px,1fr))}
+body[data-overview-mode] .slide{cursor:pointer}
+body[data-presenter-mode] .speaker-notes{display:block;margin-top:1rem;padding:.75rem;border-radius:8px;background:var(--hono-decks-card-image-background)}
+.hono-decks-warnings{margin:1rem;padding:.75rem;border-radius:14px;background:var(--hono-decks-warning-background);color:var(--hono-decks-warning-color)}
+@media screen{html[data-hono-decks-print-preview]{width:auto;height:auto;min-height:100%;overflow:visible}
+body[data-hono-decks-print-preview]{min-height:100vh;overflow:auto;color-scheme:light;color:#000;--hono-decks-print-gap:6mm;--hono-decks-print-slot-height:80mm;--hono-decks-print-scale:.28}
+body[data-hono-decks-print-preview] .hono-decks-stage{display:block;width:auto;height:auto;min-height:100vh;overflow:visible;padding:12mm 0;box-sizing:border-box}
+body[data-hono-decks-print-preview] .hono-decks-deck{display:grid;grid-template-columns:1fr;grid-auto-rows:var(--hono-decks-print-slot-height);gap:var(--hono-decks-print-gap);width:calc(var(--hono-decks-print-slot-height) * 16 / 9);max-width:calc(100vw - 24px);height:auto;margin:0 auto;transform:none!important}
+body[data-hono-decks-print-preview] .slide{position:static;width:100%;max-width:100%;height:var(--hono-decks-print-slot-height);aspect-ratio:16/9;justify-self:center;align-self:center;padding:0;box-shadow:0 2px 10px rgba(15,23,42,.16);transition:none!important;transform:none!important}
+body[data-hono-decks-print-preview] .slide.layout-cover,body[data-hono-decks-print-preview] .slide.layout-statement{display:block}
+body[data-hono-decks-print-preview] .hono-decks-slide-content{width:var(--hono-decks-width);height:var(--hono-decks-height);box-sizing:border-box;padding:1.8rem;transform:scale(var(--hono-decks-print-scale));transform-origin:left top;overflow:hidden}
+body[data-hono-decks-print-preview]:not([data-overview-mode]) .slide[hidden]{display:block!important}
+body[data-hono-decks-print-preview] .slide[data-slide-state]{visibility:visible!important;opacity:1!important;transform:none!important}
+body[data-hono-decks-print-preview] [data-hono-decks-fire]{visibility:visible!important;opacity:1!important;transform:none!important;filter:none!important}}
+@page{size:A4 portrait;margin:12mm}
+@media print{:root{color-scheme:light;color:#000;--hono-decks-print-gap:6mm;--hono-decks-print-slot-height:80mm;--hono-decks-print-scale:.28}html,body{width:auto;height:auto;overflow:visible}.hono-decks-stage{display:block;width:auto;height:auto;overflow:visible}.hono-decks-deck{display:grid;grid-template-columns:1fr;grid-auto-rows:var(--hono-decks-print-slot-height);gap:var(--hono-decks-print-gap);width:calc(var(--hono-decks-print-slot-height) * 16 / 9);height:auto;margin:0 auto;transform:none!important}body:not([data-overview-mode]) .slide{position:relative}.slide{position:relative;width:100%;max-width:100%;height:var(--hono-decks-print-slot-height);aspect-ratio:16/9;justify-self:center;align-self:center;padding:0;page-break-after:auto;break-after:auto;break-inside:avoid;box-shadow:none;transition:none!important;transform:none!important}.slide.layout-cover,.slide.layout-statement{display:block}.hono-decks-slide-content{position:absolute;inset:0 auto auto 0;width:var(--hono-decks-width);height:var(--hono-decks-height);box-sizing:border-box;padding:1.8rem;zoom:var(--hono-decks-print-scale);overflow:hidden}.slide:nth-of-type(3n):not(:last-child){page-break-after:always;break-after:page}body:not([data-overview-mode]) .slide[hidden]{display:block!important}.slide[data-slide-state]{visibility:visible!important;opacity:1!important;transform:none!important}[data-hono-decks-fire]{visibility:visible!important;opacity:1!important;transform:none!important;filter:none!important}}
+@media print{.hono-decks-embed-viewport iframe,.hono-decks-tweet-embed iframe,.hono-decks-tweet-embed .twitter-tweet{display:none!important}.hono-decks-embed-print-fallback{display:grid;width:100%;height:100%;place-items:center;overflow:hidden;background:var(--hono-decks-card-background);color:var(--hono-decks-accent-color);text-decoration:none}.hono-decks-embed-print-fallback:has(.hono-decks-embed-print-poster){display:block}.hono-decks-embed-print-poster+span{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0)}.hono-decks-tweet-print-fallback{display:flex;min-height:12rem;align-items:center;justify-content:center;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);color:var(--hono-decks-accent-color);text-decoration:none}}
+@media (prefers-reduced-motion: reduce){*,*::before,*::after{scroll-behavior:auto!important;animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important;transition-delay:0s!important}.slide[data-active-transition]{transform:none!important}}`;
+}
+//#endregion
 //#region src/server/document.ts
 async function resolveDeckDocument(input, options, overrides) {
 	const page = {
@@ -3138,8 +3538,8 @@ function renderPresentationScript(nonce) {
   const slides = Array.from(document.querySelectorAll(".slide"));
   const stage = document.querySelector("[data-hono-decks-stage]");
   const deck = document.querySelector("[data-hono-decks-deck]");
-  const DESIGN_WIDTH = 1920;
-  const DESIGN_HEIGHT = 1080;
+  const DESIGN_WIDTH = ${PRESENTATION_DESIGN_WIDTH};
+  const DESIGN_HEIGHT = ${PRESENTATION_DESIGN_HEIGHT};
   let index = 0;
   let previousIndex = 0;
   let stepIndex = 0;
@@ -3524,6 +3924,10 @@ function renderPresentationScript(nonce) {
   });
 
   document.addEventListener("keydown", (event) => {
+    if (event.defaultPrevented || event.metaKey || event.ctrlKey || event.altKey) return;
+    const target = event.target;
+    if (target instanceof HTMLElement && (target.isContentEditable || target.closest("input,textarea,select,button,a[href],[role=textbox],[role=button],[role=slider]"))) return;
+    if (["ArrowRight", "ArrowLeft", " "].includes(event.key)) event.preventDefault();
     if (event.key === "ArrowRight" || event.key === " ") handleCommand("next");
     if (event.key === "ArrowLeft") handleCommand("previous");
     if (event.key === "f") handleCommand("fullscreen");
@@ -3543,6 +3947,9 @@ function renderPresentationScript(nonce) {
   window.__honoDecksPresentationRuntime = { command: handleCommand };
 
   window.addEventListener("resize", fitDeck);
+  if (typeof ResizeObserver !== "undefined" && stage instanceof HTMLElement) {
+    new ResizeObserver(fitDeck).observe(stage);
+  }
   fitDeck();
   const initialState = readInitialState();
   show(initialState.index, initialState.stepIndex);
@@ -3553,109 +3960,6 @@ function escapeHtml$7(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
 }
 //#endregion
-//#region src/renderer/presentation-style.ts
-const PRESENTATION_DESIGN_WIDTH = 1920;
-const PRESENTATION_DESIGN_HEIGHT = 1080;
-function presentationDesignCssVariables() {
-	return `--hono-decks-width:${PRESENTATION_DESIGN_WIDTH}px;--hono-decks-height:${PRESENTATION_DESIGN_HEIGHT}px`;
-}
-function basePresentationStyle() {
-	return `
-:root{color-scheme:dark;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;font-size:32px;${presentationDesignCssVariables()};--hono-decks-transition-duration:.24s;--hono-decks-transition-easing:ease;--hono-decks-color:#eef2ff;--hono-decks-muted-color:#cbd5e1;--hono-decks-accent-color:#8bd3ff;--hono-decks-border-color:rgba(148,163,184,.24);--hono-decks-inline-code-background:rgba(15,23,42,.72);--hono-decks-code-background:rgba(15,23,42,.78);--hono-decks-card-background:rgba(15,23,42,.78);--hono-decks-card-image-background:rgba(255,255,255,.08);--hono-decks-warning-background:rgba(255,193,7,.12);--hono-decks-warning-color:#ffe59b;color:var(--hono-decks-color)}
-html,body{margin:0;width:100%;height:100%;overflow:hidden}
-.hono-decks-stage{width:100vw;height:100vh;overflow:hidden;position:relative;display:grid;place-items:center}
-.hono-decks-deck{display:grid;gap:1rem;width:var(--hono-decks-width);height:var(--hono-decks-height);box-sizing:border-box;transform-origin:left top}
-.slide{box-sizing:border-box;aspect-ratio:16/9;padding:clamp(1.2rem,3vw,3rem);overflow:hidden}
-.hono-decks-slide-content{width:100%;height:100%}
-.slide.layout-cover,.slide.layout-statement{display:flex;flex-direction:column;justify-content:center}
-.slide.layout-cover>.hono-decks-slide-content,.slide.layout-statement>.hono-decks-slide-content{display:flex;flex-direction:column;justify-content:center}
-.slide code{font-family:"SFMono-Regular","Cascadia Code","Liberation Mono",Menlo,Consolas,monospace;font-size:.9em;line-height:1.45}
-.slide :not(pre)>code{border-radius:6px;background:var(--hono-decks-inline-code-background);padding:.12em .34em}
-.slide pre{max-width:100%;overflow:auto;box-sizing:border-box;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-code-background);padding:1rem;tab-size:2;white-space:pre}
-.slide pre code{display:block;min-width:max-content;background:transparent;padding:0}
-.slide table{width:100%;margin:1rem 0;border-collapse:collapse}
-.slide th,.slide td{border:1px solid var(--hono-decks-border-color);padding:.4em .75em;text-align:left}
-.slide th{background:var(--hono-decks-card-background);font-weight:700}
-.slide del{color:var(--hono-decks-muted-color)}
-.slide li.task-list-item{list-style:none;margin-left:-1.4em}
-.slide li.task-list-item input[type=checkbox]{margin-right:.5em;vertical-align:middle}
-.hono-decks-code-block{margin:1rem 0;max-width:100%}
-.hono-decks-code-caption{display:inline-flex;margin:0 0 .4rem;border:1px solid var(--hono-decks-border-color);border-radius:6px;padding:.2rem .5rem;background:var(--hono-decks-inline-code-background);color:var(--hono-decks-muted-color);font-size:.82rem}
-.hono-decks-embed-frame{margin:1rem 0;max-width:100%}
-.hono-decks-embed-viewport{width:min(100%,72rem);overflow:hidden}
-.hono-decks-embed-viewport iframe{display:block;width:100%;height:100%;border:0}
-.hono-decks-embed-print-fallback{display:none}
-.hono-decks-embed-print-poster{display:block;width:100%;height:100%;object-fit:cover}
-.hono-decks-embed-fallback{margin:.45rem 0 0;color:var(--hono-decks-muted-color);font-size:.84rem}
-.hono-decks-embed-fallback a{color:inherit}
-.hono-decks-social-embed{margin:1rem 0;max-width:min(100%,42rem)}
-.hono-decks-social-card{margin:0;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);padding:1rem}
-.hono-decks-social-card p{margin:0 0 .75rem;line-height:1.55}
-.hono-decks-social-card footer{display:flex;flex-wrap:wrap;gap:.65rem;align-items:center;color:var(--hono-decks-muted-color);font-size:.9rem}
-.hono-decks-social-card a{color:inherit}
-.hono-decks-tweet-embed{margin:1rem 0;max-width:min(100%,42rem)}
-.hono-decks-tweet-embed .twitter-tweet{margin:0;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);padding:1rem}
-.hono-decks-tweet-embed .twitter-tweet a{color:inherit}
-.hono-decks-tweet-print-fallback{display:none}
-.hono-decks-link-card{margin:1rem 0;max-width:min(100%,42rem)}
-.hono-decks-link-card-anchor{display:grid;grid-template-columns:minmax(9rem,32%) minmax(0,1fr);gap:.75rem;align-items:stretch;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);padding:1rem;color:inherit;text-decoration:none}
-.hono-decks-link-card-body{display:grid;gap:.35rem;min-width:0}
-.hono-decks-link-card-image{width:100%;height:100%;max-height:10rem;aspect-ratio:16/9;object-fit:cover;border-radius:6px;background:var(--hono-decks-card-image-background)}
-.hono-decks-link-card-site{color:var(--hono-decks-accent-color);font-size:.8rem;text-transform:uppercase}
-.hono-decks-link-card-title{font-weight:700}
-.hono-decks-link-card-description{color:var(--hono-decks-muted-color);line-height:1.45}
-.hono-decks-link-card-label{color:var(--hono-decks-accent-color);font-size:.88rem}
-@media (max-width: 640px){.hono-decks-link-card-anchor{grid-template-columns:1fr}.hono-decks-link-card-image{height:auto;max-height:12rem}}
-.mdx-hero{height:100%;display:grid;grid-template-columns:minmax(0,1fr) minmax(280px,42%);gap:clamp(1rem,3vw,3rem);align-items:center}
-.mdx-hero:not(.has-image){grid-template-columns:1fr}
-.mdx-hero-copy{min-width:0}
-.mdx-hero-eyebrow{margin:0 0 .75rem;color:var(--hono-decks-accent-color);text-transform:uppercase;font-size:.85rem;letter-spacing:0}
-.mdx-hero h1{margin:0;font-size:clamp(2.2rem,5vw,5rem);line-height:1.02}
-.mdx-hero-subtitle{margin:1rem 0 0;font-size:clamp(1rem,1.8vw,1.5rem);line-height:1.45;color:var(--hono-decks-muted-color)}
-.mdx-hero-image{width:100%;height:auto;max-height:70vh;object-fit:contain;border-radius:8px}
-[data-hono-decks-fire]{--fire-duration:.18s;--fire-easing:ease;--fire-opacity:0;--fire-transform:translateY(.35rem);--fire-filter:none;visibility:visible;opacity:1;transform:none;filter:none;transition:visibility 0s linear 0s,opacity var(--fire-duration) var(--fire-easing),transform var(--fire-duration) var(--fire-easing),filter var(--fire-duration) var(--fire-easing)}
-[data-hono-decks-fire][data-fire-hidden]{visibility:hidden;opacity:var(--fire-opacity);transform:var(--fire-transform);filter:var(--fire-filter);transition-delay:var(--fire-duration),0s,0s,0s}
-[data-fire-effect=none]{--fire-duration:0s;--fire-transform:none}
-[data-fire-effect=fade]{--fire-transform:none}
-[data-fire-effect=fade-up]{--fire-transform:translateY(.85rem)}
-[data-fire-effect=scale]{--fire-transform:scale(.96)}
-body:not([data-overview-mode]) .hono-decks-deck{position:relative}
-body:not([data-overview-mode]) .slide{position:absolute;inset:0;width:100%;height:100%}
-.slide[data-active-transition]{transition:opacity var(--hono-decks-active-transition-duration,var(--hono-decks-slide-transition-duration,var(--hono-decks-transition-duration))) var(--hono-decks-active-transition-easing,var(--hono-decks-slide-transition-easing,var(--hono-decks-transition-easing))),transform var(--hono-decks-active-transition-duration,var(--hono-decks-slide-transition-duration,var(--hono-decks-transition-duration))) var(--hono-decks-active-transition-easing,var(--hono-decks-slide-transition-easing,var(--hono-decks-transition-easing)));will-change:opacity,transform}
-.slide[data-slide-state="inactive"]{visibility:hidden;pointer-events:none}
-.slide[data-slide-state="active"]{visibility:visible;opacity:1;transform:translate3d(0,0,0) scale(1)}
-.slide[data-active-transition="fade"][data-slide-state="entering"],.slide[data-active-transition="fade"][data-slide-state="leaving"],.slide[data-active-transition="view-transition"][data-slide-state="entering"],.slide[data-active-transition="view-transition"][data-slide-state="leaving"]{opacity:0}
-.slide[data-active-transition="fade-out"][data-slide-state="entering"]{opacity:1}
-.slide[data-active-transition="fade-out"][data-slide-state="leaving"]{opacity:0}
-.slide[data-active-transition="slide-left"][data-slide-direction="forward"][data-slide-state="entering"],.slide[data-active-transition="slide-right"][data-slide-direction="backward"][data-slide-state="leaving"]{transform:translate3d(100%,0,0)}
-.slide[data-active-transition="slide-left"][data-slide-direction="forward"][data-slide-state="leaving"],.slide[data-active-transition="slide-right"][data-slide-direction="backward"][data-slide-state="entering"]{transform:translate3d(-100%,0,0)}
-.slide[data-active-transition="slide-left"][data-slide-direction="backward"][data-slide-state="entering"],.slide[data-active-transition="slide-right"][data-slide-direction="forward"][data-slide-state="leaving"]{transform:translate3d(-100%,0,0)}
-.slide[data-active-transition="slide-left"][data-slide-direction="backward"][data-slide-state="leaving"],.slide[data-active-transition="slide-right"][data-slide-direction="forward"][data-slide-state="entering"]{transform:translate3d(100%,0,0)}
-.slide[data-active-transition="slide-up"][data-slide-direction="forward"][data-slide-state="entering"],.slide[data-active-transition="slide-down"][data-slide-direction="backward"][data-slide-state="leaving"]{transform:translate3d(0,100%,0)}
-.slide[data-active-transition="slide-up"][data-slide-direction="forward"][data-slide-state="leaving"],.slide[data-active-transition="slide-down"][data-slide-direction="backward"][data-slide-state="entering"]{transform:translate3d(0,-100%,0)}
-.slide[data-active-transition="slide-up"][data-slide-direction="backward"][data-slide-state="entering"],.slide[data-active-transition="slide-down"][data-slide-direction="forward"][data-slide-state="leaving"]{transform:translate3d(0,-100%,0)}
-.slide[data-active-transition="slide-up"][data-slide-direction="backward"][data-slide-state="leaving"],.slide[data-active-transition="slide-down"][data-slide-direction="forward"][data-slide-state="entering"]{transform:translate3d(0,100%,0)}
-body:not([data-overview-mode]) .slide[hidden]{display:none}
-body[data-overview-mode] .hono-decks-deck{grid-template-columns:repeat(auto-fit,minmax(260px,1fr))}
-body[data-overview-mode] .slide{cursor:pointer}
-body[data-presenter-mode] .speaker-notes{display:block;margin-top:1rem;padding:.75rem;border-radius:8px;background:var(--hono-decks-card-image-background)}
-.hono-decks-warnings{margin:1rem;padding:.75rem;border-radius:14px;background:var(--hono-decks-warning-background);color:var(--hono-decks-warning-color)}
-@media screen{html[data-hono-decks-print-preview]{width:auto;height:auto;min-height:100%;overflow:visible}
-body[data-hono-decks-print-preview]{min-height:100vh;overflow:auto;color-scheme:light;color:#000;--hono-decks-print-gap:6mm;--hono-decks-print-slot-height:80mm;--hono-decks-print-scale:.28}
-body[data-hono-decks-print-preview] .hono-decks-stage{display:block;width:auto;height:auto;min-height:100vh;overflow:visible;padding:12mm 0;box-sizing:border-box}
-body[data-hono-decks-print-preview] .hono-decks-deck{display:grid;grid-template-columns:1fr;grid-auto-rows:var(--hono-decks-print-slot-height);gap:var(--hono-decks-print-gap);width:calc(var(--hono-decks-print-slot-height) * 16 / 9);max-width:calc(100vw - 24px);height:auto;margin:0 auto;transform:none!important}
-body[data-hono-decks-print-preview] .slide{position:static;width:100%;max-width:100%;height:var(--hono-decks-print-slot-height);aspect-ratio:16/9;justify-self:center;align-self:center;padding:0;box-shadow:0 2px 10px rgba(15,23,42,.16);transition:none!important;transform:none!important}
-body[data-hono-decks-print-preview] .slide.layout-cover,body[data-hono-decks-print-preview] .slide.layout-statement{display:block}
-body[data-hono-decks-print-preview] .hono-decks-slide-content{width:var(--hono-decks-width);height:var(--hono-decks-height);box-sizing:border-box;padding:clamp(1.2rem,3vw,3rem);transform:scale(var(--hono-decks-print-scale));transform-origin:left top;overflow:hidden}
-body[data-hono-decks-print-preview]:not([data-overview-mode]) .slide[hidden]{display:block!important}
-body[data-hono-decks-print-preview] .slide[data-slide-state]{visibility:visible!important;opacity:1!important;transform:none!important}
-body[data-hono-decks-print-preview] [data-hono-decks-fire]{visibility:visible!important;opacity:1!important;transform:none!important;filter:none!important}}
-@page{size:A4 portrait;margin:12mm}
-@media print{:root{color-scheme:light;color:#000;--hono-decks-print-gap:6mm;--hono-decks-print-slot-height:80mm;--hono-decks-print-scale:.28}html,body{width:auto;height:auto;overflow:visible}.hono-decks-stage{display:block;width:auto;height:auto;overflow:visible}.hono-decks-deck{display:grid;grid-template-columns:1fr;grid-auto-rows:var(--hono-decks-print-slot-height);gap:var(--hono-decks-print-gap);width:calc(var(--hono-decks-print-slot-height) * 16 / 9);height:auto;margin:0 auto;transform:none!important}body:not([data-overview-mode]) .slide{position:relative}.slide{position:relative;width:100%;max-width:100%;height:var(--hono-decks-print-slot-height);aspect-ratio:16/9;justify-self:center;align-self:center;padding:0;page-break-after:auto;break-after:auto;break-inside:avoid;box-shadow:none;transition:none!important;transform:none!important}.slide.layout-cover,.slide.layout-statement{display:block}.hono-decks-slide-content{position:absolute;inset:0 auto auto 0;width:var(--hono-decks-width);height:var(--hono-decks-height);box-sizing:border-box;padding:clamp(1.2rem,3vw,3rem);zoom:var(--hono-decks-print-scale);overflow:hidden}.slide:nth-of-type(3n):not(:last-child){page-break-after:always;break-after:page}body:not([data-overview-mode]) .slide[hidden]{display:block!important}.slide[data-slide-state]{visibility:visible!important;opacity:1!important;transform:none!important}[data-hono-decks-fire]{visibility:visible!important;opacity:1!important;transform:none!important;filter:none!important}}
-@media print{.hono-decks-embed-viewport iframe,.hono-decks-tweet-embed iframe,.hono-decks-tweet-embed .twitter-tweet{display:none!important}.hono-decks-embed-print-fallback{display:grid;width:100%;height:100%;place-items:center;overflow:hidden;background:var(--hono-decks-card-background);color:var(--hono-decks-accent-color);text-decoration:none}.hono-decks-embed-print-fallback:has(.hono-decks-embed-print-poster){display:block}.hono-decks-embed-print-poster+span{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0)}.hono-decks-tweet-print-fallback{display:flex;min-height:12rem;align-items:center;justify-content:center;border:1px solid var(--hono-decks-border-color);border-radius:8px;background:var(--hono-decks-card-background);color:var(--hono-decks-accent-color);text-decoration:none}}
-@media (prefers-reduced-motion: reduce){*,*::before,*::after{scroll-behavior:auto!important;animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important;transition-delay:0s!important}.slide[data-active-transition]{transform:none!important}}`;
-}
-//#endregion
 //#region src/renderer/presentation-page.ts
 function presentationPageTitle(deck) {
 	return deck.meta.title ?? deck.slug;
@@ -3949,12 +4253,16 @@ function slideStyleAttribute(slide, assets) {
 	if (slide.meta.transitionEasing) declarations.push(`--hono-decks-slide-transition-easing:${slide.meta.transitionEasing}`);
 	return declarations.length ? ` style="${escapeHtml$5(declarations.join(";"))}"` : "";
 }
+function requireSlideHtml(slide) {
+	if (typeof slide.html !== "string") throw new RenderError("Slide has no renderable body. Import createDecks() from the generated module; compileDecks() returns build information only.", "slide-body-missing");
+	return slide.html;
+}
 async function renderSlideBodyAsync(slide, assets, input) {
 	try {
 		return slide.render ? await renderJsxValue(slide.render({ components: createMdxComponents(input.components ?? builtInSlideComponents, { assets }) })) : slide.nodes?.length ? await renderSlideNodesAsync(slide.nodes, {
 			components: input.components,
 			assets
-		}) : rewriteLocalAssetUrls(slide.html, assets);
+		}) : rewriteLocalAssetUrls(requireSlideHtml(slide), assets);
 	} catch (error) {
 		if (error instanceof RenderError) throw error;
 		throw new RenderError(`Render failed in ${input.deck?.sourcePath ?? "unknown deck"} slide ${slide.index + 1}: ${formatErrorMessage$1(error)}`, "slide-render-error", error);
@@ -3981,7 +4289,7 @@ function formatErrorMessage$1(error) {
 function serveDecksClientEntry(clientEntry, options = {}) {
 	return (c) => {
 		const headers = { "content-type": options.contentType ?? "text/javascript; charset=utf-8" };
-		const cacheControl = options.cacheControl ?? "public, max-age=300";
+		const cacheControl = options.cacheControl ?? "no-cache";
 		if (cacheControl !== false) headers["cache-control"] = cacheControl;
 		return c.body(clientEntry, 200, headers);
 	};
@@ -4275,6 +4583,7 @@ function renderViewerScript(nonce) {
     }
 
     function handleKeydown(event) {
+      if (event.defaultPrevented) return;
       if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "p" && printPath) {
         event.preventDefault();
         const printUrl = new URL(printPath, window.location.href);
@@ -4282,6 +4591,10 @@ function renderViewerScript(nonce) {
         window.location.assign(printUrl);
         return;
       }
+      if (event.metaKey || event.ctrlKey || event.altKey) return;
+      const target = event.target;
+      if (target instanceof HTMLElement && (target.isContentEditable || target.closest("input,textarea,select,button,a[href],[role=textbox],[role=button],[role=slider]"))) return;
+      if (["ArrowRight", "ArrowLeft", " "].includes(event.key)) event.preventDefault();
       if (event.key === "ArrowRight" || event.key === " ") sendCommand("next");
       if (event.key === "ArrowLeft") sendCommand("previous");
       if (event.key === "f") void toggleViewerFullscreen();
@@ -4345,7 +4658,7 @@ function baseViewerStyle() {
 html,body{margin:0;width:100%;height:100%;min-height:100vh}
 @supports (height:100dvh){html,body{height:100dvh;min-height:100dvh}}
 body{overflow:hidden}
-*:focus-visible{outline:none}
+*:focus-visible{outline:2px solid currentColor;outline-offset:2px}
 [data-hono-decks-viewer]{width:100%;height:100vh;min-height:0;display:grid;place-items:center;box-sizing:border-box;overflow:hidden}
 @supports (height:100dvh){[data-hono-decks-viewer]{height:100dvh}}
 .hono-decks-viewer-header{position:absolute;width:1px;height:1px;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}
@@ -4363,7 +4676,7 @@ ${viewerViewportRule()}
 .hono-decks-mobile-navigation:focus-visible{outline:2px solid currentColor;outline-offset:-4px}
 .hono-decks-mobile-navigation:active{background:rgba(15,23,42,.28);color:#eef2ff;opacity:1}
 .hono-decks-mobile-navigation .hono-decks-control-icon{width:22px;height:22px}
-.hono-decks-viewport>[data-hono-decks-position]{position:absolute;left:50%;bottom:max(8px,env(safe-area-inset-bottom,0));z-index:3;transform:translateX(-50%);border:0;background:transparent;color:inherit;padding:0;font:inherit;font-size:12px;line-height:1;opacity:.38;pointer-events:none;white-space:nowrap}
+.hono-decks-viewport>[data-hono-decks-position]{position:absolute;left:50%;bottom:max(8px,env(safe-area-inset-bottom,0));z-index:3;transform:translateX(-50%);border:0;border-radius:4px;background:rgba(15,23,42,.9);color:#eef2ff;padding:4px 6px;font:inherit;font-size:12px;line-height:1;opacity:1;pointer-events:none;white-space:nowrap}
 .hono-decks-viewer-controls{position:absolute;left:50%;bottom:max(.25rem,env(safe-area-inset-bottom,0));display:flex;gap:8px;align-items:center;justify-content:center;max-width:calc(100% - 1rem);min-width:0;z-index:4;transform:translateX(-50%)}
 .hono-decks-viewer-controls [data-hono-decks-navigation-control="previous"],.hono-decks-viewer-controls [data-hono-decks-navigation-control="next"],.hono-decks-viewer-controls [data-hono-decks-position]{position:absolute;visibility:hidden;pointer-events:none}
 .hono-decks-viewer-controls button,.hono-decks-viewer-controls a,.hono-decks-viewer-controls span{border:1px solid rgba(148,163,184,.32);border-radius:8px;background:rgba(15,23,42,.78);color:inherit;padding:8px 10px;font:inherit;font-size:14px}
@@ -4380,7 +4693,7 @@ ${viewerViewportRule()}
 function embeddedViewerStyle() {
 	const root = "[data-hono-decks-viewer][data-hono-decks-embed]";
 	return `${root}{color-scheme:dark;background:#050816;color:#eef2ff;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;display:grid;gap:12px;width:100%;min-width:0;box-sizing:border-box}
-${root} *:focus-visible{outline:none}
+${root} *:focus-visible{outline:2px solid currentColor;outline-offset:2px}
 ${root} .hono-decks-viewer-shell{position:relative;display:grid;grid-template-rows:minmax(0,1fr);place-items:center;width:100%;min-width:0;min-height:0;box-sizing:border-box}
 ${root} .hono-decks-viewer-stage{display:grid;place-items:center;width:100%;min-width:0;min-height:0;container-type:inline-size}
 ${root} .hono-decks-viewport{width:100%;aspect-ratio:${VIEWER_ASPECT_RATIO};position:relative;overflow:hidden;touch-action:pan-y}
@@ -4393,7 +4706,7 @@ ${root} .hono-decks-mobile-navigation-next{right:.25rem}
 ${root} .hono-decks-mobile-navigation:focus-visible{outline:2px solid currentColor;outline-offset:-4px}
 ${root} .hono-decks-mobile-navigation:active{background:rgba(15,23,42,.28);color:#eef2ff;opacity:1}
 ${root} .hono-decks-mobile-navigation .hono-decks-control-icon{width:22px;height:22px}
-${root} .hono-decks-viewport>[data-hono-decks-position]{position:absolute;left:50%;bottom:8px;z-index:3;transform:translateX(-50%);border:0;background:transparent;color:inherit;padding:0;font:inherit;font-size:12px;line-height:1;opacity:.5;pointer-events:none;white-space:nowrap}
+${root} .hono-decks-viewport>[data-hono-decks-position]{position:absolute;left:50%;bottom:8px;z-index:3;transform:translateX(-50%);border:0;border-radius:4px;background:rgba(15,23,42,.9);color:#eef2ff;padding:4px 6px;font:inherit;font-size:12px;line-height:1;opacity:1;pointer-events:none;white-space:nowrap}
 ${root} .hono-decks-viewer-controls{position:absolute;left:50%;bottom:max(.25rem,env(safe-area-inset-bottom,0));display:flex;gap:8px;align-items:center;justify-content:center;max-width:calc(100% - 1rem);min-width:0;z-index:4;transform:translateX(-50%)}
 ${root} .hono-decks-viewer-controls [data-hono-decks-navigation-control="previous"],${root} .hono-decks-viewer-controls [data-hono-decks-navigation-control="next"],${root} .hono-decks-viewer-controls [data-hono-decks-position]{position:absolute;visibility:hidden;pointer-events:none}
 ${root} .hono-decks-viewer-controls button,${root} .hono-decks-viewer-controls a,${root} .hono-decks-viewer-controls span{border:1px solid rgba(148,163,184,.32);border-radius:8px;background:rgba(15,23,42,.78);color:inherit;padding:8px 10px;font:inherit;font-size:14px}
@@ -5034,7 +5347,7 @@ function decksRouter(options) {
 			slug,
 			surface: "render"
 		}, 404);
-		const clientEntry = options.clientEntry ?? resolveGeneratedClientEntryUrl(options, mountPath);
+		const clientEntry = options.clientEntry ?? (deck.clientEntryRequired === false ? void 0 : resolveGeneratedClientEntryUrl(options, mountPath));
 		try {
 			const document = await resolveRouterDocument(c, options, "render", mountPath, deck);
 			return c.html(await renderCompiledDeckPageAsync({
@@ -5139,7 +5452,7 @@ function decksRouter(options) {
 			slug,
 			surface: "presentation"
 		}, 404);
-		const clientEntry = options.clientEntry ?? resolveGeneratedClientEntryUrl(options, mountPath);
+		const clientEntry = options.clientEntry ?? (deck.clientEntryRequired === false ? void 0 : resolveGeneratedClientEntryUrl(options, mountPath));
 		try {
 			const document = await resolveRouterDocument(c, options, "presentation", mountPath, deck);
 			return c.html(await renderCompiledDeckPageAsync({
@@ -5419,7 +5732,7 @@ const DEFAULT_DECKS_CONFIG_FILE = "hono-decks.config.ts";
 async function loadDecksConfig(input) {
 	const path = resolve(input.cwd, input.configFile ?? "hono-decks.config.ts");
 	if (!existsSync(path)) throw new Error(`Config file not found: ${input.configFile ?? "hono-decks.config.ts"}. Run \`hono-decks init\` first.`);
-	const source = (await build({
+	const result = await build({
 		absWorkingDir: input.cwd,
 		entryPoints: [path],
 		bundle: true,
@@ -5427,16 +5740,20 @@ async function loadDecksConfig(input) {
 		platform: "node",
 		target: "node20",
 		write: false,
+		metafile: true,
 		logLevel: "silent",
 		alias: { "hono-decks": resolveRuntimeEntry() }
-	})).outputFiles[0]?.text;
+	});
+	const source = result.outputFiles[0]?.text;
 	if (!source) throw new Error(`Could not load config file: ${path}`);
 	const config = (await import(`data:text/javascript;charset=utf-8,${encodeURIComponent(source)}#${Date.now()}`)).default;
 	if (!config || typeof config !== "object") throw new Error(`Config must have a default export: ${path}`);
 	if (typeof config.mountPath !== "string") throw new Error(`Config mountPath must be a string: ${path}`);
+	if (config.build?.markdown !== void 0 && config.build.markdown !== "void" && (typeof config.build.markdown !== "object" || !config.build.markdown || typeof config.build.markdown.adapter !== "string" || !config.build.markdown.adapter.trim())) throw new Error("Config build.markdown must be \"void\" or an adapter reference.");
 	return {
 		path,
 		config,
+		dependencies: Object.keys(result.metafile.inputs).map((inputPath) => resolve(input.cwd, inputPath)),
 		root: config.build?.root ?? "decks",
 		outDir: config.build?.outDir ?? "src/generated",
 		ogpCacheFile: config.build?.ogpCacheFile