Update fumadocs (major) #99

renovate · 2025-09-20T12:52:43Z

This PR contains the following updates:

Package	Change	Diffend
fumadocs-core (source)	`15.2.8` -> `16.0.11`	Diff
fumadocs-mdx (source)	`11.6.0` -> `13.0.8`	Diff
fumadocs-ui (source)	`15.2.8` -> `16.0.11`	Diff

Release Notes

fuma-nama/fumadocs (fumadocs-core)

`v16.0.11`

Compare Source

Patch Changes

ff68f69: [Page Tree Builder] Fix node IDs are not unique across different locales
00058c8: Drop framework-side createContext

`v16.0.10`

Compare Source

Patch Changes

733b01e: Support remarkDirectiveAdmonition, deprecate remarkAdmonition in favor of it.

`v16.0.9`

Compare Source

Patch Changes

2eef888: Remove unnecessary aria-label from the link icon in headings
- fumadocs-core@16.0.9

`v16.0.8`

Compare Source

Patch Changes

c0df2c4: improve navbar button gaps
117ad86: Add support for using a custom GitHub API base URL
Updated dependencies [bc97236]
Updated dependencies [ca09b6a]
Updated dependencies [117ad86]
- fumadocs-core@16.0.8

`v16.0.7`

Patch Changes

Updated dependencies [f97cd1e]
Updated dependencies [f7e15e2]
- fumadocs-core@16.0.7

`v16.0.5`

Compare Source

Patch Changes

8221785: hotfix i18n middleware URL formating

`v16.0.4`

Compare Source

Patch Changes

99971c7: Support external: to mark links as external in meta.json

`v16.0.3`

Compare Source

`v16.0.2`

Compare Source

Patch Changes

d511232: Fix i18n middleware search params handling

`v16.0.1`

Compare Source

Patch Changes

45f0c1f: hotfix <DynamicCodeBlock /> Vite + React 19.2 compat issues

`v16.0.0`

Major Changes

851897c: Remove fumadocs-core/sidebar API

why: no longer used by Fumadocs UI, and the abstraction isn't good enough.

migrate: The original component is mostly a wrapper of react-remove-scroll, you can use Shadcn UI for pre-built sidebars.
4049ccc: Remove fumadocs-core/server export
- getGithubLastEdit: Moved to fumadocs-core/content/github.
- getTableOfContents: Moved to fumadocs-core/content/toc.
- PageTree and page tree utilities: Moved to fumadocs-core/page-tree.
- TOCItemType, TableOfContents: Moved to fumadocs-core/toc.
- createMetadataImage: Use the Next.js Metadata API instead.
429c41a: Switch to Shiki JavaScript Regex engine by default

This is important for Cloudflare Worker compatibility, JavaScript engine is the new default over Oniguruma (WASM).
- rehype-code: replaced the experimentalJSEngine option with engine: js | oniguruma.
- fumadocs-core/highlight: use JS engine by default, drop custom engine support, use Shiki directly instead.
5210f18: Set minimal React.js version to 19.2.0

19.2 has multiple crucial updates that can improve Fumadocs' performance, and it should works seamlessly on mainstream React.js frameworks.

As a consequence, Next.js 16 is now the minimal version when using Fumadocs UI because Next.js always uses the internal canary version of React.js.
42f09c3: Remove deprecated APIs
- fumadocs-ui/page:
  - removed <DocsCategory />.
  - removed breadcrumbs.full option from <DocsPage />.
- fumadocs-core/search/algolia: renamed option document to indexName.
- fumadocs-core/search:
  - remove deprecated signature of createFromSource(): migrate to newer usage instead.
```
export function createFromSource<S extends LoaderOutput<LoaderConfig>>(
  source: S,
  pageToIndexFn?: (page: InferPageType<S>) => Awaitable<AdvancedIndex>,
  options?: Omit<Options<S>, 'buildIndex'>,
): SearchAPI;
```
  - remove deprecated parameters in useSearch(), pass them in the client object instead.
- fumadocs-core/highlight: remove deprecated withPrerenderScript and loading options from useShiki().
- fumadocs-core/i18n: removed createI18nMiddleware, import from fumadocs-core/i18n/middleware instead.
- fumadocs-core/source:
  - removed deprecated transformers, pageTree.attach* options from loader().
  - removed deprecated page.file property.
  - removed FileInfo & parseFilePath utilities.

55afd8a: Migrate to New Orama Cloud

