fumapress 0.2.4 → 0.3.0

package/dist/layouts/blog.js

@@ -0,0 +1,85 @@
+import { getCreationDate, renderBody, renderPageMeta, renderToc } from "../lib/shared.js";
+import { joinPathname } from "../lib/join-pathname.js";
+import { LinkToHome } from "../components/blog.js";
+import { getTags } from "../lib/shared/blog.js";
+import { BlogPanel, BlogProvider } from "../components/blog-panel.js";
+import { createHomeLayout } from "./home.js";
+import { Link } from "waku";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { unstable_notFound } from "waku/router/server";
+import { TagIcon } from "lucide-react";
+//#region src/layouts/blog.tsx
+function createBlogLayout(options) {
+	const HomeLayout = createHomeLayout(options);
+	return function BlogLayout({ children, ctx, lang }) {
+		return /* @__PURE__ */ jsx(HomeLayout, {
+			lang,
+			ctx,
+			children: /* @__PURE__ */ jsx("main", {
+				className: "flex flex-col w-full max-w-[1400px] flex-1 px-4 pt-6 pb-20 mx-auto",
+				children
+			})
+		});
+	};
+}
+function createBlogLayoutPage(options = {}) {
+	const { render } = options;
+	return async function BlogLayoutPage({ slugs, ctx, blog, lang }) {
+		const page = (await ctx.getLoader()).getPage(slugs, lang);
+		if (!page) unstable_notFound();
+		const tags = await getTags(ctx, page);
+		const _raw = await render?.call(ctx, page);
+		const result = {
+			body: _raw?.body ?? await renderBody(ctx, page, "[Fumapress] Please specify the `render` option in createBlogLayoutPage()"),
+			toc: _raw?.toc ?? await renderToc(ctx, page) ?? [],
+			creationDate: _raw?.creationDate ?? await getCreationDate(ctx, page)
+		};
+		return /* @__PURE__ */ jsxs(BlogProvider, {
+			toc: result.toc,
+			children: [
+				renderPageMeta(page, ctx),
+				/* @__PURE__ */ jsxs("div", {
+					className: "flex flex-col gap-4 items-center border-y px-4 pt-3.5 pb-6 bg-fd-card text-fd-card-foreground shadow-inner max-sm:-mx-4 sm:rounded-xl sm:border",
+					children: [
+						/* @__PURE__ */ jsx("div", {
+							className: "flex flex-row items-center gap-2 w-full max-w-[900px]",
+							children: /* @__PURE__ */ jsx(LinkToHome, {
+								blog,
+								lang
+							})
+						}),
+						/* @__PURE__ */ jsx("h1", {
+							className: "font-semibold text-2xl w-full max-w-[900px]",
+							children: page.data.title
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-fd-muted-foreground w-full max-w-[900px]",
+							children: page.data.description
+						}),
+						tags && tags.length > 0 && /* @__PURE__ */ jsxs("div", {
+							className: "flex flex-row items-center gap-2 flex-wrap w-full max-w-[900px] text-sm text-fd-primary-foreground font-mono",
+							children: [/* @__PURE__ */ jsx(TagIcon, { className: "size-4 text-fd-muted-foreground" }), tags.map((t) => {
+								if (blog.tagsPath !== false) return /* @__PURE__ */ jsx(Link, {
+									to: joinPathname(lang ?? "", blog.tagsPath, t),
+									className: "px-1.5 py-0.5 rounded-lg bg-fd-primary",
+									children: t
+								}, t);
+								return /* @__PURE__ */ jsx("p", {
+									className: "px-1.5 py-0.5 rounded-lg bg-fd-primary",
+									children: t
+								}, t);
+							})]
+						})
+					]
+				}),
+				/* @__PURE__ */ jsx("article", {
+					className: "prose mt-6 mx-auto w-full max-w-[900px]",
+					children: result.body
+				}),
+				/* @__PURE__ */ jsx(BlogPanel, {})
+			]
+		});
+	};
+}
+//#endregion
+export { createBlogLayout, createBlogLayoutPage };

