fumapress 0.3.1 → 0.4.0

package/css/generated.css

@@ -39,6 +39,8 @@
 @source inline("createBlogLayoutPage");
 @source inline("createBlogTagPage");
 @source inline("createBlogTagsPage");
+@source inline("createClientAPIPage");
+@source inline("createContext");
 @source inline("createDocsLayoutPage");
 @source inline("createHomeLayout");
 @source inline("createHomeLayoutPage");
@@ -53,10 +55,13 @@
 @source inline("data");
 @source inline("data-version");
 @source inline("date");
+@source inline("decoded");
 @source inline("decoration-fd-primary");
 @source inline("default");
+@source inline("defined");
 @source inline("detect");
 @source inline("detector");
+@source inline("do");
 @source inline("duration-150");
 @source inline("else");
 @source inline("empty");
@@ -66,6 +71,7 @@
 @source inline("export");
 @source inline("extends");
 @source inline("false");
+@source inline("find");
 @source inline("fixed");
 @source inline("flex");
 @source inline("flex-1");
@@ -106,7 +112,9 @@
 @source inline("inherit");
 @source inline("inline-flex");
 @source inline("interface");
+@source inline("is");
 @source inline("isLoading");
+@source inline("it");
 @source inline("item");
 @source inline("items");
 @source inline("items-center");
@@ -164,6 +172,7 @@
 @source inline("page");
 @source inline("pageProps");
 @source inline("panelButtonVariants");
+@source inline("payload");
 @source inline("pb-20");
 @source inline("pb-6");
 @source inline("posts");
@@ -196,6 +205,7 @@
 @source inline("rounded-lg");
 @source inline("rounded-xl");
 @source inline("schema");
+@source inline("schemaId");
 @source inline("search");
 @source inline("setOpen");
 @source inline("shadow-inner");
@@ -215,6 +225,7 @@
 @source inline("static");
 @source inline("string");
 @source inline("styles");
+@source inline("sure");
 @source inline("tags");
 @source inline("tagsPath");
 @source inline("text-2xl");
@@ -227,6 +238,7 @@
 @source inline("text-xs");
 @source inline("the");
 @source inline("this");
+@source inline("throw");
 @source inline("title");
 @source inline("to");
 @source inline("toc");
@@ -244,12 +256,15 @@
 @source inline("useCopyButton");
 @source inline("useDocsSearch");
 @source inline("useI18n");
+@source inline("useMemo");
 @source inline("useState");
 @source inline("useTOCItems");
+@source inline("value");
 @source inline("variant");
 @source inline("w-full");
 @source inline("waku");
 @source inline("xl:grid-cols-4");
 @source inline("xl:grid-cols-6");
+@source inline("you");
 @source inline("z-2");
 @source inline("z-20");

package/dist/components/openapi.js

@@ -0,0 +1,6 @@
+"use client";
+import { createClientAPIPage } from "fumadocs-openapi/ui/create-client";
+//#region src/components/openapi.tsx
+var openapi_default = createClientAPIPage();
+//#endregion
+export { openapi_default as default };

package/dist/components/openapi.payload.js

