fumapress 0.3.0 → 0.3.1

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/adapters/openapi.d.ts

@@ -0,0 +1,15 @@
+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

@@ -0,0 +1,22 @@
+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 };

package/dist/config.d.ts

@@ -37,8 +37,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;

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/types.d.ts

@@ -23,15 +23,17 @@ interface CreatePagesContext<C extends ConfigContext = ConfigContext> extends Ap
 }
 interface ServerPlugin<C extends ConfigContext = ConfigContext> {
   /** receive & modify context */
-  init?: (this: AppContext<C>) => void;
+  init?: (this: AppContext<C>) => Awaitable<void>;
   createPages?: (this: CreatePagesContext<C>, fns: RouteFns) => Awaitable<void>;
 }
-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;

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 = {
@@ -39,11 +40,14 @@ function blogPlugin({ paths = {}, isBlog = (page) => page.type === "blog", layou
 				render: renderMode,
 				path: "/[lang]/(blog)/[...slugs]",
 				staticPaths: blogPages.map((page) => [page.locale, ...page.slugs]),
-				component: ({ slugs, lang }) => {
+				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
 					});
 				}
@@ -111,10 +115,13 @@ function blogPlugin({ paths = {}, isBlog = (page) => page.type === "blog", layou
 				render: renderMode,
 				path: "/(blog)/[...slugs]",
 				staticPaths: blogPages.map((page) => page.slugs),
-				component: ({ 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
 					});
 				}
@@ -151,7 +158,7 @@ function blogPlugin({ paths = {}, isBlog = (page) => page.type === "blog", layou
 				createPage({
 					path: joinPathname("/(blog)", blogCtx.tagsPath, "[tag]"),
 					render: renderMode,
-					staticPaths: grouped ? Array.from(grouped.keys()) : [],
+					staticPaths: Array.from(grouped.keys()),
 					component: ({ tag }) => {
 						return /* @__PURE__ */ jsx(TagPage, {
 							tag,

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,7 +7,6 @@ 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 {
 		init() {
@@ -33,9 +32,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 +44,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,13 @@
+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";
+
+//#region src/plugins/openapi.d.ts
+type OpenAPIOptions = OpenAPIAdapterOptions;
+/**
+ * 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,21 @@
+import { fumadocsOpenAPI, isOpenAPI } from "../adapters/openapi.js";
+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 { init() {
+		this.adapters.push(fumadocsOpenAPI(options));
+		initRenderers(this.data["core:docs-layout"] ??= {});
+		initRenderers(this.data["core:notebook-layout"] ??= {});
+	} };
+}
+//#endregion
+export { openapiLoaderPlugin, openapiPlugin };

package/dist/router.d.ts

@@ -1,10 +1,12 @@
+import { AppContext } from "./lib/shared.js";
 import { Config, 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>): {
-  extend: typeof waku.createPages;
-  createPages: () => ReturnType<typeof waku.createPages>;
+  createPages: (fn?: (this: AppContext<C>, fns: RouteFns) => Awaitable<void>, options?: Options) => ReturnType<typeof waku.createPages>;
 };
 //#endregion
 export { createRouter };

package/dist/router.js

@@ -2,12 +2,12 @@ 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);
+		for (const plugin of context.plugins) await plugin.init?.call(context);
 		return {
 			context,
 			root: context.layouts.root ?? (await import("./layouts/root.js")).createRootLayout(),
@@ -35,7 +35,7 @@ function createRouter(userConfig) {
 					});
 				}
 			};
-			await base(fns);
+			await base?.call(context, fns);
 			const resolved = /* @__PURE__ */ new Set();
 			const createPagesCtx = {
 				...context,
@@ -44,7 +44,12 @@ function createRouter(userConfig) {
 				}
 			};
 			for (const plugin of context.plugins) await plugin.createPages?.call(createPagesCtx, fns);
-			const pendingPages = (await context.getLoader()).getPages().filter((page) => !resolved.has(page));
+			const source = await context.getLoader();
+			const staticPaths = [];
+			for (const page of source.getPages()) {
+				if (resolved.has(page)) continue;
+				staticPaths.push(page.locale ? [page.locale, ...page.slugs] : page.slugs);
+			}
 			const defaultRenderMode = context.mode === "dynamic" ? "dynamic" : "static";
 			if (context.i18nConfig) {
 				fns.createRoot({
@@ -65,11 +70,14 @@ 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 }) {
+						const page = (await context.getLoader()).getPage(slugs, lang);
+						if (!page || resolved.has(page)) unstable_notFound();
 						return /* @__PURE__ */ jsx(layouts.page, {
 							lang,
 							slugs,
+							page,
 							ctx: context
 						});
 					}
@@ -105,10 +113,13 @@ function createRouter(userConfig) {
 				fns.createPage({
 					render: defaultRenderMode,
 					path: "/[...slugs]",
-					staticPaths: pendingPages.map((page) => page.slugs),
-					component({ 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,
 							ctx: context
 						});
 					}
@@ -125,12 +136,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.3.1",
   "description": "An opinionated docs framework powered by Fumadocs",
   "keywords": [
     "Docs",
@@ -21,6 +21,7 @@
     ".": "./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",
@@ -32,6 +33,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",
@@ -61,7 +63,8 @@
     "@types/mdx": "^2.0.13",
     "@types/node": "^25.8.0",
     "@types/react": "^19.2.14",
-    "fumadocs-mdx": "^15.0.5",
+    "fumadocs-mdx": "^15.0.6",
+    "fumadocs-openapi": "^10.8.5",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "tsdown": "0.22.0",
@@ -72,11 +75,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
     },