@orama/core is the new version of Orama Cloud client. See their docs for details.

When using Fumadocs' Orama Cloud integration, you need to use the new client instead:

import { sync } from 'fumadocs-core/search/orama-cloud';
import { OramaCloud } from '@&#8203;orama/core';

// update this
const orama = new OramaCloud({
  projectId: '<project id>',
  apiKey: '<private api key>',
});

await sync(orama, {
  index: '<data source id>',
  documents: records,
});

Minor Changes

cbc93e9: Disable single by default on fumadocs-core/toc API

Patch Changes

230c6bf: let getPageTreePeers handle i18n

`v15.8.4`

Compare Source

Patch Changes

ce2be59: Loader Plugin: support name & config options
31b9494: Support multiple() for multiple sources in same loader()

`v15.8.3`

Compare Source

Patch Changes

a3a14e7: Bump deps

`v15.8.2`

Compare Source

Patch Changes

ad9a004: Deprecate fumadocs-core/server export

It will be removed on Fumadocs 16, as some APIs under the /server export are actually available (and even used) under browser environment.

A more modularized design will be introduced over the original naming.
- getGithubLastEdit: Moved to fumadocs-core/content/github.
- getTableOfContents: Moved to fumadocs-core/content/toc.
- PageTree and page tree utilities: Moved to fumadocs-core/page-tree.
- TOCItemType, TableOfContents: Moved to fumadocs-core/toc.
- createMetadataImage: Deprecated, use the Next.js Metadata API instead.
90cf1fe: Support Negotiation API
747bdbc: Support lucide react icons plugin for loader()

`v15.8.1`

Compare Source

Patch Changes

71bce86: Make loader().getPages() to return pages from all languages when locale is not specified
f04547f: Publish plugins API on loader()

`v15.8.0`

Compare Source

Minor Changes

d1ae3e8: Move SortedResult and other search-related types to fumadocs-core/search

This also exposed the search result highlighter API, you may now use it for highlighting results of your own search integration

Old export will be kept until the next major release.
51268ec: Breadcrumbs API: default includePage to false.

Patch Changes

655bb46: [Internal] parseCodeBlockAttributes include null values, restrict rehype-code to only parse title and tab attributes.
6548a59: Support breadcrumbs for Search API
51268ec: Breadcrumbs API: Fix root folders being filtered when includeRoot is set to true.

`v15.7.13`

Compare Source

Patch Changes

982aed6: Fix source.getPageByHref() return no result without explicit language

`v15.7.12`

Compare Source

Patch Changes

846b28a: Support multiple codeblocks in same tab
2b30315: Support mode option in search server

`v15.7.11`

Compare Source

`v15.7.10`

Compare Source

Patch Changes

c948f59: Try to workaround legacy i18n middleware under /i18n export without breaking changes

`v15.7.9`

Compare Source

Patch Changes

d135efd: transformerIcon supports SVG string to extend codeblock icons
4082acc: Expose highlightHast API

`v15.7.8`

Compare Source

Patch Changes

f65778d: Link improve external link detection by enabling it on any protocols
e4c12a3: Add framework adapters to optional peer deps

`v15.7.7`

Compare Source

Patch Changes

0b53056: Support remarkMdxMermaid - convert mermaid codeblocks into <Mermaid /> component
3490285: Support remarkMdxFiles - convert files codeblocks into <Files /> component

`v15.7.6`

Compare Source

`v15.7.5`

Compare Source

Patch Changes

cedc494: Hotfix URL normalization logic

`v15.7.4`

Compare Source

`v15.7.3`

Compare Source

Patch Changes

6d97379: unify remark nodes parsing & improve types
e776ee5: Fix langAlias not being passed to Shiki rehype plugin

`v15.7.2`

Compare Source

Patch Changes

88b5a4e: Fix duplicate pages in page tree when referencing subpage in meta.json and using ... or adding the subfolder again
039b24b: Fix failed to update page tree from loader()
08eee2b: [remark-npm] Enable npm install prefix fallback only on old alias

`v15.7.1`

Compare Source

Patch Changes

195b090: Support a list of source for loader() API
e1c84a2: Support fallbackLanguage for loader() i18n API

`v15.7.0`

Compare Source

Minor Changes

514052e: Include locale code into page.path

Previously when i18n is enabled, page.path is not equal to the virtual file paths you passed into loader():

