build(deps): bump the docs-fumadocs group across 1 directory with 4 updates - #3642

Sourced from fumadocs-core's releases.

fumadocs@16.15.17

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

Apply the Vite base path to the "View as Markdown" link

<ViewOptionsPopover /> linked to markdownUrl without the Vite base, so sites served under a base path got a 404. It now prefixes the URL like <MarkdownCopyButton /> does.

Fix #3620

fumadocs@16.15.16

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

Don't copy failed Markdown responses

<MarkdownCopyButton /> copied the body of error responses, like a 404 page, and kept it cached until a full reload. Failed responses are rejected, and only successful ones are cached.

Fix #3612

Get pages by decoded slugs

getPage() accepts both URI encoded and decoded slugs. React Router and TanStack Router pass decoded params, so pages with spaces or non-ASCII characters in their slugs were not found.

Fix #3613

fumadocs@16.15.15

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

Fix infinite recursion in the MDX stringifier with mdast-util-to-markdown@2.1.3

The stringifier wraps every toMarkdown handler but dropped their attention and peek properties, which mdast-util-to-markdown@2.1.3 relies on to serialize bold and italic text. Pages containing them overflowed the stack during build.

fumadocs@16.15.14

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

Announce copy confirmation to screen readers

Copy buttons are polite live regions whose label switches to "Copied" after a successful copy, so screen readers announce it. The code block's copy button no longer reports success when the clipboard write fails.

Expose the search dialog as a combobox

The search input is now a combobox that controls a listbox of option results and reports the highlighted result through aria-activedescendant, so screen readers announce results as you move through them. Hidden result buttons are removed from the tab order, and the empty state is announced as a status message.

... (truncated)

