Released: 2026-11-13

### Breaking Changes

- `zudoDoc()` now throws a `TypeError` when the settings still contain `findInPage`, the key that 11.0.0 removed, instead of ignoring it. The message tells you to remove the key. Configs without `findInPage` are unaffected. (#4763)
- The `@takazudo/zudo-doc-history-server` peer floor moves from `^11.0.0` to `^12.0.0`. Projects that enable document history need history-server 12.x.

### Features

- Pages that exist as real content in more than one locale now link each other with `<link rel="alternate" hreflang>` after the canonical link, including a self-reference and `x-default` for the default-locale page, and the sitemap lists the same pairs as `xhtml:link` alternates. This covers the home pages and latest document pages; fallback-only, versioned and tag pages stay unpaired. Nothing changes without `siteUrl` or on single-locale sites. `@takazudo/zudo-doc/route-enumerators` adds `getDocLocaleAlternates` and `getHomeLocaleAlternates`, and sitemap entries gain an optional `alternates` field. (#4787)

### Bug Fixes

- The sitemap's `<lastmod>` is now each document page's last-updated date from document history, the same date as its "Updated" label, instead of the build date on every URL. Routes with no known date (home and locale roots, tag, asset and versioned pages, or any page while `docHistory` is off or document history generation is skipped) have no `<lastmod>`. `@takazudo/zudo-doc/route-enumerators` adds `enumerateSitemapEntries`; `enumerateAllRoutes` is unchanged. (#4784)
- Page URLs in `llms.txt`, `llms-full.txt`, the browser search index (`search-index.json`), the agent export (manifest, items, search index) and MCP `search`/`fetch` results now follow the `trailingSlash` setting, the same as the built routes. With `trailingSlash: true` they end with `/` and no longer cite a URL that redirects; with `trailingSlash: false` output is unchanged. The schemas are unchanged and agent page IDs stay the same, but the `url` values, the `llms.txt` bytes and the agent corpus fingerprint change for sites with `trailingSlash: true`. (#4783)
- MCP `search` result titles name the part of a multi-part page once, for example `Read-only MCP server (en · part 1/2)` instead of `Read-only MCP server (part 1/2) (en · part 1/2)`. Stored item titles and `fetch` results are unchanged. (#4783)
- `/mcp` no longer approves the opaque `Origin: null` when `siteUrl` has no `http:` or `https:` scheme (for example `docs.example.com:8443`). Only an `http(s)` `siteUrl` adds an approved origin; requests without `Origin` and requests from the endpoint's own origin behave as before. (#4783)
- The agent export (`/agent/v1/` pages, items and search index) now turns admonitions, `<Details>` and `<TabItem>` into a bold label such as `**Note: Title**` followed by their body, and renders `<CategoryNav>`, `<CategoryTreeNav>`, `<SiteTreeNav>`, `<DocCardNav>` and `<NoteTrayIndex>` as Markdown link lists of the same locale's exported pages. These pages are no longer marked `unsupportedDynamicContent`. Other components, and components whose props are not plain literals, still become a placeholder that now names the component, for example `[Dynamic content unavailable in text export: MathBlock]`, and keep the flag. Item text and the corpus fingerprint change for pages that use these components. `llms-full.txt` is unchanged. (#4786)