hono-decks 0.4.5 → 1.0.0

package/README.ja.md

@@ -253,6 +253,7 @@ export default defineDecksConfig({
 - `hono-decks/advanced`: `defineDecks()`、`decksRouter()`、`deckContext()`、raw renderer など独自 pipeline 用
 - `hono-decks/client`: browser hydration
 - `hono-decks/node`: compiler と Node filesystem adapter
+- `hono-decks/vite`: 開発中のcompileとwatchをViteへ組み込むintegration
 - `hono-decks/cli`: programmatic CLI runner
 
 通常の generated workflow では root entry だけを import します。`hono-decks/advanced` は custom `DeckSource` や router をゼロから組み立てる場合に限定してください。

package/README.md

@@ -259,6 +259,7 @@ Image generation is intentionally not part of the core package. The <code>exampl
 - <code>hono-decks/advanced</code>: <code>defineDecks()</code>, <code>decksRouter()</code>, <code>deckContext()</code>, raw renderers, and other low-level pipeline APIs
 - <code>hono-decks/client</code>: browser hydration
 - <code>hono-decks/node</code>: the compiler and Node filesystem adapter
+- <code>hono-decks/vite</code>: Vite integration that compiles and watches decks during development
 - <code>hono-decks/cli</code>: the programmatic CLI runner
 
 The generated workflow normally imports only the root entry. Use <code>hono-decks/advanced</code> only when assembling a custom <code>DeckSource</code> or router from the lower-level primitives.

package/dist/advanced.d.ts

@@ -616,4 +616,4 @@ declare function serveDecksClientEntry(clientEntry: string, options?: ServeDecks
 //#region src/source/manifest-source.d.ts
 declare function manifestDeckSource<E extends Env = any>(manifest: DeckManifest): DeckSource<E>;
 //#endregion
-export { type AssetRef, type CompileWarning, type CompiledDeck, type CompiledSlide, type ComponentPlaceholder, type ConfiguredDecks, type DeckBrowserRunBinding, type DeckBrowserRunPdfOptions, type DeckBrowserRunPngOptions, type DeckContextOptions, type DeckContextVariables, type DeckControlIconName, type DeckDevResolver, type DeckDevResolverInput, type DeckDocumentOptions, type DeckDocumentPageOptions, type DeckDocumentRenderInput, type DeckDocumentSurface, type DeckEntry, type DeckExportOptions, type DeckExportResolverInput, type DeckExternalEmbedContext, type DeckExternalEmbedOptions, type DeckExternalEmbedRenderInput, type DeckExternalEmbedViewerOptions, type DeckFrontmatter, type DeckIndexPageInput, type DeckIndexPageOptions, type DeckIndexRenderInput, type DeckKind, type DeckManifest, type DeckPageMeta, type DeckPaths, type DeckPresenterEnabledInput, type DeckPresenterEnabledResolver, type DeckPresenterViewerControlOptions, type DeckRenderable, type DeckRequestContext, type DeckRouteEnabled, type DeckRouteEnabledResolver, type DeckRouteSurface, type DeckRouteSurfaceInput, type DeckSource, type DeckTocItem, type DeckViewerAvailablePages, type DeckViewerControlDefaults, type DeckViewerControlItem, type DeckViewerControlItemRenderer, type DeckViewerControlKey, type DeckViewerControlRenderInput, type DeckViewerControlSlotItems, type DeckViewerControlsContext, type DeckViewerControlsItemsResolver, type DeckViewerControlsOptions, type DeckViewerDefaultControlItem, type DeckViewerEmbed, type DeckViewerEmbedOptions, type DeckViewerExportPaths, type DeckViewerLinkControlItem, type DeckViewerOptions, type DeckViewerPart, type DeckViewerParts, type DeckViewerRenderControlItem, type DeckViewerRenderInput, type DecksBuildConfig, type DecksConfig, type DecksOptions, type DecksRouterConfig, type DecksRouterExtension, type DecksRouterOptions, type DecksRouterOverrides, type DecksRouterPagesOptions, type DecksRouterPresenterOptions, type DefinedDecks, type MaybePromise, type R2AssetKeyInput, type R2AssetSourceOptions, type R2BucketLike, type R2BucketResolver, type R2ObjectBodyLike, type R2ObjectHttpMetadataLike, type ResolvedDeckDocument, SLIDE_TRANSITIONS, type ServeDecksClientEntryOptions, type SlideComponent, type SlideComponentDefinition, type SlideComponentInput, type SlideComponentProps, type SlideComponentRegistry, type SlideFrontmatter, type SlideTransition, builtInSlideComponents, configureDecks, controlIconLabel, createDeckPaths, createDeckViewerEmbed, createDeckViewerParts, deckContext, decksRouter, defineDecks, defineDecksConfig, defineSlideComponents, manifestDeckSource, mergeDecksRouterOptions, renderCompiledDeck, renderCompiledDeckAsync, renderCompiledDeckPage, renderCompiledDeckPageAsync, renderCompiledSlide, renderCompiledSlideAsync, renderControlIcon, renderControlIconHtml, serveDecksClientEntry, withR2Assets };
+export { type AssetRef, type CompileWarning, type CompiledDeck, type CompiledSlide, type ComponentPlaceholder, type ConfiguredDecks, type DeckBrowserRunBinding, type DeckBrowserRunPdfOptions, type DeckBrowserRunPngOptions, type DeckContextOptions, type DeckContextVariables, type DeckControlIconName, type DeckDevResolver, type DeckDevResolverInput, type DeckDocumentOptions, type DeckDocumentPageOptions, type DeckDocumentRenderInput, type DeckDocumentSurface, type DeckEntry, type DeckExportOptions, type DeckExportResolverInput, type DeckExternalEmbedContext, type DeckExternalEmbedOptions, type DeckExternalEmbedRenderInput, type DeckExternalEmbedViewerOptions, type DeckFrontmatter, type DeckIndexPageInput, type DeckIndexPageOptions, type DeckIndexRenderInput, type DeckKind, type DeckManifest, type DeckPageMeta, type DeckPaths, type DeckPresenterEnabledInput, type DeckPresenterEnabledResolver, type DeckPresenterViewerControlOptions, type DeckRenderable, type DeckRequestContext, type DeckRouteEnabled, type DeckRouteEnabledResolver, type DeckRouteSurface, type DeckRouteSurfaceInput, type DeckSource, type DeckTocItem, type DeckViewerAvailablePages, type DeckViewerControlDefaults, type DeckViewerControlItem, type DeckViewerControlItemRenderer, type DeckViewerControlKey, type DeckViewerControlRenderInput, type DeckViewerControlSlotItems, type DeckViewerControlsContext, type DeckViewerControlsItemsResolver, type DeckViewerControlsOptions, type DeckViewerDefaultControlItem, type DeckViewerEmbed, type DeckViewerEmbedOptions, type DeckViewerExportPaths, type DeckViewerLinkControlItem, type DeckViewerOpenGraphInput, type DeckViewerOpenGraphOptions, type DeckViewerOptions, type DeckViewerPart, type DeckViewerParts, type DeckViewerRenderControlItem, type DeckViewerRenderInput, type DecksBuildConfig, type DecksConfig, type DecksOptions, type DecksRouterConfig, type DecksRouterExtension, type DecksRouterOptions, type DecksRouterOverrides, type DecksRouterPagesOptions, type DecksRouterPresenterOptions, type DefinedDecks, type MaybePromise, type R2AssetKeyInput, type R2AssetSourceOptions, type R2BucketLike, type R2BucketResolver, type R2ObjectBodyLike, type R2ObjectHttpMetadataLike, type ResolvedDeckDocument, SLIDE_TRANSITIONS, type ServeDecksClientEntryOptions, type SlideComponent, type SlideComponentDefinition, type SlideComponentInput, type SlideComponentProps, type SlideComponentRegistry, type SlideFrontmatter, type SlideTransition, builtInSlideComponents, configureDecks, controlIconLabel, createDeckPaths, createDeckViewerEmbed, createDeckViewerParts, deckContext, decksRouter, defineDecks, defineDecksConfig, defineSlideComponents, manifestDeckSource, mergeDecksRouterOptions, renderCompiledDeck, renderCompiledDeckAsync, renderCompiledDeckPage, renderCompiledDeckPageAsync, renderCompiledSlide, renderCompiledSlideAsync, renderControlIcon, renderControlIconHtml, serveDecksClientEntry, withR2Assets };

package/dist/advanced.js

@@ -333,10 +333,13 @@ function defineSlideComponents(input) {
 }
 function createMdxComponents(registry, input = {}) {
 	const components = {
-		img: (props) => jsx("img", rewriteAssetProps(props, input.assets)),
-		a: (props) => jsx("a", rewriteAssetProps(props, input.assets))
+		img: (props) => jsx("img", rewriteAssetProps(props ?? {}, input.assets)),
+		a: (props) => jsx("a", rewriteAssetProps(props ?? {}, input.assets))
+	};
+	for (const [name, definition] of Object.entries(registry)) components[name] = (props) => {
+		const resolvedProps = props ?? {};
+		return renderRegisteredComponent(name, definition, resolvedProps, resolvedProps.children, input.assets);
 	};
-	for (const [name, definition] of Object.entries(registry)) components[name] = (props = {}) => renderRegisteredComponent(name, definition, props, props.children, input.assets);
 	return components;
 }
 function heroImage(props) {
@@ -391,7 +394,11 @@ function codeBlockText(value) {
 	if (value === null || value === void 0 || typeof value === "boolean") return "";
 	if (typeof value === "string" || typeof value === "number") return String(value);
 	if (isJsxValue(value)) return codeBlockText(value.props?.children);
-	return String(value);
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "";
+	}
 }
 function renderSlideNodes(nodes, input = {}) {
 	return normalizeVoidElementSpacing(nodes.map((node) => String(renderSlideNode(node, input))).join(""));
@@ -707,6 +714,7 @@ function renderPresentationScript(nonce) {
   let isTransitioning = false;
   let pendingNavigation = null;
   let transitionToken = 0;
+  let touchStart = null;
 
   function fitDeck() {
     if (!(stage instanceof HTMLElement) || !(deck instanceof HTMLElement)) return;
@@ -748,10 +756,10 @@ function renderPresentationScript(nonce) {
     const entries = slideFires(slide).map((fire) => {
       const rawAt = fire.getAttribute("data-fire-at");
       let position;
-      if (rawAt !== null && /^\d+$/.test(rawAt)) {
+      if (rawAt !== null && /^[0-9]+$/.test(rawAt)) {
         position = Number(rawAt);
       } else {
-        const offset = rawAt !== null && /^[+-]\d+$/.test(rawAt) ? Number(rawAt) : 1;
+        const offset = rawAt !== null && /^[+-][0-9]+$/.test(rawAt) ? Number(rawAt) : 1;
         cursor += offset;
         position = cursor;
       }
@@ -1039,6 +1047,33 @@ function renderPresentationScript(nonce) {
     if (action === "overview") toggleOverview();
   }
 
+  function isInteractiveTouchTarget(target) {
+    return target instanceof Element && Boolean(target.closest("a,button,input,select,textarea,[contenteditable],[role='button']"));
+  }
+
+  function handleTouchStart(event) {
+    if (event.touches.length !== 1 || isInteractiveTouchTarget(event.target)) {
+      touchStart = null;
+      return;
+    }
+    const touch = event.touches[0];
+    touchStart = { x: touch.clientX, y: touch.clientY };
+  }
+
+  function handleTouchEnd(event) {
+    if (!touchStart || event.changedTouches.length !== 1) {
+      touchStart = null;
+      return;
+    }
+    const touch = event.changedTouches[0];
+    const deltaX = touch.clientX - touchStart.x;
+    const deltaY = touch.clientY - touchStart.y;
+    touchStart = null;
+    const threshold = Math.max(48, window.innerWidth * 0.08);
+    if (Math.abs(deltaX) < threshold || Math.abs(deltaX) <= Math.abs(deltaY) * 1.25) return;
+    handleCommand(deltaX < 0 ? "next" : "previous");
+  }
+
   async function toggleFullscreen() {
     if (document.fullscreenElement) {
       await document.exitFullscreen?.();
@@ -1062,6 +1097,9 @@ function renderPresentationScript(nonce) {
     if (event.key === "p") handleCommand("presenter");
     if (event.key === "o") handleCommand("overview");
   });
+  document.addEventListener("touchstart", handleTouchStart, { passive: true });
+  document.addEventListener("touchend", handleTouchEnd, { passive: true });
+  document.addEventListener("touchcancel", () => { touchStart = null; }, { passive: true });
 
   window.addEventListener("message", (event) => {
     const message = event.data;
@@ -2137,7 +2175,7 @@ async function renderDeckViewerPage(input) {
   ${document.head}
 </head>
 <body>
-  ${await renderJsxValue(await content)}
+  ${await renderJsxValue(content)}
   ${renderViewerScript(document.nonce)}
 </body>
 </html>`;
@@ -2469,10 +2507,25 @@ async function renderDeckExternalEmbedResponse(input) {
 		mountPath,
 		title: deck.meta.title ?? slug
 	}, input.document, input.options.document);
+	const viewerOptions = typeof input.options.viewer === "function" ? await input.options.viewer(input.context) : input.options.viewer;
+	const controls = viewerOptions?.controls === void 0 ? { items: (_defaults, context) => [{
+		type: "link",
+		key: "open-viewer",
+		href: context.meta.paths.viewer,
+		label: "Open full viewer in new tab",
+		icon: "external-link",
+		attributes: {
+			"aria-label": "Open full viewer in new tab",
+			"data-hono-decks-viewer-link": true,
+			target: "_blank",
+			rel: "noreferrer"
+		}
+	}] } : viewerOptions.controls;
 	const viewer = await createDeckViewerEmbed({
 		deck,
 		mountPath,
-		...typeof input.options.viewer === "function" ? await input.options.viewer(input.context) : input.options.viewer,
+		...viewerOptions,
+		controls,
 		availablePages: input.availablePages,
 		nonce: document.nonce
 	});

package/dist/bin.js

@@ -262,7 +262,7 @@ function takeKnownStringWithWarning(attrs, key, values, fallback, warnings, code
 	if (typeof value === "string" && values.includes(value)) return value;
 	warnings.push({
 		code,
-		message: `Unknown ${key} value "${String(value)}"; using ${fallback}.`,
+		message: `Unknown ${key} value "${formatFrontmatterValue(value)}"; using ${fallback}.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 	return fallback;
@@ -274,7 +274,7 @@ function takeTransitionDuration(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionDuration(value)) return value;
 	warnings.push({
 		code: "invalid-transition-duration",
-		message: `Invalid transitionDuration value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionDuration value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
@@ -285,10 +285,20 @@ function takeTransitionEasing(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionEasing(value)) return value;
 	warnings.push({
 		code: "invalid-transition-easing",
-		message: `Invalid transitionEasing value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionEasing value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
+function formatFrontmatterValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return value.toString();
+	if (value === null) return "null";
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "[unserializable value]";
+	}
+}
 function isValidTransitionDuration(value) {
 	return value.split(",").map((item) => item.trim()).every((item) => /^(?:\d+|\d*\.\d+)(?:ms|s)$/.test(item));
 }
@@ -1130,7 +1140,7 @@ function fireAtAttributeValue(value) {
 function zennEmbedNode(node, input) {
 	if (node.type !== "paragraph" || !Array.isArray(node.children) || node.children.length !== 2) return void 0;
 	const [prefix, link] = node.children;
-	if (prefix?.type !== "text" || String(prefix.value ?? "").trim() !== "@") return void 0;
+	if (prefix?.type !== "text" || typeof prefix.value !== "string" || prefix.value.trim() !== "@") return void 0;
 	if (link?.type !== "link" || typeof link.url !== "string") return void 0;
 	const name = collectMarkdownText(link).trim().toLowerCase();
 	if (name === "youtube") return mdxElement("EmbedFrame", [

package/dist/cli.d.ts

@@ -7,7 +7,7 @@ interface RunHonoDecksCliInput {
   /** Stops a long-running `compile --watch` command. */
   signal?: AbortSignal;
   /** Test/tooling hook for filesystem watching. */
-  watchFileSystem?(path: string, options: {
+  watchFileSystem?(this: void, path: string, options: {
     recursive: boolean;
   }, listener: (eventType: "rename" | "change", filename: string | null) => void): {
     close(): void;

package/dist/cli.js

@@ -261,7 +261,7 @@ function takeKnownStringWithWarning(attrs, key, values, fallback, warnings, code
 	if (typeof value === "string" && values.includes(value)) return value;
 	warnings.push({
 		code,
-		message: `Unknown ${key} value "${String(value)}"; using ${fallback}.`,
+		message: `Unknown ${key} value "${formatFrontmatterValue(value)}"; using ${fallback}.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 	return fallback;
@@ -273,7 +273,7 @@ function takeTransitionDuration(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionDuration(value)) return value;
 	warnings.push({
 		code: "invalid-transition-duration",
-		message: `Invalid transitionDuration value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionDuration value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
@@ -284,10 +284,20 @@ function takeTransitionEasing(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionEasing(value)) return value;
 	warnings.push({
 		code: "invalid-transition-easing",
-		message: `Invalid transitionEasing value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionEasing value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
+function formatFrontmatterValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return value.toString();
+	if (value === null) return "null";
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "[unserializable value]";
+	}
+}
 function isValidTransitionDuration(value) {
 	return value.split(",").map((item) => item.trim()).every((item) => /^(?:\d+|\d*\.\d+)(?:ms|s)$/.test(item));
 }
@@ -1129,7 +1139,7 @@ function fireAtAttributeValue(value) {
 function zennEmbedNode(node, input) {
 	if (node.type !== "paragraph" || !Array.isArray(node.children) || node.children.length !== 2) return void 0;
 	const [prefix, link] = node.children;
-	if (prefix?.type !== "text" || String(prefix.value ?? "").trim() !== "@") return void 0;
+	if (prefix?.type !== "text" || typeof prefix.value !== "string" || prefix.value.trim() !== "@") return void 0;
 	if (link?.type !== "link" || typeof link.url !== "string") return void 0;
 	const name = collectMarkdownText(link).trim().toLowerCase();
 	if (name === "youtube") return mdxElement("EmbedFrame", [

package/dist/mod.d.ts

@@ -521,4 +521,4 @@ interface R2AssetSourceOptions<E extends Env = any> {
 }
 declare function withR2Assets<E extends Env = any>(source: DeckSource<E>, options: R2AssetSourceOptions<E>): DeckSource<E>;
 //#endregion
-export { type AssetRef, type CompileWarning, type CompiledDeck, type CompiledSlide, type ComponentPlaceholder, type ConfiguredDecks, type DeckBrowserRunBinding, type DeckBrowserRunPdfOptions, type DeckBrowserRunPngOptions, type DeckContextVariables, type DeckControlIconName, type DeckDevResolver, type DeckDevResolverInput, type DeckDocumentOptions, type DeckDocumentPageOptions, type DeckDocumentRenderInput, type DeckDocumentSurface, type DeckEntry, type DeckExportOptions, type DeckExportResolverInput, type DeckExternalEmbedContext, type DeckExternalEmbedOptions, type DeckExternalEmbedRenderInput, type DeckExternalEmbedViewerOptions, type DeckFrontmatter, type DeckIndexPageInput, type DeckIndexPageOptions, type DeckIndexRenderInput, type DeckKind, type DeckManifest, type DeckPageMeta, type DeckPaths, type DeckPresenterEnabledInput, type DeckPresenterEnabledResolver, type DeckPresenterViewerControlOptions, type DeckRenderable, type DeckRequestContext, type DeckRouteEnabled, type DeckRouteEnabledResolver, type DeckRouteSurface, type DeckRouteSurfaceInput, type DeckSource, type DeckTocItem, type DeckViewerAvailablePages, type DeckViewerControlDefaults, type DeckViewerControlItem, type DeckViewerControlItemRenderer, type DeckViewerControlKey, type DeckViewerControlRenderInput, type DeckViewerControlSlotItems, type DeckViewerControlsContext, type DeckViewerControlsItemsResolver, type DeckViewerControlsOptions, type DeckViewerDefaultControlItem, type DeckViewerEmbed, type DeckViewerEmbedOptions, type DeckViewerExportPaths, type DeckViewerLinkControlItem, type DeckViewerOptions, type DeckViewerPart, type DeckViewerParts, type DeckViewerRenderControlItem, type DeckViewerRenderInput, type DecksBuildConfig, type DecksConfig, type DecksRouterConfig, type DecksRouterExtension, type DecksRouterOptions, type DecksRouterPagesOptions, type DecksRouterPresenterOptions, type MaybePromise, type R2AssetKeyInput, type R2AssetSourceOptions, type R2BucketLike, type R2BucketResolver, type R2ObjectBodyLike, type R2ObjectHttpMetadataLike, type ResolvedDeckDocument, SLIDE_TRANSITIONS, type SlideComponent, type SlideComponentDefinition, type SlideComponentInput, type SlideComponentProps, type SlideComponentRegistry, type SlideFrontmatter, type SlideTransition, createDeckPaths, createDeckViewerEmbed, defineDecksConfig, defineSlideComponents, withR2Assets };
+export { type AssetRef, type CompileWarning, type CompiledDeck, type CompiledSlide, type ComponentPlaceholder, type ConfiguredDecks, type DeckBrowserRunBinding, type DeckBrowserRunPdfOptions, type DeckBrowserRunPngOptions, type DeckContextVariables, type DeckControlIconName, type DeckDevResolver, type DeckDevResolverInput, type DeckDocumentOptions, type DeckDocumentPageOptions, type DeckDocumentRenderInput, type DeckDocumentSurface, type DeckEntry, type DeckExportOptions, type DeckExportResolverInput, type DeckExternalEmbedContext, type DeckExternalEmbedOptions, type DeckExternalEmbedRenderInput, type DeckExternalEmbedViewerOptions, type DeckFrontmatter, type DeckIndexPageInput, type DeckIndexPageOptions, type DeckIndexRenderInput, type DeckKind, type DeckManifest, type DeckPageMeta, type DeckPaths, type DeckPresenterEnabledInput, type DeckPresenterEnabledResolver, type DeckPresenterViewerControlOptions, type DeckRenderable, type DeckRequestContext, type DeckRouteEnabled, type DeckRouteEnabledResolver, type DeckRouteSurface, type DeckRouteSurfaceInput, type DeckSource, type DeckTocItem, type DeckViewerAvailablePages, type DeckViewerControlDefaults, type DeckViewerControlItem, type DeckViewerControlItemRenderer, type DeckViewerControlKey, type DeckViewerControlRenderInput, type DeckViewerControlSlotItems, type DeckViewerControlsContext, type DeckViewerControlsItemsResolver, type DeckViewerControlsOptions, type DeckViewerDefaultControlItem, type DeckViewerEmbed, type DeckViewerEmbedOptions, type DeckViewerExportPaths, type DeckViewerLinkControlItem, type DeckViewerOpenGraphInput, type DeckViewerOpenGraphOptions, type DeckViewerOptions, type DeckViewerPart, type DeckViewerParts, type DeckViewerRenderControlItem, type DeckViewerRenderInput, type DecksBuildConfig, type DecksConfig, type DecksRouterConfig, type DecksRouterExtension, type DecksRouterOptions, type DecksRouterPagesOptions, type DecksRouterPresenterOptions, type MaybePromise, type R2AssetKeyInput, type R2AssetSourceOptions, type R2BucketLike, type R2BucketResolver, type R2ObjectBodyLike, type R2ObjectHttpMetadataLike, type ResolvedDeckDocument, SLIDE_TRANSITIONS, type SlideComponent, type SlideComponentDefinition, type SlideComponentInput, type SlideComponentProps, type SlideComponentRegistry, type SlideFrontmatter, type SlideTransition, createDeckPaths, createDeckViewerEmbed, defineDecksConfig, defineSlideComponents, withR2Assets };

package/dist/mod.js

@@ -292,7 +292,11 @@ function codeBlockText(value) {
 	if (value === null || value === void 0 || typeof value === "boolean") return "";
 	if (typeof value === "string" || typeof value === "number") return String(value);
 	if (isJsxValue(value)) return codeBlockText(value.props?.children);
-	return String(value);
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "";
+	}
 }
 async function renderJsxValue(value) {
 	const resolved = value instanceof Promise ? await value : value;

package/dist/node.d.ts

@@ -295,7 +295,7 @@ interface CompileDecksInput extends BuildDeckManifestFromFileSystemInput {
   out: string;
   ogpCacheFile?: string;
   refreshOgp?: boolean;
-  resolveOgp?(url: string): Promise<LinkCardOgpMetadata | undefined>;
+  resolveOgp?(this: void, url: string): Promise<LinkCardOgpMetadata | undefined>;
 }
 declare function compileDecks(input: CompileDecksInput): Promise<DeckManifest>;
 declare function buildDeckManifestFromFileSystem(input: BuildDeckManifestFromFileSystemInput): Promise<DeckManifest>;
@@ -307,8 +307,8 @@ declare function writeDecksRouterModule(input: WriteDecksRouterModuleInput): Pro
 interface CreateLocalDeckIOInput {
   cwd: string;
   root: string;
-  pathExists?(path: string): boolean;
-  watchFileSystem?(path: string, options: {
+  pathExists?(this: void, path: string): boolean;
+  watchFileSystem?(this: void, path: string, options: {
     recursive: boolean;
   }, listener: (eventType: "rename" | "change", filename: string | null) => void): {
     close(): void;
@@ -326,7 +326,7 @@ interface CreateLocalDevSlidesAppInput {
 interface LocalDevSlidesApp {
   app: Hono;
   localDeckIO: LocalDeckIO;
-  stop(): void;
+  stop: () => void;
 }
 declare function createLocalDevSlidesApp(input: CreateLocalDevSlidesAppInput): Promise<LocalDevSlidesApp>;
 //#endregion

package/dist/node.js

@@ -275,7 +275,7 @@ function takeKnownStringWithWarning(attrs, key, values, fallback, warnings, code
 	if (typeof value === "string" && values.includes(value)) return value;
 	warnings.push({
 		code,
-		message: `Unknown ${key} value "${String(value)}"; using ${fallback}.`,
+		message: `Unknown ${key} value "${formatFrontmatterValue(value)}"; using ${fallback}.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 	return fallback;
@@ -287,7 +287,7 @@ function takeTransitionDuration(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionDuration(value)) return value;
 	warnings.push({
 		code: "invalid-transition-duration",
-		message: `Invalid transitionDuration value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionDuration value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
@@ -298,10 +298,20 @@ function takeTransitionEasing(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionEasing(value)) return value;
 	warnings.push({
 		code: "invalid-transition-easing",
-		message: `Invalid transitionEasing value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionEasing value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
+function formatFrontmatterValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return value.toString();
+	if (value === null) return "null";
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "[unserializable value]";
+	}
+}
 function isValidTransitionDuration(value) {
 	return value.split(",").map((item) => item.trim()).every((item) => /^(?:\d+|\d*\.\d+)(?:ms|s)$/.test(item));
 }
@@ -1328,7 +1338,7 @@ function fireAtAttributeValue(value) {
 function zennEmbedNode(node, input) {
 	if (node.type !== "paragraph" || !Array.isArray(node.children) || node.children.length !== 2) return void 0;
 	const [prefix, link] = node.children;
-	if (prefix?.type !== "text" || String(prefix.value ?? "").trim() !== "@") return void 0;
+	if (prefix?.type !== "text" || typeof prefix.value !== "string" || prefix.value.trim() !== "@") return void 0;
 	if (link?.type !== "link" || typeof link.url !== "string") return void 0;
 	const name = collectMarkdownText(link).trim().toLowerCase();
 	if (name === "youtube") return mdxElement("EmbedFrame", [
@@ -2756,10 +2766,13 @@ function defineSlideComponents(input) {
 }
 function createMdxComponents(registry, input = {}) {
 	const components = {
-		img: (props) => jsx("img", rewriteAssetProps(props, input.assets)),
-		a: (props) => jsx("a", rewriteAssetProps(props, input.assets))
+		img: (props) => jsx("img", rewriteAssetProps(props ?? {}, input.assets)),
+		a: (props) => jsx("a", rewriteAssetProps(props ?? {}, input.assets))
+	};
+	for (const [name, definition] of Object.entries(registry)) components[name] = (props) => {
+		const resolvedProps = props ?? {};
+		return renderRegisteredComponent(name, definition, resolvedProps, resolvedProps.children, input.assets);
 	};
-	for (const [name, definition] of Object.entries(registry)) components[name] = (props = {}) => renderRegisteredComponent(name, definition, props, props.children, input.assets);
 	return components;
 }
 function heroImage(props) {
@@ -2814,7 +2827,11 @@ function codeBlockText(value) {
 	if (value === null || value === void 0 || typeof value === "boolean") return "";
 	if (typeof value === "string" || typeof value === "number") return String(value);
 	if (isJsxValue(value)) return codeBlockText(value.props?.children);
-	return String(value);
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "";
+	}
 }
 function renderSlideNodes(nodes, input = {}) {
 	return normalizeVoidElementSpacing(nodes.map((node) => String(renderSlideNode(node, input))).join(""));
@@ -3130,6 +3147,7 @@ function renderPresentationScript(nonce) {
   let isTransitioning = false;
   let pendingNavigation = null;
   let transitionToken = 0;
+  let touchStart = null;
 
   function fitDeck() {
     if (!(stage instanceof HTMLElement) || !(deck instanceof HTMLElement)) return;
@@ -3171,10 +3189,10 @@ function renderPresentationScript(nonce) {
     const entries = slideFires(slide).map((fire) => {
       const rawAt = fire.getAttribute("data-fire-at");
       let position;
-      if (rawAt !== null && /^\d+$/.test(rawAt)) {
+      if (rawAt !== null && /^[0-9]+$/.test(rawAt)) {
         position = Number(rawAt);
       } else {
-        const offset = rawAt !== null && /^[+-]\d+$/.test(rawAt) ? Number(rawAt) : 1;
+        const offset = rawAt !== null && /^[+-][0-9]+$/.test(rawAt) ? Number(rawAt) : 1;
         cursor += offset;
         position = cursor;
       }
@@ -3462,6 +3480,33 @@ function renderPresentationScript(nonce) {
     if (action === "overview") toggleOverview();
   }
 
+  function isInteractiveTouchTarget(target) {
+    return target instanceof Element && Boolean(target.closest("a,button,input,select,textarea,[contenteditable],[role='button']"));
+  }
+
+  function handleTouchStart(event) {
+    if (event.touches.length !== 1 || isInteractiveTouchTarget(event.target)) {
+      touchStart = null;
+      return;
+    }
+    const touch = event.touches[0];
+    touchStart = { x: touch.clientX, y: touch.clientY };
+  }
+
+  function handleTouchEnd(event) {
+    if (!touchStart || event.changedTouches.length !== 1) {
+      touchStart = null;
+      return;
+    }
+    const touch = event.changedTouches[0];
+    const deltaX = touch.clientX - touchStart.x;
+    const deltaY = touch.clientY - touchStart.y;
+    touchStart = null;
+    const threshold = Math.max(48, window.innerWidth * 0.08);
+    if (Math.abs(deltaX) < threshold || Math.abs(deltaX) <= Math.abs(deltaY) * 1.25) return;
+    handleCommand(deltaX < 0 ? "next" : "previous");
+  }
+
   async function toggleFullscreen() {
     if (document.fullscreenElement) {
       await document.exitFullscreen?.();
@@ -3485,6 +3530,9 @@ function renderPresentationScript(nonce) {
     if (event.key === "p") handleCommand("presenter");
     if (event.key === "o") handleCommand("overview");
   });
+  document.addEventListener("touchstart", handleTouchStart, { passive: true });
+  document.addEventListener("touchend", handleTouchEnd, { passive: true });
+  document.addEventListener("touchcancel", () => { touchStart = null; }, { passive: true });
 
   window.addEventListener("message", (event) => {
     const message = event.data;
@@ -4497,7 +4545,7 @@ async function renderDeckViewerPage(input) {
   ${document.head}
 </head>
 <body>
-  ${await renderJsxValue(await content)}
+  ${await renderJsxValue(content)}
   ${renderViewerScript(document.nonce)}
 </body>
 </html>`;
@@ -4829,10 +4877,25 @@ async function renderDeckExternalEmbedResponse(input) {
 		mountPath,
 		title: deck.meta.title ?? slug
 	}, input.document, input.options.document);
+	const viewerOptions = typeof input.options.viewer === "function" ? await input.options.viewer(input.context) : input.options.viewer;
+	const controls = viewerOptions?.controls === void 0 ? { items: (_defaults, context) => [{
+		type: "link",
+		key: "open-viewer",
+		href: context.meta.paths.viewer,
+		label: "Open full viewer in new tab",
+		icon: "external-link",
+		attributes: {
+			"aria-label": "Open full viewer in new tab",
+			"data-hono-decks-viewer-link": true,
+			target: "_blank",
+			rel: "noreferrer"
+		}
+	}] } : viewerOptions.controls;
 	const viewer = await createDeckViewerEmbed({
 		deck,
 		mountPath,
-		...typeof input.options.viewer === "function" ? await input.options.viewer(input.context) : input.options.viewer,
+		...viewerOptions,
+		controls,
 		availablePages: input.availablePages,
 		nonce: document.nonce
 	});

package/dist/vite.js

@@ -261,7 +261,7 @@ function takeKnownStringWithWarning(attrs, key, values, fallback, warnings, code
 	if (typeof value === "string" && values.includes(value)) return value;
 	warnings.push({
 		code,
-		message: `Unknown ${key} value "${String(value)}"; using ${fallback}.`,
+		message: `Unknown ${key} value "${formatFrontmatterValue(value)}"; using ${fallback}.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 	return fallback;
@@ -273,7 +273,7 @@ function takeTransitionDuration(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionDuration(value)) return value;
 	warnings.push({
 		code: "invalid-transition-duration",
-		message: `Invalid transitionDuration value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionDuration value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
@@ -284,10 +284,20 @@ function takeTransitionEasing(attrs, warnings, slideIndex) {
 	if (typeof value === "string" && isValidTransitionEasing(value)) return value;
 	warnings.push({
 		code: "invalid-transition-easing",
-		message: `Invalid transitionEasing value "${String(value)}"; ignoring it.`,
+		message: `Invalid transitionEasing value "${formatFrontmatterValue(value)}"; ignoring it.`,
 		...slideIndex !== void 0 ? { slideIndex } : {}
 	});
 }
+function formatFrontmatterValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return value.toString();
+	if (value === null) return "null";
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return "[unserializable value]";
+	}
+}
 function isValidTransitionDuration(value) {
 	return value.split(",").map((item) => item.trim()).every((item) => /^(?:\d+|\d*\.\d+)(?:ms|s)$/.test(item));
 }
@@ -1129,7 +1139,7 @@ function fireAtAttributeValue(value) {
 function zennEmbedNode(node, input) {
 	if (node.type !== "paragraph" || !Array.isArray(node.children) || node.children.length !== 2) return void 0;
 	const [prefix, link] = node.children;
-	if (prefix?.type !== "text" || String(prefix.value ?? "").trim() !== "@") return void 0;
+	if (prefix?.type !== "text" || typeof prefix.value !== "string" || prefix.value.trim() !== "@") return void 0;
 	if (link?.type !== "link" || typeof link.url !== "string") return void 0;
 	const name = collectMarkdownText(link).trim().toLowerCase();
 	if (name === "youtube") return mdxElement("EmbedFrame", [
@@ -1993,7 +2003,7 @@ function honoDecks(options = {}) {
 		if (!server) return;
 		const next = /* @__PURE__ */ new Set([deckRoot, configPath]);
 		const removed = [...watchedPaths].filter((path) => !next.has(path));
-		if (removed.length > 0) await server.watcher.unwatch(removed);
+		if (removed.length > 0) server.watcher.unwatch(removed);
 		server.watcher.add([...next]);
 		watchedPaths = next;
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-decks",
-  "version": "0.4.5",
+  "version": "1.0.0",
   "description": "Slide decks for Hono and Cloudflare Workers",
   "keywords": [
     "cloudflare-workers",