Skip to content

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Aug 21, 2025

This PR contains the following updates:

Package Change Age Confidence
fumadocs-core (source) 15.6.12 -> 15.7.0 age confidence

Release Notes

fuma-nama/fumadocs (fumadocs-core)

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 '@​/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

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.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


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

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

@LuggaPugga LuggaPugga merged commit f53f6ff into main Aug 22, 2025
2 checks passed
@LuggaPugga LuggaPugga deleted the renovate/fumadocs-core-15.x branch August 22, 2025 09:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants