hono-decks 1.1.0 → 1.2.0

package/README.ja.md

@@ -69,7 +69,7 @@ npm run dev
 npm run build
 ```
 
-この連携には `void-plugin-hono-jsx@^0.4.0` の standalone compiler／client export
+この連携には `void-plugin-hono-jsx@^0.5.0` の standalone compiler／client export
 が必要です。`--install` は対応範囲のアダプターを選びます。
 `--install` を省略する場合は、Markdown 用の任意 peer も必要です：
 `markdown-exit@^1.3.0 yaml@^2.9.1 markdown-it-container@^4.0.0 shiki@^4.5.0 @shikijs/transformers@^4.5.0`。
@@ -474,3 +474,37 @@ app.route("/internal-slides", decksRouter({ source, dev: true }));
 反映します。反映中に失敗した場合は、直前の内容へ戻します。OS やプロセスの停止時の
 一括反映、複数プロセスの同時実行は保証しません。復元自体に失敗した場合は、
 復旧用ファイルを残し、その場所をエラーに表示します。
+
+## Markdownアダプター
+
+従来の `build.markdown: "void"` に加えて、ビルド時に読み込むアダプターを指定できます。
+
+```ts
+export default defineDecksConfig({
+  mountPath: "/slides",
+  router: { clientEntryAssetPath: "/_assets/client" },
+  build: {
+    root: "decks",
+    markdown: { adapter: "hono-decks/adapters/hono-markdown" },
+  },
+});
+```
+
+このブリッジは共通の `@ts-76/hono-markdown` を利用します。共通パッケージはVoid・Viteに依存しません。このアダプターを選ぶ場合はコンパイラー用peer dependenciesも導入します。
+既存の `markdown: "void"` は、既に導入したVoidアダプターの公開コンパイラーAPIでも引き続き動作します。
+`init --framework void --install` の導入手順、既存のdev／buildコマンドは変わりません。
+
+設定はサーバー実行時にも読み込むため、アダプターは文字列で指定し、Node用のfactoryを設定ファイルへimportしません。
+Hono＋Vite・HonoXは引き続きMDXが標準で、VoidやMarkdown用パーサーの追加は不要です。
+これらでMarkdownを使う場合は、共通パッケージとコンパイラー用peer dependenciesを導入し、上記ブリッジを選択します。
+Viteは仮想モジュールを利用し、既存の `hono-decks compile` はファイル出力を維持します。
+
+独自アダプターは `createMarkdownAdapter({ cwd, options })` をexportし、`read(source)`、非同期の
+`compile(source, { sourcePath })`、`client(islands)` を返します。型は `hono-decks/adapters/hono-markdown` からimportできます。
+スライド分割・メタデータ・アセット・ルーティング・表示中スライドの判定はhono-decksが担当し、Markdownの変換とislandのスケジュールはアダプターが担当します。
+同じVoidアプリにhonoxpressを組み込んでも、ドキュメントとスライドが互いの内部実装に依存する必要はありません。
+
+Hono＋Vite・HonoXのinitは、dev serverが標準で`.js`を除外するため、拡張子なしの
+`/_assets/client`を設定します。配信は既存アプリのミドルウェア・認可を通ります。
+既存CLI構成の標準パス`/_assets/client.js`は維持します。VoidなしのMarkdown実アプリ検証は、
+`HONO_MARKDOWN_PACKAGE`に共通パッケージのtarballを指定し、`node scripts/verify-vite-init.mjs`で実行できます。

package/README.md

@@ -68,7 +68,7 @@ npm run dev
 npm run build
 ~~~
 
-This integration requires `void-plugin-hono-jsx@^0.4.0` or a compatible adapter
+This integration requires `void-plugin-hono-jsx@^0.5.0` or a compatible adapter
 with the `/markdown/compiler` and `/markdown/client` exports. `--install` selects
 the supported adapter range. Without `--install`, also install the optional Markdown peers:
 `markdown-exit@^1.3.0 yaml@^2.9.1 markdown-it-container@^4.0.0 shiki@^4.5.0 @shikijs/transformers@^4.5.0`.
@@ -465,7 +465,7 @@ At this level, the application owns the mount path, source policy, and option me
 ## Void Hono Markdown
 
 Set `build.markdown: "void"` in `hono-decks.config.ts` to opt into `.md` decks
-alongside MDX. This requires `void-plugin-hono-jsx@^0.4.0` with its standalone compiler and client exports.
+alongside MDX. This requires `void-plugin-hono-jsx@^0.5.0` with its standalone compiler and client exports.
 See the [Void consumer fixture](https://github.com/ts-76/hono-decks/tree/main/fixtures/void-markdown)
 for package verification, Void middleware hosting, supported syntax and limitations.
 
@@ -490,3 +490,47 @@ files (including cache files) on a publication error. Application-owned files
 are preserved. This guarantees rollback on reported build failure, not
 crash-atomic publication or coordination between concurrent compiler processes.
 If rollback itself fails, the error lists retained recovery directories.
+
+## Markdown adapters
+
+The deck compiler accepts a build-only module reference as well as the existing
+`build.markdown: "void"` preset:
+
+```ts
+export default defineDecksConfig({
+  mountPath: "/slides",
+  router: { clientEntryAssetPath: "/_assets/client" },
+  build: {
+    root: "decks",
+    markdown: { adapter: "hono-decks/adapters/hono-markdown" },
+  },
+});
+```
+
+The Hono Markdown bridge uses `@ts-76/hono-markdown/compiler` and its browser
+runtime. The common package has no Void or Vite dependency. Install its optional compiler peers when selecting this adapter. Existing
+Void configurations continue to work with the adapter's public compiler API,
+including compatible earlier adapter versions. `init --framework void
+--install` retains the one-command setup and unchanged dev/build scripts.
+
+Keep the adapter reference in config as a string: config is also imported by the
+server runtime. The compiler loads adapters only during builds. Hono+Vite and
+HonoX continue to default to MDX without installing Void or Markdown peers.
+For Markdown in these hosts, install the common package and its compiler peers
+and select the bridge above. Vite uses virtual modules; `hono-decks compile`
+continues to emit files.
+
+Custom build adapters export `createMarkdownAdapter({ cwd, options })`, returning
+`read(source)`, asynchronous `compile(source, { sourcePath })`, and
+`client(islands)`. Types are exported from `hono-decks/adapters/hono-markdown`.
+The deck host owns splitting, metadata, assets, routing and the visible-slide
+hydration gate; Markdown compilation and island scheduling belong to the adapter.
+Document adapters such as honoxpress can use the same Markdown package in a Void
+app without importing deck internals or changing their route ownership.
+
+Hono+Vite/HonoX init selects the extensionless `/_assets/client` route because
+`@hono/vite-dev-server` excludes `.js` requests by default. The client still goes
+through the application's middleware and authorization. Existing standalone CLI
+configurations retain their default `/_assets/client.js` route. For local
+Markdown checks without Void, set `HONO_MARKDOWN_PACKAGE` to the common tarball
+and run `node scripts/verify-vite-init.mjs`.

package/dist/adapters/hono-markdown.d.ts

@@ -0,0 +1,39 @@
+import "hono";
+import "hono/jsx";
+import "hono/utils/html";
+//#region src/node/markdown-adapter.d.ts
+interface MarkdownIsland {
+  id: string;
+  modulePath: string;
+  hydrate: string;
+}
+interface DeckMarkdownAdapter {
+  read(source: string): {
+    frontmatter: Record<string, unknown>;
+    content: string;
+    script: string;
+  };
+  compile(source: string, input: {
+    sourcePath: string;
+  }): Promise<{
+    code: string;
+    headings: {
+      depth: number;
+      slug: string;
+      text: string;
+    }[];
+    clientCode: string;
+    islands?: MarkdownIsland[];
+  }>;
+  client(islands: MarkdownIsland[]): string;
+}
+//#endregion
+//#region src/adapters/hono-markdown.d.ts
+/** Node-only bridge. Existing Void configs retain their original compiler/runtime pair. */
+declare function createHonoMarkdownAdapter(cwd: string, legacy?: boolean, options?: Record<string, unknown>): Promise<DeckMarkdownAdapter>;
+declare function createMarkdownAdapter({ cwd, options }: {
+  cwd: string;
+  options?: Record<string, unknown>;
+}): Promise<DeckMarkdownAdapter>;
+//#endregion
+export { type DeckMarkdownAdapter, type MarkdownIsland, createHonoMarkdownAdapter, createMarkdownAdapter };

package/dist/adapters/hono-markdown.js

@@ -0,0 +1,47 @@
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+//#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 createMarkdownAdapter({ cwd, options }) {
+	return createHonoMarkdownAdapter(cwd, false, options);
+}
+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
+export { createHonoMarkdownAdapter, createMarkdownAdapter };

package/dist/advanced.d.ts

@@ -544,8 +544,11 @@ interface DefinedDecks<E extends Env = any> {
 }
 /** File-system settings consumed by the CLI. */
 interface DecksBuildConfig {
-  /** Opt into .md decks compiled by void-plugin-hono-jsx/markdown/compiler. */
-  markdown?: "void";
+  /** Build-only Markdown adapter reference. "void" retains the compatible preset. */
+  markdown?: "void" | {
+    adapter: string;
+    options?: Record<string, unknown>;
+  };
   /** Deck source directory. @default "decks" */
   root?: string;
   /** CLI output directory. Vite keeps modules in memory. @default "src/generated" */

package/dist/bin.js

@@ -8,10 +8,10 @@ import { unified } from "unified";
 import remarkGfm from "remark-gfm";
 import remarkMdx from "remark-mdx";
 import remarkParse from "remark-parse";
-import { fileURLToPath, pathToFileURL } from "node:url";
 import { compile } from "@mdx-js/mdx";
 import remarkDirective from "remark-directive";
 import { codeToHtml } from "shiki";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { build } from "esbuild";
 import { lookup } from "node:dns/promises";
 import { isIP } from "node:net";
@@ -1506,29 +1506,20 @@ function extractDeckPrelude(source) {
 	};
 }
 //#endregion
-//#region src/node/void-markdown.ts
-/** Load only for an explicit Void Markdown build; ordinary MDX has no new peers. */
-async function compileVoidMarkdownDecks(input) {
+//#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;
-	let compiler;
-	try {
-		compiler = await import(pathToFileURL(createRequire(resolve(input.cwd ?? process.cwd(), "package.json")).resolve("void-plugin-hono-jsx/markdown/compiler")).href);
-		if (typeof (compiler.compileMarkdownModule ?? compiler.compileStaticMarkdown) !== "function" || typeof (compiler.readMarkdownModule ?? compiler.readStaticMarkdown) !== "function") throw new Error("Missing standalone compiler API");
-	} catch (error) {
-		throw new Error("Void Markdown requires void-plugin-hono-jsx with the public /markdown/compiler API and its Markdown peers installed in the app.", { cause: error });
-	}
-	const readModule = compiler.readMarkdownModule ?? compiler.readStaticMarkdown;
-	const compileModule = compiler.compileMarkdownModule ?? compiler.compileStaticMarkdown;
 	const decks = [...mdx.decks];
 	const clients = /* @__PURE__ */ new Set();
 	const markdownIslands = /* @__PURE__ */ new Map();
 	for (const entry of markdownEntries) try {
-		const parsed = readModule(await input.readText(entry.sourcePath));
+		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);
@@ -1549,12 +1540,13 @@ async function compileVoidMarkdownDecks(input) {
 		const slides = [];
 		for (const [index, slideSource] of splitMarkdownSlides(parsed.content).entries()) {
 			const prelude = parsed.script ? `<script>\n${parsed.script}\n<\/script>\n` : "";
-			const slide = readModule(prelude + slideSource);
+			const slide = adapter.read(prelude + slideSource);
 			const path = `${input.outDir}/decks/${entry.slug}/slide-${index}.ts`;
-			const result = await compileModule(rewriteAssetUrls(`${prelude}---\n${JSON.stringify({
+			const rewritten = rewriteAssetUrls(`${prelude}---\n${JSON.stringify({
 				...parsed.frontmatter,
 				...slide.frontmatter
-			})}\n---\n${slide.content}`, assets), { sourcePath: resolve(input.cwd ?? process.cwd(), entry.sourcePath) });
+			})}\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);
@@ -1604,6 +1596,7 @@ async function compileVoidMarkdownDecks(input) {
 		decks,
 		routerModule: emitModuleDecksRouter({ decks }),
 		clientCode: [...clients].join("\n"),
+		clientModules: [adapter.client([...markdownIslands.values()])].filter(Boolean),
 		markdownIslands: [...markdownIslands.values()]
 	};
 }