const source = loader({
  source: {
    files: [
      {
        path: 'folder/index.cn.mdx',
        // ...
      },
    ],
  },
});

console.log(source.getPages('cn'));
// path: folder/index.mdx

This can be confusing, the only solution to obtain the original path was page.absolutePath.

From now, the page.path will also include the locale code:

const source = loader({
  source: {
    files: [
      {
        path: 'folder/index.cn.mdx',
        // ...
      },
    ],
  },
});

console.log(source.getPages('cn'));
// path: folder/index.cn.mdx

While this change doesn't affect intended API usages, it may lead to minor bugs when advanced usage/hacks involved around page.path.

e785f98: Introduce page tree fallback API

Page tree is a tree structure.

Previously, when an item is excluded from page tree, it is isolated entirely that you cannot display it at all.

With the new fallback API, isolated pages will go into fallback page tree instead:
```
{
  "children": [
    {
      "type": "page",
      "name": "Introduction"
    }
  ],
  "fallback": {
    "children": [
      {
        "type": "page",
        "name": "Hidden Page"
      }
    ]
  }
}
```
Items in fallback are invisible unless you've opened its item.

0531bf4: Introduce page tree transformer API

You can now define page tree transformer.

export const source = loader({
  // ...
  pageTree: {
    transformers: [
      {
        root(root) {
          return root;
        },
        file(node, file) {
          return node;
        },
        folder(node, dir, metaPath) {
          return node;
        },
        separator(node) {
          return node;
        },
      },
    ],
  },
});

50eb07f: Support type-safe i18n config

// lib/source.ts
import { defineI18n } from 'fumadocs-core/i18n';

export const i18n = defineI18n({
  defaultLanguage: 'en',
  languages: ['en', 'cn'],
});

// root layout
import { defineI18nUI } from 'fumadocs-ui/i18n';
import { i18n } from '@&#8203;/lib/i18n';

const { provider } = defineI18nUI(i18n, {
  translations: {
    cn: {
      displayName: 'Chinese',
      search: 'Translated Content',
    },
    en: {
      displayName: 'English',
    },
  },
});

function RootLayout({ children }: { children: React.ReactNode }) {
  return <RootProvider i18n={provider(lang)}>{children}</RootProvider>;
}

Although optional, we highly recommend you to refactor the import to i18n middleware:

// here!
import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware';
import { i18n } from '@&#8203;/lib/i18n';

export default createI18nMiddleware(i18n);

Patch Changes

e254c65: Simplify Source API storage management
ec75601: Support ReactNode for icons in page tree
67df155: createFromSource support async buildIndex and Fumadocs MDX Async Mode
b109d06: Redesign useShiki & <DynamicCodeBlock /> to use React 19 hooks

Patch Changes

569bc26: Improve remark-image: (1) append public URL to output src if it is a URL. (2) ignore if failed to obtain SVG size.
817c237: Support search result highlighting.

Result nodes now have a contentWithHighlights property, you can render it with custom renderer, or a default one provided on Fumadocs UI.

`v15.6.9`

Compare Source

Patch Changes

