fumapress 0.5.2 → 0.5.3

package/dist/components/image.d.ts

@@ -1,4 +1,3 @@
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { ImgHTMLAttributes, ReactNode } from "react";
 
 //#region src/components/image.d.ts
@@ -25,6 +24,6 @@ declare function Image({
   unoptimized,
   preload,
   ...rest
-}: ImageProps): _$react_jsx_runtime0.JSX.Element;
+}: ImageProps): import("react").JSX.Element;
 //#endregion
 export { Image, ImageProps, StaticImageData };

package/dist/components/link.d.ts

@@ -1,4 +1,3 @@
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { ComponentProps, ReactNode, TransitionFunction } from "react";
 
 //#region src/components/link.d.ts
@@ -20,6 +19,6 @@ declare function Link({
   href,
   children,
   ...props
-}: LinkProps): _$react_jsx_runtime0.JSX.Element;
+}: LinkProps): import("react").JSX.Element;
 //#endregion
 export { Link, LinkProps };

package/dist/lib/pathname.js

@@ -1,9 +1,12 @@
 //#region src/lib/pathname.ts
 function joinPathname(...paths) {
-	let combined = paths.join("/").replaceAll(/\/+/g, "/");
-	if (!combined.startsWith("/")) combined = "/" + combined;
-	if (combined.endsWith("/")) combined = combined.slice(0, -1);
-	return combined;
+	const segs = [];
+	for (let p of paths) {
+		if (p.startsWith("/")) p = p.slice(1);
+		if (p.endsWith("/")) p = p.slice(0, -1);
+		if (p.length > 0) segs.push(p);
+	}
+	return "/" + segs.join("/");
 }
 const PATHNAME_SEGMENT_REGEX = /^[A-Za-z0-9\-._~!$&'()*+,;=:@]+$/;
 /** Check if the string is a full pathname (one that does not include `.` or `..`) */

package/dist/lib/shared.d.ts

@@ -3,6 +3,7 @@ import { Adapter, AppContextData, Awaitable, ServerPlugin } from "./types.js";
 import { ReactNode } from "react";
 import { LoaderOutput } from "fumadocs-core/source";
 import { AsyncLocalStorage } from "node:async_hooks";
+
 //#region src/lib/shared.d.ts
 interface AppContext<C extends ConfigContext = ConfigContext> {
   mode: BuildMode;

package/dist/lib/types.d.ts

@@ -7,9 +7,10 @@ import { RootLayoutContextData } from "../layouts/root.js";
 import { ReactNode } from "react";
 import { ContentStorage, LoaderOptions, LoaderPluginOption, Page } from "fumadocs-core/source";
 import { I18nConfig } from "fumadocs-core/i18n";
-import { CreateApi, CreateLayout, CreatePage, CreateRoot, CreateSlice, createPages } from "waku/router/server";
-import { TOCItemType } from "fumadocs-core/toc";
+import { CreateApi, CreateInterceptor, CreateLayout, CreatePage, CreateRoot, CreateSlice, createPages } from "waku/router/server";
 import { StructuredData } from "fumadocs-core/mdx-plugins";
+import { TOCItemType } from "fumadocs-core/toc";
+import { Hono } from "hono/tiny";
 import { MiddlewareHandler } from "hono";
 import { unstable_createServerEntryAdapter } from "waku/adapter-builders";
 
@@ -56,8 +57,9 @@ interface ServerPlugin<C extends ConfigContext = ConfigContext> {
   /** resolve content loader options */
   configureLoader?: (this: AppContext<C>, options: PressLoaderOptions) => Awaitable<PressLoaderOptions>;
   /** create Hono middlewares */
-  createMiddlewares?: (this: AppContext<C>) => Awaitable<MiddlewareHandler[] | undefined>;
-  unstable_onSSGRequest?: <T>(req: Request, next: () => T) => T;
+  createMiddlewares?: (this: AppContext<C>, env: {
+    app: Hono;
+  }) => Awaitable<MiddlewareHandler[] | undefined>;
   unstable_onServerEntry?: (entry: ReturnType<ReturnType<typeof unstable_createServerEntryAdapter>>) => ReturnType<ReturnType<typeof unstable_createServerEntryAdapter>>;
 }
 interface BaseRouteFns {
@@ -66,6 +68,7 @@ interface BaseRouteFns {
   createRoot: CreateRoot;
   createApi: CreateApi;
   createSlice: CreateSlice;
+  createInterceptor: CreateInterceptor;
 }
 type CreatePagesResult = ReturnType<typeof createPages>;
 interface RouteFns extends BaseRouteFns {

package/dist/plugins/blog.js

@@ -33,15 +33,10 @@ function blogPlugin({ paths = {}, isBlog = (page) => page.type === "blog", layou
 				})
 			});
 		},
-		createMiddlewares() {
-			return [(_c, next) => blogContext.run(blogCtx, next)];
-		},
-		unstable_onSSGRequest(_req, next) {
-			return blogContext.run(blogCtx, next);
-		},
-		async createPages({ createPage, createLayout }) {
+		async createPages({ createPage, createLayout, createInterceptor }) {
 			const renderMode = this.mode === "default" ? "static" : this.mode;
 			const blogPages = (await this.getLoader()).getPages().filter(isBlog.bind(this));
+			createInterceptor((next) => blogContext.run(blogCtx, next));
 			createLayout({
 				render: renderMode,
 				path: this.i18nConfig ? "/[lang]/(blog)" : "/(blog)",

package/dist/plugins/image/cloudflare.client.js

@@ -0,0 +1,36 @@
+"use client";
+import { ImageProvider } from "../../components/image.js";
+import { joinPathname } from "../../lib/pathname.js";
+import { jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+//#region src/plugins/image/cloudflare.client.tsx
+function createProvider(config) {
+	return {
+		name: "cloudflare",
+		defaultQuality: config.defaultQuality,
+		deviceSizes: config.sizes,
+		sizes: config.sizes,
+		buildImageUrl({ src, width, quality }) {
+			const parts = [
+				`width=${width}`,
+				`quality=${quality}`,
+				`format=${config.format}`
+			];
+			if (config.fit) parts.push(`fit=${config.fit}`);
+			return joinPathname(config.path, parts.join(","), src);
+		},
+		canOptimize(src) {
+			if (import.meta.env.DEV) return false;
+			if (!config.dangerouslyAllowSVG && src.split("?", 1)[0].endsWith(".svg")) return false;
+			return true;
+		}
+	};
+}
+function CloudflareImageProvider({ config, children }) {
+	return /* @__PURE__ */ jsx(ImageProvider, {
+		provider: useMemo(() => createProvider(config), [config]),
+		children
+	});
+}
+//#endregion
+export { CloudflareImageProvider };

package/dist/plugins/image/cloudflare.d.ts

@@ -0,0 +1,22 @@
+import { ConfigContext } from "../../config.js";
+import { ServerPlugin } from "../../lib/types.js";
+
+//#region src/plugins/image/cloudflare.d.ts
+/** @see https://developers.cloudflare.com/images/transform-images/transform-via-url/ */
+interface CloudflareImageOptions {
+  /** Image transformation path prefix. @default "/cdn-cgi/image" */
+  path?: string;
+  /** Allowed image widths for optimization and srcSet generation. (ascending order) */
+  sizes?: number[];
+  /** Allowed quality values (1–100). @default [75] */
+  qualities?: number[];
+  /** Output format. @default "auto" */
+  format?: "auto" | "avif" | "webp" | "jpeg" | "png" | "json";
+  /** How the image fits the requested dimensions. */
+  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
+  /** Allow SVG optimization. @default false */
+  dangerouslyAllowSVG?: boolean;
+}
+declare function imagePlugin<C extends ConfigContext = ConfigContext>(options?: CloudflareImageOptions): ServerPlugin<C>;
+//#endregion
+export { CloudflareImageOptions, imagePlugin };

package/dist/plugins/image/cloudflare.js

@@ -0,0 +1,21 @@
+import { CloudflareImageProvider } from "./cloudflare.client.js";
+import { resolveCloudflareImageConfig } from "./cloudflare.utils.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/plugins/image/cloudflare.tsx
+function imagePlugin(options = {}) {
+	const config = resolveCloudflareImageConfig(options);
+	return {
+		name: "image:cloudflare",
+		init() {
+			(this.data["core:provider"] ??= []).push((props) => {
+				props.children = /* @__PURE__ */ jsx(CloudflareImageProvider, {
+					config,
+					children: props.children
+				});
+				return props;
+			});
+		}
+	};
+}
+//#endregion
+export { imagePlugin };

package/dist/plugins/image/cloudflare.utils.js

@@ -0,0 +1,32 @@
+//#region src/plugins/image/cloudflare.utils.ts
+function resolveCloudflareImageConfig(options = {}) {
+	const qualities = options.qualities ?? [75];
+	return {
+		path: options.path ?? "/cdn-cgi/image",
+		dangerouslyAllowSVG: options.dangerouslyAllowSVG ?? false,
+		format: options.format ?? "auto",
+		fit: options.fit,
+		sizes: options.sizes ? options.sizes.sort((a, b) => a - b) : [
+			16,
+			32,
+			48,
+			64,
+			96,
+			128,
+			256,
+			384,
+			640,
+			750,
+			828,
+			1080,
+			1200,
+			1920,
+			2048,
+			3840
+		],
+		qualities,
+		defaultQuality: Math.max(...qualities)
+	};
+}
+//#endregion
+export { resolveCloudflareImageConfig };

package/dist/plugins/llms.txt.js

@@ -38,7 +38,7 @@ function llmsPlugin(options = {}) {
 				return res;
 			});
 		},
-		createMiddlewares() {
+		createMiddlewares({ app }) {
 			if (this.mode === "static") return;
 			const middlewares = [];
 			const parsePathname = (pathname) => {
@@ -49,23 +49,26 @@ function llmsPlugin(options = {}) {
 				} : void 0;
 				return { slugs };
 			};
-			if (autoRedirect) middlewares.push(async ({ req, redirect }, next) => {
+			if (autoRedirect) middlewares.push(async ({ req }, next) => {
 				if (req.path.endsWith(".md") || !isMarkdownPreferred(req.raw)) return next();
 				const parsed = parsePathname(req.path);
 				if (!parsed) return next();
 				const { lang, slugs } = parsed;
-				if (!(await this.getLoader()).getPage(slugs, lang)) return next();
-				return redirect(slugsToMarkdownPath(slugs, lang).pathname);
+				const url = new URL(slugsToMarkdownPath(slugs, lang).pathname, req.url);
+				const res = await app.fetch(new Request(url));
+				if (!res.ok) return next();
+				return res;
 			});
-			if (this.mode === "dynamic") middlewares.push(async ({ req, redirect }, next) => {
+			if (this.mode === "dynamic") middlewares.push(async ({ req }, next) => {
 				if (!req.path.endsWith(".md")) return next();
 				const parsed = parsePathname(req.path);
 				if (!parsed || parsed.slugs[0] === "_llms.txt") return next();
 				const { lang, slugs } = parsed;
-				const loader = await this.getLoader();
 				slugs[slugs.length - 1] = slugs[slugs.length - 1].replace(/\.md$/, "");
-				if (!loader.getPage(slugs, lang)) return next();
-				return redirect(slugsToMarkdownPath(slugs, lang).pathname);
+				const url = new URL(slugsToMarkdownPath(slugs, lang).pathname, req.url);
+				const res = await app.fetch(new Request(url));
+				if (!res.ok) return next();
+				return res;
 			});
 			return middlewares;
 		},

package/dist/plugins/openapi.d.ts

@@ -11,7 +11,11 @@ interface OpenAPIOptions {
   disableLoaderPlugin?: boolean;
   /** must be a client component */
   ClientAPIPage?: FC<ClientApiPageProps>;
-  /** create proxy server */
+  /**
+   * Create proxy server.
+   *
+   * By default, it will create one when `proxyUrl` is specified in `createOpenAPI()`.
+   */
   createProxy?: boolean | (() => Awaitable<ReturnType<OpenAPIServer["createProxy"]>>);
 }
 /**

package/dist/plugins/openapi.js

@@ -1,3 +1,4 @@
+import { isPlainPathname } from "../lib/pathname.js";
 import { PayloadProvider, WithPayload } from "../components/openapi.payload.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/plugins/openapi.tsx
@@ -5,7 +6,7 @@ import { jsx } from "react/jsx-runtime";
 * this will register the OpenAPI adapter & required layout configs.
 */
 function openapiPlugin(options) {
-	const { server, disableLoaderPlugin = false, createProxy } = options;
+	const { server, disableLoaderPlugin = false } = options;
 	function initRenderers(data) {
 		(data.renderers ??= []).push(function(data) {
 			if (isOpenAPI(this.page.data)) data.pageProps.full ??= true;
@@ -42,8 +43,9 @@ function openapiPlugin(options) {
 			return options;
 		},
 		async createPages({ createApi }) {
+			const proxyUrl = server.options.proxyUrl;
+			const { createProxy = typeof proxyUrl === "string" && isPlainPathname(proxyUrl) } = options;
 			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({

package/dist/router/index.d.ts

@@ -3,13 +3,16 @@ import { ConfigBuilder, ConfigContext } from "../config.js";
 import { Awaitable, RouteFns } from "../lib/types.js";
 import { createPages } from "waku";
 import { unstable_notFound as notFound, unstable_redirect as redirect } from "waku/router/server";
+import { Hono } from "hono/tiny";
 import { MiddlewareHandler } from "hono";
 import { unstable_createServerEntryAdapter } from "waku/adapter-builders";
 
 //#region src/router/index.d.ts
 interface Router<C extends ConfigContext = ConfigContext> {
   createPages: (fn?: (this: AppContext<C>, fns: RouteFns) => Awaitable<void>, options?: Options) => ReturnType<typeof createPages>;
-  createMiddlewares: () => (() => MiddlewareHandler)[];
+  createMiddlewares: () => ((opts: {
+    app: Hono;
+  }) => MiddlewareHandler)[];
   patchAdapter: <Options>(adapter: ReturnType<typeof unstable_createServerEntryAdapter<Options>>) => ReturnType<typeof unstable_createServerEntryAdapter<Options>>;
 }
 declare function createRouter<C extends ConfigContext>(userConfig: ConfigBuilder<C>): Promise<Router<C>>;

package/dist/router/index.js

@@ -39,6 +39,7 @@ async function createRouter(userConfig) {
 				}
 				return page;
 			}
+			fns.createInterceptor((next) => appContext.run(context, next));
 			await base?.call(context, fns);
 			for (const plugin of context.plugins) await plugin.createPages?.call(context, fns);
 			const staticPaths = [];
@@ -132,13 +133,10 @@ async function createRouter(userConfig) {
 		}, createPagesOptions);
 		return result;
 	}
-	function contextMiddleware() {
-		return (_c, next) => appContext.run(context, next);
-	}
-	function pluginsMiddleware() {
+	function pluginsMiddleware(opts) {
 		async function init() {
 			const out = [];
-			const resolved = await Promise.all(context.plugins.map((plugin) => plugin.createMiddlewares?.call(context)));
+			const resolved = await Promise.all(context.plugins.map((plugin) => plugin.createMiddlewares?.call(context, opts)));
 			for (const v of resolved) if (v) out.push(...v);
 			return out;
 		}
@@ -160,24 +158,7 @@ async function createRouter(userConfig) {
 	}
 	function patchAdapter(adapter) {
 		return (handlers, options) => {
-			let entry = adapter({
-				...handlers,
-				handleBuild(utils) {
-					const hooks = [];
-					hooks.push(utils.withRequest);
-					hooks.push((_req, fn) => appContext.run(context, fn));
-					for (const plugin of context.plugins) if (plugin.unstable_onSSGRequest) hooks.push(plugin.unstable_onSSGRequest);
-					function runHook(req, fn, index = 0) {
-						const hook = hooks[index];
-						if (!hook) return fn();
-						return hook(req, () => runHook(req, fn, index + 1));
-					}
-					return handlers.handleBuild({
-						...utils,
-						withRequest: runHook
-					});
-				}
-			}, options);
+			let entry = adapter(handlers, options);
 			for (const plugin of context.plugins) if (plugin.unstable_onServerEntry) entry = plugin.unstable_onServerEntry(entry);
 			return entry;
 		};
@@ -186,7 +167,7 @@ async function createRouter(userConfig) {
 		createPages: createPages$2,
 		patchAdapter,
 		createMiddlewares() {
-			return [contextMiddleware, pluginsMiddleware];
+			return [pluginsMiddleware];
 		}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumapress",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "An opinionated docs framework powered by Fumadocs",
   "keywords": [
     "Docs",
@@ -34,6 +34,7 @@
     "./layouts/switch": "./dist/layouts/switch.js",
     "./plugins/blog": "./dist/plugins/blog.js",
     "./plugins/flexsearch": "./dist/plugins/flexsearch.js",
+    "./plugins/image/cloudflare": "./dist/plugins/image/cloudflare.js",
     "./plugins/image/self-hosted": "./dist/plugins/image/self-hosted.js",
     "./plugins/image/vercel": "./dist/plugins/image/vercel.js",
     "./plugins/image/vercel.enhancer": "./dist/plugins/image/vercel.enhancer.js",
@@ -60,7 +61,7 @@
     "flexsearch": "^0.8.212",
     "lucide-react": "^1.17.0",
     "tailwind-merge": "^3.6.0",
-    "vite": "^8.0.14",
+    "vite": "^8.0.16",
     "xml-js": "^1.6.11",
     "zod": "^4.4.3"
   },
@@ -70,20 +71,20 @@
     "@types/http-cache-semantics": "^4.2.0",
     "@types/mdx": "^2.0.13",
     "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@types/react": "^19.2.16",
     "@types/react-dom": "^19.2.3",
     "fumadocs-core": "^16.9.3",
     "fumadocs-mdx": "^15.0.10",
-    "fumadocs-openapi": "^10.9.1",
+    "fumadocs-openapi": "^10.10.3",
     "fumadocs-ui": "^16.9.3",
     "hono": "^4.12.23",
     "http-cache-semantics": "^4.2.0",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "sharp": "^0.34.5",
-    "tsdown": "0.22.0",
+    "tsdown": "0.22.1",
     "typescript": "^6.0.3",
-    "waku": "1.0.0-beta.1"
+    "waku": "1.0.0-beta.2"
   },
   "peerDependencies": {
     "@types/mdx": "*",