@@ -1640,6 +1633,64 @@ function splitMarkdownSlides(source) {
 	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/node/client-entry.ts
 async function discoverClientComponentIds(input) {
 	const result = {};
@@ -1660,12 +1711,11 @@ async function emitClientEntryModule(input) {
 			registrations.push(`${JSON.stringify(clientId)}: ${localName}`);
 		}
 	}
-	const markdown = input.markdownIslands ?? [];
-	if (registrations.length === 0 && markdown.length === 0) return `export const decksClientEntry = ${JSON.stringify(input.extraCode ?? "")};\n`;
+	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: `${markdown.length ? `import { hydrateMarkdownIslands } from "void-plugin-hono-jsx/markdown/client";
-hydrateMarkdownIslands({ ${markdown.map((entry) => `${javascriptString(entry.id)}: () => import(${javascriptString(entry.modulePath)})`).join(",")} });` : ""}
+			contents: `${clientModules.join("\n")}
 import { hydrateSlideIslands } from "hono-decks/client";
 ${imports.join("\n")}
 
@@ -1742,9 +1792,6 @@ function hashString(value) {
 function safeIdentifier(value) {
 	return value.replace(/[^A-Za-z0-9_$]+/g, "_").replace(/^[^A-Za-z_$]+/, "_") || "_";
 }
-function javascriptString(value) {
-	return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
-}
 //#endregion
 //#region src/node/local-deck-io.ts
 async function listFiles(cwd, dir) {
@@ -1952,7 +1999,7 @@ 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, { markdown: input.markdown === "void" });
+	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]] : [];
@@ -1980,7 +2027,8 @@ async function compileDeckModules(input) {
 		refresh: input.refreshOgp,
 		resolveOgp: input.resolveOgp ?? resolveOgpMetadata
 	});
-	const generated = await (input.markdown === "void" ? compileVoidMarkdownDecks : 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,
@@ -1999,7 +2047,7 @@ async function compileDeckModules(input) {
 		clientEntries: clientEntryPaths,
 		clientComponentIds,
 		extraCode: generated.clientCode,
-		markdownIslands: generated.markdownIslands,
+		clientModules: generated.clientModules,
 		onCss: (css) => {
 			clientCss = css;
 		}
@@ -2149,7 +2197,7 @@ async function loadDecksConfig(input) {
 	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") throw new Error("Config build.markdown must be \"void\".");
+	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,
@@ -2302,7 +2350,7 @@ async function runInitCommand(input, args, stdout, stderr) {
 		return { exitCode: 1 };
 	}
 	if (parsed.options.framework) try {
-		const { initializeVite } = await import("./init-vite-mLg3XlcN.js");
+		const { initializeVite } = await import("./init-vite-EA_L4k2H.js");
 		const sampleSlug = await initializeVite(input.cwd, parsed.options.framework, parsed.options.configFile, parsed.options.entry, parsed.options.install ? { adapter: parsed.options.adapter } : void 0);
 		stdout(`Initialized ${parsed.options.framework} decks at /slides/${sampleSlug}. Run your usual dev or build command; no manual compile is needed.`);
 		return { exitCode: 0 };

package/dist/cli.js

@@ -7,10 +7,10 @@ import { unified } from "unified";
 import remarkGfm from "remark-gfm";
 import remarkMdx from "remark-mdx";
 import remarkParse from "remark-parse";
-import { fileURLToPath, pathToFileURL } from "node:url";
 import { compile } from "@mdx-js/mdx";
 import remarkDirective from "remark-directive";
 import { codeToHtml } from "shiki";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { build } from "esbuild";
 import { lookup } from "node:dns/promises";
 import { isIP } from "node:net";
@@ -1505,29 +1505,20 @@ function extractDeckPrelude(source) {
 	};
 }
 //#endregion
-//#region src/node/void-markdown.ts
-/** Load only for an explicit Void Markdown build; ordinary MDX has no new peers. */
-async function compileVoidMarkdownDecks(input) {
+//#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;
-	let compiler;
-	try {
-		compiler = await import(pathToFileURL(createRequire(resolve(input.cwd ?? process.cwd(), "package.json")).resolve("void-plugin-hono-jsx/markdown/compiler")).href);
-		if (typeof (compiler.compileMarkdownModule ?? compiler.compileStaticMarkdown) !== "function" || typeof (compiler.readMarkdownModule ?? compiler.readStaticMarkdown) !== "function") throw new Error("Missing standalone compiler API");
-	} catch (error) {
-		throw new Error("Void Markdown requires void-plugin-hono-jsx with the public /markdown/compiler API and its Markdown peers installed in the app.", { cause: error });
-	}
-	const readModule = compiler.readMarkdownModule ?? compiler.readStaticMarkdown;
-	const compileModule = compiler.compileMarkdownModule ?? compiler.compileStaticMarkdown;
 	const decks = [...mdx.decks];
 	const clients = /* @__PURE__ */ new Set();
 	const markdownIslands = /* @__PURE__ */ new Map();
 	for (const entry of markdownEntries) try {
-		const parsed = readModule(await input.readText(entry.sourcePath));
+		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);
@@ -1548,12 +1539,13 @@ async function compileVoidMarkdownDecks(input) {
 		const slides = [];
 		for (const [index, slideSource] of splitMarkdownSlides(parsed.content).entries()) {
 			const prelude = parsed.script ? `<script>\n${parsed.script}\n<\/script>\n` : "";
-			const slide = readModule(prelude + slideSource);
+			const slide = adapter.read(prelude + slideSource);
 			const path = `${input.outDir}/decks/${entry.slug}/slide-${index}.ts`;
-			const result = await compileModule(rewriteAssetUrls(`${prelude}---\n${JSON.stringify({
+			const rewritten = rewriteAssetUrls(`${prelude}---\n${JSON.stringify({
 				...parsed.frontmatter,
 				...slide.frontmatter
-			})}\n---\n${slide.content}`, assets), { sourcePath: resolve(input.cwd ?? process.cwd(), entry.sourcePath) });
+			})}\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);
@@ -1603,6 +1595,7 @@ async function compileVoidMarkdownDecks(input) {
 		decks,
 		routerModule: emitModuleDecksRouter({ decks }),
 		clientCode: [...clients].join("\n"),
+		clientModules: [adapter.client([...markdownIslands.values()])].filter(Boolean),
 		markdownIslands: [...markdownIslands.values()]
 	};
 }
@@ -1639,6 +1632,64 @@ function splitMarkdownSlides(source) {
 	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/node/client-entry.ts
 async function discoverClientComponentIds(input) {
 	const result = {};
@@ -1659,12 +1710,11 @@ async function emitClientEntryModule(input) {
 			registrations.push(`${JSON.stringify(clientId)}: ${localName}`);
 		}
 	}
-	const markdown = input.markdownIslands ?? [];
-	if (registrations.length === 0 && markdown.length === 0) return `export const decksClientEntry = ${JSON.stringify(input.extraCode ?? "")};\n`;
+	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: `${markdown.length ? `import { hydrateMarkdownIslands } from "void-plugin-hono-jsx/markdown/client";
-hydrateMarkdownIslands({ ${markdown.map((entry) => `${javascriptString(entry.id)}: () => import(${javascriptString(entry.modulePath)})`).join(",")} });` : ""}
+			contents: `${clientModules.join("\n")}
 import { hydrateSlideIslands } from "hono-decks/client";
 ${imports.join("\n")}
 
@@ -1741,9 +1791,6 @@ function hashString(value) {
 function safeIdentifier(value) {
 	return value.replace(/[^A-Za-z0-9_$]+/g, "_").replace(/^[^A-Za-z_$]+/, "_") || "_";
 }
-function javascriptString(value) {
-	return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
-}
 //#endregion
 //#region src/node/local-deck-io.ts
 async function listFiles(cwd, dir) {
@@ -1951,7 +1998,7 @@ 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, { markdown: input.markdown === "void" });
+	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]] : [];
@@ -1979,7 +2026,8 @@ async function compileDeckModules(input) {
 		refresh: input.refreshOgp,
 		resolveOgp: input.resolveOgp ?? resolveOgpMetadata
 	});
-	const generated = await (input.markdown === "void" ? compileVoidMarkdownDecks : 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,
@@ -1998,7 +2046,7 @@ async function compileDeckModules(input) {
 		clientEntries: clientEntryPaths,
 		clientComponentIds,
 		extraCode: generated.clientCode,
-		markdownIslands: generated.markdownIslands,
+		clientModules: generated.clientModules,
 		onCss: (css) => {
 			clientCss = css;
 		}
@@ -2148,7 +2196,7 @@ async function loadDecksConfig(input) {
 	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") throw new Error("Config build.markdown must be \"void\".");
+	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,
@@ -2301,7 +2349,7 @@ async function runInitCommand(input, args, stdout, stderr) {
 		return { exitCode: 1 };
 	}
 	if (parsed.options.framework) try {
-		const { initializeVite } = await import("./init-vite-mLg3XlcN.js");
+		const { initializeVite } = await import("./init-vite-EA_L4k2H.js");
 		const sampleSlug = await initializeVite(input.cwd, parsed.options.framework, parsed.options.configFile, parsed.options.entry, parsed.options.install ? { adapter: parsed.options.adapter } : void 0);
 		stdout(`Initialized ${parsed.options.framework} decks at /slides/${sampleSlug}. Run your usual dev or build command; no manual compile is needed.`);
 		return { exitCode: 0 };