[dependabot]

Bumps the fumadocs group with 4 updates in the /docs-site directory: fumadocs-core, fumadocs-mdx, fumadocs-ui and fumadocs-python.

Updates fumadocs-core from 16.15.4 to 16.17.9

Release notes

Sourced from fumadocs-core's releases.

fumadocs@16.17.9

• @​fumadocs/base-ui@​16.17.9
• fumadocs-core@16.17.9
• fumadocs-ui@16.17.9

Keep the theme on Astro navigations

• The Astro RootProvider keeps the theme across navigations of the Astro client router.

Faster and more stable TOC

• TOCItems of the normal and clerk styles no longer throws "is not iterable" when navigating between pages quickly.
• The TOC track is measured once per change and drawn before paint: less work on navigation, no frame showing the previous page's track.
• The normal style highlights the active range right after the page loads, not only after the first scroll.
• Custom heading IDs containing quotes no longer crash the normal and clerk styles.

Fix #3754

Copy the page tree on deserialization

• deserializePageTree() and useFumadocsLoader() no longer mutate the serialized page tree.

Keep the AsyncAPI data of generated pages

• pageSchema keeps _asyncapi in the frontmatter of pages generated by Fumadocs AsyncAPI, like _openapi.

TanStack links with a hash or search params

• Links like /docs/page#heading or /docs/page?q=1 preload and open the right page in the TanStack adapter.

Fix #3758

fumadocs@16.17.8

• @​fumadocs/base-ui@​16.17.8
• fumadocs-core@16.17.8
• fumadocs-ui@16.17.8

Bring your own highlighter

Shiki stays the default, and isn't loaded when you highlight code with another highlighter.

• fumadocs-core/highlight exports a Highlighter interface, created with createHighlights() from fumadocs-core/highlight/highlights (@pierre/highlights) or createShikiHighlighter() from fumadocs-core/highlight/shiki, override() creates one with other options.
• rehypeCodeFromHighlighter from fumadocs-core/mdx-plugins/rehype-code.core highlights code blocks with a highlighter, or a function creating one with the transformers of Fumadocs. createRehypeCode is deprecated, Sätteri has rehypeCodeFromHighlighter in @fumadocs/satteri/rehype-code. Pass transformerTwoslash() in its transformers option to analyze Twoslash blocks in batches.
• createServerCodeBlock() and createDynamicCodeBlock() in Fumadocs UI create code blocks from a highlighter. Dynamic code blocks are highlighted on the server too.
• toJsx() from fumadocs-core/utils/hast-to-jsx converts hast into React elements like toJsxRuntime() of hast-util-to-jsx-runtime, MDX nodes through an evaluator, over 10x faster on highlighted code, whose spans render as one HTML string. Every Fumadocs renderer uses it, hast-util-to-jsx-runtime is no longer a dependency.
• Twoslash loads the languages of code blocks in popups before highlighting, an unknown language there no longer fails the code block.
• OpenAPI Standalone highlights code blocks with Highlights, in its server-rendered pages too.
• The page factories of OpenAPI, GraphQL and AsyncAPI, type tables, createPython(), createPythonComponents(), localHtml() and the shadcn createSnippet() take a highlighter.
• Deprecated shiki and shikiOptions of the API pages and shiki of type tables, pass a highlighter instead.
• Integrations require fumadocs-core 16.17.8, the API pages and shadcn also require fumadocs-ui 16.17.8.

... (truncated)

Commits

