fumapress 0.5.1 → 0.5.2

package/css/generated.css

@@ -15,6 +15,7 @@
 @source inline("allTags");
 @source inline("allowed");
 @source inline("allows");
+@source inline("always");
 @source inline("and");
 @source inline("and/or");
 @source inline("any");
@@ -62,6 +63,7 @@
 @source inline("cases");
 @source inline("cause");
 @source inline("causes");
+@source inline("change");
 @source inline("check");
 @source inline("children");
 @source inline("class-variance-authority");
@@ -147,6 +149,7 @@
 @source inline("flex-row");
 @source inline("flex-wrap");
 @source inline("flexsearchStaticClient");
+@source inline("fn");
 @source inline("following");
 @source inline("font-medium");
 @source inline("font-mono");
@@ -155,6 +158,7 @@
 @source inline("framework");
 @source inline("free");
 @source inline("from");
+@source inline("fromPathname");
 @source inline("full");
 @source inline("fumadocs-core/framework");
 @source inline("fumadocs-core/i18n");
@@ -176,6 +180,7 @@
 @source inline("ghost");
 @source inline("githubUrl");
 @source inline("given");
+@source inline("global");
 @source inline("green");
 @source inline("grid");
 @source inline("grid-cols-1");
@@ -211,6 +216,7 @@
 @source inline("including");
 @source inline("incorrect");
 @source inline("indexPath");
+@source inline("indicates");
 @source inline("inherit");
 @source inline("inheritLayoutProps");
 @source inline("inherited");
@@ -247,6 +253,7 @@
 @source inline("level");
 @source inline("like");
 @source inline("limitation");
+@source inline("link");
 @source inline("loading");
 @source inline("locale");
 @source inline("lucide-react");
@@ -277,6 +284,8 @@
 @source inline("multiple");
 @source inline("mx-auto");
 @source inline("name");
+@source inline("navigation");
+@source inline("never");
 @source inline("new");
 @source inline("normal");
 @source inline("not");
@@ -309,6 +318,7 @@
 @source inline("params");
 @source inline("parsed");
 @source inline("path");
+@source inline("path/hash");
 @source inline("pathname");
 @source inline("payload");
 @source inline("pb-6");
@@ -345,6 +355,7 @@
 @source inline("py-6");
 @source inline("quality");
 @source inline("query");
+@source inline("query-only");
 @source inline("r");
 @source inline("react");
 @source inline("react-dom");
@@ -382,6 +393,7 @@
 @source inline("schema");
 @source inline("schemaId");
 @source inline("screens");
+@source inline("scroll");
 @source inline("search");
 @source inline("see");
 @source inline("sell");
@@ -391,6 +403,7 @@
 @source inline("shadow-md");
 @source inline("shadow-sm");
 @source inline("shall");
+@source inline("should");
 @source inline("shrink-0");
 @source inline("significantly");
 @source inline("size-3.5");

package/dist/client.d.ts

@@ -1,22 +1,7 @@
+import { Link, LinkProps } from "./components/link.js";
 import { Unstable_ChangeRouteCallback, Unstable_ChangeRouteEvent } from "waku/router/client";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
-import { ComponentProps, ReactNode, TransitionFunction } from "react";
 
 //#region src/client.d.ts
