Skip to content

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Aug 22, 2025

This PR contains the following updates:

Package Type Update Change OpenSSF
fumadocs-core (source) dependencies minor 15.6.12 -> 15.7.0 OpenSSF Scorecard
fumadocs-mdx (source) dependencies minor 11.7.5 -> 11.8.0 OpenSSF Scorecard
fumadocs-ui (source) dependencies minor 15.6.12 -> 15.7.0 OpenSSF Scorecard

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 12:00 AM through 04:59 AM and 10:00 PM through 11:59 PM, Monday through Friday ( * 0-4,22-23 * * 1-5 ), Only on Sunday and Saturday ( * * * * 0,6 ) (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Enabled.

Rebasing: Whenever PR is behind base branch, 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.

Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
@renovate renovate bot added the dependencies Dependency updates label Aug 22, 2025
@renovate renovate bot enabled auto-merge (squash) August 22, 2025 00:30
@github-actions github-actions bot added qa:running QA workflow is currently running status:approved Pull request has been approved qa:success QA workflow passed successfully status:ready-for-review Pull request is ready for review status:mergeable Pull request is approved, tests pass, and ready to merge and removed qa:running QA workflow is currently running status:ready-for-review Pull request is ready for review status:approved Pull request has been approved labels Aug 22, 2025
@renovate renovate bot merged commit 8b7cc8b into main Aug 22, 2025
13 checks passed
@renovate renovate bot deleted the renovate/fumadocs-packages branch August 22, 2025 00:33
@github-actions github-actions bot added status:merged Pull request has been merged and removed status:mergeable Pull request is approved, tests pass, and ready to merge labels Aug 22, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Dependency updates qa:success QA workflow passed successfully status:merged Pull request has been merged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant