fumapress 0.2.4 → 0.3.0

package/css/generated.css

@@ -1,103 +1,255 @@
+@source inline("---spacing");
+@source inline("-translate-x-1/2");
 @source inline("@orama/orama");
 @source inline("absolutePath");
-@source inline("adapter");
+@source inline("active:scale-95");
 @source inline("as");
 @source inline("async");
 @source inline("await");
+@source inline("backdrop-blur-sm");
+@source inline("bg-fd-card");
+@source inline("bg-fd-primary");
+@source inline("bg-fd-primary/10");
+@source inline("bg-fd-secondary/80");
+@source inline("blog");
+@source inline("blogPosts");
 @source inline("body");
+@source inline("border");
+@source inline("border-2");
 @source inline("border-b");
+@source inline("border-dashed");
+@source inline("border-fd-primary");
+@source inline("border-y");
+@source inline("bottom-2");
+@source inline("buttonVariants");
+@source inline("children");
+@source inline("class-variance-authority");
 @source inline("className");
 @source inline("client");
+@source inline("cn");
 @source inline("const");
 @source inline("core:docs-layout");
 @source inline("core:home-layout");
+@source inline("core:notebook-layout");
 @source inline("core:provider");
-@source inline("core:render-body");
-@source inline("core:render-toc");
+@source inline("count");
 @source inline("create");
-@source inline("createDocsLayout");
+@source inline("createBlogIndexPage");
+@source inline("createBlogLayout");
+@source inline("createBlogLayoutPage");
+@source inline("createBlogTagPage");
+@source inline("createBlogTagsPage");
+@source inline("createDocsLayoutPage");
 @source inline("createHomeLayout");
+@source inline("createHomeLayoutPage");
+@source inline("createLayoutSwitch");
+@source inline("createLayoutSwitchAuto");
+@source inline("createNotebookLayoutPage");
 @source inline("createRootLayout");
+@source inline("creationDate");
+@source inline("ctx");
+@source inline("currentDate");
+@source inline("cva");
 @source inline("data");
 @source inline("data-version");
+@source inline("date");
+@source inline("decoration-fd-primary");
 @source inline("default");
+@source inline("detect");
+@source inline("detector");
+@source inline("duration-150");
 @source inline("else");
 @source inline("empty");
+@source inline("empty:hidden");
 @source inline("en");
 @source inline("english");
 @source inline("export");
 @source inline("extends");
+@source inline("false");
+@source inline("fixed");
 @source inline("flex");
+@source inline("flex-1");
 @source inline("flex-col");
 @source inline("flex-row");
+@source inline("flex-wrap");
 @source inline("flexsearchStaticClient");
+@source inline("font-medium");
+@source inline("font-mono");
+@source inline("font-semibold");
 @source inline("for");
 @source inline("from");
 @source inline("fumadocs-core/source");
 @source inline("fumadocs-core/toc");
 @source inline("function");
+@source inline("gap-1");
 @source inline("gap-2");
+@source inline("gap-4");
+@source inline("getCreationDate");
+@source inline("getTags");
+@source inline("ghost");
 @source inline("githubUrl");
+@source inline("grid");
+@source inline("grid-cols-1");
+@source inline("grid-cols-2");
+@source inline("groupTags");
+@source inline("grouped");
 @source inline("hook");
 @source inline("hooks");
+@source inline("hover:bg-fd-accent");
+@source inline("hover:text-fd-accent-foreground");
+@source inline("href");
 @source inline("i18n");
 @source inline("i18nConfig");
 @source inline("if");
 @source inline("import");
 @source inline("in");
+@source inline("inherit");
+@source inline("inline-flex");
 @source inline("interface");
 @source inline("isLoading");
+@source inline("item");
 @source inline("items");
 @source inline("items-center");
+@source inline("items-start");
+@source inline("joinPathname");
+@source inline("key");
 @source inline("lang");
 @source inline("language");
 @source inline("languages");
+@source inline("lastModified");
+@source inline("layout");
 @source inline("layoutData");
 @source inline("layoutProps");
+@source inline("layouts");
+@source inline("left-1/2");
+@source inline("length");
 @source inline("let");
 @source inline("loaderConfig");
 @source inline("locale");
 @source inline("locales");
+@source inline("lucide-react");
 @source inline("markdownUrl");