0ab2cdd: remove waku & tanstack peer dependency temporarily (see #2144)

`v15.6.8`

Compare Source

`v15.6.7`

Compare Source

Patch Changes

6fa1442: Support to override <HideIfEmpty /> scripts nonce with <HideIfEmptyProvider />

`v15.6.6`

Compare Source

Patch Changes

1b0e9d5: Add mixedbread integration

`v15.6.5`

Compare Source

Patch Changes

658fa96: Support custom options for error handling for remark-image

`v15.6.4`

Compare Source

`v15.6.3`

Compare Source

`v15.6.2`

Compare Source

`v15.6.1`

Compare Source

Patch Changes

1a902ff: Fix static export map

`v15.6.0`

Compare Source

Minor Changes

f8d1709: Redesigned Codeblock Tabs

Instead of relying on Tabs component, it supports a dedicated tabs component for codeblocks:

<CodeBlockTabs>
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="value">Name</CodeBlockTabsTrigger>
  </CodeBlockTabsList>
  <CodeBlockTab value="value" asChild>
    <CodeBlock>...</CodeBlock>
  </CodeBlockTab>
</CodeBlockTabs>

The old usage is not deprecated, you can still use them while Fumadocs' remark plugins will generate codeblock tabs using the new way.

Patch Changes

d0f8a15: Enable remarkNpm by default, replace remarkInstall with it.
84918b8: Support passing tag to search client/server as string array

`v15.5.5`

Compare Source

Patch Changes

0d3f76b: Fix wrong indexing of file system

`v15.5.4`

Compare Source

Patch Changes

35c3c0b: Support handling duplicated slugs and conflicts such as dir/index.mdx vs dir.mdx

`v15.5.3`

Compare Source

Patch Changes

7d1ac21: hotfix paths not being normalized on Windows

`v15.5.2`

Compare Source

Patch Changes

7a45921: Add absolutePath and path properties to pages, mark file as deprecated
1b7bc4b: Add @types/react to optional peer dependency to avoid version conflict in monorepos

`v15.5.1`

Compare Source

Patch Changes

b4916d2: Move hide-if-empty component to Fumadocs Core
8738b9c: Always encode generated slugs for non-ASCII characters in loader()

a66886b: Deprecate other parameters for useDocsSearch()

The new usage passes options to a single object, improving the readability:

import { useDocsSearch } from 'fumadocs-core/search/client';

const { search, setSearch, query } = useDocsSearch({
  type: 'fetch',
  locale: 'optional',
  tag: 'optional',
  delayMs: 100,
  allowEmpty: false,
});

`v15.5.0`

Compare Source

`v15.4.2`

Compare Source

Patch Changes

0ab6c7f: Improve performance by using shallow compare on useOnChange by default

`v15.4.1`

Compare Source

`v15.4.0`

Compare Source

Minor Changes

961b67e: Bump algolia search to v5

This also introduced changes to some APIs since algoliasearch v4 and v5 has many differences.

Now we highly recommend to pass an index name to sync():

import { algoliasearch } from 'algoliasearch';
import { sync } from 'fumadocs-core/search/algolia';
const client = algoliasearch('id', 'key');

void sync(client, {
  indexName: 'document',
  documents: records,
});

For search client, pass them to searchOptions:

'use client';

import { liteClient } from 'algoliasearch/lite';
import type { SharedProps } from 'fumadocs-ui/components/dialog/search';
import SearchDialog from 'fumadocs-ui/components/dialog/search-algolia';

const client = liteClient(appId, apiKey);

export default function CustomSearchDialog(props: SharedProps) {
  return (
    <SearchDialog
      searchOptions={{
        client,
        indexName: 'document',
      }}
      {...props}
      showAlgolia
    />
  );
}

Patch Changes

1b999eb: Introduce <Markdown /> component
7d78bc5: Improve createRelativeLink and getPageByHref for i18n usage

`v15.3.4`

Compare Source

`v15.3.3`

Compare Source

Patch Changes

4ae7b4a: Support MDX in codeblock tab value

`v15.3.2`

Compare Source

Patch Changes

c25d678: Support Shiki focus notation transformer by default

`v15.3.1`

Compare Source

Patch Changes

3372792: Support line numbers in codeblock

`v15.3.0`

Compare Source

Patch Changes

c05dc03: Improve error message of remark image

`v15.2.15`

Compare Source

Patch Changes

50db874: Remove placeholder space for codeblocks
Updated dependencies [50db874]
Updated dependencies [79e75c3]
- fumadocs-core@15.2.15

`v15.2.14`

Compare Source

Patch Changes

Updated dependencies [6ea1718]
- fumadocs-core@15.2.14

`v15.2.13`

Compare Source

Patch Changes

b433d93: Recommend using custom button/link instead for edit on GitHub button
1e07ed8: Support disabling codeblock styles with .not-fumadocs-codeblock
- fumadocs-core@15.2.13

`v15.2.12`

Compare Source

Patch Changes

b68bb51: Fix sidebar legacy behaviours
127e681: Fix Notebook layout ignores themeSwitch and sidebar.collapsible on nav mode
Updated dependencies [acff667]
- fumadocs-core@15.2.12

`v15.2.11`

Compare Source

Patch Changes

d4d1ba7: Fix sidebar collapsible control search button still visible with search disabled
4e62b41: Bundle lucide-react as part of library
07cd690: Support separators without name
Updated dependencies [07cd690]
- fumadocs-core@15.2.11

`v15.2.10`

Compare Source

Patch Changes

3a5595a: Support deprecated properties in Type Table
8c9fc1f: Fix callout margin
- fumadocs-core@15.2.10

`v15.2.9`

Compare Source

Patch Changes

e72af4b: Improve layout
ea0f468: Fix relative file href with hash
7f3c30e: Add shadcn.css preset
- fumadocs-core@15.2.9

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

github-actions · 2025-09-20T12:54:55Z

GitLab Pipeline Action

General information

Link to pipeline: https://gitlab.com/code0-tech/development/telescopium/-/pipelines/2156500514

Status: Failed
Duration: 43 seconds

renovate · 2025-10-22T06:47:04Z

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

any of the package files in this branch needs updating, or
the branch becomes conflicted, or
you click the rebase/retry checkbox if found above, or
you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: package-lock.json

npm warn Unknown env config "store". This will stop working in the next major version of npm.
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: fumadocs-core@16.0.11
npm error Found: next@15.3.1
npm error node_modules/next
npm error   next@"15.3.1" from the root project
npm error   peerOptional next@"^15.3.0 || ^16.0.0" from fumadocs-mdx@13.0.8
npm error   node_modules/fumadocs-mdx
npm error     fumadocs-mdx@"13.0.8" from the root project
npm error
npm error Could not resolve dependency:
npm error peerOptional next@"16.x.x" from fumadocs-core@16.0.11
npm error node_modules/fumadocs-core
npm error   fumadocs-core@"16.0.11" from the root project
npm error   peer fumadocs-core@"^15.0.0 || ^16.0.0" from fumadocs-mdx@13.0.8
npm error   node_modules/fumadocs-mdx
npm error     fumadocs-mdx@"13.0.8" from the root project
npm error   1 more (fumadocs-ui)
npm error
npm error Conflicting peer dependency: next@16.0.2
npm error node_modules/next
npm error   peerOptional next@"16.x.x" from fumadocs-core@16.0.11
npm error   node_modules/fumadocs-core
npm error     fumadocs-core@"16.0.11" from the root project
npm error     peer fumadocs-core@"^15.0.0 || ^16.0.0" from fumadocs-mdx@13.0.8
npm error     node_modules/fumadocs-mdx
npm error       fumadocs-mdx@"13.0.8" from the root project
npm error     1 more (fumadocs-ui)
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /runner/cache/others/npm/_logs/2025-11-13T10_47_52_260Z-eresolve-report.txt
npm error A complete log of this run can be found in: /runner/cache/others/npm/_logs/2025-11-13T10_47_52_260Z-debug-0.log

renovate bot added the dependencies This updates dependency files label Sep 20, 2025

renovate bot assigned Taucher2003 Sep 20, 2025

renovate bot force-pushed the renovate/major-fumadocs branch 2 times, most recently from 50fab51 to 0db598d Compare September 25, 2025 14:52

renovate bot force-pushed the renovate/major-fumadocs branch 2 times, most recently from d3c15cb to 2ec0280 Compare October 6, 2025 18:11

renovate bot force-pushed the renovate/major-fumadocs branch 2 times, most recently from 65d18f0 to 0cb086b Compare October 22, 2025 06:46

renovate bot changed the title ~~Update dependency fumadocs-mdx to v12~~ Update fumadocs (major) Oct 22, 2025

renovate bot force-pushed the renovate/major-fumadocs branch 5 times, most recently from 7db996b to 2c40ca8 Compare October 28, 2025 17:10

renovate bot force-pushed the renovate/major-fumadocs branch 3 times, most recently from e354868 to 8ee5bc6 Compare November 3, 2025 11:59

renovate bot force-pushed the renovate/major-fumadocs branch 3 times, most recently from 4569690 to 94de78b Compare November 11, 2025 16:09

Update fumadocs

825822a

renovate bot force-pushed the renovate/major-fumadocs branch from 94de78b to 825822a Compare November 13, 2025 10:48

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Update fumadocs (major) #99

Update fumadocs (major) #99

renovate bot commented Sep 20, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Sep 20, 2025 •

edited

Loading

Uh oh!

renovate bot commented Oct 22, 2025 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Update fumadocs (major) #99

Are you sure you want to change the base?

Update fumadocs (major) #99

Conversation

renovate bot commented Sep 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Configuration

Uh oh!

github-actions bot commented Sep 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

GitLab Pipeline Action

General information

Uh oh!

renovate bot commented Oct 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ Artifact update problem

File name: package-lock.json

Uh oh!

Reviewers

Assignees

Labels

Projects

renovate bot commented Sep 20, 2025 •

edited

Loading

github-actions bot commented Sep 20, 2025 •

edited

Loading

renovate bot commented Oct 22, 2025 •

edited

Loading