• bb43b61 Version Packages (#3621)
• 6791d6f fix(ui): apply the Vite base path to the "View as Markdown" link
• bc42c20 Version Packages (#3618)
• 2516fba feat(openapi): show auth descriptions in a hover card
• abdba4e clean code
• b7f5431 fix(openapi): follow-ups to #3617
• 1e88d6f Fix OpenAPI issues (#3617)
• 1bc5374 Version Packages (#3603)
• 7b83e88 fix(core): fix infinite recursion in the MDX stringifier with `mdast-util-to-...
• c481705 fix(api-docs): label schema property copy button (#3602)
• Additional commits viewable in compare view

Sourced from fumadocs-mdx's releases.

fumadocs-mdx@15.4.5

Stop recrawling node_modules on every Vite config resolution

The config hook of fumadocs-mdx/vite walked the dependency tree below Fumadocs packages once per chain reaching a package, so a docs app with a few Fumadocs packages read ~10k package.json files (~0.9s) each time Vite resolved its config, which it does once per build environment.

The crawl now visits each package once, breadth-first, and still records the shortest chain to every CommonJS dependency (fumadocs-ui > @base-ui/react > use-sync-external-store/shim and friends). The result is memoized for the process until the package manager's install state changes, so a build with several environments crawls once.

fumadocs-mdx@15.4.4

Sort glob results for deterministic codegen

fumadocs-mdx's Node codegen now sorts glob-matched files before generating collections, so the output (and anything derived from getPages()) is stable across builds of unchanged content. The Vite codegen path was checked separately: Vite's own import.meta.glob already sorts matched files internally, so it did not need the same fix.

fumadocs-mdx@15.4.3

Fix experimentalBuildCache bloating frontmatter-only imports

With a warm build cache, ?only=frontmatter imports were served the fully compiled page from cache instead of the frontmatter module, so every page was bundled two more times. The cache now only applies to full compilations.

fumadocs-mdx@15.4.2

Fix the _mdast export with removePosition

// fumadocs-mdx collection config
postprocess: {
  includeMDAST: { removePosition: true },
},

This exported _mdast with no value, and getMDAST() then reported that includeMDAST was disabled. removePosition strips positions in place and returns nothing, so JSON.stringify received undefined.

The tree is now cloned, stripped, and serialized from the clone.

Fix SOURCEMAP_BROKEN warnings on Vite

With build.sourcemap enabled, Vite warned once per content and meta file because the loaders returned no source map. They now return an empty map when nothing is generated.

Source maps for MDX stay opt-in, pass SourceMapGenerator from source-map to MDX options:

import { SourceMapGenerator } from 'source-map';
export default defineConfig({
mdxOptions: {
SourceMapGenerator,
},
});

• cb6f3d6 Version Packages (#3600)
• 6676327 perf(mdx): reduce duplicated file reads
• f1186d9 fix(openapi): normalize fetch methods
• a8438dc Version Packages (#3595)
• 539bada feat(ui): support block toc variant
• 23bef0b docs: correct stale info
• e988e54 fix(ui): announce copy confirmation to screen readers
• 583e2ca fix(ui): keep search dialog active state inside the list
• 11bc9dc fix(ui): expose the search dialog as a combobox
• d7fa38c fix(ui): remove hidden sidebar controls from the tab order
• Additional commits viewable in compare view

Sourced from fumadocs-openapi's releases.

fumadocs-openapi@12.1.0

Render security scheme descriptions as Markdown in the playground

Fix #3607

Render request bodies of unsupported media types read-only

A request body with a media type that has no adapter no longer throws. It is shown as usual, left out of code usages, and cannot be sent from the playground.

text/plain with parameters, like text/plain; charset=utf-8, is also handled like text/plain.

isMediaTypeSupported() is removed, use resolveMediaAdapter() instead.

Fix #3615

Add createOAuthHandler()

A route handler to use as the single OAuth redirect URI of API playgrounds, instead of registering every page. Pass its URL to createOpenAPIPage({ oauthRedirectUrl }).

import { openapi } from '@/lib/openapi';
export const GET = openapi.createOAuthHandler();

Fix #3611

Fix OAuth flows of the API playground

• The client credentials flow can send the client credentials in an HTTP Basic Authorization header, like the password flow (#3609).
• Relative authorizationUrl and tokenUrl are resolved against the selected server, requestOAuthToken() requires a serverUrl for it (#3610).
• The redirect_uri leaves out the fragment and query of the page, a fragment is not allowed in redirect URIs.
• Multiple scopes are space-delimited, they were sent as a single scope joined by +.
• Query params of authorizationUrl, like audience, are kept.
• HTTP Basic client credentials are form-encoded, as RFC 6749 requires.
• The implicit and authorization code flows send a random state, and keep the flow in sessionStorage instead of the URL: the client secret is no longer sent to the authorization server, the token URL resolves against the server selected when the flow starts, and only flows started in the same tab are accepted.

Skip response examples without a value

An Example Object can omit value, like when it uses externalValue, which crashed the operation page. These examples are skipped.

Examples with the OpenAPI 3.2 dataValue are rendered too.

Fix #3608

fumadocs-openapi@12.0.4

Name schema property link buttons for screen readers

Give the icon-only property link button a translated label and announce when its link has been copied. Include Simplified and Traditional Chinese translations for both labels.

... (truncated)

• bc42c20 Version Packages (#3618)
• 2516fba feat(openapi): show auth descriptions in a hover card
• abdba4e clean code
• b7f5431 fix(openapi): follow-ups to #3617
• 1e88d6f Fix OpenAPI issues (#3617)
• 1bc5374 Version Packages (#3603)
• 7b83e88 fix(core): fix infinite recursion in the MDX stringifier with `mdast-util-to-...
• c481705 fix(api-docs): label schema property copy button (#3602)
• d48fa91 docs: preview toc variants
• cb6f3d6 Version Packages (#3600)
• Additional commits viewable in compare view

Sourced from fumadocs-ui's releases.

fumadocs@16.15.17

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

Apply the Vite base path to the "View as Markdown" link

<ViewOptionsPopover /> linked to markdownUrl without the Vite base, so sites served under a base path got a 404. It now prefixes the URL like <MarkdownCopyButton /> does.

Fix #3620

fumadocs@16.15.16

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

Don't copy failed Markdown responses

<MarkdownCopyButton /> copied the body of error responses, like a 404 page, and kept it cached until a full reload. Failed responses are rejected, and only successful ones are cached.

Fix #3612

Get pages by decoded slugs

getPage() accepts both URI encoded and decoded slugs. React Router and TanStack Router pass decoded params, so pages with spaces or non-ASCII characters in their slugs were not found.

Fix #3613

fumadocs@16.15.15

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

Fix infinite recursion in the MDX stringifier with mdast-util-to-markdown@2.1.3

The stringifier wraps every toMarkdown handler but dropped their attention and peek properties, which mdast-util-to-markdown@2.1.3 relies on to serialize bold and italic text. Pages containing them overflowed the stack during build.

fumadocs@16.15.14

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

Announce copy confirmation to screen readers

Copy buttons are polite live regions whose label switches to "Copied" after a successful copy, so screen readers announce it. The code block's copy button no longer reports success when the clipboard write fails.

Expose the search dialog as a combobox

The search input is now a combobox that controls a listbox of option results and reports the highlighted result through aria-activedescendant, so screen readers announce results as you move through them. Hidden result buttons are removed from the tab order, and the empty state is announced as a status message.

... (truncated)

• bb43b61 Version Packages (#3621)
• 6791d6f fix(ui): apply the Vite base path to the "View as Markdown" link
• bc42c20 Version Packages (#3618)
• 2516fba feat(openapi): show auth descriptions in a hover card
• abdba4e clean code
• b7f5431 fix(openapi): follow-ups to #3617
• 1e88d6f Fix OpenAPI issues (#3617)
• 1bc5374 Version Packages (#3603)
• 7b83e88 fix(core): fix infinite recursion in the MDX stringifier with `mdast-util-to-...
• c481705 fix(api-docs): label schema property copy button (#3602)
• Additional commits viewable in compare view