+@source inline("matching");
+@source inline("max-h-[min(600px,calc(100vh---spacing(30)))]");
+@source inline("max-sm:-mx-4");
+@source inline("max-w-[1400px]");
+@source inline("max-w-[900px]");
+@source inline("max-w-[calc(100%---spacing(4))]");
 @source inline("mb-0");
+@source inline("md:grid-cols-3");
+@source inline("md:grid-cols-4");
+@source inline("md:p-8");
 @source inline("min-h-screen");
+@source inline("min-w-0");
+@source inline("ms-auto");
+@source inline("mt-4");
+@source inline("mt-6");
+@source inline("mt-auto");
+@source inline("mx-auto");
 @source inline("name");
+@source inline("never");
 @source inline("new");
 @source inline("of");
+@source inline("onClick");
+@source inline("onCopy");
+@source inline("onOpenChange");
 @source inline("onSearchChange");
+@source inline("open");
 @source inline("option");
+@source inline("options");
+@source inline("orderedPosts");
+@source inline("overline");
+@source inline("p-1");
+@source inline("p-4");
 @source inline("page");
 @source inline("pageProps");
+@source inline("panelButtonVariants");
+@source inline("pb-20");
 @source inline("pb-6");
+@source inline("posts");
+@source inline("primary");
+@source inline("props");
+@source inline("prose");
 @source inline("providerProps");
 @source inline("pt-2");
+@source inline("pt-3.5");
+@source inline("pt-4");
+@source inline("pt-6");
+@source inline("px-1.5");
+@source inline("px-2");
+@source inline("px-3");
+@source inline("px-4");
+@source inline("py-0.5");
+@source inline("py-1");
+@source inline("py-2");
 @source inline("query");
 @source inline("r");
 @source inline("react");
 @source inline("render");
 @source inline("renderCtx");
-@source inline("renderPageMeta");
 @source inline("renderRootMeta");
 @source inline("result");
 @source inline("return");
 @source inline("root");
-@source inline("satisfies");
+@source inline("rotate-180");
+@source inline("rounded-2xl");
+@source inline("rounded-lg");
+@source inline("rounded-xl");
 @source inline("schema");
 @source inline("search");
+@source inline("setOpen");
+@source inline("shadow-inner");
+@source inline("shadow-md");
+@source inline("shadow-sm");
+@source inline("shrink-0");
+@source inline("size-3.5");
+@source inline("size-4");
+@source inline("size-6");
+@source inline("sm:border");
+@source inline("sm:bottom-4");
+@source inline("sm:grid-cols-3");
+@source inline("sm:max-w-[400px]");
+@source inline("sm:rounded-xl");
 @source inline("source");
 @source inline("specify");
 @source inline("static");
 @source inline("string");
 @source inline("styles");
+@source inline("tags");
+@source inline("tagsPath");
+@source inline("text-2xl");
+@source inline("text-3xl");
+@source inline("text-fd-card-foreground");
+@source inline("text-fd-muted-foreground");
+@source inline("text-fd-primary");
+@source inline("text-fd-primary-foreground");
+@source inline("text-sm");
+@source inline("text-xs");
 @source inline("the");
 @source inline("this");
-@source inline("throw");
+@source inline("title");
+@source inline("to");
 @source inline("toc");
+@source inline("transition-all");
+@source inline("transition-colors");
+@source inline("transition-transform");
 @source inline("translations");
 @source inline("tree");
+@source inline("truncate");
 @source inline("type");
 @source inline("undefined");
 @source inline("unstable_notFound");
+@source inline("url");
 @source inline("use");
+@source inline("useCopyButton");
 @source inline("useDocsSearch");
-@source inline("useI18n");
+@source inline("useI18n");
+@source inline("useState");
+@source inline("useTOCItems");
+@source inline("variant");
+@source inline("w-full");
+@source inline("waku");
+@source inline("xl:grid-cols-4");
+@source inline("xl:grid-cols-6");
+@source inline("z-2");
+@source inline("z-20");

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,24 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+export { __commonJSMin, __toESM };

package/dist/adapters/mdx/schema.d.ts