package/dist/layouts/blog.tags.d.ts

@@ -0,0 +1,19 @@
+import { ConfigContext } from "../config.js";
+import { BlogTagPage, BlogTagsPage } from "../plugins/blog.js";
+import { ReactNode } from "react";
+
+//#region src/layouts/blog.tags.d.ts
+interface BlogTagsPageOptions {
+  heading?: ReactNode;
+  description?: ReactNode;
+}
+declare function createBlogTagsPage<C extends ConfigContext = ConfigContext>({
+  heading,
+  description
+}?: BlogTagsPageOptions): BlogTagsPage<C>;
+declare function createBlogTagPage<C extends ConfigContext = ConfigContext>({
+  heading,
+  description
+}?: BlogTagsPageOptions): BlogTagPage<C>;
+//#endregion
+export { BlogTagsPageOptions, createBlogTagPage, createBlogTagsPage };

package/dist/layouts/blog.tags.js

@@ -0,0 +1,113 @@
+import { LinkToHome, OrderedBlogGrid } from "../components/blog.js";
+import { getTags, groupTags } from "../lib/shared/blog.js";
+import { Link } from "waku";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { NewspaperIcon, TagIcon } from "lucide-react";
+//#region src/layouts/blog.tags.tsx
+function createBlogTagsPage({ heading, description } = {}) {
+	return async function BlogTagsPage({ lang, blog, ctx }) {
+		const grouped = await groupTags(ctx, (await ctx.getLoader()).getPages(lang).filter((page) => blog.isBlog.call(ctx, page)));
+		return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex flex-col items-start gap-4 border-y px-4 pt-3.5 pb-6 bg-fd-card text-fd-card-foreground shadow-inner max-sm:-mx-4 sm:rounded-xl sm:border",
+			children: [
+				/* @__PURE__ */ jsx(LinkToHome, {
+					lang,
+					blog
+				}),
+				/* @__PURE__ */ jsx("h1", {
+					className: "font-semibold text-2xl",
+					children: heading ?? "All Tags"
+				}),
+				/* @__PURE__ */ jsx("p", {
+					className: "text-fd-muted-foreground empty:hidden",
+					children: description ?? /* @__PURE__ */ jsxs("span", {
+						className: "flex items-center gap-1",
+						children: [
+							/* @__PURE__ */ jsx(TagIcon, { className: "size-3.5 text-fd-primary" }),
+							/* @__PURE__ */ jsx("span", {
+								className: "text-fd-primary font-mono",
+								children: grouped.size
+							}),
+							" tags in total."
+						]
+					})
+				})
+			]
+		}), /* @__PURE__ */ jsx("div", {
+			className: "grid grid-cols-2 sm:grid-cols-3 gap-2 mt-4 md:grid-cols-4 xl:grid-cols-6",
+			children: Array.from(grouped.entries()).sort((a, b) => b[1] - a[1]).map(([tag, count]) => /* @__PURE__ */ jsxs(Link, {
+				to: `/blog/tags/${tag}`,
+				className: "flex flex-row items-center gap-2 bg-fd-card text-fd-card-foreground border font-mono rounded-lg px-2 py-1 transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground",
+				children: [
+					/* @__PURE__ */ jsx(TagIcon, { className: "size-3.5 text-fd-muted-foreground" }),
+					/* @__PURE__ */ jsx("p", {
+						className: "font-medium",
+						children: tag
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "ms-auto text-sm text-fd-muted-foreground",
+						children: count
+					})
+				]
+			}, tag))
+		})] });
+	};
+}
+function createBlogTagPage({ heading, description } = {}) {
+	return async function BlogTagsPage({ lang, tag, blog, ctx }) {
+		const source = await ctx.getLoader();
+		const posts = [];
+		for (const page of source.getPages(lang)) {
+			if (!blog.isBlog.call(ctx, page)) continue;
+			const tags = await getTags(ctx, page);
+			if (!tags || !tags.includes(tag)) continue;
+			posts.push(page);
+		}
+		return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex flex-col items-start gap-4 border-y p-4 pt-3.5 bg-fd-card text-fd-card-foreground shadow-inner max-sm:-mx-4 sm:rounded-xl sm:border",
+			children: [
+				/* @__PURE__ */ jsx(LinkToHome, {
+					lang,
+					blog
+				}),
+				/* @__PURE__ */ jsx("h1", {
+					className: "font-semibold text-2xl",
+					children: heading ?? /* @__PURE__ */ jsxs("span", {
+						className: "inline-flex gap-2 items-center",
+						children: [
+							/* @__PURE__ */ jsx(TagIcon, { className: "text-fd-primary size-6" }),
+							"Tag ",
+							/* @__PURE__ */ jsxs("span", {
+								className: "font-mono text-fd-primary",
+								children: [
+									"\"",
+									tag,
+									"\""
+								]
+							})
+						]
+					})
+				}),
+				/* @__PURE__ */ jsx("p", {
+					className: "text-fd-muted-foreground empty:hidden",
+					children: description ?? /* @__PURE__ */ jsxs("span", {
+						className: "inline-flex items-center gap-1",
+						children: [
+							/* @__PURE__ */ jsx(NewspaperIcon, { className: "text-fd-primary size-3.5" }),
+							/* @__PURE__ */ jsx("span", {
+								className: "font-mono text-fd-primary",
+								children: posts.length
+							}),
+							" matching blog posts."
+						]
+					})
+				})
+			]
+		}), /* @__PURE__ */ jsx(OrderedBlogGrid, {
+			posts,
+			ctx
+		})] });
+	};
+}
+//#endregion
+export { createBlogTagPage, createBlogTagsPage };

