12.0.0
Release notes for 12.0.0.
Released: 2026-11-13
Breaking Changes
zudoDoc()now throws aTypeErrorwhen the settings still containfindInPage, the key that 11.0.0 removed, instead of ignoring it. The message tells you to remove the key. Configs withoutfindInPageare unaffected. (#4763)The
@takazudo/zudo-doc-history-serverpeer floor moves from^11.0.0to^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 andx-defaultfor the default-locale page, and the sitemap lists the same pairs asxhtml:linkalternates. This covers the home pages and latest document pages; fallback-only, versioned and tag pages stay unpaired. Nothing changes withoutsiteUrlor on single-locale sites.@takazudo/addszudo- doc/ route- enumerators getDocLocaleAlternatesandgetHomeLocaleAlternates, and sitemap entries gain an optionalalternatesfield. (#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 whiledocHistoryis off or document history generation is skipped) have no<lastmod>.@takazudo/addszudo- doc/ route- enumerators enumerateSitemapEntries;enumerateAllRoutesis 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 MCPsearch/fetchresults now follow thetrailingSlashsetting, the same as the built routes. WithtrailingSlash: truethey end with/and no longer cite a URL that redirects; withtrailingSlash: falseoutput is unchanged. The schemas are unchanged and agent page IDs stay the same, but theurlvalues, thellms.txtbytes and the agent corpus fingerprint change for sites withtrailingSlash: true. (#4783)MCP
searchresult titles name the part of a multi-part page once, for exampleRead-only MCP server (en · part 1/2)instead ofRead-. Stored item titles andonly MCP server (part 1/ 2) (en · part 1/ 2) fetchresults are unchanged. (#4783)/no longer approves the opaquemcp Origin: nullwhensiteUrlhas nohttp:orhttps:scheme (for exampledocs.example.com:8443). Only anhttp(s)siteUrladds an approved origin; requests withoutOriginand requests from the endpoint's own origin behave as before. (#4783)The agent export (
/pages, items and search index) now turns admonitions,agent/ v1/ <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 markedunsupportedDynamicContent. 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.txtis unchanged. (#4786)