@@ -0,0 +1,39 @@
+import * as base from "fumadocs-core/source/schema";
+import z from "zod";
+
+//#region src/adapters/mdx/schema.d.ts
+declare const pageSchema: z.ZodObject<{
+  title: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodString>;
+  full: z.ZodOptional<z.ZodBoolean>;
+  _openapi: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<base._JSONType, base._JSONType>>>;
+}, z.core.$strip>;
+declare const metaSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  description: z.ZodOptional<z.ZodString>;
+  root: z.ZodOptional<z.ZodBoolean>;
+  defaultOpen: z.ZodOptional<z.ZodBoolean>;
+  collapsible: z.ZodOptional<z.ZodBoolean>;
+  icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const blogPageSchema: z.ZodObject<{
+  title: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodString>;
+  full: z.ZodOptional<z.ZodBoolean>;
+  _openapi: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<base._JSONType, base._JSONType>>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const blogMetaSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  description: z.ZodOptional<z.ZodString>;
+  root: z.ZodOptional<z.ZodBoolean>;
+  defaultOpen: z.ZodOptional<z.ZodBoolean>;
+  collapsible: z.ZodOptional<z.ZodBoolean>;
+  icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//#endregion
+export { blogMetaSchema, blogPageSchema, metaSchema, pageSchema };

package/dist/adapters/mdx/schema.js

@@ -0,0 +1,9 @@
+import * as base from "fumadocs-core/source/schema";
+import z from "zod";
+//#region src/adapters/mdx/schema.ts
+const pageSchema = base.pageSchema;
+const metaSchema = base.metaSchema;
+const blogPageSchema = base.pageSchema.extend({ tags: z.array(z.string()).optional() });
+const blogMetaSchema = base.metaSchema;
+//#endregion
+export { blogMetaSchema, blogPageSchema, metaSchema, pageSchema };

package/dist/adapters/mdx.js

@@ -1,5 +1,6 @@
 import { createElement } from "react";
 import defaultMdxComponents, { createRelativeLink } from "fumadocs-ui/mdx";
+import { z } from "zod/mini";
 //#region src/adapters/mdx.ts
 function fumadocsMdx(options) {
 	const getMdxComponents = options?.getMdxComponents;
@@ -24,9 +25,26 @@ function fumadocsMdx(options) {
 		async "core:render-toc"(page) {
 			if (isSyncEntry(page.data)) return page.data.toc;
 			if (isAsyncEntry(page.data)) return (await page.data.load()).toc;
+		},
+		"core:get-creation-date"(page) {
+			if (isSyncEntry(page.data) || isAsyncEntry(page.data)) return "date" in page.data && page.data.date instanceof Date ? page.data.date : void 0;
+		},
+		async "core:get-modified-date"(page) {
+			let data;
+			if (isSyncEntry(page.data)) data = page.data;
+			else if (isAsyncEntry(page.data)) data = await page.data.load();
+			else return;
+			return "lastModified" in data && data.lastModified instanceof Date ? data.lastModified : void 0;
+		},
+		"blog:get-tags"(page) {
+			if (isSyncEntry(page.data) || isAsyncEntry(page.data)) {
+				const parsed = tagsSchema.safeParse(page.data);
+				return parsed.success ? parsed.data.tags : void 0;
+			}
 		}
 	};
 }
+const tagsSchema = z.looseObject({ tags: z.optional(z.array(z.string())) });
 function isSyncEntry(v) {
 	return "info" in v && typeof v.info === "object" && "_exports" in v && typeof v._exports === "object";
 }

package/dist/components/blog-panel.js

@@ -0,0 +1,56 @@
+"use client";
+import { cn } from "../lib/cn.js";
+import { useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ChevronDown, ShareIcon } from "lucide-react";
+import { TOCProvider, TOCScrollArea, useTOCItems } from "fumadocs-ui/components/toc";
+import { TOCItem, TOCItems } from "fumadocs-ui/components/toc/clerk";
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "fumadocs-ui/components/ui/collapsible";
+import { cva } from "class-variance-authority";
+import { useCopyButton } from "fumadocs-ui/utils/use-copy-button";
+//#region src/components/blog-panel.tsx
+const panelButtonVariants = cva("inline-flex items-center font-medium gap-2 px-3 py-2 transition-all duration-150 rounded-lg hover:text-fd-accent-foreground hover:bg-fd-accent active:scale-95");
+function BlogPanel() {
+	const items = useTOCItems();
+	const [open, setOpen] = useState(false);
+	const [isSuccessful, onCopy] = useCopyButton(() => {
+		if (navigator.share) return navigator.share({
+			title: document.title,
+			url: location.href
+		});
+		else return navigator.clipboard.writeText(location.href);
+	});
+	return /* @__PURE__ */ jsxs(Collapsible, {
+		open,
+		onOpenChange: setOpen,
+		className: "fixed w-full max-w-[calc(100%---spacing(4))] left-1/2 -translate-x-1/2 bottom-2 border shadow-md text-sm bg-fd-secondary/80 backdrop-blur-sm z-20 p-1 rounded-xl sm:max-w-[400px] sm:bottom-4",
+		children: [/* @__PURE__ */ jsx(CollapsibleContent, { children: /* @__PURE__ */ jsx(TOCScrollArea, {
+			className: "max-h-[min(600px,calc(100vh---spacing(30)))]",
+			children: /* @__PURE__ */ jsx(TOCItems, { children: items.map((item) => /* @__PURE__ */ jsx(TOCItem, {
+				item,
+				onClick: () => setOpen(false)
+			}, item.url)) })
+		}) }), /* @__PURE__ */ jsxs("div", {
+			className: "flex flex-row gap-2",
+			children: [/* @__PURE__ */ jsxs(CollapsibleTrigger, {
+				className: cn(panelButtonVariants(), "min-w-0"),
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "truncate",
+					children: "Table of Contents"
+				}), /* @__PURE__ */ jsx(ChevronDown, { className: cn("size-3.5 shrink-0 text-fd-muted-foreground transition-transform", open && "rotate-180") })]
+			}), /* @__PURE__ */ jsxs("button", {
+				className: cn(panelButtonVariants(), "ms-auto text-fd-muted-foreground"),
+				onClick: onCopy,
+				children: [/* @__PURE__ */ jsx(ShareIcon, { className: "size-3.5 shrink-0" }), isSuccessful ? "Copied" : "Share"]
+			})]
+		})]
+	});
+}
+function BlogProvider({ toc, children }) {
+	return /* @__PURE__ */ jsx(TOCProvider, {
+		toc,
+		children
+	});
+}
+//#endregion
+export { BlogPanel, BlogProvider };

