fumapress 0.3.0 → 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/adapters/mdx.js

@@ -3,7 +3,12 @@ import defaultMdxComponents, { createRelativeLink } from "fumadocs-ui/mdx";
 import { z } from "zod/mini";
 //#region src/adapters/mdx.ts
 function fumadocsMdx(options) {
-	const getMdxComponents = options?.getMdxComponents;
+	const getMdxComponents = options?.getMdxComponents ?? async function(page) {
+		return {
+			...defaultMdxComponents,
+			a: createRelativeLink(await this.getLoader(), page)
+		};
+	};
 	return {
 		async "core:get-text"(page) {
 			if (isAsyncEntry(page.data) || isSyncEntry(page.data)) return page.data.getText("processed");
@@ -17,10 +22,7 @@ function fumadocsMdx(options) {
 			if (isSyncEntry(page.data)) body = page.data.body;
 			else if (isAsyncEntry(page.data)) body = (await page.data.load()).body;
 			else return;
-			return createElement(body, getMdxComponents ? await getMdxComponents.call(this, page) : { components: {
-				...defaultMdxComponents,
-				a: createRelativeLink(await this.getLoader(), page)
-			} });
+			return createElement(body, { components: await getMdxComponents.call(this, page) });
 		},
 		async "core:render-toc"(page) {
 			if (isSyncEntry(page.data)) return page.data.toc;

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<{
@@ -37,8 +33,9 @@ interface Layouts<C extends ConfigContext = ConfigContext> {
   }>;
   page: ComponentType<{
     lang?: string;
-    ctx: AppContext<C>;
     slugs: string[];
+    ctx: AppContext<C>;
+    page: C["loaderConfig"]["page"];
   }>;
   notFound: ComponentType<{
     lang?: string;
@@ -80,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/layouts/blog.js

@@ -6,7 +6,6 @@ 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) {
@@ -24,9 +23,7 @@ function createBlogLayout(options) {
 }
 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();
+	return async function BlogLayoutPage({ ctx, page, blog, lang }) {
 		const tags = await getTags(ctx, page);
 		const _raw = await render?.call(ctx, page);
 		const result = {

package/dist/layouts/docs.js

@@ -1,17 +1,14 @@
 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, PageLastUpdate, ViewOptionsPopover } from "fumadocs-ui/layouts/docs/page";
 //#region src/layouts/docs.tsx
 function createDocsLayoutPage({ render } = {}) {
 	const TDocsLayout = createTransformChildren(DocsLayout);
 	const TDocsPage = createTransformChildren(DocsPage);
-	return async function Layout({ slugs, lang, ctx }) {
+	return async function Layout({ lang, page, ctx }) {
 		const { getLoader, layouts, data: { "core:docs-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);

package/dist/layouts/home.js

@@ -1,14 +1,11 @@
 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 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();
+	return async function Layout({ lang, page, 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);

package/dist/layouts/notebook.js

@@ -1,17 +1,14 @@
 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 }) {
+	return async function Layout({ lang, page, 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);

package/dist/layouts/switch.js

@@ -3,9 +3,8 @@ import { unstable_notFound } from "waku/router/server";
 //#region src/layouts/switch.tsx
 function createLayoutSwitchAuto(layouts) {
 	return async function(props) {
-		const { slugs, lang, ctx } = props;
-		const page = (await ctx.getLoader()).getPage(slugs, lang);
-		if (!page?.type) unstable_notFound();
+		const { page } = props;
+		if (!page.type) unstable_notFound();
 		const Layout = layouts[page.type];
 		if (!Layout) unstable_notFound();
 		return /* @__PURE__ */ jsx(Layout, { ...props });
@@ -13,10 +12,7 @@ function createLayoutSwitchAuto(layouts) {
 }
 function createLayoutSwitch(detector, layouts) {
 	return async function(props) {
-		const { slugs, lang, ctx } = props;
-		const page = (await ctx.getLoader()).getPage(slugs, lang);
-		if (!page) unstable_notFound();
-		const Layout = layouts[detector.call(ctx, page)];
+		const Layout = layouts[detector.call(props.ctx, props.page)];
 		if (!Layout) unstable_notFound();
 		return /* @__PURE__ */ jsx(Layout, { ...props });
 	};

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,29 +22,47 @@ 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>) => void;
-  createPages?: (this: CreatePagesContext<C>, fns: RouteFns) => Awaitable<void>;
+  init?: (this: AppContext<C>) => 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 RouteFns {
+interface BaseRouteFns {
   createPage: CreatePage;
   createLayout: CreateLayout;
   createRoot: CreateRoot;
   createApi: CreateApi;
   createSlice: CreateSlice;
+}
+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.d.ts

@@ -37,6 +37,7 @@ interface BlogContext<C extends ConfigContext> {
 type BlogLayoutPage<C extends ConfigContext = ConfigContext> = ComponentType<{
   lang?: string;
   slugs: string[];
+  page: C["loaderConfig"]["page"];
   blog: BlogContext<C>;
   ctx: AppContext<C>;
 }>;

package/dist/plugins/blog.js

@@ -4,6 +4,7 @@ import { groupTags, groupTagsI18n } from "../lib/shared/blog.js";
 import { createBlogTagPage, createBlogTagsPage } from "../layouts/blog.tags.js";
 import { createBlogLayout, createBlogLayoutPage } from "../layouts/blog.js";
 import { jsx } from "react/jsx-runtime";
+import { unstable_notFound } from "waku/router/server";
 //#region src/plugins/blog.tsx
 function blogPlugin({ paths = {}, isBlog = (page) => page.type === "blog", layouts = {} } = {}) {
 	const blogCtx = {
@@ -11,158 +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: ({ slugs, lang }) => {
-					return /* @__PURE__ */ jsx(Page, {
-						lang,
-						slugs,
-						blog: blogCtx,
-						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: ({ slugs }) => {
-					return /* @__PURE__ */ jsx(Page, {
-						blog: blogCtx,
-						slugs,
-						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: grouped ? 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.d.ts

@@ -4,7 +4,7 @@ import { Awaitable, ServerPlugin } from "../lib/types.js";
 
 //#region src/plugins/llms.txt.d.ts
 interface LLMsOptions<C extends ConfigContext = ConfigContext> {
-  getLLMText?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<string>;
+  getLLMText?: (this: AppContext<C>, page: C["loaderConfig"]["page"]) => Awaitable<string | undefined>;
 }
 declare function llmsPlugin<C extends ConfigContext = ConfigContext>(options?: LLMsOptions<NoInfer<C>>): ServerPlugin<C>;
 //#endregion

package/dist/plugins/llms.txt.js

@@ -7,9 +7,9 @@ function llmsPlugin(options = {}) {
 			const txt = await adapter["core:get-text"]?.call(this, page);
 			if (txt !== void 0) return `# ${page.data.title} (${page.url})\n\n${txt}`;
 		}
-		throw new Error("[Fumapress] Please specify the `getLLMText()` option in llmsPlugin()");
 	} } = options;
 	return {
+		name: "core:llms.txt",
 		init() {
 			this.data["core:docs-layout"] ??= {};
 			this.data["core:docs-layout"].renderers ??= [];
@@ -33,9 +33,9 @@ function llmsPlugin(options = {}) {
 				render: defaultRenderMode,
 				path: "/llms-full.txt",
 				handler: async () => {
-					const scan = (await this.getLoader()).getPages().map(getLLMText);
-					const scanned = await Promise.all(scan);
-					return new Response(scanned.join("\n\n"));
+					const source = await this.getLoader();
+					const scanned = await Promise.all(source.getPages().map(getLLMText));
+					return new Response(scanned.filter((item) => item !== void 0).join("\n\n"));
 				}
 			});
 			createApiIsomorphic({
@@ -45,7 +45,8 @@ function llmsPlugin(options = {}) {
 				handler: async (_req, { params }) => {
 					const page = (await this.getLoader()).getPage(markdownPathToSlugs(params.slugs), params.lang);
 					if (!page) unstable_notFound();
-					return new Response(await getLLMText(page), { headers: { "Content-Type": "text/markdown" } });
+					const txt = await getLLMText(page);
+					return new Response(txt ?? "", { headers: { "Content-Type": "text/markdown" } });
 				}
 			});
 		}

package/dist/plugins/openapi.d.ts

@@ -0,0 +1,20 @@
+import { ConfigContext } from "../config.js";
+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
+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.
+ */
+declare function openapiPlugin<C extends ConfigContext>(options: OpenAPIOptions): ServerPlugin<C>;
+//#endregion
+export { OpenAPIOptions, openapiLoaderPlugin, openapiPlugin };

package/dist/plugins/openapi.js

@@ -0,0 +1,102 @@
+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
+/**
+* this will register the OpenAPI adapter & required layout configs.
+*/
+function openapiPlugin(options) {
+	function initRenderers(data) {
+		(data.renderers ??= []).push(function(data) {
+			if (isOpenAPI(this.page.data)) data.pageProps.full ??= true;
+			return data;
+		});
+	}
+	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,10 +1,12 @@
-import { Config, ConfigContext } from "./config.js";
+import { AppContext } from "./lib/shared.js";
+import { ConfigBuilder, ConfigContext } from "./config.js";
+import { Awaitable, RouteFns } from "./lib/types.js";
 import * as waku from "waku";
 
 //#region src/router.d.ts
-declare function createRouter<C extends ConfigContext>(userConfig: Config<C>): {
-  extend: typeof waku.createPages;
-  createPages: () => ReturnType<typeof waku.createPages>;
+type Options = Parameters<typeof waku.createPages>[1];
+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
 export { createRouter };

package/dist/router.js

@@ -2,22 +2,18 @@ import { parseConfig } from "./lib/shared.js";
 import * as waku from "waku";
 import { Fragment } from "react";
 import { jsx } from "react/jsx-runtime";
-import { unstable_redirect } from "waku/router/server";
+import { unstable_notFound, unstable_redirect } from "waku/router/server";
 //#region src/router.tsx
 function createRouter(userConfig) {
 	async function init() {
-		const context = parseConfig(userConfig);
-		for (const plugin of context.plugins) 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
-		};
+		const context = await parseConfig(userConfig);
+		for (const plugin of context.plugins) await plugin.init?.call(context);
+		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,17 +31,24 @@ function createRouter(userConfig) {
 					});
 				}
 			};
-			await base(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 pendingPages = (await context.getLoader()).getPages().filter((page) => !resolved.has(page));
+				return page;
+			}
+			await base?.call(context, fns);
+			for (const plugin of context.plugins) await plugin.createPages?.call(context, fns);
+			const staticPaths = [];
 			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);
+			}
 			if (context.i18nConfig) {
 				fns.createRoot({
 					render: defaultRenderMode,
@@ -65,11 +68,12 @@ function createRouter(userConfig) {
 				fns.createPage({
 					render: defaultRenderMode,
 					path: "/[lang]/[...slugs]",
-					staticPaths: pendingPages.map((page) => [page.locale, ...page.slugs]),
-					component({ slugs, lang }) {
+					staticPaths,
+					async component({ slugs, lang }) {
 						return /* @__PURE__ */ jsx(layouts.page, {
 							lang,
 							slugs,
+							page: await resolvePage(slugs, lang),
 							ctx: context
 						});
 					}
@@ -105,10 +109,11 @@ function createRouter(userConfig) {
 				fns.createPage({
 					render: defaultRenderMode,
 					path: "/[...slugs]",
-					staticPaths: pendingPages.map((page) => page.slugs),
-					component({ slugs }) {
+					staticPaths,
+					async component({ slugs }) {
 						return /* @__PURE__ */ jsx(layouts.page, {
 							slugs,
+							page: await resolvePage(slugs),
 							ctx: context
 						});
 					}
@@ -125,12 +130,7 @@ function createRouter(userConfig) {
 			return null;
 		}, createPagesOptions);
 	};
-	return {
-		extend: createPages,
-		createPages() {
-			return createPages(() => null);
-		}
-	};
+	return { createPages };
 }
 //#endregion
 export { createRouter };

package/dist/vite.d.ts

@@ -1,6 +1,14 @@
-import { PluginOption } from "vite";
+import { Plugin } from "vite";
 
 //#region src/vite.d.ts
-declare function press(): PluginOption;
+interface PluginOptions {
+  /**
+   * Auto-generate Vite config to handle CJS bundling.
+   *
+   * @default true
+   */
+  generateViteConfig?: boolean;
+}
+declare function press(options?: PluginOptions): Plugin;
 //#endregion
-export { press as default };
+export { PluginOptions, press as default };

package/dist/vite.js

@@ -1,12 +1,11 @@
 import { crawlFrameworkPkgs } from "./lib/vitefu.js";
 //#region src/vite.ts
-function press() {
-	return pressCore();
-}
-function pressCore() {
+function press(options = {}) {
+	const { generateViteConfig = true } = options;
 	return {
 		name: "fumapress:core",
 		async config(_, { command }) {
+			if (!generateViteConfig) return;
 			const out = await crawlFrameworkPkgs({
 				root: process.cwd(),
 				isBuild: command === "build",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumapress",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "An opinionated docs framework powered by Fumadocs",
   "keywords": [
     "Docs",
@@ -32,6 +32,7 @@
     "./plugins/blog": "./dist/plugins/blog.js",
     "./plugins/flexsearch": "./dist/plugins/flexsearch.js",
     "./plugins/llms.txt": "./dist/plugins/llms.txt.js",
+    "./plugins/openapi": "./dist/plugins/openapi.js",
     "./plugins/orama-search": "./dist/plugins/orama-search.js",
     "./plugins/takumi": "./dist/plugins/takumi.js",
     "./router": "./dist/router.js",
@@ -45,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",
@@ -59,9 +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.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",
@@ -72,11 +74,15 @@
     "@types/mdx": "*",
     "@types/react": "*",
     "fumadocs-mdx": "^15.0.0",
+    "fumadocs-openapi": "^10.8.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "waku": "1.0.0-beta.0"
   },
   "peerDependenciesMeta": {
+    "fumadocs-openapi": {
+      "optional": true
+    },
     "@types/mdx": {
       "optional": true
     },