• c308d52 Version Packages (#3745)
• bc26607 fix(mdx-remote): strip frontmatter
• 85280a5 docs: group integration guides by framework, align Astro page data (#3760)
• 5adee40 feat(astro): first-class Astro integration and docs (#3759)
• 4be3d58 fix(core): align tanstack link behaviours
• 71d1358 docs: add community Privatus Analytics integration (#3757)
• da4ca7b fix(ui): better toc
• 4a7b6be fix(cli): correct route locations
• 2af7b68 fix(openapi, asyncapi): resolve index card links from the output directory (#...
• 5bf8134 feat(openapi): let renderParameterField render the default input with another...
• Additional commits viewable in compare view

Updates fumadocs-mdx from 15.4.0 to 15.4.10

Release notes

Sourced from fumadocs-mdx's releases.

fumadocs-mdx@15.4.10

remarkInclude in fumadocs-core

<include> moved from Fumadocs MDX to fumadocs-core/mdx-plugins/remark-include, a unified plugin for any MDX or Markdown pipeline.

• fumadocs-mdx/config still exports remarkInclude, forwarded from fumadocs-core.
• getProcessor parses included files by their format, like a .md file included in an .mdx page.
• Headings in an included section get IDs unique among the page's own headings.
• Circular includes throw instead of hanging, and included code files no longer end with an empty line.
• fumadocs-mdx requires fumadocs-core 16.17.8.

fumadocs-mdx@15.4.9

Turbopack loader warnings

• Next.js 16.4 builds no longer warn Module not found: Can't resolve <dynamic> for the config imports of the loaders.

fumadocs-mdx@15.4.8

Imports across Windows drives

• remarkImage and generated .source files import files on another drive or a UNC path by their absolute path.
• Generated imports of files in dot-folders are prefixed with ./.

Fix #3723

fumadocs-mdx@15.4.7

Markdown and search records from the authored source

remarkLLMs() and remarkStructure() of fumadocs-core slice their Markdown from the authored source like Sätteri, instead of stringifying the syntax tree. It is much faster, Markdown is no longer escaped or reformatted, and local images keep their addresses. Re-sync your search indexes to pick up the new records.

• Plugins record the Markdown of content they replace with replaceSource() or embedSource() from fumadocs-core/mdx-plugins/stringifier, in place of data._stringify, and add search records with data.structuredData. Nodes they insert otherwise are left out. A namespace limits an edit to the stringifiers of that namespace, like search for search records.
• Search records are always Markdown, also in Sätteri. filterElement replaces stringify.filterElement, it chooses the JSX elements kept as HTML tags (File, TypeTable, Callout and Card by default) that search dialogs render as components. Other elements and links are replaced by their content, images are removed, and an element on one line is recorded like a paragraph.
• Removed defaultStringifier() (use createStringifier()), StringifyOptions, allowedMdxAttributes, filterMdxAttributes, placeholder() (use mdxAsPlaceholder), and the stringify and mdast-util-to-markdown options of both plugins.
• Included content goes through the plugins like the document's own, Sätteri includes .md files as Markdown.
• <auto-files> shows its files in a code block, auto-type-table its props in a Markdown table, created by typeTableToMarkdown() from fumadocs-typescript.
• remarkShow() and fileGenerator() of fumadocs-docgen record their Markdown, generators receive the file to do the same.
• Records of fumadocs-obsidian resolve wikilinks, and leave comments, block IDs, callout markers and embeds out. Comments are removed before parsing, so they no longer split a paragraph.
• Pages of fumadocs-python compile from their MDX, so they have Markdown and search records.
• fumadocs-mdx, fumadocs-docgen and fumadocs-obsidian require fumadocs-core 16.17.0.

Fix #3662

Commits

• 97e62b9 Version Packages (#3733)
• ccae3e0 fix(core): improve shiki compat
• 96a571b chore: bump deps
• 097b5cc fix: workaround ts 7.1 bugs
• 2fced92 feat(twoslash,story,typescript): use typescript 7.1
• 6e2a75e perf(core): improve transformer performance
• 4f5cbd3 perf(core): rewrite hast-util-to-jsx-runtime
• f0d8981 feat(*): new highlighter API + highlights
• bc86bbb fix(core,satteri): use served URLs of imported images in processed Markdown (...
• cfdccc8 feat(core): support remark-include at core layer (#3740)
• Additional commits viewable in compare view

Updates fumadocs-ui from 16.15.4 to 16.17.9

Release notes

Sourced from fumadocs-ui's releases.

fumadocs@16.17.9

• @​fumadocs/base-ui@​16.17.9
• fumadocs-core@16.17.9
• fumadocs-ui@16.17.9

Keep the theme on Astro navigations

• The Astro RootProvider keeps the theme across navigations of the Astro client router.

Faster and more stable TOC

• TOCItems of the normal and clerk styles no longer throws "is not iterable" when navigating between pages quickly.
• The TOC track is measured once per change and drawn before paint: less work on navigation, no frame showing the previous page's track.
• The normal style highlights the active range right after the page loads, not only after the first scroll.
• Custom heading IDs containing quotes no longer crash the normal and clerk styles.

Fix #3754

Copy the page tree on deserialization

• deserializePageTree() and useFumadocsLoader() no longer mutate the serialized page tree.

Keep the AsyncAPI data of generated pages

• pageSchema keeps _asyncapi in the frontmatter of pages generated by Fumadocs AsyncAPI, like _openapi.

TanStack links with a hash or search params

• Links like /docs/page#heading or /docs/page?q=1 preload and open the right page in the TanStack adapter.

Fix #3758

fumadocs@16.17.8

• @​fumadocs/base-ui@​16.17.8
• fumadocs-core@16.17.8
• fumadocs-ui@16.17.8

Bring your own highlighter

Shiki stays the default, and isn't loaded when you highlight code with another highlighter.

• fumadocs-core/highlight exports a Highlighter interface, created with createHighlights() from fumadocs-core/highlight/highlights (@pierre/highlights) or createShikiHighlighter() from fumadocs-core/highlight/shiki, override() creates one with other options.
• rehypeCodeFromHighlighter from fumadocs-core/mdx-plugins/rehype-code.core highlights code blocks with a highlighter, or a function creating one with the transformers of Fumadocs. createRehypeCode is deprecated, Sätteri has rehypeCodeFromHighlighter in @fumadocs/satteri/rehype-code. Pass transformerTwoslash() in its transformers option to analyze Twoslash blocks in batches.
• createServerCodeBlock() and createDynamicCodeBlock() in Fumadocs UI create code blocks from a highlighter. Dynamic code blocks are highlighted on the server too.
• toJsx() from fumadocs-core/utils/hast-to-jsx converts hast into React elements like toJsxRuntime() of hast-util-to-jsx-runtime, MDX nodes through an evaluator, over 10x faster on highlighted code, whose spans render as one HTML string. Every Fumadocs renderer uses it, hast-util-to-jsx-runtime is no longer a dependency.
• Twoslash loads the languages of code blocks in popups before highlighting, an unknown language there no longer fails the code block.
• OpenAPI Standalone highlights code blocks with Highlights, in its server-rendered pages too.
• The page factories of OpenAPI, GraphQL and AsyncAPI, type tables, createPython(), createPythonComponents(), localHtml() and the shadcn createSnippet() take a highlighter.
• Deprecated shiki and shikiOptions of the API pages and shiki of type tables, pass a highlighter instead.
• Integrations require fumadocs-core 16.17.8, the API pages and shadcn also require fumadocs-ui 16.17.8.

... (truncated)

Commits

• c308d52 Version Packages (#3745)
• bc26607 fix(mdx-remote): strip frontmatter
• 85280a5 docs: group integration guides by framework, align Astro page data (#3760)
• 5adee40 feat(astro): first-class Astro integration and docs (#3759)
• 4be3d58 fix(core): align tanstack link behaviours
• 71d1358 docs: add community Privatus Analytics integration (#3757)
• da4ca7b fix(ui): better toc
• 4a7b6be fix(cli): correct route locations
• 2af7b68 fix(openapi, asyncapi): resolve index card links from the output directory (#...
• 5bf8134 feat(openapi): let renderParameterField render the default input with another...
• Additional commits viewable in compare view

Updates fumadocs-python from 1.0.1 to 1.0.5

Release notes

Sourced from fumadocs-python's releases.

fumadocs-python@1.0.5

Bring your own highlighter

Shiki stays the default, and isn't loaded when you highlight code with another highlighter.

• fumadocs-core/highlight exports a Highlighter interface, created with createHighlights() from fumadocs-core/highlight/highlights (@pierre/highlights) or createShikiHighlighter() from fumadocs-core/highlight/shiki, override() creates one with other options.
• rehypeCodeFromHighlighter from fumadocs-core/mdx-plugins/rehype-code.core highlights code blocks with a highlighter, or a function creating one with the transformers of Fumadocs. createRehypeCode is deprecated, Sätteri has rehypeCodeFromHighlighter in @fumadocs/satteri/rehype-code. Pass transformerTwoslash() in its transformers option to analyze Twoslash blocks in batches.
• createServerCodeBlock() and createDynamicCodeBlock() in Fumadocs UI create code blocks from a highlighter. Dynamic code blocks are highlighted on the server too.
• toJsx() from fumadocs-core/utils/hast-to-jsx converts hast into React elements like toJsxRuntime() of hast-util-to-jsx-runtime, MDX nodes through an evaluator, over 10x faster on highlighted code, whose spans render as one HTML string. Every Fumadocs renderer uses it, hast-util-to-jsx-runtime is no longer a dependency.
• Twoslash loads the languages of code blocks in popups before highlighting, an unknown language there no longer fails the code block.
• OpenAPI Standalone highlights code blocks with Highlights, in its server-rendered pages too.
• The page factories of OpenAPI, GraphQL and AsyncAPI, type tables, createPython(), createPythonComponents(), localHtml() and the shadcn createSnippet() take a highlighter.
• Deprecated shiki and shikiOptions of the API pages and shiki of type tables, pass a highlighter instead.
• Integrations require fumadocs-core 16.17.8, the API pages and shadcn also require fumadocs-ui 16.17.8.

fumadocs-python@1.0.4

Markdown and search records from the authored source

remarkLLMs() and remarkStructure() of fumadocs-core slice their Markdown from the authored source like Sätteri, instead of stringifying the syntax tree. It is much faster, Markdown is no longer escaped or reformatted, and local images keep their addresses. Re-sync your search indexes to pick up the new records.

• Plugins record the Markdown of content they replace with replaceSource() or embedSource() from fumadocs-core/mdx-plugins/stringifier, in place of data._stringify, and add search records with data.structuredData. Nodes they insert otherwise are left out. A namespace limits an edit to the stringifiers of that namespace, like search for search records.
• Search records are always Markdown, also in Sätteri. filterElement replaces stringify.filterElement, it chooses the JSX elements kept as HTML tags (File, TypeTable, Callout and Card by default) that search dialogs render as components. Other elements and links are replaced by their content, images are removed, and an element on one line is recorded like a paragraph.
• Removed defaultStringifier() (use createStringifier()), StringifyOptions, allowedMdxAttributes, filterMdxAttributes, placeholder() (use mdxAsPlaceholder), and the stringify and mdast-util-to-markdown options of both plugins.
• Included content goes through the plugins like the document's own, Sätteri includes .md files as Markdown.
• <auto-files> shows its files in a code block, auto-type-table its props in a Markdown table, created by typeTableToMarkdown() from fumadocs-typescript.
• remarkShow() and fileGenerator() of fumadocs-docgen record their Markdown, generators receive the file to do the same.
• Records of fumadocs-obsidian resolve wikilinks, and leave comments, block IDs, callout markers and embeds out. Comments are removed before parsing, so they no longer split a paragraph.
• Pages of fumadocs-python compile from their MDX, so they have Markdown and search records.
• fumadocs-mdx, fumadocs-docgen and fumadocs-obsidian require fumadocs-core 16.17.0.

Fix #3662

Commits

• 97e62b9 Version Packages (#3733)
• ccae3e0 fix(core): improve shiki compat
• 96a571b chore: bump deps
• 097b5cc fix: workaround ts 7.1 bugs
• 2fced92 feat(twoslash,story,typescript): use typescript 7.1
• 6e2a75e perf(core): improve transformer performance
• 4f5cbd3 perf(core): rewrite hast-util-to-jsx-runtime
• f0d8981 feat(*): new highlighter API + highlights
• bc86bbb fix(core,satteri): use served URLs of imported images in processed Markdown (...
• cfdccc8 feat(core): support remark-include at core layer (#3740)
• Additional commits viewable in compare view

[sameerkumar18]

@dependabot rebase