-interface LinkProps extends ComponentProps<"a"> {
-  /**
-   * indicates if the link should scroll or not on navigation
-   * - `true`: always scroll
-   * - `false`: never scroll
-   * - `undefined`: scroll on path/hash change (not on query-only change)
-   */
-  scroll?: boolean;
-  unstable_pending?: ReactNode;
-  unstable_notPending?: ReactNode;
-  unstable_prefetchOnEnter?: boolean;
-  unstable_prefetchOnView?: boolean;
-  unstable_startTransition?: ((fn: TransitionFunction) => void) | undefined;
-}
 interface Router {
   push: (to: string, options?: {
     /**
@@ -45,11 +30,6 @@ interface Router {
   query: string;
   hash: string;
 }
-declare function Link({
-  href,
-  children,
-  ...props
-}: LinkProps): _$react_jsx_runtime0.JSX.Element;
 declare function useRouter(): Router;
 //#endregion
-export { Link, LinkProps, Router, useRouter };
+export { Link, type LinkProps, Router, useRouter };

package/dist/client.js

@@ -1,14 +1,8 @@
 "use client";
-import { Link as Link$1, useRouter as useRouter$1 } from "waku/router/client";
-import { jsx } from "react/jsx-runtime";
+import { Link } from "./components/link.js";
+import { useRouter as useRouter$1 } from "waku/router/client";
 //#region src/client.tsx
-function Link({ href = "#", children, ...props }) {
-	return /* @__PURE__ */ jsx(Link$1, {
-		to: href,
-		...props,
-		children
-	});
-}
+/** tiny wrapper of `waku` */
 function useRouter() {
 	return useRouter$1();
 }

package/dist/components/blog.js

@@ -1,16 +1,16 @@
+import { Link } from "./link.js";
 import { getCreationDate, getPressContext } from "../lib/shared.js";
 import { cn } from "../lib/cn.js";
 import { I18nLabel } from "./i18n.js";
 import { joinPathname } from "../lib/pathname.js";
 import { getBlogContext } from "../plugins/blog.js";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { Link } from "waku";
 import { CornerLeftUpIcon } from "lucide-react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
 //#region src/components/blog.tsx
 function BlogItem({ page, date }) {
 	return /* @__PURE__ */ jsxs(Link, {
-		to: page.url,
+		href: page.url,
 		className: "flex flex-col bg-fd-card rounded-2xl border shadow-sm p-4 transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground",
 		children: [
 			/* @__PURE__ */ jsx("p", {
@@ -52,7 +52,7 @@ function LinkToHome({ lang }) {
 	const { indexPath } = getBlogContext();
 	if (!indexPath) return;
 	return /* @__PURE__ */ jsxs(Link, {
-		to: lang ? joinPathname(lang, indexPath) : indexPath,
+		href: lang ? joinPathname(lang, indexPath) : indexPath,
 		className: cn(buttonVariants({
 			variant: "ghost",
 			className: "text-fd-muted-foreground gap-2"

package/dist/components/link.d.ts

@@ -0,0 +1,25 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { ComponentProps, ReactNode, TransitionFunction } from "react";
+
+//#region src/components/link.d.ts
+interface LinkProps extends ComponentProps<"a"> {
+  /**
+   * indicates if the link should scroll or not on navigation
+   * - `true`: always scroll
+   * - `false`: never scroll
+   * - `undefined`: scroll on path/hash change (not on query-only change)
+   */
+  scroll?: boolean;
+  unstable_pending?: ReactNode;
+  unstable_notPending?: ReactNode;
+  unstable_prefetchOnEnter?: boolean;
+  unstable_prefetchOnView?: boolean;
+  unstable_startTransition?: ((fn: TransitionFunction) => void) | undefined;
+}
+declare function Link({
+  href,
+  children,
+  ...props
+}: LinkProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { Link, LinkProps };

package/dist/components/link.js

@@ -0,0 +1,18 @@
+"use client";
+import { useRouter as useRouter$1 } from "../client.js";
+import { Link } from "waku/router/client";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/link.tsx
+function Link$1({ href = "#", children, ...props }) {
+	if (typeof global !== "undefined" && global.LINK_SSG_CONTEXT) global.LINK_SSG_CONTEXT.links.push({
+		href,
+		fromPathname: useRouter$1().path
+	});
+	return /* @__PURE__ */ jsx(Link, {
+		to: href,
+		...props,
+		children
+	});
+}
+//#endregion
+export { Link$1 as Link };

package/dist/components/provider.js

@@ -1,5 +1,6 @@
 "use client";
-import { Link, useRouter } from "../client.js";
+import { Link } from "./link.js";
+import { useRouter } from "../client.js";
 import { Image } from "./image.js";
 import { jsx } from "react/jsx-runtime";
 import { useMemo } from "react";

package/dist/layouts/blog.index.js

@@ -1,3 +1,4 @@
+import { Link } from "../components/link.js";
 import { getPressContext } from "../lib/shared.js";
 import { cn } from "../lib/cn.js";
 import { I18nLabel } from "../components/i18n.js";
@@ -5,7 +6,6 @@ import { joinPathname } from "../lib/pathname.js";
 import { getBlogContext } from "../plugins/blog.js";
 import { OrderedBlogGrid } from "../components/blog.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { Link } from "waku";
 import { ListIcon } from "lucide-react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
 //#region src/layouts/blog.index.tsx
@@ -26,7 +26,7 @@ function createBlogIndexPage({ heading, description } = {}) {
 					children: description
 				}),
 				tagsPath !== false && /* @__PURE__ */ jsxs(Link, {
-					to: lang ? joinPathname(lang, tagsPath) : tagsPath,
+					href: lang ? joinPathname(lang, tagsPath) : tagsPath,
 					className: cn(buttonVariants({ variant: "primary" }), "gap-2"),
 					children: [/* @__PURE__ */ jsx(ListIcon, { className: "size-4" }), /* @__PURE__ */ jsx(I18nLabel, { label: "allTags" })]
 				})

package/dist/layouts/blog.js

@@ -1,3 +1,4 @@
+import { Link } from "../components/link.js";
 import { getCreationDate, getPressContext, renderBody, renderPageMeta, renderToc } from "../lib/shared.js";
 import { BlogPanel, BlogProvider } from "../components/blog-panel.js";
 import { getTags } from "../lib/shared/blog.js";
@@ -6,7 +7,6 @@ import { createHomeLayout } from "./home.js";
 import { getBlogContext } from "../plugins/blog.js";
 import { LinkToHome } from "../components/blog.js";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { Link } from "waku";
 import { TagIcon } from "lucide-react";
 //#region src/layouts/blog.tsx
 /** You can use `createHomeLayout()` directly, this is only a wrapper */
@@ -48,7 +48,7 @@ function createBlogLayoutPage(options = {}) {
 							className: "flex flex-row items-center gap-2 flex-wrap w-full max-w-[900px] text-sm text-fd-primary-foreground font-mono",
 							children: [/* @__PURE__ */ jsx(TagIcon, { className: "size-4 text-fd-muted-foreground" }), tags.map((t) => {
 								if (tagsPath !== false) return /* @__PURE__ */ jsx(Link, {
-									to: joinPathname(lang ?? "", tagsPath, t),
+									href: joinPathname(lang ?? "", tagsPath, t),
 									className: "px-1.5 py-0.5 rounded-lg bg-fd-primary",
 									children: t
 								}, t);

package/dist/layouts/blog.tags.js

@@ -1,10 +1,10 @@
+import { Link } from "../components/link.js";
 import { getPressContext } from "../lib/shared.js";
 import { I18nLabel } from "../components/i18n.js";
 import { getTags, groupTags } from "../lib/shared/blog.js";
 import { getBlogContext } from "../plugins/blog.js";
 import { LinkToHome, OrderedBlogGrid } from "../components/blog.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { Link } from "waku";
 import { NewspaperIcon, TagIcon } from "lucide-react";
 //#region src/layouts/blog.tags.tsx
 function createBlogTagsPage({ heading, description } = {}) {
@@ -34,7 +34,7 @@ function createBlogTagsPage({ heading, description } = {}) {
 		}), /* @__PURE__ */ jsx("div", {
 			className: "grid grid-cols-2 sm:grid-cols-3 gap-2 mt-4 md:grid-cols-4 xl:grid-cols-6",
 			children: Array.from(grouped.entries()).sort((a, b) => b[1] - a[1]).map(([tag, count]) => /* @__PURE__ */ jsxs(Link, {
-				to: `/blog/tags/${tag}`,
+				href: `/blog/tags/${tag}`,
 				className: "flex flex-row items-center gap-2 bg-fd-card text-fd-card-foreground border font-mono rounded-lg px-2 py-1 transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground",
 				children: [
 					/* @__PURE__ */ jsx(TagIcon, { className: "size-3.5 text-fd-muted-foreground" }),

package/dist/lib/types.d.ts

@@ -7,7 +7,7 @@ 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 } from "waku/router/server";
+import { CreateApi, CreateLayout, CreatePage, CreateRoot, CreateSlice, createPages } from "waku/router/server";
 import { TOCItemType } from "fumadocs-core/toc";
 import { StructuredData } from "fumadocs-core/mdx-plugins";
 import { MiddlewareHandler } from "hono";
@@ -56,7 +56,7 @@ 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>) => MiddlewareHandler[] | undefined;
+  createMiddlewares?: (this: AppContext<C>) => Awaitable<MiddlewareHandler[] | undefined>;
   unstable_onSSGRequest?: <T>(req: Request, next: () => T) => T;
   unstable_onServerEntry?: (entry: ReturnType<ReturnType<typeof unstable_createServerEntryAdapter>>) => ReturnType<ReturnType<typeof unstable_createServerEntryAdapter>>;
 }
@@ -67,6 +67,7 @@ interface BaseRouteFns {
   createApi: CreateApi;
   createSlice: CreateSlice;
 }
+type CreatePagesResult = ReturnType<typeof createPages>;
 interface RouteFns extends BaseRouteFns {
   createApiIsomorphic: (config: {
     render: "static" | "dynamic";
@@ -76,6 +77,8 @@ interface RouteFns extends BaseRouteFns {
       params: Record<string, string | string[]>;
     }) => Promise<Response>;
   }) => void;
+  /** access `createPages()` output */
+  unstable_getCreated: () => CreatePagesResult;
 }
 type ServerPluginOption<C extends ConfigContext = ConfigContext> = ServerPlugin<C> | false | undefined | null | ServerPluginOption<C>[];
 /** can be extended from other libraries */

package/dist/plugins/link-validation.d.ts

@@ -0,0 +1,24 @@
+import { ConfigContext } from "../config.js";
+import { Awaitable, ServerPlugin } from "../lib/types.js";
+
+//#region src/plugins/link-validation.d.ts
+interface LinkSSGContext {
+  links: {
+    href: string;
+    fromPathname: string;
+  }[];
+}
+type ValidateResult = "not-found" | null;
+declare global {
+  /** server always share the same `global` during build, we can use it to collect pre-rendered links */
+  var LINK_SSG_CONTEXT: LinkSSGContext | undefined;
+}
+interface LinkValidationOptions {
+  /** whether the link is skipped for validation */
+  ignored?: (href: string) => boolean;
+  /** when external link is discovered */
+  externalLink?: (href: string) => Awaitable<ValidateResult>;
+}
+declare function linkValidationPlugin<C extends ConfigContext>(options?: LinkValidationOptions): ServerPlugin<C>;
+//#endregion
+export { LinkValidationOptions, linkValidationPlugin };

package/dist/plugins/link-validation.js

@@ -0,0 +1,30 @@
+//#region src/plugins/link-validation.tsx
+function linkValidationPlugin(options = {}) {
+	const { ignored, externalLink } = options;
+	return { unstable_onServerEntry(entry) {
+		const build = entry.build;
+		entry.build = async (...args) => {
+			const context = global.LINK_SSG_CONTEXT = { links: [] };
+			const res = await build(...args);
+			const hrefMap = /* @__PURE__ */ new Map();
+			for (const link of context.links) hrefMap.set(link.href, null);
+			await Promise.all(Array.from(hrefMap.keys()).map(async (href) => {
+				if (href.startsWith("mailto:") || href.startsWith("#")) return;
+				if (ignored && ignored(href)) return;
+				if (URL.canParse(href)) {
+					if (externalLink) hrefMap.set(href, await externalLink(href));
+				} else if ((await entry.fetch(new Request(new URL(href, "http://localhost")))).status === 404) hrefMap.set(href, "not-found");
+			}));
+			const errors = [];
+			for (const link of context.links) {
+				const info = hrefMap.get(link.href);
+				if (info) errors.push(`In "${link.fromPathname}": link "${link.href}" ${info}`);
+			}
+			if (errors.length > 0) throw new Error("\n" + errors.join("\n"));
+			return res;
+		};
+		return entry;
+	} };
+}
+//#endregion
+export { linkValidationPlugin };

package/dist/plugins/llms.txt.js

@@ -92,7 +92,7 @@ function llmsPlugin(options = {}) {
 			createApiIsomorphic({
 				render: renderMode,
 				path: joinPathname(this.i18nConfig ? "[lang]" : "", basePath, "[...slugs]"),
-				staticPaths: renderMode === "static" ? (await this.getLoader()).getPages().map((page) => slugsToMarkdownPath(page.slugs, page.locale).staticPath) : void 0,
+				staticPaths: (await this.getLoader()).getPages().map((page) => slugsToMarkdownPath(page.slugs, page.locale).staticPath),
 				handler: async (_req, { params }) => {
 					const page = (await this.getLoader()).getPage(markdownPathToSlugs(params.slugs), params.lang);
 					if (!page) unstable_notFound();

package/dist/plugins/sitemap.d.ts

@@ -0,0 +1,196 @@
+import { AppContext } from "../lib/shared.js";
+import { ConfigContext } from "../config.js";
+import { Awaitable, ServerPlugin } from "../lib/types.js";
+
+//#region src/plugins/sitemap.d.ts
+/**
+ * How frequently a page is likely to change.
+ *
+ * @see https://www.sitemaps.org/protocol.html#changefreqdef
+ */
+type SitemapChangeFrequency = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+/**
+ * Last modification timestamp in W3C Datetime format (ISO 8601 subset).
+ *
+ * @see https://www.sitemaps.org/protocol.html#xmlDefinition
+ */
+type SitemapLastMod = Date | string;
+/**
+ * Priority of a URL relative to other URLs on the site.
+ *
+ * Valid values are decimals between `0.0` and `1.0` inclusive.
+ *
+ * @see https://www.sitemaps.org/protocol.html#prioritydef
+ */
+type SitemapPriority = number;
+/**
+ * `rel` attribute for sitemap link elements. The protocol only defines `alternate` for hreflang.
+ *
+ * @see https://www.sitemaps.org/protocol.html#xmlDefinition
+ */
+type SitemapLinkRel = "alternate";
+/**
+ * An `xhtml:link` alternate language reference on a URL entry.
+ *
+ * @see https://www.sitemaps.org/protocol.html#xmlDefinition
+ */
+interface SitemapAlternateLink {
+  rel: SitemapLinkRel;
+  /** BCP 47 language tag (e.g. `en`, `de`, `x-default`). */
+  hreflang: string;
+  /** Fully-qualified URL of the alternate page. */
+  href: string;
+}
+/**
+ * An `image:image` entry (Google image sitemap extension).
+ *
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/image-sitemaps
+ */
+interface SitemapImage {
+  /** URL of the image. */
+  loc: string;
+  caption?: string;
+  geo_location?: string;
+  title?: string;
+  license?: string;
+}
+/**
+ * Publication metadata for a `news:news` entry (Google News sitemap extension).
+ *
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/news-sitemap
+ */
+interface SitemapNewsPublication {
+  /** Publication name; must match Google News exactly if submitted there. */
+  name: string;
+  /** Primary language of the publication in ISO 639 format (two or three letter code). */
+  language: string;
+}
+/**
+ * A `news:news` entry (Google News sitemap extension).
+ *
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/news-sitemap
+ */
+interface SitemapNews {
+  publication: SitemapNewsPublication;
+  /** Publication date in W3C Datetime format. */
+  publication_date: SitemapLastMod;
+  /** Title of the news article. */
+  title: string;
+  /** Comma-separated stock tickers (optional). */
+  stock_tickers?: string;
+}
+/**
+ * A `video:video` entry (Google video sitemap extension).
+ *
+ * Only common fields are listed; see Google's schema for the full set.
+ *
+ * @see https://developers.google.com/search/docs/crawling-indexing/sitemaps/video-sitemaps
+ */
+interface SitemapVideo {
+  /** URL of the player page or direct link to the video. */
+  content_loc?: string;
+  /** URL of the player page for this video. */
+  player_loc?: string;
+  /** Whether the video may be embedded. */
+  "player_loc@allow_embed"?: boolean;
+  /** Whether to show a paywall to users from the given countries. */
+  "player_loc@restrict"?: string;
+  /** A URL pointing to the video thumbnail image. */
+  thumbnail_loc: string;
+  title: string;
+  description: string;
+  /** Duration in seconds (max 28800). */
+  duration?: number;
+  /** Expiration date in W3C Datetime format; omit if the video does not expire. */
+  expiration_date?: SitemapLastMod;
+  /** Rating value. 0.0–5.0 or unrated if omitted. */
+  rating?: number;
+  /** Number of times the video has been viewed. */
+  view_count?: number;
+  /** Publication date in W3C Datetime format. */
+  publication_date?: SitemapLastMod;
+  /** Whether the video is family friendly. */
+  family_friendly?: "yes" | "no";
+  /** Comma-separated list of tags. */
+  tag?: string | string[];
+  /** Comma-separated domains the video may not be played on. */
+  restriction?: string;
+  /** Whether search engines may download the video file. */
+  "restriction@relationship"?: "allow" | "deny";
+  gallery_loc?: string;
+  /** Price currency in ISO 4217 format. */
+  price?: string;
+  "price@currency"?: string;
+  "price@type"?: "rent" | "purchase" | "own" | "subscription";
+  /** Platform restriction (e.g. `web`, `mobile`, `tv`). */
+  platform?: string;
+  "platform@relationship"?: "allow" | "deny";
+  /** Whether a subscription is required. */
+  requires_subscription?: "yes" | "no";
+  uploader?: string;
+  "uploader@info"?: string;
+  live?: "yes" | "no";
+}
+/**
+ * A single `<url>` entry in a sitemap.
+ *
+ * @see https://www.sitemaps.org/protocol.html#xmlDefinition
+ */
+interface SitemapUrl {
+  /**
+   * Fully-qualified URL of the page.
+   *
+   * Must be less than 2,048 characters and include protocol + host per the spec.
+   */
+  loc: string;
+  /**
+   * Last modification date of the file.
+   *
+   * Search engines may use the full W3C Datetime or the date portion only.
+   */
+  lastmod?: SitemapLastMod;
+  /**
+   * Hint for how often the page changes.
+   *
+   * Note: The value is a hint, not a command.
+   */
+  changefreq?: SitemapChangeFrequency;
+  /**
+   * Priority relative to other URLs on your site (`0.0`–`1.0`).
+   *
+   * Default priority of pages is `0.5`; this does not affect comparison across different sites.
+   */
+  priority?: SitemapPriority;
+  /**
+   * Alternate language or regional URLs (`xhtml:link`).
+   *
+   * Requires the `xhtml` namespace on the root `urlset` when serialized.
+   */
+  alternates?: readonly SitemapAlternateLink[];
+  /** Image URLs associated with this page (Google image extension). */
+  images?: readonly SitemapImage[];
+  /** Video metadata associated with this page (Google video extension). */
+  videos?: readonly SitemapVideo[];
+  /** News article metadata (Google News extension). */
+  news?: readonly SitemapNews[];
+}
+interface SitemapOptions<C extends ConfigContext = ConfigContext> {
+  /**
+   * Path for the sitemap route.
+   *
+   * @default "/sitemap.xml"
+   */
+  path?: string;
+  /**
+   * Customize or exclude sitemap entries.
+   * Return `undefined` to exclude a page.
+   */
+  getEntry?: (this: AppContext<C>, page: C["page"]) => Awaitable<SitemapUrl | undefined>;
+  /**
+   * Additional entries to include in the sitemap, be careful the `loc` field must be a fully-qualified URL.
+   */
+  additionalEntries?: SitemapUrl[] | ((this: AppContext<C>) => Awaitable<SitemapUrl[]>);
+}
+declare function sitemapPlugin<C extends ConfigContext = ConfigContext>(options?: SitemapOptions<NoInfer<C>>): ServerPlugin<C>;
+//#endregion
+export { SitemapAlternateLink, SitemapChangeFrequency, SitemapImage, SitemapLastMod, SitemapLinkRel, SitemapNews, SitemapNewsPublication, SitemapOptions, SitemapPriority, SitemapUrl, SitemapVideo, sitemapPlugin };

package/dist/plugins/sitemap.js

@@ -0,0 +1,90 @@
+import { getLastModifiedDate } from "../lib/shared.js";
+import { js2xml } from "xml-js";
+//#region src/plugins/sitemap.ts
+function formatLastmod(value) {
+	return (value instanceof Date ? value : new Date(value)).toISOString();
+}
+function imageToElement(image) {
+	const element = { "image:loc": { _text: image.loc } };
+	if (image.caption) element["image:caption"] = { _text: image.caption };
+	if (image.geo_location) element["image:geo_location"] = { _text: image.geo_location };
+	if (image.title) element["image:title"] = { _text: image.title };
+	if (image.license) element["image:license"] = { _text: image.license };
+	return element;
+}
+function entryToUrlElement(entry) {
+	const url = { loc: { _text: entry.loc } };
+	if (entry.lastmod) url.lastmod = { _text: formatLastmod(entry.lastmod) };
+	if (entry.changefreq) url.changefreq = { _text: entry.changefreq };
+	if (entry.priority !== void 0) url.priority = { _text: String(entry.priority) };
+	if (entry.alternates?.length) url["xhtml:link"] = entry.alternates.map((alternate) => ({ _attributes: {
+		rel: alternate.rel,
+		hreflang: alternate.hreflang,
+		href: alternate.href
+	} }));
+	if (entry.images?.length) url["image:image"] = entry.images.map(imageToElement);
+	return url;
+}
+function buildSitemap(entries) {
+	return js2xml({
+		_declaration: { _attributes: {
+			version: "1.0",
+			encoding: "UTF-8"
+		} },
+		urlset: {
+			_attributes: {
+				xmlns: "http://www.sitemaps.org/schemas/sitemap/0.9",
+				"xmlns:xhtml": "http://www.w3.org/1999/xhtml",
+				"xmlns:image": "http://www.google.com/schemas/sitemap-image/1.1"
+			},
+			url: entries.map(entryToUrlElement)
+		}
+	}, {
+		compact: true,
+		spaces: 0
+	});
+}
+function sitemapPlugin(options = {}) {
+	const { path = "/sitemap.xml", getEntry: _getEntry = async function getEntryDefault(page) {
+		return {
+			loc: new URL(page.url, this.siteConfig.baseUrl).href,
+			lastmod: await getLastModifiedDate(this, page),
+			priority: .8
+		};
+	}, additionalEntries } = options;
+	return {
+		name: "core:sitemap",
+		async createPages({ createApiIsomorphic, unstable_getCreated }) {
+			const renderMode = this.mode === "default" ? "static" : this.mode;
+			const getEntry = _getEntry.bind(this);
+			createApiIsomorphic({
+				render: renderMode,
+				path,
+				handler: async () => {
+					const source = await this.getLoader();
+					const entries = [];
+					const pageLocs = /* @__PURE__ */ new Set();
+					for (const entry of await Promise.all(source.getPages().map(getEntry))) {
+						if (!entry) continue;
+						pageLocs.add(entry.loc);
+						entries.push(entry);
+					}
+					for (const route of await unstable_getCreated().unstable_getRouterConfigs()) if (route.isStatic && route.type === "route") {
+						const segments = route.path.map((v) => v.name);
+						if (segments.at(-1) === "404") continue;
+						const loc = new URL("/" + segments.join("/"), this.siteConfig.baseUrl).href;
+						if (pageLocs.has(loc)) continue;
+						entries.push({
+							loc,
+							priority: 1
+						});
+					}
+					if (additionalEntries) entries.push(...typeof additionalEntries === "function" ? await additionalEntries.call(this) : additionalEntries);
+					return new Response(buildSitemap(entries), { headers: { "Content-Type": "application/xml" } });
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { sitemapPlugin };

package/dist/plugins/takumi.js

@@ -57,11 +57,10 @@ function takumiPlugin(options = {}) {
 			});
 		},
 		async createPages({ createApiIsomorphic }) {
-			const renderMode = this.mode === "default" ? "static" : this.mode;
 			createApiIsomorphic({
-				render: renderMode,
+				render: this.mode === "default" ? "static" : this.mode,
 				path: joinPathname(this.i18nConfig ? "[lang]" : "", basePath, "[...slugs]"),
-				staticPaths: renderMode === "static" ? (await this.getLoader()).getPages().map((page) => slugsToImagePath(page.slugs, page.locale).staticPath) : void 0,
+				staticPaths: (await this.getLoader()).getPages().map((page) => slugsToImagePath(page.slugs, page.locale).staticPath),
 				handler: async (_, { params }) => {
 					const page = (await this.getLoader()).getPage(imagePathToSlugs(params.slugs), params.lang);
 					if (!page) unstable_notFound();

package/dist/router/index.d.ts

@@ -10,8 +10,8 @@ import { unstable_createServerEntryAdapter } from "waku/adapter-builders";
 interface Router<C extends ConfigContext = ConfigContext> {
   createPages: (fn?: (this: AppContext<C>, fns: RouteFns) => Awaitable<void>, options?: Options) => ReturnType<typeof createPages>;
   createMiddlewares: () => (() => MiddlewareHandler)[];
-  patchAdapter: <Options>(adapter: ReturnType<typeof unstable_createServerEntryAdapter<Options>>) => Promise<ReturnType<typeof unstable_createServerEntryAdapter<Options>>>;
+  patchAdapter: <Options>(adapter: ReturnType<typeof unstable_createServerEntryAdapter<Options>>) => ReturnType<typeof unstable_createServerEntryAdapter<Options>>;
 }
-declare function createRouter<C extends ConfigContext>(userConfig: ConfigBuilder<C>): Router<C>;
+declare function createRouter<C extends ConfigContext>(userConfig: ConfigBuilder<C>): Promise<Router<C>>;
 //#endregion
 export { Router, createRouter, notFound, redirect };

package/dist/router/index.js

@@ -4,17 +4,16 @@ import { Fragment as Fragment$1 } from "react";
 import { createPages } from "waku";
 import { unstable_notFound, unstable_notFound as notFound, unstable_redirect as redirect } from "waku/router/server";
 //#region src/router/index.tsx
-function createRouter(userConfig) {
-	let _ctx;
-	async function getAppContext() {
-		return await (_ctx ??= initApp(userConfig));
-	}
-	function createPages$1(base, createPagesOptions) {
-		return createPages(async (_fns) => {
-			const context = await getAppContext();
+async function createRouter(userConfig) {
+	const context = await initApp(userConfig);
+	function createPages$2(base, createPagesOptions) {
+		const result = createPages(async (_fns) => {
 			const layouts = context.layouts;
 			const fns = {
 				..._fns,
+				unstable_getCreated() {
+					return result;
+				},
 				createApiIsomorphic(config) {
 					if (config.render === "static") _fns.createApi({
 						render: "static",
@@ -44,7 +43,7 @@ function createRouter(userConfig) {
 			for (const plugin of context.plugins) await plugin.createPages?.call(context, fns);
 			const staticPaths = [];
 			const defaultRenderMode = context.mode === "default" ? "static" : context.mode;
-			if (defaultRenderMode === "static") outer: for (const page of (await context.getLoader()).getPages()) {
+			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);
 			}
@@ -131,18 +130,15 @@ function createRouter(userConfig) {
 			}
 			return null;
 		}, createPagesOptions);
+		return result;
 	}
 	function contextMiddleware() {
-		return async (_c, next) => {
-			const ctx = await getAppContext();
-			return appContext.run(ctx, next);
-		};
+		return (_c, next) => appContext.run(context, next);
 	}
 	function pluginsMiddleware() {
 		async function init() {
-			const ctx = await getAppContext();
 			const out = [];
-			const resolved = await Promise.all(ctx.plugins.map((plugin) => plugin.createMiddlewares?.call(ctx)));
+			const resolved = await Promise.all(context.plugins.map((plugin) => plugin.createMiddlewares?.call(context)));
 			for (const v of resolved) if (v) out.push(...v);
 			return out;
 		}
@@ -162,16 +158,15 @@ function createRouter(userConfig) {
 			return response;
 		};
 	}
-	async function patchAdapter(adapter) {
-		const ctx = await getAppContext();
+	function patchAdapter(adapter) {
 		return (handlers, options) => {
 			let entry = adapter({
 				...handlers,
 				handleBuild(utils) {
 					const hooks = [];
 					hooks.push(utils.withRequest);
-					hooks.push((_req, fn) => appContext.run(ctx, fn));
-					for (const plugin of ctx.plugins) if (plugin.unstable_onSSGRequest) hooks.push(plugin.unstable_onSSGRequest);
+					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();
@@ -183,12 +178,12 @@ function createRouter(userConfig) {
 					});
 				}
 			}, options);
-			for (const plugin of ctx.plugins) if (plugin.unstable_onServerEntry) entry = plugin.unstable_onServerEntry(entry);
+			for (const plugin of context.plugins) if (plugin.unstable_onServerEntry) entry = plugin.unstable_onServerEntry(entry);
 			return entry;
 		};
 	}
 	return {
-		createPages: createPages$1,
+		createPages: createPages$2,
 		patchAdapter,
 		createMiddlewares() {
 			return [contextMiddleware, pluginsMiddleware];

package/dist/vite.js

@@ -60,10 +60,10 @@ const modules = import.meta.glob("./pages/**/*.{ts,tsx,js,jsx}", {
   base: '/src',
 });
 
-const router = createRouter(pressConfig);
+const router = await createRouter(pressConfig);
 const pages = router.createPages(fsRouterFn(modules));
 const middlewareFns = router.createMiddlewares();
-const adapter = await router.patchAdapter(_adapter);
+const adapter = router.patchAdapter(_adapter);
 
 export default adapter(pages, { middlewareFns });
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumapress",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "An opinionated docs framework powered by Fumadocs",
   "keywords": [
     "Docs",
@@ -37,9 +37,11 @@
     "./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",
+    "./plugins/link-validation": "./dist/plugins/link-validation.js",
     "./plugins/llms.txt": "./dist/plugins/llms.txt.js",
     "./plugins/openapi": "./dist/plugins/openapi.js",
     "./plugins/orama-search": "./dist/plugins/orama-search.js",
+    "./plugins/sitemap": "./dist/plugins/sitemap.js",
     "./plugins/takumi": "./dist/plugins/takumi.js",
     "./router": "./dist/router/index.js",
     "./router/fs": "./dist/router/fs.js",
@@ -56,11 +58,10 @@
     "@takumi-rs/image-response": "^1.6.0",
     "class-variance-authority": "^0.7.1",
     "flexsearch": "^0.8.212",
-    "fumadocs-core": "^16.9.3",
-    "fumadocs-ui": "^16.9.3",
     "lucide-react": "^1.17.0",
     "tailwind-merge": "^3.6.0",
     "vite": "^8.0.14",
+    "xml-js": "^1.6.11",
     "zod": "^4.4.3"
   },
   "devDependencies": {
@@ -71,8 +72,10 @@
     "@types/node": "^25.9.1",
     "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
+    "fumadocs-core": "^16.9.3",
     "fumadocs-mdx": "^15.0.10",
     "fumadocs-openapi": "^10.9.1",
+    "fumadocs-ui": "^16.9.3",
     "hono": "^4.12.23",
     "http-cache-semantics": "^4.2.0",
     "react": "^19.2.6",
@@ -85,8 +88,10 @@
   "peerDependencies": {
     "@types/mdx": "*",
     "@types/react": "*",
+    "fumadocs-core": "^16.9.3",
     "fumadocs-mdx": "^15.0.0",
     "fumadocs-openapi": "^10.8.0",
+    "fumadocs-ui": "^16.9.3",
     "hono": "*",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",