package/dist/layouts/docs.d.ts

@@ -1,4 +1,4 @@
-import { AppContext } from "../lib/shared.js";
+import { AppContext, TransformChildren } from "../lib/shared.js";
 import { ConfigContext, Layouts } from "../config.js";
 import { Awaitable } from "../lib/types.js";
 import { ReactNode } from "react";
@@ -12,24 +12,26 @@ interface DocsLayoutOptions<C extends ConfigContext = ConfigContext> {
     lang?: string;
   }, page: C["loaderConfig"]["page"]) => Awaitable<{
     markdownUrl?: string;
+    lastModified?: Date | null;
     body?: ReactNode;
-    layoutProps?: Partial<DocsLayoutProps>;
-    pageProps?: DocsPageProps;
+    layoutProps?: Partial<TransformChildren<DocsLayoutProps>>;
+    pageProps?: TransformChildren<DocsPageProps>;
   }>;
 }
 interface DocsLayoutRenderData {
   markdownUrl?: string;
+  lastModified?: Date | null;
   body: ReactNode;
-  layoutProps: DocsLayoutProps;
-  pageProps: DocsPageProps;
+  layoutProps: TransformChildren<DocsLayoutProps>;
+  pageProps: TransformChildren<DocsPageProps>;
 }
 interface DocsLayoutContextData {
   renderers?: ((this: {
     page: Page;
   }, data: DocsLayoutRenderData) => Awaitable<DocsLayoutRenderData>)[];
 }