package/dist/components/blog.js

@@ -0,0 +1,60 @@
+import { getCreationDate } from "../lib/shared.js";
+import { cn } from "../lib/cn.js";
+import { joinPathname } from "../lib/join-pathname.js";
+import { Link } from "waku";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { buttonVariants } from "fumadocs-ui/components/ui/button";
+import { CornerLeftUpIcon } from "lucide-react";
+//#region src/components/blog.tsx
+function BlogItem({ page, date }) {
+	return /* @__PURE__ */ jsxs(Link, {
+		to: page.url,
+		className: "flex flex-col bg-fd-card rounded-2xl border shadow-sm p-4 transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground",
+		children: [
+			/* @__PURE__ */ jsx("p", {
+				className: "font-medium",
+				children: page.data.title
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "text-sm text-fd-muted-foreground",
+				children: page.data.description
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "mt-auto pt-4 text-xs text-fd-primary",
+				children: date.toDateString()
+			})
+		]
+	});
+}
+async function OrderedBlogGrid({ posts, ctx }) {
+	const currentDate = new Date(Date.now());
+	const orderedPosts = [];
+	for (const page of posts) {
+		const date = await getCreationDate(ctx, page);
+		orderedPosts.push({
+			page,
+			date: date ?? currentDate
+		});
+	}
+	orderedPosts.sort((a, b) => b.date.getTime() - a.date.getTime());
+	return /* @__PURE__ */ jsx("div", {
+		className: "grid grid-cols-1 gap-2 mt-4 md:grid-cols-3 xl:grid-cols-4",
+		children: orderedPosts.map(({ page, date }) => /* @__PURE__ */ jsx(BlogItem, {
+			page,
+			date
+		}, page.url))
+	});
+}
+function LinkToHome({ lang, blog }) {
+	if (!blog.indexPath) return;
+	return /* @__PURE__ */ jsxs(Link, {
+		to: lang ? joinPathname(lang, blog.indexPath) : blog.indexPath,
+		className: cn(buttonVariants({
+			variant: "ghost",
+			className: "text-fd-muted-foreground gap-2"
+		})),
+		children: [/* @__PURE__ */ jsx(CornerLeftUpIcon, { className: "size-3.5" }), "Back to Home"]
+	});
+}
+//#endregion
+export { LinkToHome, OrderedBlogGrid };

