fuma-nama/fumadocs fumadocs-ui@13.0.0 on GitHub

Major Changes

89190ae: Rename prefix option on Tailwind CSS Plugin to cssPrefix

why: The previous name was misleading

migrate: Rename the option.

import { createPreset } from 'fumadocs-ui/tailwind-plugin';

/** @type {import('tailwindcss').Config} */
export default {
  presets: [
    createPreset({
      cssPrefix: 'fd',
    }),
  ],
};

b02eebf: Move keepCodeBlockBackground option to code block component

why: Easier to customise code block styles.

migrate:

Enable keepBackground on <CodeBlock />, and remove deprecated usage.

import { Pre, CodeBlock } from 'fumadocs-ui/components/codeblock';

<MDX
  components={{
    pre: ({ ref: _ref, ...props }) => (
      <CodeBlock keepBackground {...props}>
        <Pre>{props.children}</Pre>
      </CodeBlock>
    ),
  }}
/>;

f868018: Replace secondary link items with icon link items
why: Link items with type secondary has been deprecated long time ago.
migrate: Replace type secondary with icon.

8aebeab: Change usage of I18nProvider

why: Make possible to load translations lazily

migrate:

import { RootProvider } from 'fumadocs-ui/provider';
import type { ReactNode } from 'react';
import { I18nProvider } from 'fumadocs-ui/i18n';

export default function Layout({
  params: { lang },
  children,
}: {
  params: { lang: string };
  children: ReactNode;
}) {
  return (
    <html lang={lang}>
      <body>
        <I18nProvider
          locale={lang}
          // options
          locales={[
            {
              name: 'English',
              locale: 'en',
            },
            {
              name: 'Chinese',
              locale: 'cn',
            },
          ]}
          // translations
          translations={
            {
              cn: {
                toc: '目錄',
                search: '搜尋文檔',
                lastUpdate: '最後更新於',
                searchNoResult: '沒有結果',
                previousPage: '上一頁',
                nextPage: '下一頁',
              },
            }[lang]
          }
        >
          <RootProvider>{children}</RootProvider>
        </I18nProvider>
      </body>
    </html>
  );
}

8aebeab: Require locale prop on I18nProvider
why: Fix problems related to pathname parsing
migrate: Pass locale parameter to the provider
0377bb4: Rename id prop on Tabs component to groupId
why: Conflicted with HTML id attribute.
migrate: Rename to groupId.
e8e6a17: Make Tailwind CSS Plugin ESM-only
why: Tailwind CSS supported ESM and TypeScript configs.
migrate: Use ESM syntax in your Tailwind CSS config.
c901e6b: Remove deprecated fumadocs-ui/components/api components
why: The new OpenAPI integration has its own UI implementation.
migrate: Update to latest OpenAPI integration.
89190ae: Add fd- prefix to all Fumadocs UI colors, animations and utilities
why: The added Tailwind CSS colors may conflict with the existing colors of codebases.
migrate: Enable addGlobalColors on Tailwind CSS Plugin or add the fd- prefix to class names.
```
import { createPreset } from 'fumadocs-ui/tailwind-plugin';

/** @type {import('tailwindcss').Config} */
export default {
  presets: [
    createPreset({
      addGlobalColors: true,
    }),
  ],
};
```

b02eebf: Change code block component usage

why: The previous usage was confusing, some props are passed directly to pre while some are not.

migrate:

Pass all props to CodeBlock component.
This also includes class names, change your custom styles if necessary.

import { Pre, CodeBlock } from 'fumadocs-ui/components/codeblock';

<MDX
  components={{
    // HTML `ref` attribute conflicts with `forwardRef`
    pre: ({ ref: _ref, ...props }) => (
      <CodeBlock {...props}>
        <Pre>{props.children}</Pre>
      </CodeBlock>
    ),
  }}
/>;

You can ignore this if you didn't customise the default pre element.

4373231: Remove RollButton component
why: RollButton was created because there were no "Table Of Contents" on mobile viewports. Now users can use the TOC Popover to switch between headings, RollButton is no longer a suitable design for Fumadocs UI.
migrate: Remove usages, you may copy the last implementation of RollButton.

Minor Changes

c684c00: Support to disable container style overriding
c8964d3: Include Callout as default MDX component

Patch Changes

daa7d3c: Fix empty folder animation problems
Updated dependencies [09c3103]
Updated dependencies [c714eaa]
Updated dependencies [b02eebf]
- fumadocs-core@13.0.0