-declare function createDocsLayout<C extends ConfigContext = ConfigContext>({
+declare function createDocsLayoutPage<C extends ConfigContext = ConfigContext>({
   render
 }?: DocsLayoutOptions<NoInfer<C>>): Layouts<C>["page"];
 //#endregion
-export { DocsLayoutContextData, DocsLayoutOptions, DocsLayoutRenderData, createDocsLayout };
+export { DocsLayoutContextData, DocsLayoutOptions, DocsLayoutRenderData, createDocsLayoutPage };

package/dist/layouts/docs.js

@@ -1,85 +1,59 @@
-import { baseOptions, getGitHubFileUrl, renderPageMeta } from "../lib/shared.js";
+import { baseLayoutProps, createTransformChildren, getGitHubFileUrl, getLastModifiedDate, mergeLayoutConfigs, renderBody, renderPageMeta, renderToc } from "../lib/shared.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { unstable_notFound } from "waku/router/server";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import { DocsBody, DocsDescription, DocsPage, DocsTitle, MarkdownCopyButton, ViewOptionsPopover } from "fumadocs-ui/layouts/docs/page";
+import { DocsBody, DocsDescription, DocsPage, DocsTitle, MarkdownCopyButton, PageLastUpdate, ViewOptionsPopover } from "fumadocs-ui/layouts/docs/page";
 //#region src/layouts/docs.tsx
-function createDocsLayout({ render } = {}) {
-	async function defaultRender(page) {
-		let body;
-		let toc;
-		for (const adapter of this.adapters) {
-			body = await adapter["core:render-body"]?.call(this, page);
-			if (body !== void 0) break;
-		}
-		for (const adapter of this.adapters) {
-			toc = await adapter["core:render-toc"]?.call(this, page);
-			if (toc !== void 0) break;
-		}
-		if (body === void 0) throw new Error("[Fumapress] Please specify the `render` option in createDocsLayout()");
-		return {
-			body,
-			pageProps: { toc }
-		};
-	}
-	return async function Layout(props) {
-		const { slugs, lang, getLoader, data: { "core:docs-layout": layoutData } } = props;
+function createDocsLayoutPage({ render } = {}) {
+	const TDocsLayout = createTransformChildren(DocsLayout);
+	const TDocsPage = createTransformChildren(DocsPage);
+	return async function Layout({ slugs, lang, ctx }) {
+		const { getLoader, layouts, data: { "core:docs-layout": layoutData } } = ctx;
 		const source = await getLoader();
 		const page = source.getPage(slugs, lang);
 		if (!page) unstable_notFound();
-		const _raw = await (render ?? defaultRender).call(props, page);
-		let result;
-		if (_raw.body === void 0 || _raw.pageProps === void 0) {
-			const _default = await defaultRender.call(props, page);
-			result = {
-				markdownUrl: _raw.markdownUrl,
-				pageProps: _raw.pageProps ?? _default.pageProps,
-				body: _raw.body ?? _default.body,
-				layoutProps: {
-					tree: source.getPageTree(lang),
-					..._raw.layoutProps ?? baseOptions(props)
-				}
-			};
-		} else result = {
-			body: _raw.body,
-			pageProps: _raw.pageProps,
-			markdownUrl: _raw.markdownUrl,
-			layoutProps: {
-				tree: source.getPageTree(lang),
-				..._raw.layoutProps ?? baseOptions(props)
-			}
+		async function getLayoutProps(overrides) {
+			const inherit = await layouts.defaultProps?.call(ctx, { lang });
+			return mergeLayoutConfigs({ tree: source.getPageTree(lang) }, baseLayoutProps(ctx), inherit, overrides);
+		}
+		const _raw = await render?.call(ctx, page);
+		let result = {
+			..._raw,
+			lastModified: _raw?.lastModified ?? await getLastModifiedDate(ctx, page),
+			pageProps: {
+				..._raw?.pageProps,
+				toc: _raw?.pageProps?.toc ?? await renderToc(ctx, page)
+			},
+			body: _raw?.body ?? await renderBody(ctx, page, "[Fumapress] Please specify the `render` option in createDocsLayoutPage()"),
+			layoutProps: await getLayoutProps(_raw?.layoutProps)
 		};
 		if (layoutData?.renderers) {
 			const renderCtx = { page };
 			for (const r of layoutData.renderers) result = await r.call(renderCtx, result);
 		}
-		return /* @__PURE__ */ jsxs(DocsLayout, {
-			...result.layoutProps,
-			children: [
-				renderPageMeta(page, props),
-				result.layoutProps.children,
-				/* @__PURE__ */ jsxs(DocsPage, {
-					...result.pageProps,
-					children: [
-						result.pageProps.children,
-						/* @__PURE__ */ jsx(DocsTitle, { children: page.data.title }),
-						/* @__PURE__ */ jsx(DocsDescription, {
-							className: "mb-0",
-							children: page.data.description
-						}),
-						/* @__PURE__ */ jsxs("div", {
-							className: "flex flex-row gap-2 items-center border-b pt-2 pb-6",
-							children: [result.markdownUrl && /* @__PURE__ */ jsx(MarkdownCopyButton, { markdownUrl: result.markdownUrl }), /* @__PURE__ */ jsx(ViewOptionsPopover, {
-								markdownUrl: result.markdownUrl,
-								githubUrl: page.absolutePath ? getGitHubFileUrl(props, page.absolutePath) : void 0
-							})]
-						}),
-						/* @__PURE__ */ jsx(DocsBody, { children: result.body })
-					]
-				})
-			]
+		return /* @__PURE__ */ jsxs(TDocsLayout, {
+			props: result.layoutProps,
+			children: [renderPageMeta(page, ctx), /* @__PURE__ */ jsxs(TDocsPage, {
+				props: result.pageProps,
+				children: [
+					/* @__PURE__ */ jsx(DocsTitle, { children: page.data.title }),
+					/* @__PURE__ */ jsx(DocsDescription, {
+						className: "mb-0",
+						children: page.data.description
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex flex-row gap-2 items-center border-b pt-2 pb-6",
+						children: [result.markdownUrl && /* @__PURE__ */ jsx(MarkdownCopyButton, { markdownUrl: result.markdownUrl }), /* @__PURE__ */ jsx(ViewOptionsPopover, {
+							markdownUrl: result.markdownUrl,
+							githubUrl: page.absolutePath ? getGitHubFileUrl(ctx, page.absolutePath) : void 0
+						})]
+					}),
+					/* @__PURE__ */ jsx(DocsBody, { children: result.body }),
+					result.lastModified && /* @__PURE__ */ jsx(PageLastUpdate, { date: result.lastModified })
+				]
+			})]
 		});
 	};
 }
 //#endregion
-export { createDocsLayout };
+export { createDocsLayoutPage };

package/dist/layouts/home.d.ts

@@ -1,28 +1,40 @@
-import { AppContext } from "../lib/shared.js";
+import { AppContext, TransformChildren } from "../lib/shared.js";
 import { ConfigContext, Layouts } from "../config.js";
 import { Awaitable } from "../lib/types.js";
-import { ReactNode } from "react";
+import { ComponentType, ReactNode } from "react";
 import { HomeLayoutProps } from "fumadocs-ui/layouts/home";
 import { Page } from "fumadocs-core/source";
 
 //#region src/layouts/home.d.ts
-interface HomeLayoutOptions<C extends ConfigContext = ConfigContext> {
+interface HomeLayoutPageOptions<C extends ConfigContext = ConfigContext> {
   render?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<{
     body?: ReactNode;
-    layoutProps?: Partial<HomeLayoutProps>;
+    layoutProps?: TransformChildren<HomeLayoutProps>;
   }>;
 }
 interface HomeLayoutRenderData {
   body: ReactNode;
-  layoutProps: HomeLayoutProps;
+  layoutProps: TransformChildren<HomeLayoutProps>;
 }
 interface HomeLayoutContextData {
   renderers?: ((this: {
-    page: Page;
+    page: Page | undefined;
   }, data: HomeLayoutRenderData) => Awaitable<HomeLayoutRenderData>)[];
 }
+declare function createHomeLayoutPage<C extends ConfigContext = ConfigContext>({
+  render
+}?: HomeLayoutPageOptions<NoInfer<C>>): Layouts<C>["page"];
+interface HomeLayoutOptions<C extends ConfigContext = ConfigContext> {
+  render?: (this: AppContext<C>) => Awaitable<{
+    layoutProps?: TransformChildren<HomeLayoutProps>;
+  }>;
+}
 declare function createHomeLayout<C extends ConfigContext = ConfigContext>({
   render
-}: HomeLayoutOptions<NoInfer<C>>): Layouts<C>["page"];
+}?: HomeLayoutOptions<C>): ComponentType<{
+  lang?: string;
+  children: ReactNode;
+  ctx: AppContext<C>;
+}>;
 //#endregion
-export { HomeLayoutContextData, HomeLayoutOptions, HomeLayoutRenderData, createHomeLayout };
+export { HomeLayoutContextData, HomeLayoutOptions, HomeLayoutPageOptions, HomeLayoutRenderData, createHomeLayout, createHomeLayoutPage };

package/dist/layouts/home.js

@@ -1,34 +1,54 @@
-import { baseOptions, renderPageMeta } from "../lib/shared.js";
-import { jsxs } from "react/jsx-runtime";
+import { baseLayoutProps, createTransformChildren, mergeLayoutConfigs, renderBody, renderPageMeta } from "../lib/shared.js";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { unstable_notFound } from "waku/router/server";
 import { HomeLayout } from "fumadocs-ui/layouts/home";
 //#region src/layouts/home.tsx
-function createHomeLayout({ render }) {
-	async function renderDefault(page) {
-		for (const adapter of this.adapters) {
-			const body = await adapter["core:render-body"]?.call(this, page);
-			if (body !== void 0) return { body };
-		}
-		throw new Error("[Fumapress] Please specify the `render` option in createHomeLayout()");
-	}
-	return async function Layout(props) {
-		const { slugs, lang, getLoader, data: { "core:home-layout": layoutData } } = props;
+function createHomeLayoutPage({ render } = {}) {
+	const THomeLayout = createTransformChildren(HomeLayout);
+	return async function Layout({ slugs, lang, ctx }) {
+		const { getLoader, layouts, data: { "core:home-layout": layoutData } } = ctx;
 		const page = (await getLoader()).getPage(slugs, lang);
 		if (!page) unstable_notFound();
-		const _raw = await (render ?? renderDefault).call(props, page);
+		async function getLayoutProps(overrides) {
+			const inherit = await layouts.defaultProps?.call(ctx, { lang });
+			return mergeLayoutConfigs(baseLayoutProps(ctx), inherit, overrides);
+		}
+		const _raw = await render?.call(ctx, page);
 		let result = {
-			body: _raw.body === void 0 ? (await renderDefault.call(props, page)).body : _raw.body,
-			layoutProps: _raw.layoutProps ?? baseOptions(props)
+			body: _raw?.body ?? await renderBody(ctx, page, "[Fumapress] Please specify the `render` option in createHomeLayoutPage()"),
+			layoutProps: await getLayoutProps(_raw?.layoutProps)
 		};
 		if (layoutData?.renderers) {
 			const renderCtx = { page };
 			for (const r of layoutData.renderers) result = await r.call(renderCtx, result);
 		}
-		return /* @__PURE__ */ jsxs(HomeLayout, {
-			...result.layoutProps,
-			children: [renderPageMeta(page, props), result.body]
+		return /* @__PURE__ */ jsxs(THomeLayout, {
+			props: result.layoutProps,
+			children: [renderPageMeta(page, ctx), result.body]
+		});
+	};
+}
+function createHomeLayout({ render } = {}) {
+	const THomeLayout = createTransformChildren(HomeLayout);
+	return async function Layout({ lang, children, ctx }) {
+		const { layouts, data: { "core:home-layout": layoutData } } = ctx;
+		async function getLayoutProps(overrides) {
+			const inherit = await layouts.defaultProps?.call(ctx, { lang });
+			return mergeLayoutConfigs(baseLayoutProps(ctx), inherit, overrides);
+		}
+		let result = {
+			body: children,
+			layoutProps: await getLayoutProps((await render?.call(ctx))?.layoutProps)
+		};
+		if (layoutData?.renderers) {
+			const renderCtx = { page: void 0 };
+			for (const r of layoutData.renderers) result = await r.call(renderCtx, result);
+		}
+		return /* @__PURE__ */ jsx(THomeLayout, {
+			props: result.layoutProps,
+			children: result.body
 		});
 	};
 }
 //#endregion
-export { createHomeLayout };
+export { createHomeLayout, createHomeLayoutPage };

package/dist/layouts/notebook.d.ts

@@ -0,0 +1,37 @@
+import { AppContext, TransformChildren } from "../lib/shared.js";
+import { ConfigContext, Layouts } from "../config.js";
+import { Awaitable } from "../lib/types.js";
+import { ReactNode } from "react";
+import { DocsLayoutProps } from "fumadocs-ui/layouts/notebook";
+import { DocsPageProps } from "fumadocs-ui/layouts/notebook/page";
+import { Page } from "fumadocs-core/source";
+
+//#region src/layouts/notebook.d.ts
+interface NotebookLayoutOptions<C extends ConfigContext = ConfigContext> {
+  render?: (this: AppContext<C> & {
+    lang?: string;
+  }, page: C["loaderConfig"]["page"]) => Awaitable<{
+    markdownUrl?: string;
+    lastModified?: Date | null;
+    body?: ReactNode;
+    layoutProps?: Partial<TransformChildren<DocsLayoutProps>>;
+    pageProps?: TransformChildren<DocsPageProps>;
+  }>;
+}
+interface NotebookLayoutRenderData {
+  markdownUrl?: string;
+  lastModified?: Date | null;
+  body: ReactNode;
+  layoutProps: TransformChildren<DocsLayoutProps>;
+  pageProps: TransformChildren<DocsPageProps>;
+}
+interface NotebookLayoutContextData {
+  renderers?: ((this: {
+    page: Page;
+  }, data: NotebookLayoutRenderData) => Awaitable<NotebookLayoutRenderData>)[];
+}
+declare function createNotebookLayoutPage<C extends ConfigContext = ConfigContext>({
+  render
+}?: NotebookLayoutOptions<NoInfer<C>>): Layouts<C>["page"];
+//#endregion
+export { NotebookLayoutContextData, NotebookLayoutOptions, NotebookLayoutRenderData, createNotebookLayoutPage };

package/dist/layouts/notebook.js

@@ -0,0 +1,59 @@
+import { baseLayoutProps, createTransformChildren, getGitHubFileUrl, getLastModifiedDate, mergeLayoutConfigs, renderBody, renderPageMeta, renderToc } from "../lib/shared.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { unstable_notFound } from "waku/router/server";
+import { DocsLayout } from "fumadocs-ui/layouts/notebook";
+import { DocsBody, DocsDescription, DocsPage, DocsTitle, MarkdownCopyButton, PageLastUpdate, ViewOptionsPopover } from "fumadocs-ui/layouts/notebook/page";
+//#region src/layouts/notebook.tsx
+function createNotebookLayoutPage({ render } = {}) {
+	const TDocsLayout = createTransformChildren(DocsLayout);
+	const TDocsPage = createTransformChildren(DocsPage);
+	return async function Layout({ slugs, lang, ctx }) {
+		const { getLoader, layouts, data: { "core:notebook-layout": layoutData } } = ctx;
+		const source = await getLoader();
+		const page = source.getPage(slugs, lang);
+		if (!page) unstable_notFound();
+		async function getLayoutProps(overrides) {
+			const inherit = await layouts.defaultProps?.call(ctx, { lang });
+			return mergeLayoutConfigs({ tree: source.getPageTree(lang) }, baseLayoutProps(ctx), inherit, overrides);
+		}
+		const _raw = await render?.call(ctx, page);
+		let result = {
+			..._raw,
+			lastModified: _raw?.lastModified ?? await getLastModifiedDate(ctx, page),
+			pageProps: {
+				..._raw?.pageProps,
+				toc: _raw?.pageProps?.toc ?? await renderToc(ctx, page)
+			},
+			body: _raw?.body ?? await renderBody(ctx, page, "[Fumapress] Please specify the `render` option in createNotebookLayoutPage()"),
+			layoutProps: await getLayoutProps(_raw?.layoutProps)
+		};
+		if (layoutData?.renderers) {
+			const renderCtx = { page };
+			for (const r of layoutData.renderers) result = await r.call(renderCtx, result);
+		}
+		return /* @__PURE__ */ jsxs(TDocsLayout, {
+			props: result.layoutProps,
+			children: [renderPageMeta(page, ctx), /* @__PURE__ */ jsxs(TDocsPage, {
+				props: result.pageProps,
+				children: [
+					/* @__PURE__ */ jsx(DocsTitle, { children: page.data.title }),
+					/* @__PURE__ */ jsx(DocsDescription, {
+						className: "mb-0",
+						children: page.data.description
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex flex-row gap-2 items-center border-b pt-2 pb-6",
+						children: [result.markdownUrl && /* @__PURE__ */ jsx(MarkdownCopyButton, { markdownUrl: result.markdownUrl }), /* @__PURE__ */ jsx(ViewOptionsPopover, {
+							markdownUrl: result.markdownUrl,
+							githubUrl: page.absolutePath ? getGitHubFileUrl(ctx, page.absolutePath) : void 0
+						})]
+					}),
+					/* @__PURE__ */ jsx(DocsBody, { children: result.body }),
+					result.lastModified && /* @__PURE__ */ jsx(PageLastUpdate, { date: result.lastModified })
+				]
+			})]
+		});
+	};
+}
+//#endregion
+export { createNotebookLayoutPage };

package/dist/layouts/root.d.ts

@@ -3,7 +3,7 @@ import { RootProviderProps } from "fumadocs-ui/provider/waku";
 
 //#region src/layouts/root.d.ts
 interface RootLayoutOptions {
-  providerProps?: RootProviderProps;
+  providerProps?: Omit<RootProviderProps, "children">;
 }
 declare function createRootLayout<C extends ConfigContext = ConfigContext>(options?: RootLayoutOptions): Layouts<C>["root"];
 //#endregion

package/dist/layouts/root.js

@@ -4,12 +4,11 @@ import styles from "virtual:root.css?inline";
 import { RootProvider } from "fumadocs-ui/provider/waku";
 //#region src/layouts/root.tsx
 function createRootLayout(options) {
-	return async function(props) {
-		const { children, lang, i18nConfig, data } = props;
-		const hooks = data["core:provider"];
+	return async function({ lang, ctx, children }) {
+		const hooks = ctx.data["core:provider"];
 		let providerProps = { ...options?.providerProps };
-		if (i18nConfig) {
-			const { languages } = i18nConfig;
+		if (ctx.i18nConfig) {
+			const { languages } = ctx.i18nConfig;
 			providerProps.i18n ??= {
 				locale: lang,
 				locales: Object.entries(languages).map(([k, v]) => ({
@@ -23,7 +22,7 @@ function createRootLayout(options) {
 		return /* @__PURE__ */ jsxs("html", {
 			lang: lang ?? "en",
 			suppressHydrationWarning: true,
-			children: [/* @__PURE__ */ jsxs("head", { children: [/* @__PURE__ */ jsx("style", { children: styles }), renderRootMeta(props)] }), /* @__PURE__ */ jsx("body", {
+			children: [/* @__PURE__ */ jsxs("head", { children: [/* @__PURE__ */ jsx("style", { children: styles }), renderRootMeta(ctx)] }), /* @__PURE__ */ jsx("body", {
 				"data-version": "1.0",
 				className: "flex flex-col min-h-screen",
 				children: /* @__PURE__ */ jsx(RootProvider, {

package/dist/layouts/switch.d.ts

@@ -0,0 +1,11 @@
+import { AppContext } from "../lib/shared.js";
+import { ConfigContext, Layouts } from "../config.js";
+import { Page } from "fumadocs-core/source";
+
+//#region src/layouts/switch.d.ts
+declare function createLayoutSwitchAuto<C extends ConfigContext = ConfigContext>(layouts: Record<C["loaderConfig"]["page"] extends Page<infer Type extends string> ? Type : never, Layouts<C>["page"]>): Layouts<C>["page"];
+declare function createLayoutSwitch<T extends string, C extends ConfigContext = ConfigContext>(/** detect layout from page */
+
+detector: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => T, layouts: Record<NoInfer<T>, Layouts<C>["page"]>): Layouts<C>["page"];
+//#endregion
+export { createLayoutSwitch, createLayoutSwitchAuto };