hono-decks 1.1.0 → 1.2.0

package/dist/{init-vite-mLg3XlcN.js → init-vite-EA_L4k2H.js}

@@ -6,6 +6,19 @@ import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { parse } from "@babel/parser";
 import { execFile } from "node:child_process";
+//#region src/adapters/void.ts
+/** Dependency policy of the Void preset, outside the deck compiler. */
+const voidDependencies = [
+	["void", "void@>=1.1.11 <1.2.0"],
+	["vite", "vite@^8.0.16"],
+	["hono", "hono@^4.13.13"],
+	["markdown-exit", "markdown-exit@^1.3.0"],
+	["yaml", "yaml@^2.9.1"],
+	["markdown-it-container", "markdown-it-container@^4.0.0"],
+	["shiki", "shiki@^4.5.0"],
+	["@shikijs/transformers", "@shikijs/transformers@^4.5.0"]
+];
+//#endregion
 //#region src/node/install-void.ts
 async function installVoidDependencies(cwd, options = {}) {
 	if (options.adapter?.startsWith("-")) throw new Error("--adapter must be a package specifier or tarball path.");
@@ -33,16 +46,7 @@ async function installVoidDependencies(cwd, options = {}) {
 			return true;
 		}
 	};
-	const required = [
-		["void", "void@>=1.1.11 <1.2.0"],
-		["vite", "vite@^8.0.16"],
-		["hono", "hono@^4.13.13"],
-		["markdown-exit", "markdown-exit@^1.3.0"],
-		["yaml", "yaml@^2.9.1"],
-		["markdown-it-container", "markdown-it-container@^4.0.0"],
-		["shiki", "shiki@^4.5.0"],
-		["@shikijs/transformers", "@shikijs/transformers@^4.5.0"]
-	];
+	const required = voidDependencies;
 	for (const [id, spec] of required) {
 		if (missing(id)) continue;
 		const version = await installedVersion(require.resolve(id), id);
@@ -77,7 +81,7 @@ async function installVoidDependencies(cwd, options = {}) {
 		specs.push(`hono-decks@${requested}`);
 	}
 	if (options.adapter || missing("void-plugin-hono-jsx/markdown/compiler")) {
-		let adapter = options.adapter ?? "void-plugin-hono-jsx@^0.4.0";
+		let adapter = options.adapter ?? "void-plugin-hono-jsx@^0.5.0";
 		if (/^\d+\./.test(adapter)) adapter = "void-plugin-hono-jsx@" + adapter;
 		else if (modernYarn && (adapter.endsWith(".tgz") || adapter.startsWith("file:"))) adapter = "void-plugin-hono-jsx@file:" + resolve(cwd, adapter.replace(/^file:/, ""));
 		specs.push(adapter);
@@ -127,26 +131,30 @@ function compare(a, b) {
 	return 0;
 }
 //#endregion
+//#region src/adapters/vite-presets.ts
+/** Initialization policies belong to the host integration, not the compiler. */
+const vitePresets = {
+	void: { dependencies: [...voidDependencies.map(([id]) => id), "void-plugin-hono-jsx/markdown/compiler"] },
+	hono: {
+		dependencies: ["vite", "hono"],
+		clientEntryAssetPath: "/_assets/client"
+	},
+	honox: {
+		dependencies: [
+			"vite",
+			"hono",
+			"honox"
+		],
+		clientEntryAssetPath: "/_assets/client"
+	}
+};
+//#endregion
 //#region src/node/init-vite.ts
 /** Configure an existing Vite app without changing its package scripts. */
 async function initializeVite(cwd, framework, configFile = "hono-decks.config.ts", entry, installation) {
 	if (!configFile || configFile.startsWith("/") || configFile.includes("\\") || /^[A-Za-z]:/.test(configFile) || configFile.split("/").includes("..") || !/\.[cm]?[jt]s$/.test(configFile)) throw new Error("--config must be a JS/TS file inside the current working directory.");
 	const require = createRequire(join(cwd, "package.json"));
-	const dependencies = framework === "void" ? [
-		"void",
-		"vite",
-		"hono",
-		"void-plugin-hono-jsx/markdown/compiler",
-		"markdown-exit",
-		"yaml",
-		"markdown-it-container",
-		"shiki",
-		"@shikijs/transformers"
-	] : [
-		"vite",
-		"hono",
-		...framework === "honox" ? ["honox"] : []
-	];
+	const dependencies = vitePresets[framework].dependencies;
 	for (const dependency of installation ? [] : dependencies) try {
 		require.resolve(dependency);
 	} catch {
@@ -177,7 +185,7 @@ async function initializeVite(cwd, framework, configFile = "hono-decks.config.ts
 
 export default defineDecksConfig({
   mountPath: "/slides",
-  build: { root: "decks"${framework === "void" ? ", markdown: \"void\"" : ""} },
+  build: { root: "decks"${framework === "void" ? ", markdown: \"void\"" : ""} },${vitePresets[framework].clientEntryAssetPath ? `\n  router: { clientEntryAssetPath: ${JSON.stringify(vitePresets[framework].clientEntryAssetPath)} },` : ""}
 });
 `
 		},

package/dist/mod.d.ts

@@ -463,8 +463,11 @@ type DecksRouterOverrides<E extends Env = any> = Partial<Omit<DecksRouterOptions
 type DecksRouterConfig<E extends Env = any> = Omit<DecksRouterOverrides<E>, "source">;
 /** 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/node.d.ts

@@ -236,116 +236,6 @@ declare class RenderError extends Error {
   constructor(message: string, code: string, cause?: unknown);
 }
 //#endregion
-//#region src/routing/file-routing.d.ts
-interface ResolvedDeckFile {
-  slug: string;
-  sourcePath: string;
-  kind: DeckKind;
-  assetPaths: string[];
-}
-declare function resolveDeckFiles(paths: string[], root?: string, options?: {
-  markdown?: boolean;
-}): ResolvedDeckFile[];
-//#endregion
-//#region src/generator/mdx/ogp.d.ts
-interface LinkCardOgpMetadata {
-  title?: string;
-  description?: string;
-  image?: string;
-  siteName?: string;
-}
-//#endregion
-//#region src/generator/component-registry.d.ts
-interface DeckComponentExport {
-  slug: string;
-  sourcePath: string;
-  modulePath: string;
-  exportName: string;
-}
-interface ResolvedDeckComponentExport extends DeckComponentExport {
-  internalName: string;
-}
-interface ApplyDeckComponentRegistryInput {
-  manifest: DeckManifest;
-  components: DeckComponentExport[];
-}
-interface ApplyDeckComponentRegistryResult {
-  manifest: DeckManifest;
-  components: ResolvedDeckComponentExport[];
-}
-declare function applyDeckComponentRegistry(input: ApplyDeckComponentRegistryInput): ApplyDeckComponentRegistryResult;
-declare function emitDeckComponentRegistryModule(components: ResolvedDeckComponentExport[]): string;
-//#endregion
-//#region src/node/compile-decks.d.ts
-interface BuildDeckManifestFromFileSystemInput {
-  cwd: string;
-  root: string;
-  mountPath?: string;
-}
-interface WriteDeckManifestModuleInput {
-  manifest: DeckManifest;
-  outFile: string;
-}
-interface WriteDeckComponentRegistryModuleInput {
-  components: ResolvedDeckComponentExport[];
-  outFile: string;
-}
-interface WriteDecksRouterModuleInput {
-  manifestModulePath: string;
-  componentRegistryModulePath?: string;
-  outFile: string;
-}
-interface CompileDecksInput extends BuildDeckManifestFromFileSystemInput {
-  markdown?: "void";
-  out: string;
-  ogpCacheFile?: string;
-  refreshOgp?: boolean;
-  resolveOgp?(this: void, url: string): Promise<LinkCardOgpMetadata | undefined>;
-}
-/** Build information only; render using createDecks() from routerModulePath. */
-interface CompileDecksResult {
-  outDir: string;
-  routerModulePath: string;
-  decks: DeckBuildSummary[];
-}
-interface DeckBuildSummary extends Omit<CompiledDeck, "slides" | "componentRegistry"> {
-  slides: (Pick<CompiledSlide, "index" | "meta" | "notes"> & {
-    modulePath: string;
-  })[];
-}
-declare function compileDecks(input: CompileDecksInput): Promise<CompileDecksResult>;
-declare function buildDeckManifestFromFileSystem(input: BuildDeckManifestFromFileSystemInput): Promise<DeckManifest>;
-declare function writeDeckManifestModule(input: WriteDeckManifestModuleInput): Promise<void>;
-declare function writeDeckComponentRegistryModule(input: WriteDeckComponentRegistryModuleInput): Promise<void>;
-declare function writeDecksRouterModule(input: WriteDecksRouterModuleInput): Promise<void>;
-//#endregion
-//#region src/node/local-deck-io.d.ts
-interface CreateLocalDeckIOInput {
-  cwd: string;
-  root: string;
-  pathExists?(this: void, path: string): boolean;
-  watchFileSystem?(this: void, path: string, options: {
-    recursive: boolean;
-  }, listener: (eventType: "rename" | "change", filename: string | null) => void): {
-    close(): void;
-  };
-}
-declare function createLocalDeckIO(input: CreateLocalDeckIOInput): LocalDeckIO;
-//#endregion
-//#region src/node/local-dev-app.d.ts
-interface CreateLocalDevSlidesAppInput {
-  cwd: string;
-  root: string;
-  mountPath?: string;
-  watchFileSystem?: CreateLocalDeckIOInput["watchFileSystem"];
-}
-interface LocalDevSlidesApp {
-  app: Hono;
-  localDeckIO: LocalDeckIO;
-  stop: () => void;
-}
-declare function createLocalDevSlidesApp(input: CreateLocalDevSlidesAppInput): Promise<LocalDevSlidesApp>;
-//#endregion
 //#region src/renderer/control-icons.d.ts
 type DeckControlIconName = "deck-list" | "home" | "viewer" | "projection" | "presenter" | "previous" | "next" | "fullscreen" | "external-link" | "print" | "details" | "export-pdf" | "export-png";
 //#endregion
@@ -646,8 +536,11 @@ type DecksRouterOverrides<E extends Env = any> = Partial<Omit<DecksRouterOptions
 type DecksRouterConfig<E extends Env = any> = Omit<DecksRouterOverrides<E>, "source">;
 /** 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" */
@@ -664,6 +557,116 @@ interface DecksConfig<E extends Env = any> {
   router?: DecksRouterConfig<E>;
 }
 //#endregion
+//#region src/routing/file-routing.d.ts
+interface ResolvedDeckFile {
+  slug: string;
+  sourcePath: string;
+  kind: DeckKind;
+  assetPaths: string[];
+}
+declare function resolveDeckFiles(paths: string[], root?: string, options?: {
+  markdown?: boolean;
+}): ResolvedDeckFile[];
+//#endregion
+//#region src/generator/mdx/ogp.d.ts
+interface LinkCardOgpMetadata {
+  title?: string;
+  description?: string;
+  image?: string;
+  siteName?: string;
+}
+//#endregion
+//#region src/generator/component-registry.d.ts
+interface DeckComponentExport {
+  slug: string;
+  sourcePath: string;
+  modulePath: string;
+  exportName: string;
+}
+interface ResolvedDeckComponentExport extends DeckComponentExport {
+  internalName: string;
+}
+interface ApplyDeckComponentRegistryInput {
+  manifest: DeckManifest;
+  components: DeckComponentExport[];
+}
+interface ApplyDeckComponentRegistryResult {
+  manifest: DeckManifest;
+  components: ResolvedDeckComponentExport[];
+}
+declare function applyDeckComponentRegistry(input: ApplyDeckComponentRegistryInput): ApplyDeckComponentRegistryResult;
+declare function emitDeckComponentRegistryModule(components: ResolvedDeckComponentExport[]): string;
+//#endregion
+//#region src/node/compile-decks.d.ts
+interface BuildDeckManifestFromFileSystemInput {
+  cwd: string;
+  root: string;
+  mountPath?: string;
+}
+interface WriteDeckManifestModuleInput {
+  manifest: DeckManifest;
+  outFile: string;
+}
+interface WriteDeckComponentRegistryModuleInput {
+  components: ResolvedDeckComponentExport[];
+  outFile: string;
+}
+interface WriteDecksRouterModuleInput {
+  manifestModulePath: string;
+  componentRegistryModulePath?: string;
+  outFile: string;
+}
+interface CompileDecksInput extends BuildDeckManifestFromFileSystemInput {
+  markdown?: DecksBuildConfig["markdown"];
+  out: string;
+  ogpCacheFile?: string;
+  refreshOgp?: boolean;
+  resolveOgp?(this: void, url: string): Promise<LinkCardOgpMetadata | undefined>;
+}
+/** Build information only; render using createDecks() from routerModulePath. */
+interface CompileDecksResult {
+  outDir: string;
+  routerModulePath: string;
+  decks: DeckBuildSummary[];
+}
+interface DeckBuildSummary extends Omit<CompiledDeck, "slides" | "componentRegistry"> {
+  slides: (Pick<CompiledSlide, "index" | "meta" | "notes"> & {
+    modulePath: string;
+  })[];
+}
+declare function compileDecks(input: CompileDecksInput): Promise<CompileDecksResult>;
+declare function buildDeckManifestFromFileSystem(input: BuildDeckManifestFromFileSystemInput): Promise<DeckManifest>;
+declare function writeDeckManifestModule(input: WriteDeckManifestModuleInput): Promise<void>;
+declare function writeDeckComponentRegistryModule(input: WriteDeckComponentRegistryModuleInput): Promise<void>;
+declare function writeDecksRouterModule(input: WriteDecksRouterModuleInput): Promise<void>;
+//#endregion
+//#region src/node/local-deck-io.d.ts
+interface CreateLocalDeckIOInput {
+  cwd: string;
+  root: string;
+  pathExists?(this: void, path: string): boolean;
+  watchFileSystem?(this: void, path: string, options: {
+    recursive: boolean;
+  }, listener: (eventType: "rename" | "change", filename: string | null) => void): {
+    close(): void;
+  };
+}
+declare function createLocalDeckIO(input: CreateLocalDeckIOInput): LocalDeckIO;
+//#endregion
+//#region src/node/local-dev-app.d.ts
+interface CreateLocalDevSlidesAppInput {
+  cwd: string;
+  root: string;
+  mountPath?: string;
+  watchFileSystem?: CreateLocalDeckIOInput["watchFileSystem"];
+}
+interface LocalDevSlidesApp {
+  app: Hono;
+  localDeckIO: LocalDeckIO;
+  stop: () => void;
+}
+declare function createLocalDevSlidesApp(input: CreateLocalDevSlidesAppInput): Promise<LocalDevSlidesApp>;
+//#endregion
 //#region src/node/config.d.ts
 declare const DEFAULT_DECKS_CONFIG_FILE = "hono-decks.config.ts";
 interface LoadedDecksConfig<E extends Env = any> {

package/dist/node.js

@@ -5,10 +5,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 { existsSync, watch } from "node:fs";
 import { build } from "esbuild";
 import { lookup } from "node:dns/promises";
@@ -1698,29 +1698,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);
@@ -1741,12 +1732,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);
@@ -1796,6 +1788,7 @@ async function compileVoidMarkdownDecks(input) {
 		decks,
 		routerModule: emitModuleDecksRouter({ decks }),
 		clientCode: [...clients].join("\n"),
+		clientModules: [adapter.client([...markdownIslands.values()])].filter(Boolean),
 		markdownIslands: [...markdownIslands.values()]
 	};
 }
@@ -1832,6 +1825,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/generator/component-registry.ts
 function applyDeckComponentRegistry(input) {
 	const components = input.components.map((component) => ({
@@ -1942,12 +1993,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")}
 
@@ -2024,9 +2074,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/path-utils.ts
 function dirname(path) {
@@ -2369,7 +2416,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]] : [];
@@ -2397,7 +2444,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,
@@ -2416,7 +2464,7 @@ async function compileDeckModules(input) {
 		clientEntries: clientEntryPaths,
 		clientComponentIds,
 		extraCode: generated.clientCode,
-		markdownIslands: generated.markdownIslands,
+		clientModules: generated.clientModules,
 		onCss: (css) => {
 			clientCss = css;
 		}
@@ -5701,7 +5749,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,