@@ -0,0 +1,21 @@
+"use client";
+import { createContext, use, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/openapi.payload.tsx
+const Context = createContext(null);
+function PayloadProvider({ payload, children }) {
+	return /* @__PURE__ */ jsx(Context, {
+		value: useMemo(() => JSON.parse(payload), [payload]),
+		children
+	});
+}
+function WithPayload({ schemaId, Comp, props }) {
+	const payload = use(Context)?.[schemaId];
+	if (!payload) throw new Error(`[Fumapress] Failed to find OpenAPI payload for schema "${schemaId}", do you sure it is defined in createOpenAPI()?`);
+	return /* @__PURE__ */ jsx(Comp, {
+		payload,
+		...props
+	});
+}
+//#endregion
+export { PayloadProvider, WithPayload };

package/dist/config.d.ts

@@ -1,5 +1,5 @@
 import { AppContext } from "./lib/shared.js";
-import { Adapter, Awaitable, ServerPlugin } from "./lib/types.js";
+import { Adapter, Awaitable, ServerPluginOption } from "./lib/types.js";
 import { ComponentType, ReactNode } from "react";
 import { TranslationsOption } from "fumadocs-ui/contexts/i18n";
 import { LoaderConfig, LoaderOutput } from "fumadocs-core/source";
@@ -22,12 +22,8 @@ interface Config<C extends ConfigContext = ConfigContext> {
   /** the default content loader */
   loader: LoaderOutput<C["loaderConfig"]> | (() => Awaitable<LoaderOutput<C["loaderConfig"]>>);
   site?: SiteConfig;
-  layouts?: Partial<Layouts>;
-  plugins?: ServerPlugin[];
-  /** adapter for content sources, use `fumadocs-mdx` if not specified */
-  adapters?: Adapter[];
   i18n?: I18nConfig$1<C["lang"]>;
-  meta?: MetaConfig<C>;
+  meta?: MetaConfig<NoInfer<C>>;
 }
 interface Layouts<C extends ConfigContext = ConfigContext> {
   root: ComponentType<{
@@ -81,9 +77,13 @@ interface I18nConfigBuilder<Lang extends string> extends I18nConfig$1<Lang> {
   toCore: () => I18nConfig<Lang>;
 }
 interface ConfigBuilder<C extends ConfigContext> extends Config<C> {
-  usePlugins: (...plugins: ServerPlugin<C>[]) => ConfigBuilder<C>;
+  getPlugins: () => ServerPluginOption<C>[];
+  getLayouts: () => Partial<Layouts<C>>;
+  getAdapters: () => Adapter<C>[];
+  usePlugins: (...plugins: ServerPluginOption<C>[]) => ConfigBuilder<C>;
   useLayouts: (layouts: Partial<Layouts<C>>) => ConfigBuilder<C>;
-  useAdapters: (...adapters: Adapter[]) => ConfigBuilder<C>;
+  /** Add adapter for content sources, use `fumadocs-mdx` if not specified */
+  useAdapters: (...adapters: Adapter<C>[]) => ConfigBuilder<C>;
 }
 declare function defineConfig<C extends LoaderConfig, L extends string = string>(config: Config<{
   loaderConfig: C;

package/dist/config.js

@@ -1,20 +1,29 @@
 //#region src/config.ts
 function defineConfig(config) {
+	const plugins = [];
+	const layouts = {};
+	const adapters = [];
 	return {
 		...config,
-		useAdapters(...adapters) {
-			this.adapters ??= [];
-			this.adapters.push(...adapters);
+		getPlugins() {
+			return plugins;
+		},
+		getAdapters() {
+			return adapters;
+		},
+		getLayouts() {
+			return layouts;
+		},
+		useAdapters(...values) {
+			adapters.push(...values);
 			return this;
 		},
-		useLayouts(layouts) {
-			this.layouts ??= {};
-			Object.assign(this.layouts, layouts);
+		useLayouts(overrides) {
+			Object.assign(layouts, overrides);
 			return this;
 		},
-		usePlugins(...plugins) {
-			this.plugins ??= [];
-			this.plugins.push(...plugins);
+		usePlugins(...values) {
+			plugins.push(...values);
 			return this;
 		}
 	};

package/dist/index.d.ts

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

package/dist/layouts/blog.d.ts

@@ -1,6 +1,6 @@
-import { HomeLayoutOptions } from "./home.js";
 import { AppContext } from "../lib/shared.js";
 import { ConfigContext } from "../config.js";
+import { HomeLayoutOptions } from "./home.js";
 import { Awaitable } from "../lib/types.js";
 import { BlogLayout, BlogLayoutPage } from "../plugins/blog.js";
 import { ReactNode } from "react";

package/dist/lib/shared.d.ts

@@ -1,11 +1,7 @@
-import { DocsLayoutContextData } from "../layouts/docs.js";
-import { HomeLayoutContextData } from "../layouts/home.js";
-import { NotebookLayoutContextData } from "../layouts/notebook.js";
 import { BuildMode, ConfigContext, I18nConfig, Layouts, MetaConfig } from "../config.js";
-import { Adapter, Awaitable, ServerPlugin } from "./types.js";
+import { Adapter, AppContextData, Awaitable, ServerPlugin } from "./types.js";
 import { ComponentType, ReactNode } from "react";
-import { RootProviderProps } from "fumadocs-ui/provider/waku";
-import { LoaderOutput, Page } from "fumadocs-core/source";
+import { LoaderOutput } from "fumadocs-core/source";
 
 //#region src/lib/shared.d.ts
 interface AppContext<C extends ConfigContext = ConfigContext> {
@@ -13,7 +9,7 @@ interface AppContext<C extends ConfigContext = ConfigContext> {
   getLoader: () => Awaitable<LoaderOutput<C["loaderConfig"]>>;
   plugins: ServerPlugin<C>[];
   adapters: Adapter<C>[];
-  layouts: Partial<Layouts<C>>;
+  layouts: Layouts<C>;
   /** always `undefined`, easier way to infer types */
   $context: C;
   /**
@@ -33,15 +29,8 @@ interface AppContext<C extends ConfigContext = ConfigContext> {
     };
   };
 }
-interface AppContextData {
-  "core:page-meta"?: ((page: Page) => ReactNode)[];
-  "core:notebook-layout"?: NotebookLayoutContextData;
-  "core:docs-layout"?: DocsLayoutContextData;
-  "core:home-layout"?: HomeLayoutContextData;
-  "core:provider"?: ((props: RootProviderProps) => Awaitable<RootProviderProps>)[];
-}
 type TransformChildren<T> = Omit<T, "children"> & {
   children?: ((nodes: ReactNode) => ReactNode)[];
 };
 //#endregion
-export { AppContext, AppContextData, TransformChildren };
+export { AppContext, TransformChildren };

package/dist/lib/shared.js

@@ -2,20 +2,39 @@ import { __toESM } from "../_virtual/_rolldown/runtime.js";
 import { getGitRootDir } from "./fs.js";
 import { fumadocsMdx } from "../adapters/mdx.js";
 import { require_deepmerge } from "../node_modules/.pnpm/@fastify_deepmerge@3.2.1/node_modules/@fastify/deepmerge/index.js";
+import { disableSearchPlugin } from "../plugins/internal/disable-search.js";
 import path from "node:path";
 import { Fragment, isValidElement } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 //#region src/lib/shared.tsx
 var import_deepmerge = /* @__PURE__ */ __toESM(require_deepmerge());
-function parseConfig(config) {
+async function parseConfig(config) {
+	let adapters = config.getAdapters();
+	if (adapters.length === 0) adapters = [fumadocsMdx()];
+	const ORDER = {
+		pre: -1,
+		post: 1,
+		_: 0
+	};
+	function resolvePlugins(plugins) {
+		const flat = plugins.flat(Infinity);
+		flat.push(disableSearchPlugin());
+		return flat.sort((a, b) => ORDER[a.enforce ?? "_"] - ORDER[b.enforce ?? "_"]);
+	}
+	const layouts = config.getLayouts();
 	return {
 		getLoader() {
 			if (typeof config.loader === "function") return config.loader();
 			return config.loader;
 		},
-		layouts: config.layouts ?? {},
-		plugins: config.plugins ?? [],
-		adapters: config.adapters ?? [fumadocsMdx()],
+		layouts: {
+			...layouts,
+			root: layouts.root ?? (await import("../layouts/root.js")).createRootLayout(),
+			page: layouts.page ?? (await import("../layouts/docs.js")).createDocsLayoutPage(),
+			notFound: layouts.notFound ?? (await import("fumadocs-ui/layouts/home/not-found")).DefaultNotFound
+		},
+		plugins: resolvePlugins(config.getPlugins()),
+		adapters,
 		$context: void 0,
 		data: {},
 		i18nConfig: config.i18n,

package/dist/lib/types.d.ts

@@ -1,9 +1,14 @@
 import { AppContext } from "./shared.js";
 import { ConfigContext } from "../config.js";
+import { DocsLayoutContextData } from "../layouts/docs.js";
+import { HomeLayoutContextData } from "../layouts/home.js";
+import { NotebookLayoutContextData } from "../layouts/notebook.js";
 import { ReactNode } from "react";
 import { CreateApi, CreateLayout, CreatePage, CreateRoot, CreateSlice } from "waku/router/server";
 import { TOCItemType } from "fumadocs-core/toc";
+import { Page } from "fumadocs-core/source";
 import { StructuredData } from "fumadocs-core/mdx-plugins";
+import { RootProviderProps } from "fumadocs-ui/provider/base";
 
 //#region src/lib/types.d.ts
 type Awaitable<T> = T | Promise<T>;
@@ -17,14 +22,21 @@ interface Adapter<C extends ConfigContext = ConfigContext> {
   "core:get-modified-date"?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<Date | undefined>;
   "blog:get-tags"?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<string[] | undefined>;
 }
-interface CreatePagesContext<C extends ConfigContext = ConfigContext> extends AppContext<C> {
-  /** call this function if the page's route is already created by your plugin */
-  markResolved: (page: C["loaderConfig"]["page"]) => void;
-}
 interface ServerPlugin<C extends ConfigContext = ConfigContext> {
+  name?: string;
+  /** force change the order of plugin */
+  enforce?: "pre" | "post";
   /** receive & modify context */
   init?: (this: AppContext<C>) => Awaitable<void>;
-  createPages?: (this: CreatePagesContext<C>, fns: RouteFns) => Awaitable<void>;
+  createPages?: (this: AppContext<C>, fns: RouteFns) => Awaitable<void>;
+  /**
+   * Resolve the given page before passing to the **default** page renderer:
+   *
+   * - `object`: replace the page object.
+   * - `false`: render not found (will also exclude from static pre-rendering).
+   * - `undefined`: fallback to default.
+   */
+  resolvePage?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<C["loaderConfig"]["page"] | false | undefined>;
 }
 interface BaseRouteFns {
   createPage: CreatePage;
@@ -37,11 +49,20 @@ interface RouteFns extends BaseRouteFns {
   createApiIsomorphic: (config: {
     render: "static" | "dynamic";
     path: string;
-    staticPaths?: string[][];
+    staticPaths?: string[] | string[][];
     handler: (req: Request, ctx: {
       params: Record<string, string | string[]>;
     }) => Promise<Response>;
   }) => void;
 }
+type ServerPluginOption<C extends ConfigContext = ConfigContext> = ServerPlugin<C> | ServerPluginOption<C>[];
+/** can be extended from other libraries */
+interface AppContextData {
+  "core:page-meta"?: ((page: Page) => ReactNode)[];
+  "core:notebook-layout"?: NotebookLayoutContextData;
+  "core:docs-layout"?: DocsLayoutContextData;
+  "core:home-layout"?: HomeLayoutContextData;
+  "core:provider"?: ((props: RootProviderProps) => Awaitable<RootProviderProps>)[];
+}
 //#endregion
-export { Adapter, Awaitable, RouteFns, ServerPlugin };
+export { Adapter, AppContextData, Awaitable, RouteFns, ServerPlugin, ServerPluginOption };

package/dist/plugins/blog.js

@@ -12,164 +12,164 @@ function blogPlugin({ paths = {}, isBlog = (page) => page.type === "blog", layou
 		tagsPath: paths.tags ?? "/blog/tags",
 		isBlog
 	};
-	return { async createPages({ createPage, createLayout }) {
-		const renderMode = this.mode === "dynamic" ? "dynamic" : "static";
-		const source = await this.getLoader();
-		const blogPages = [];
-		for (const page of source.getPages()) {
-			if (!isBlog.call(this, page)) continue;
-			blogPages.push(page);
-			this.markResolved(page);
-		}
-		const Layout = layouts.layout ?? createBlogLayout();
-		const Page = layouts.page ?? createBlogLayoutPage();
-		if (this.i18nConfig) {
-			createLayout({
-				render: renderMode,
-				path: "/[lang]/(blog)",
-				component: ({ lang, children }) => {
-					return /* @__PURE__ */ jsx(Layout, {
-						lang,
-						blog: blogCtx,
-						ctx: this,
-						children
-					});
-				}
-			});
-			createPage({
-				render: renderMode,
-				path: "/[lang]/(blog)/[...slugs]",
-				staticPaths: blogPages.map((page) => [page.locale, ...page.slugs]),
-				component: async ({ slugs, lang }) => {
-					const page = (await this.getLoader()).getPage(slugs, lang);
-					if (!page || !isBlog.call(this, page)) unstable_notFound();
-					return /* @__PURE__ */ jsx(Page, {
-						lang,
-						slugs,
-						blog: blogCtx,
-						page,
-						ctx: this
-					});
-				}
-			});
-			if (blogCtx.indexPath !== false) {
-				const IndexPage = layouts.index ?? createBlogIndexPage();
-				createPage({
+	return {
+		name: "core:blog",
+		resolvePage(page) {
+			if (isBlog.call(this, page)) return false;
+		},
+		async createPages({ createPage, createLayout }) {
+			const renderMode = this.mode === "dynamic" ? "dynamic" : "static";
+			const blogPages = (await this.getLoader()).getPages().filter((page) => isBlog.call(this, page));
+			const Layout = layouts.layout ?? createBlogLayout();
+			const Page = layouts.page ?? createBlogLayoutPage();
+			if (this.i18nConfig) {
+				createLayout({
 					render: renderMode,
-					path: joinPathname("/[lang]/(blog)", blogCtx.indexPath),
-					staticPaths: Object.keys(this.i18nConfig.languages),
-					component: ({ lang }) => {
-						return /* @__PURE__ */ jsx(IndexPage, {
+					path: "/[lang]/(blog)",
+					component: ({ lang, children }) => {
+						return /* @__PURE__ */ jsx(Layout, {
 							lang,
 							blog: blogCtx,
-							ctx: this
+							ctx: this,
+							children
 						});
 					}
 				});
-			}
-			if (blogCtx.tagsPath !== false) {
-				const TagsPage = layouts.tags ?? createBlogTagsPage();
-				const TagPage = layouts.tag ?? createBlogTagPage();
 				createPage({
-					path: joinPathname("/[lang]/(blog)", blogCtx.tagsPath),
 					render: renderMode,
-					staticPaths: Object.keys(this.i18nConfig.languages),
-					component: ({ lang }) => {
-						return /* @__PURE__ */ jsx(TagsPage, {
+					path: "/[lang]/(blog)/[...slugs]",
+					staticPaths: blogPages.map((page) => [page.locale, ...page.slugs]),
+					component: async ({ slugs, lang }) => {
+						const page = (await this.getLoader()).getPage(slugs, lang);
+						if (!page || !isBlog.call(this, page)) unstable_notFound();
+						return /* @__PURE__ */ jsx(Page, {
 							lang,
+							slugs,
 							blog: blogCtx,
+							page,
 							ctx: this
 						});
 					}
 				});
-				const groupedTags = await groupTagsI18n(this, blogPages);
-				const staticPaths = [];
-				for (const [locale, tags] of groupedTags) for (const tag of tags.keys()) staticPaths.push([locale, tag]);
-				createPage({
-					path: joinPathname("/[lang]/(blog)", blogCtx.tagsPath, "[tag]"),
-					render: renderMode,
-					staticPaths,
-					component: ({ lang, tag }) => {
-						return /* @__PURE__ */ jsx(TagPage, {
-							lang,
-							tag,
-							blog: blogCtx,
-							ctx: this
-						});
-					}
-				});
-			}
-		} else {
-			createLayout({
-				render: renderMode,
-				path: "/(blog)",
-				component: ({ children }) => {
-					return /* @__PURE__ */ jsx(Layout, {
-						blog: blogCtx,
-						ctx: this,
-						children
+				if (blogCtx.indexPath !== false) {
+					const IndexPage = layouts.index ?? createBlogIndexPage();
+					createPage({
+						render: renderMode,
+						path: joinPathname("/[lang]/(blog)", blogCtx.indexPath),
+						staticPaths: Object.keys(this.i18nConfig.languages),
+						component: ({ lang }) => {
+							return /* @__PURE__ */ jsx(IndexPage, {
+								lang,
+								blog: blogCtx,
+								ctx: this
+							});
+						}
 					});
 				}
-			});
-			createPage({
-				render: renderMode,
-				path: "/(blog)/[...slugs]",
-				staticPaths: blogPages.map((page) => page.slugs),
-				component: async ({ slugs }) => {
-					const page = (await this.getLoader()).getPage(slugs);
-					if (!page || !isBlog.call(this, page)) unstable_notFound();
-					return /* @__PURE__ */ jsx(Page, {
-						blog: blogCtx,
-						slugs,
-						page,
-						ctx: this
+				if (blogCtx.tagsPath !== false) {
+					const TagsPage = layouts.tags ?? createBlogTagsPage();
+					const TagPage = layouts.tag ?? createBlogTagPage();
+					createPage({
+						path: joinPathname("/[lang]/(blog)", blogCtx.tagsPath),
+						render: renderMode,
+						staticPaths: Object.keys(this.i18nConfig.languages),
+						component: ({ lang }) => {
+							return /* @__PURE__ */ jsx(TagsPage, {
+								lang,
+								blog: blogCtx,
+								ctx: this
+							});
+						}
+					});
+					const groupedTags = await groupTagsI18n(this, blogPages);
+					const staticPaths = [];
+					for (const [locale, tags] of groupedTags) for (const tag of tags.keys()) staticPaths.push([locale, tag]);
+					createPage({
+						path: joinPathname("/[lang]/(blog)", blogCtx.tagsPath, "[tag]"),
+						render: renderMode,
+						staticPaths,
+						component: ({ lang, tag }) => {
+							return /* @__PURE__ */ jsx(TagPage, {
+								lang,
+								tag,
+								blog: blogCtx,
+								ctx: this
+							});
+						}
 					});
 				}
-			});
-			if (blogCtx.indexPath !== false) {
-				const IndexPage = layouts.index ?? createBlogIndexPage();
-				createPage({
+			} else {
+				createLayout({
 					render: renderMode,
-					path: joinPathname("/(blog)", blogCtx.indexPath),
-					staticPaths: [],
-					component: () => {
-						return /* @__PURE__ */ jsx(IndexPage, {
+					path: "/(blog)",
+					component: ({ children }) => {
+						return /* @__PURE__ */ jsx(Layout, {
 							blog: blogCtx,
-							ctx: this
+							ctx: this,
+							children
 						});
 					}
 				});
-			}
-			if (blogCtx.tagsPath !== false) {
-				const TagsPage = layouts.tags ?? createBlogTagsPage();
-				const TagPage = layouts.tag ?? createBlogTagPage();
 				createPage({
-					path: joinPathname("/(blog)", blogCtx.tagsPath),
 					render: renderMode,
-					staticPaths: [],
-					component: () => {
-						return /* @__PURE__ */ jsx(TagsPage, {
-							blog: blogCtx,
-							ctx: this
-						});
-					}
-				});
-				const grouped = await groupTags(this, blogPages);
-				createPage({
-					path: joinPathname("/(blog)", blogCtx.tagsPath, "[tag]"),
-					render: renderMode,
-					staticPaths: Array.from(grouped.keys()),
-					component: ({ tag }) => {
-						return /* @__PURE__ */ jsx(TagPage, {
-							tag,
+					path: "/(blog)/[...slugs]",
+					staticPaths: blogPages.map((page) => page.slugs),
+					component: async ({ slugs }) => {
+						const page = (await this.getLoader()).getPage(slugs);
+						if (!page || !isBlog.call(this, page)) unstable_notFound();
+						return /* @__PURE__ */ jsx(Page, {
 							blog: blogCtx,
+							slugs,
+							page,
 							ctx: this
 						});
 					}
 				});
+				if (blogCtx.indexPath !== false) {
+					const IndexPage = layouts.index ?? createBlogIndexPage();
+					createPage({
+						render: renderMode,
+						path: joinPathname("/(blog)", blogCtx.indexPath),
+						staticPaths: [],
+						component: () => {
+							return /* @__PURE__ */ jsx(IndexPage, {
+								blog: blogCtx,
+								ctx: this
+							});
+						}
+					});
+				}
+				if (blogCtx.tagsPath !== false) {
+					const TagsPage = layouts.tags ?? createBlogTagsPage();
+					const TagPage = layouts.tag ?? createBlogTagPage();
+					createPage({
+						path: joinPathname("/(blog)", blogCtx.tagsPath),
+						render: renderMode,
+						staticPaths: [],
+						component: () => {
+							return /* @__PURE__ */ jsx(TagsPage, {
+								blog: blogCtx,
+								ctx: this
+							});
+						}
+					});
+					const grouped = await groupTags(this, blogPages);
+					createPage({
+						path: joinPathname("/(blog)", blogCtx.tagsPath, "[tag]"),
+						render: renderMode,
+						staticPaths: Array.from(grouped.keys()),
+						component: ({ tag }) => {
+							return /* @__PURE__ */ jsx(TagPage, {
+								tag,
+								blog: blogCtx,
+								ctx: this
+							});
+						}
+					});
+				}
 			}
 		}
-	} };
+	};
 }
 //#endregion
 export { blogPlugin };

package/dist/plugins/flexsearch.js

@@ -13,10 +13,11 @@ function flexsearchPlugin({ buildIndex = async function buildIndexDefault(page)
 	throw new Error("[Fumapress] Please specify the `buildIndex` option to flexsearchPlugin()");
 } } = {}) {
 	return {
+		name: "core:flexsearch",
 		init() {
-			if (this.mode === "static") (this.data["core:provider"] ??= []).push(async (props) => {
-				props.search ??= {};
-				props.search.SearchDialog ??= (await import("../components/flexsearch-static.js")).default;
+			(this.data["core:provider"] ??= []).push(async (props) => {
+				props.search ??= { enabled: true };
+				if (this.mode === "static") props.search.SearchDialog ??= (await import("../components/flexsearch-static.js")).default;
 				return props;
 			});
 		},

package/dist/plugins/internal/disable-search.js

@@ -0,0 +1,15 @@
+//#region src/plugins/internal/disable-search.ts
+function disableSearchPlugin() {
+	return {
+		name: "core:disable-search-if-needed",
+		enforce: "post",
+		init() {
+			(this.data["core:provider"] ??= []).push((data) => {
+				data.search ??= { enabled: false };
+				return data;
+			});
+		}
+	};
+}
+//#endregion
+export { disableSearchPlugin };

package/dist/plugins/llms.txt.js

@@ -9,6 +9,7 @@ function llmsPlugin(options = {}) {
 		}
 	} } = options;
 	return {
+		name: "core:llms.txt",
 		init() {
 			this.data["core:docs-layout"] ??= {};
 			this.data["core:docs-layout"].renderers ??= [];

package/dist/plugins/openapi.d.ts

@@ -1,10 +1,17 @@
 import { ConfigContext } from "../config.js";
-import { ServerPlugin } from "../lib/types.js";
-import { OpenAPIAdapterOptions } from "../adapters/openapi.js";
-import { openapiPlugin as openapiLoaderPlugin } from "fumadocs-openapi/server";
+import { Awaitable, ServerPlugin } from "../lib/types.js";
+import { FC } from "react";
+import { OpenAPIServer, openapiPlugin as openapiLoaderPlugin } from "fumadocs-openapi/server";
+import { ClientApiPageProps } from "fumadocs-openapi/ui/create-client";
 
 //#region src/plugins/openapi.d.ts
-type OpenAPIOptions = OpenAPIAdapterOptions;
+interface OpenAPIOptions {
+  server: OpenAPIServer;
+  /** must be a client component */
+  ClientAPIPage?: FC<ClientApiPageProps>;
+  /** create proxy server */
+  createProxy?: boolean | (() => Awaitable<ReturnType<OpenAPIServer["createProxy"]>>);
+}
 /**
  * this will register the OpenAPI adapter & required layout configs.
  */

package/dist/plugins/openapi.js

@@ -1,4 +1,6 @@
-import { fumadocsOpenAPI, isOpenAPI } from "../adapters/openapi.js";
+import { PayloadProvider, WithPayload } from "../components/openapi.payload.js";
+import { jsx } from "react/jsx-runtime";
+import { unstable_notFound } from "waku/router/server";
 import { openapiPlugin as openapiLoaderPlugin } from "fumadocs-openapi/server";
 //#region src/plugins/openapi.tsx
 /**
@@ -11,11 +13,90 @@ function openapiPlugin(options) {
 			return data;
 		});
 	}
-	return { init() {
-		this.adapters.push(fumadocsOpenAPI(options));
-		initRenderers(this.data["core:docs-layout"] ??= {});
-		initRenderers(this.data["core:notebook-layout"] ??= {});
-	} };
+	return {
+		name: "core:openapi",
+		init() {
+			this.adapters.push(adapter(options));
+			initRenderers(this.data["core:docs-layout"] ??= {});
+			initRenderers(this.data["core:notebook-layout"] ??= {});
+		},
+		resolvePage(page) {
+			if (isOpenAPI(page.data)) return false;
+		},
+		async createPages({ createPage, createLayout, createApi }) {
+			const { server, createProxy } = options;
+			const renderMode = this.mode === "dynamic" ? "dynamic" : "static";
+			createLayout({
+				path: this.i18nConfig ? "/[lang]/(openapi)" : "/(openapi)",
+				render: renderMode,
+				async component({ children }) {
+					const payload = {};
+					for (const [schemaId, schema] of Object.entries(await server.getSchemas())) payload[schemaId] = {
+						bundled: schema.bundled,
+						proxyUrl: server.options.proxyUrl
+					};
+					return /* @__PURE__ */ jsx(PayloadProvider, {
+						payload: JSON.stringify(payload),
+						children
+					});
+				}
+			});
+			const staticPaths = [];
+			if (renderMode === "static") for (const page of (await this.getLoader()).getPages()) {
+				if (!isOpenAPI(page.data)) continue;
+				staticPaths.push(page.locale ? [page.locale, ...page.slugs] : page.slugs);
+			}
+			createPage({
+				render: renderMode,
+				path: this.i18nConfig ? "/[lang]/(openapi)/[...slugs]" : "/(openapi)/[...slugs]",
+				staticPaths,
+				component: async ({ slugs, lang }) => {
+					const page = (await this.getLoader()).getPage(slugs, lang);
+					if (!page || !isOpenAPI(page.data)) unstable_notFound();
+					return /* @__PURE__ */ jsx(this.layouts.page, {
+						slugs,
+						page,
+						ctx: this
+					});
+				}
+			});
+			if (createProxy) {
+				const proxyUrl = server.options.proxyUrl;
+				if (!proxyUrl) throw new Error(`[Fumapress] The "proxyUrl" option in createOpenAPI() is required to create proxy server`);
+				if (this.mode === "static") throw new Error(`[Fumapress] static mode is not compatible with proxy server`);
+				createApi({
+					path: proxyUrl,
+					render: "dynamic",
+					handlers: { all: (typeof createProxy === "function" ? await createProxy() : server.createProxy()).handle }
+				});
+			}
+		}
+	};
+}
+function adapter(options) {
+	return {
+		async "core:render-body"(page) {
+			if (isOpenAPI(page.data)) {
+				const ClientAPIPage = options.ClientAPIPage ?? (await import("../components/openapi.js")).default;
+				const props = page.data.getAPIPageProps();
+				return /* @__PURE__ */ jsx(WithPayload, {
+					schemaId: props.document,
+					Comp: ClientAPIPage,
+					props
+				});
+			}
+		},
+		"core:render-toc"(page) {
+			if (isOpenAPI(page.data)) return page.data.toc;
+		},
+		"core:get-structured-data"(page) {
+			if (isOpenAPI(page.data)) return page.data.structuredData;
+		}
+	};
+}
+/** @internal */
+function isOpenAPI(data) {
+	return "getAPIPageProps" in data && typeof data.getAPIPageProps === "function";
 }
 //#endregion
 export { openapiLoaderPlugin, openapiPlugin };

package/dist/plugins/orama-search.js

@@ -13,10 +13,11 @@ function oramaSearchPlugin({ buildIndex = async function buildIndexDefault(page)
 	throw new Error("[Fumapress] Please specify the `buildIndex` option to oramaSearchPlugin()");
 } } = {}) {
 	return {
+		name: "core:orama-search",
 		init() {
-			if (this.mode === "static") (this.data["core:provider"] ??= []).push(async (props) => {
-				props.search ??= {};
-				props.search.SearchDialog ??= (await import("../components/orama-search-static.js")).default;
+			(this.data["core:provider"] ??= []).push(async (props) => {
+				props.search ??= { enabled: true };
+				if (this.mode === "static") props.search.SearchDialog ??= (await import("../components/orama-search-static.js")).default;
 				return props;
 			});
 		},

package/dist/plugins/takumi.js

@@ -14,6 +14,7 @@ function takumiPlugin(options = {}) {
 	const width = 1200;
 	const height = 630;
 	return {
+		name: "core:takumi",
 		init() {
 			(this.data["core:page-meta"] ??= []).push((page) => {
 				const pathname = slugsToImagePath(page.slugs, page.locale).url;

package/dist/router.d.ts

@@ -1,11 +1,11 @@
 import { AppContext } from "./lib/shared.js";
-import { Config, ConfigContext } from "./config.js";
+import { ConfigBuilder, ConfigContext } from "./config.js";
 import { Awaitable, RouteFns } from "./lib/types.js";
 import * as waku from "waku";
 
 //#region src/router.d.ts
 type Options = Parameters<typeof waku.createPages>[1];
-declare function createRouter<C extends ConfigContext>(userConfig: Config<C>): {
+declare function createRouter<C extends ConfigContext>(userConfig: ConfigBuilder<C>): {
   createPages: (fn?: (this: AppContext<C>, fns: RouteFns) => Awaitable<void>, options?: Options) => ReturnType<typeof waku.createPages>;
 };
 //#endregion

package/dist/router.js

@@ -6,18 +6,14 @@ import { unstable_notFound, unstable_redirect } from "waku/router/server";
 //#region src/router.tsx
 function createRouter(userConfig) {
 	async function init() {
-		const context = parseConfig(userConfig);
+		const context = await parseConfig(userConfig);
 		for (const plugin of context.plugins) await plugin.init?.call(context);
-		return {
-			context,
-			root: context.layouts.root ?? (await import("./layouts/root.js")).createRootLayout(),
-			page: context.layouts.page ?? (await import("./layouts/docs.js")).createDocsLayoutPage(),
-			notFound: context.layouts.notFound ?? (await import("fumadocs-ui/layouts/home/not-found")).DefaultNotFound
-		};
+		return context;
 	}
 	const createPages = (base, createPagesOptions) => {
 		return waku.createPages(async (_fns) => {
-			const { context, ...layouts } = await init();
+			const context = await init();
+			const layouts = context.layouts;
 			const fns = {
 				..._fns,
 				createApiIsomorphic(config) {
@@ -35,22 +31,24 @@ function createRouter(userConfig) {
 					});
 				}
 			};
-			await base?.call(context, fns);
-			const resolved = /* @__PURE__ */ new Set();
-			const createPagesCtx = {
-				...context,
-				markResolved(page) {
-					resolved.add(page);
+			async function resolvePage(slugs, lang) {
+				let page = (await context.getLoader()).getPage(slugs, lang);
+				if (!page) unstable_notFound();
+				for (const plugin of context.plugins) {
+					const resolved = await plugin.resolvePage?.call(context, page);
+					if (typeof resolved === "object") page = resolved;
+					else if (resolved === false) unstable_notFound();
 				}
-			};
-			for (const plugin of context.plugins) await plugin.createPages?.call(createPagesCtx, fns);
-			const source = await context.getLoader();
+				return page;
+			}
+			await base?.call(context, fns);
+			for (const plugin of context.plugins) await plugin.createPages?.call(context, fns);
 			const staticPaths = [];
-			for (const page of source.getPages()) {
-				if (resolved.has(page)) continue;
+			const defaultRenderMode = context.mode === "dynamic" ? "dynamic" : "static";
+			if (defaultRenderMode === "static") outer: for (const page of (await context.getLoader()).getPages()) {
+				for (const plugin of context.plugins) if (await plugin.resolvePage?.call(context, page) === false) continue outer;
 				staticPaths.push(page.locale ? [page.locale, ...page.slugs] : page.slugs);
 			}
-			const defaultRenderMode = context.mode === "dynamic" ? "dynamic" : "static";
 			if (context.i18nConfig) {
 				fns.createRoot({
 					render: defaultRenderMode,
@@ -72,12 +70,10 @@ function createRouter(userConfig) {
 					path: "/[lang]/[...slugs]",
 					staticPaths,
 					async component({ slugs, lang }) {
-						const page = (await context.getLoader()).getPage(slugs, lang);
-						if (!page || resolved.has(page)) unstable_notFound();
 						return /* @__PURE__ */ jsx(layouts.page, {
 							lang,
 							slugs,
-							page,
+							page: await resolvePage(slugs, lang),
 							ctx: context
 						});
 					}
@@ -115,11 +111,9 @@ function createRouter(userConfig) {
 					path: "/[...slugs]",
 					staticPaths,
 					async component({ slugs }) {
-						const page = (await context.getLoader()).getPage(slugs);
-						if (!page || resolved.has(page)) unstable_notFound();
 						return /* @__PURE__ */ jsx(layouts.page, {
 							slugs,
-							page,
+							page: await resolvePage(slugs),
 							ctx: context
 						});
 					}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumapress",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "An opinionated docs framework powered by Fumadocs",
   "keywords": [
     "Docs",
@@ -21,7 +21,6 @@
     ".": "./dist/index.js",
     "./adapters/mdx": "./dist/adapters/mdx.js",
     "./adapters/mdx/schema": "./dist/adapters/mdx/schema.js",
-    "./adapters/openapi": "./dist/adapters/openapi.js",
     "./layouts/blog": "./dist/layouts/blog.js",
     "./layouts/blog.index": "./dist/layouts/blog.index.js",
     "./layouts/blog.tags": "./dist/layouts/blog.tags.js",
@@ -47,11 +46,11 @@
   },
   "dependencies": {
     "@orama/orama": "^3.1.18",
-    "@takumi-rs/image-response": "^1.1.2",
+    "@takumi-rs/image-response": "^1.3.0",
     "class-variance-authority": "^0.7.1",
     "flexsearch": "^0.8.212",
-    "fumadocs-core": "^16.8.11",
-    "fumadocs-ui": "^16.8.11",
+    "fumadocs-core": "^16.8.12",
+    "fumadocs-ui": "^16.8.12",
     "lucide-react": "^1.16.0",
     "tailwind-merge": "^3.6.0",
     "vite": "^8.0.13",
@@ -61,10 +60,10 @@
     "@fastify/deepmerge": "^3.2.1",
     "@tailwindcss/oxide": "^4.3.0",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^25.8.0",
-    "@types/react": "^19.2.14",
-    "fumadocs-mdx": "^15.0.6",
-    "fumadocs-openapi": "^10.8.5",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
+    "fumadocs-mdx": "^15.0.7",
+    "fumadocs-openapi": "^10.9.0",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "tsdown": "0.22.0",

package/dist/adapters/openapi.d.ts

@@ -1,15 +0,0 @@
-import { ConfigContext } from "../config.js";
-import { Adapter } from "../lib/types.js";
-import { FC } from "react";
-import { OpenAPIPageData } from "fumadocs-openapi/server";
-import { ClientApiPageProps } from "fumadocs-openapi/ui/create-client";
-
-//#region src/adapters/openapi.d.ts
-interface OpenAPIAdapterOptions {
-  ClientAPIPage: FC<ClientApiPageProps>;
-}
-declare function fumadocsOpenAPI<C extends ConfigContext>(options: OpenAPIAdapterOptions): Adapter<C>;
-/** @internal */
-declare function isOpenAPI(data: object): data is OpenAPIPageData;
-//#endregion
-export { OpenAPIAdapterOptions, fumadocsOpenAPI, isOpenAPI };

package/dist/adapters/openapi.js

@@ -1,22 +0,0 @@
-import { jsx } from "react/jsx-runtime";
-//#region src/adapters/openapi.tsx
-function fumadocsOpenAPI(options) {
-	const { ClientAPIPage } = options;
-	return {
-		async "core:render-body"(page) {
-			if (isOpenAPI(page.data)) return /* @__PURE__ */ jsx(ClientAPIPage, { ...await page.data.getClientAPIPageProps() });
-		},
-		"core:render-toc"(page) {
-			if (isOpenAPI(page.data)) return page.data.toc;
-		},
-		"core:get-structured-data"(page) {
-			if (isOpenAPI(page.data)) return page.data.structuredData;
-		}
-	};
-}
-/** @internal */
-function isOpenAPI(data) {
-	return "getAPIPageProps" in data && typeof data.getAPIPageProps === "function";
-}
-//#endregion
-export { fumadocsOpenAPI, isOpenAPI };