Update fumadocs

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence	Diffend
fumadocs-core (source)	15.2.8 -> 15.8.5					Diff
fumadocs-mdx (source)	11.6.0 -> 11.10.1					Diff
fumadocs-ui (source)	15.2.8 -> 15.8.5					Diff

---

Release Notes

fuma-nama/fumadocs (fumadocs-core)

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

v15.6.12

Compare Source

v15.6.11

Compare Source

v15.6.10

Compare Source

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]

GitLab Pipeline Action

General information

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

Status: Failed
Duration: 47 seconds