package/dist/config.d.ts

@@ -4,6 +4,7 @@ import { ComponentType, ReactNode } from "react";
 import { TranslationsOption } from "fumadocs-ui/contexts/i18n";
 import { LoaderConfig, LoaderOutput } from "fumadocs-core/source";
 import { I18nConfig } from "fumadocs-core/i18n";
+import { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
 
 //#region src/config.d.ts
 interface ConfigContext {
@@ -26,31 +27,42 @@ interface Config<C extends ConfigContext = ConfigContext> {
   /** adapter for content sources, use `fumadocs-mdx` if not specified */
   adapters?: Adapter[];
   i18n?: I18nConfig$1<C["lang"]>;
-  meta?: {
-    /** render meta tags for any pages */root?: (this: AppContext<C>) => ReactNode; /** render meta tags for page */
-    page?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => ReactNode;
-  };
+  meta?: MetaConfig<C>;
 }
 interface Layouts<C extends ConfigContext = ConfigContext> {
-  root: ComponentType<AppContext<C> & {
+  root: ComponentType<{
     lang?: string;
+    ctx: AppContext<C>;
     children: ReactNode;
   }>;
-  page: ComponentType<AppContext<C> & {
+  page: ComponentType<{
     lang?: string;
+    ctx: AppContext<C>;
     slugs: string[];
   }>;
-  notFound: ComponentType<AppContext<C> & {
+  notFound: ComponentType<{
     lang?: string;
+    ctx: AppContext<C>;
   }>;
+  /**
+   * Define default props for page layouts, will be merged with current props.
+   */
+  defaultProps?: (this: AppContext<C>, env: {
+    lang: string | undefined;
+  }) => Awaitable<Omit<BaseLayoutProps, "children">>;
 }
-interface I18nConfig$1<Lang extends string = string> extends Pick<I18nConfig<NoInfer<Lang>>, "fallbackLanguage" | "parser"> {
+interface I18nConfig$1<Lang extends string = string> extends Pick<I18nConfig<NoInfer<Lang>>, "defaultLanguage" | "fallbackLanguage" | "parser"> {
   /** locale code -> language info */
   languages: { [K in Lang]: {
     displayName: string;
     translations?: TranslationsOption;
   } };
-  defaultLanguage: NoInfer<Lang>;
+}
+interface MetaConfig<C extends ConfigContext = ConfigContext> {
+  /** render meta tags for any pages */
+  root?: (this: AppContext<C>) => ReactNode;
+  /** render meta tags for page */
+  page?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => ReactNode;
 }
 interface SiteConfig {
   /** full URL of app, used for metadata generation*/
@@ -81,4 +93,4 @@ declare function defineConfig<C extends LoaderConfig, L extends string = string>
 }>;
 declare function defineI18nConfig<Lang extends string>(config: I18nConfig$1<Lang>): I18nConfigBuilder<Lang>;
 //#endregion
-export { BuildMode, Config, ConfigBuilder, ConfigContext, I18nConfig$1 as I18nConfig, I18nConfigBuilder, Layouts, SiteConfig, defineConfig, defineI18nConfig };
+export { BuildMode, Config, ConfigBuilder, ConfigContext, I18nConfig$1 as I18nConfig, I18nConfigBuilder, Layouts, MetaConfig, SiteConfig, defineConfig, defineI18nConfig };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { AppContext, AppContextData } from "./lib/shared.js";
-import { BuildMode, Config, ConfigBuilder, ConfigContext, I18nConfig, I18nConfigBuilder, Layouts, SiteConfig, defineConfig, defineI18nConfig } from "./config.js";
-import { Adapter, ServerPlugin } from "./lib/types.js";
-export { type Adapter, type AppContext, type AppContextData, BuildMode, Config, ConfigBuilder, ConfigContext, I18nConfig, I18nConfigBuilder, Layouts, type ServerPlugin, SiteConfig, defineConfig, defineI18nConfig };
+import { BuildMode, Config, ConfigBuilder, ConfigContext, I18nConfig, I18nConfigBuilder, Layouts, MetaConfig, SiteConfig, defineConfig, defineI18nConfig } from "./config.js";
+import { Adapter, RouteFns, ServerPlugin } from "./lib/types.js";
+export { type Adapter, type AppContext, type AppContextData, BuildMode, Config, ConfigBuilder, ConfigContext, I18nConfig, I18nConfigBuilder, Layouts, MetaConfig, type RouteFns, type ServerPlugin, SiteConfig, defineConfig, defineI18nConfig };

package/dist/layouts/blog.d.ts

@@ -0,0 +1,21 @@
+import { HomeLayoutOptions } from "./home.js";
+import { AppContext } from "../lib/shared.js";
+import { ConfigContext } from "../config.js";
+import { Awaitable } from "../lib/types.js";
+import { BlogLayout, BlogLayoutPage } from "../plugins/blog.js";
+import { ReactNode } from "react";
+import { TOCItemType } from "fumadocs-core/toc";
+
+//#region src/layouts/blog.d.ts
+declare function createBlogLayout<C extends ConfigContext = ConfigContext>(options?: HomeLayoutOptions<C>): BlogLayout<C>;
+interface BlogLayoutPageRenderData {
+  creationDate?: Date;
+  toc: TOCItemType[];
+  body: ReactNode;
+}
+interface BlogLayoutPageOptions<C extends ConfigContext = ConfigContext> {
+  render?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<Partial<BlogLayoutPageRenderData>>;
+}
+declare function createBlogLayoutPage<C extends ConfigContext = ConfigContext>(options?: BlogLayoutPageOptions<C>): BlogLayoutPage<C>;
+//#endregion
+export { BlogLayoutPageOptions, BlogLayoutPageRenderData, createBlogLayout, createBlogLayoutPage };

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

@@ -0,0 +1,15 @@
+import { ConfigContext } from "../config.js";
+import { BlogIndexPage } from "../plugins/blog.js";
+import { ReactNode } from "react";
+
+//#region src/layouts/blog.index.d.ts
+interface BlogIndexPageOptions {
+  heading?: ReactNode;
+  description?: ReactNode;
+}
+declare function createBlogIndexPage<C extends ConfigContext = ConfigContext>({
+  heading,
+  description
+}?: BlogIndexPageOptions): BlogIndexPage<C>;
+//#endregion
+export { BlogIndexPageOptions, createBlogIndexPage };

package/dist/layouts/blog.index.js

@@ -0,0 +1,36 @@
+import { cn } from "../lib/cn.js";
+import { joinPathname } from "../lib/join-pathname.js";
+import { OrderedBlogGrid } from "../components/blog.js";
+import { Link } from "waku";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { buttonVariants } from "fumadocs-ui/components/ui/button";
+import { ListIcon } from "lucide-react";
+//#region src/layouts/blog.index.tsx
+function createBlogIndexPage({ heading, description } = {}) {
+	return async function BlogIndexPage({ lang, blog, ctx }) {
+		const source = await ctx.getLoader();
+		return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex flex-col gap-4 items-start border-2 border-dashed border-fd-primary rounded-xl bg-fd-primary/10 p-4 z-2 md:p-8",
+			children: [
+				/* @__PURE__ */ jsx("h1", {
+					className: "text-3xl font-semibold",
+					children: heading ?? "Blog"
+				}),
+				/* @__PURE__ */ jsx("p", {
+					className: "text-fd-primary overline decoration-fd-primary empty:hidden",
+					children: description
+				}),
+				blog.tagsPath !== false && /* @__PURE__ */ jsxs(Link, {
+					to: lang ? joinPathname(lang, blog.tagsPath) : blog.tagsPath,
+					className: cn(buttonVariants({ variant: "primary" }), "gap-2"),
+					children: [/* @__PURE__ */ jsx(ListIcon, { className: "size-4" }), "All Tags"]
+				})
+			]
+		}), /* @__PURE__ */ jsx(OrderedBlogGrid, {
+			posts: source.getPages(lang).filter((page) => blog.isBlog.call(ctx, page)),
+			ctx
+		})] });
+	};
+}
+//#endregion
+export { createBlogIndexPage };