@cogita/plugin-sitemap generates a standard sitemap.xml during a static build so search engines can discover the home page, posts, and other public routes configured by the site.
The plugin only collects build-time data and writes XML. It adds no runtime virtual module and does not change theme rendering. Absolute URLs are derived from site.url and site.base.
Without sitemap, the plugin returns null and preserves the zero-config behavior. When enabled without site.url, strict mode fails the build; non-strict mode warns and skips generation.
The sitemap reads Core's ContentIndex first and reuses the shared post-list route contract. Because Rspress plugin beforeBuild hooks run in parallel, it does not read virtual-posts-data or rely on another plugin's execution order. An independent scan remains as a fallback when no shared index is available.
site.url provides the domain and any deployment path already present.site.base fills in the deployment path when it is absent from site.url.posts.routePrefix and the post file path./about and complete HTTP(S) URLs.loc and sorted deterministically.sitemap.xml inside the build directory.path cannot escape the build output directory.lastmod only contains parseable dates.priority is clamped to 0 through 1.The first release does not include image sitemaps, multilingual indexes, or a sitemap index. The SEO plugin can later reuse the sitemap's normalized URL helper. Route inclusion should also respect theme layout capability so the sitemap never advertises a route that would render a 404.
For the Chinese version, see 站点地图插件架构设计.