@windrun-huaiin/third-ui 31.0.1 → 31.1.0

package/dist/fuma/base/custom-header.d.ts

@@ -1,11 +1,12 @@
 import { type CSSProperties } from 'react';
 import { HomeLayoutProps } from 'fumadocs-ui/layouts/home';
+import type { SiteThemeSwitchConfig } from './site-layout-shared';
 export type NavbarCSSVars = CSSProperties & {
     '--fd-banner-height'?: string;
     '--fd-header-height'?: string;
     '--fd-nav-max-width'?: string;
 };
-export interface CustomHomeHeaderProps extends HomeLayoutProps {
+export interface CustomHomeHeaderProps extends Omit<HomeLayoutProps, 'themeSwitch'> {
     /**
      * Banner height in rem units
      *
@@ -46,6 +47,7 @@ export interface CustomHomeHeaderProps extends HomeLayoutProps {
      * Control order of utilities inside the mobile dropdown.
      */
     mobileMenuActionsOrder?: MobileMenuAction[];
+    themeSwitch?: SiteThemeSwitchConfig;
 }
 export type DesktopAction = 'search' | 'theme' | 'i18n' | 'secondary' | 'github';
 export type MobileBarAction = 'pinned' | 'search' | 'menu';

package/dist/fuma/base/custom-header.js

@@ -35,7 +35,7 @@ const DEFAULT_MOBILE_MENU_ACTIONS = [
     'theme',
 ];
 function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitch = {}, searchToggle = {}, bannerHeight = 0, headerHeight = 2.5, maxContentWidth = 1400, navbarClassName, floating = false, desktopActionsOrder = DEFAULT_DESKTOP_ACTIONS, mobileBarActionsOrder = DEFAULT_MOBILE_BAR_ACTIONS, mobileMenuActionsOrder = DEFAULT_MOBILE_MENU_ACTIONS, }) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e;
     const finalLinks = React.useMemo(() => shared.resolveLinkItems({ links, githubUrl }), [links, githubUrl]);
     const navItems = finalLinks.filter((item) => { var _a; return ['nav', 'all'].includes((_a = item.on) !== null && _a !== void 0 ? _a : 'all'); });
     const menuItems = finalLinks.filter((item) => { var _a; return ['menu', 'all'].includes((_a = item.on) !== null && _a !== void 0 ? _a : 'all'); });
@@ -55,8 +55,8 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
         search: searchToggle.enabled !== false
             ? (_b = (_a = searchToggle.components) === null || _a === void 0 ? void 0 : _a.lg) !== null && _b !== void 0 ? _b : null
             : null,
-        theme: themeSwitch.enabled !== false
-            ? (_c = themeSwitch.component) !== null && _c !== void 0 ? _c : jsxRuntime.jsx(headerThemeSwitch.HeaderThemeSwitch, { mode: themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode })
+        theme: shouldShowThemeSwitch(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode)
+            ? (jsxRuntime.jsx(headerThemeSwitch.HeaderThemeSwitch, { mode: normalizeThemeSwitchMode(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode) }))
             : null,
         i18n: i18n ? (jsxRuntime.jsx(CompactLanguageToggle, { children: jsxRuntime.jsx(icons.LanguagesIcon, { className: "size-5" }) })) : null,
         secondary: desktopSecondaryDisplayItems.length ? (jsxRuntime.jsx("ul", { className: "flex flex-row gap-2 items-center empty:hidden", children: desktopSecondaryDisplayItems.map((item, i) => (jsxRuntime.jsx(NavbarLinkItem, { item: item, className: utils.cn(item.type === 'icon' && [
@@ -78,8 +78,8 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
         github: githubMobileMenuItem ? (jsxRuntime.jsx(MenuLinkItem, { item: githubMobileMenuItem, className: "-me-1.5" })) : null,
         separator: jsxRuntime.jsx("div", { role: "separator", className: "flex-1" }),
         i18n: i18n ? (jsxRuntime.jsxs(CompactLanguageToggle, { children: [jsxRuntime.jsx(icons.LanguagesIcon, { className: "size-5" }), jsxRuntime.jsx(languageSelect.LanguageSelectText, {}), jsxRuntime.jsx(icons.ChevronDownIcon, { className: "size-3 text-fd-muted-foreground" })] })) : null,
-        theme: themeSwitch.enabled !== false
-            ? (_d = themeSwitch.component) !== null && _d !== void 0 ? _d : jsxRuntime.jsx(headerThemeSwitch.HeaderThemeSwitch, { mode: themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode })
+        theme: shouldShowThemeSwitch(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode)
+            ? (jsxRuntime.jsx(headerThemeSwitch.HeaderThemeSwitch, { mode: normalizeThemeSwitchMode(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode) }))
             : null,
     };
     const shouldRenderMobileUtilities = mobileMenuActionsOrder.some((action) => action !== 'separator' && Boolean(mobileMenuActionNodes[action]));
@@ -100,7 +100,7 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
                         }) })) : null] })] }));
     const mobilePinnedNode = mobilePinnedItems.length > 0 ? (jsxRuntime.jsx(jsxRuntime.Fragment, { children: mobilePinnedItems.map((item, i) => (jsxRuntime.jsx(NavbarLinkItem, { item: item, className: "max-sm:-mr-1" }, `mobile-pinned-${i}`))) })) : null;
     const mobileSearchNode = searchToggle.enabled !== false
-        ? (_f = (_e = searchToggle.components) === null || _e === void 0 ? void 0 : _e.sm) !== null && _f !== void 0 ? _f : null
+        ? (_d = (_c = searchToggle.components) === null || _c === void 0 ? void 0 : _c.sm) !== null && _d !== void 0 ? _d : null
         : null;
     const mobileBarNodes = {
         pinned: mobilePinnedNode,
@@ -108,7 +108,7 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
         menu: menuNode,
     };
     const getMobileBarNode = (action) => { var _a; return (_a = mobileBarNodes[action]) !== null && _a !== void 0 ? _a : null; };
-    return (jsxRuntime.jsxs(CustomNavbar, { bannerHeight: bannerHeight, headerHeight: headerHeight, maxContentWidth: maxContentWidth, className: navbarClassName, floating: floating, children: [jsxRuntime.jsx(Link, { href: (_g = nav.url) !== null && _g !== void 0 ? _g : '/', prefetch: false, className: "inline-flex items-center gap-2.5 font-semibold", children: renderNavTitle(nav.title) }), nav.children, jsxRuntime.jsx("ul", { className: "flex flex-row items-center gap-2 px-6 max-sm:hidden", children: navItems
+    return (jsxRuntime.jsxs(CustomNavbar, { bannerHeight: bannerHeight, headerHeight: headerHeight, maxContentWidth: maxContentWidth, className: navbarClassName, floating: floating, children: [jsxRuntime.jsx(Link, { href: (_e = nav.url) !== null && _e !== void 0 ? _e : '/', prefetch: false, className: "inline-flex items-center gap-2.5 font-semibold", children: renderNavTitle(nav.title) }), nav.children, jsxRuntime.jsx("ul", { className: "flex flex-row items-center gap-2 px-6 max-sm:hidden", children: navItems
                     .filter((item) => !isSecondary(item))
                     .map((item, i) => (jsxRuntime.jsx(NavbarLinkItem, { item: item, className: "text-sm" }, i))) }), jsxRuntime.jsx("div", { className: "flex flex-row items-center justify-end gap-1.5 flex-1 max-lg:hidden", children: desktopActionsOrder.map((action) => {
                     const node = desktopActionNodes[action];
@@ -120,6 +120,12 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
                     return node ? (jsxRuntime.jsx(React.Fragment, { children: node }, `mobile-bar-${action}`)) : null;
                 }) })] }));
 }
+function shouldShowThemeSwitch(mode) {
+    return mode === 'light-dark' || mode === 'light-dark-system' || mode == null;
+}
+function normalizeThemeSwitchMode(mode) {
+    return mode === 'light-dark' ? 'light-dark' : 'light-dark-system';
+}
 function CustomNavbar(_a) {
     var { bannerHeight = 0, headerHeight = 2.5, maxContentWidth = 1400, className, style, floating = false } = _a, props = tslib.__rest(_a, ["bannerHeight", "headerHeight", "maxContentWidth", "className", "style", "floating"]);
     const [value, setValue] = React.useState('');

package/dist/fuma/base/custom-header.mjs

@@ -33,7 +33,7 @@ const DEFAULT_MOBILE_MENU_ACTIONS = [
     'theme',
 ];
 function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitch = {}, searchToggle = {}, bannerHeight = 0, headerHeight = 2.5, maxContentWidth = 1400, navbarClassName, floating = false, desktopActionsOrder = DEFAULT_DESKTOP_ACTIONS, mobileBarActionsOrder = DEFAULT_MOBILE_BAR_ACTIONS, mobileMenuActionsOrder = DEFAULT_MOBILE_MENU_ACTIONS, }) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e;
     const finalLinks = useMemo(() => resolveLinkItems({ links, githubUrl }), [links, githubUrl]);
     const navItems = finalLinks.filter((item) => { var _a; return ['nav', 'all'].includes((_a = item.on) !== null && _a !== void 0 ? _a : 'all'); });
     const menuItems = finalLinks.filter((item) => { var _a; return ['menu', 'all'].includes((_a = item.on) !== null && _a !== void 0 ? _a : 'all'); });
@@ -53,8 +53,8 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
         search: searchToggle.enabled !== false
             ? (_b = (_a = searchToggle.components) === null || _a === void 0 ? void 0 : _a.lg) !== null && _b !== void 0 ? _b : null
             : null,
-        theme: themeSwitch.enabled !== false
-            ? (_c = themeSwitch.component) !== null && _c !== void 0 ? _c : jsx(HeaderThemeSwitch, { mode: themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode })
+        theme: shouldShowThemeSwitch(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode)
+            ? (jsx(HeaderThemeSwitch, { mode: normalizeThemeSwitchMode(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode) }))
             : null,
         i18n: i18n ? (jsx(CompactLanguageToggle, { children: jsx(LanguagesIcon, { className: "size-5" }) })) : null,
         secondary: desktopSecondaryDisplayItems.length ? (jsx("ul", { className: "flex flex-row gap-2 items-center empty:hidden", children: desktopSecondaryDisplayItems.map((item, i) => (jsx(NavbarLinkItem, { item: item, className: cn(item.type === 'icon' && [
@@ -76,8 +76,8 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
         github: githubMobileMenuItem ? (jsx(MenuLinkItem, { item: githubMobileMenuItem, className: "-me-1.5" })) : null,
         separator: jsx("div", { role: "separator", className: "flex-1" }),
         i18n: i18n ? (jsxs(CompactLanguageToggle, { children: [jsx(LanguagesIcon, { className: "size-5" }), jsx(LanguageSelectText, {}), jsx(ChevronDownIcon, { className: "size-3 text-fd-muted-foreground" })] })) : null,
-        theme: themeSwitch.enabled !== false
-            ? (_d = themeSwitch.component) !== null && _d !== void 0 ? _d : jsx(HeaderThemeSwitch, { mode: themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode })
+        theme: shouldShowThemeSwitch(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode)
+            ? (jsx(HeaderThemeSwitch, { mode: normalizeThemeSwitchMode(themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode) }))
             : null,
     };
     const shouldRenderMobileUtilities = mobileMenuActionsOrder.some((action) => action !== 'separator' && Boolean(mobileMenuActionNodes[action]));
@@ -98,7 +98,7 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
                         }) })) : null] })] }));
     const mobilePinnedNode = mobilePinnedItems.length > 0 ? (jsx(Fragment, { children: mobilePinnedItems.map((item, i) => (jsx(NavbarLinkItem, { item: item, className: "max-sm:-mr-1" }, `mobile-pinned-${i}`))) })) : null;
     const mobileSearchNode = searchToggle.enabled !== false
-        ? (_f = (_e = searchToggle.components) === null || _e === void 0 ? void 0 : _e.sm) !== null && _f !== void 0 ? _f : null
+        ? (_d = (_c = searchToggle.components) === null || _c === void 0 ? void 0 : _c.sm) !== null && _d !== void 0 ? _d : null
         : null;
     const mobileBarNodes = {
         pinned: mobilePinnedNode,
@@ -106,7 +106,7 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
         menu: menuNode,
     };
     const getMobileBarNode = (action) => { var _a; return (_a = mobileBarNodes[action]) !== null && _a !== void 0 ? _a : null; };
-    return (jsxs(CustomNavbar, { bannerHeight: bannerHeight, headerHeight: headerHeight, maxContentWidth: maxContentWidth, className: navbarClassName, floating: floating, children: [jsx(Link, { href: (_g = nav.url) !== null && _g !== void 0 ? _g : '/', prefetch: false, className: "inline-flex items-center gap-2.5 font-semibold", children: renderNavTitle(nav.title) }), nav.children, jsx("ul", { className: "flex flex-row items-center gap-2 px-6 max-sm:hidden", children: navItems
+    return (jsxs(CustomNavbar, { bannerHeight: bannerHeight, headerHeight: headerHeight, maxContentWidth: maxContentWidth, className: navbarClassName, floating: floating, children: [jsx(Link, { href: (_e = nav.url) !== null && _e !== void 0 ? _e : '/', prefetch: false, className: "inline-flex items-center gap-2.5 font-semibold", children: renderNavTitle(nav.title) }), nav.children, jsx("ul", { className: "flex flex-row items-center gap-2 px-6 max-sm:hidden", children: navItems
                     .filter((item) => !isSecondary(item))
                     .map((item, i) => (jsx(NavbarLinkItem, { item: item, className: "text-sm" }, i))) }), jsx("div", { className: "flex flex-row items-center justify-end gap-1.5 flex-1 max-lg:hidden", children: desktopActionsOrder.map((action) => {
                     const node = desktopActionNodes[action];
@@ -118,6 +118,12 @@ function CustomHomeHeader({ nav = {}, i18n = false, links, githubUrl, themeSwitc
                     return node ? (jsx(Fragment$1, { children: node }, `mobile-bar-${action}`)) : null;
                 }) })] }));
 }
+function shouldShowThemeSwitch(mode) {
+    return mode === 'light-dark' || mode === 'light-dark-system' || mode == null;
+}
+function normalizeThemeSwitchMode(mode) {
+    return mode === 'light-dark' ? 'light-dark' : 'light-dark-system';
+}
 function CustomNavbar(_a) {
     var { bannerHeight = 0, headerHeight = 2.5, maxContentWidth = 1400, className, style, floating = false } = _a, props = __rest(_a, ["bannerHeight", "headerHeight", "maxContentWidth", "className", "style", "floating"]);
     const [value, setValue] = useState('');

package/dist/fuma/base/custom-home-layout.d.ts

@@ -1,6 +1,7 @@
 import type { CSSProperties, ReactNode } from 'react';
 import { type HomeLayoutProps } from 'fumadocs-ui/layouts/home';
 import { type DesktopAction, type MobileBarAction, type MobileMenuAction } from './custom-header';
+import type { SiteThemeSwitchConfig } from './site-layout-shared';
 export interface CustomHomeLayoutProps {
     locale: string;
     options: HomeLayoutProps;
@@ -76,6 +77,10 @@ export interface CustomHomeLayoutProps {
      * The default locale for the application (default: 'en')
      */
     defaultLocale?: string;
+    /**
+     * Theme mode for this layout group.
+     */
+    themeSwitch?: SiteThemeSwitchConfig;
     children?: ReactNode;
 }
 export interface HeaderActionOrders {
@@ -83,7 +88,7 @@ export interface HeaderActionOrders {
     mobileBar?: MobileBarAction[];
     mobileMenu?: MobileMenuAction[];
 }
-export declare function CustomHomeLayout({ locale, options, children, showBanner, bannerHeight, headerHeight, headerPaddingTop, navbarClassName, banner, footer, goToTop, showFooter, showGoToTop, style, floatingNav, actionOrders, localePrefixAsNeeded, defaultLocale, }: CustomHomeLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function CustomHomeLayout({ locale, options, children, showBanner, bannerHeight, headerHeight, headerPaddingTop, navbarClassName, banner, footer, goToTop, showFooter, showGoToTop, style, floatingNav, actionOrders, localePrefixAsNeeded, defaultLocale, themeSwitch, }: CustomHomeLayoutProps): import("react/jsx-runtime").JSX.Element;
 export declare function HomeTitle({ children, className, }: {
     children: ReactNode;
     className?: string;

package/dist/fuma/base/custom-home-layout.js

@@ -6,9 +6,11 @@ var home = require('fumadocs-ui/layouts/home');
 var fumaBannerSuit = require('../fuma-banner-suit.js');
 var footer = require('../../main/footer.js');
 var goToTop = require('../../main/go-to-top.js');
+var siteThemeProvider = require('./site-theme-provider.js');
 var customHeader = require('./custom-header.js');
 
-function CustomHomeLayout({ locale, options, children, showBanner = false, bannerHeight, headerHeight = 2.5, headerPaddingTop, navbarClassName, banner, footer: footer$1, goToTop: goToTop$1, showFooter = true, showGoToTop = true, style, floatingNav = false, actionOrders, localePrefixAsNeeded = true, defaultLocale = 'en', }) {
+function CustomHomeLayout({ locale, options, children, showBanner = false, bannerHeight, headerHeight = 2.5, headerPaddingTop, navbarClassName, banner, footer: footer$1, goToTop: goToTop$1, showFooter = true, showGoToTop = true, style, floatingNav = false, actionOrders, localePrefixAsNeeded = true, defaultLocale = 'en', themeSwitch, }) {
+    var _a;
     const resolvedBannerHeight = bannerHeight !== null && bannerHeight !== void 0 ? bannerHeight : (showBanner ? 3 : 0.5);
     const resolvedPaddingTop = headerPaddingTop !== null && headerPaddingTop !== void 0 ? headerPaddingTop : (showBanner ? 0 : 0.5);
     const layoutStyle = Object.assign({ '--fd-banner-height': `${resolvedBannerHeight}rem`, '--fd-header-height': `${headerHeight}rem`, paddingTop: floatingNav
@@ -16,8 +18,9 @@ function CustomHomeLayout({ locale, options, children, showBanner = false, banne
             : `${resolvedPaddingTop}rem` }, style);
     const { nav } = options, homeLayoutProps = tslib.__rest(options, ["nav"]);
     const navOptions = nav !== null && nav !== void 0 ? nav : {};
-    const header = (jsxRuntime.jsx(customHeader.CustomHomeHeader, Object.assign({}, homeLayoutProps, { nav: navOptions, bannerHeight: resolvedBannerHeight, headerHeight: headerHeight, navbarClassName: navbarClassName, floating: floatingNav, desktopActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.desktop, mobileBarActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileBar, mobileMenuActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileMenu })));
-    return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [banner !== null && banner !== void 0 ? banner : (jsxRuntime.jsx(fumaBannerSuit.FumaBannerSuit, { locale: locale, showBanner: showBanner, floating: floatingNav })), jsxRuntime.jsxs(home.HomeLayout, Object.assign({}, homeLayoutProps, { nav: Object.assign(Object.assign({}, navOptions), { component: header }), className: 'bg-neutral-100 dark:bg-neutral-900', style: layoutStyle, children: [children, showFooter ? footer$1 !== null && footer$1 !== void 0 ? footer$1 : jsxRuntime.jsx(footer.Footer, { locale: locale, localePrefixAsNeeded: localePrefixAsNeeded, defaultLocale: defaultLocale }) : null, showGoToTop ? goToTop$1 !== null && goToTop$1 !== void 0 ? goToTop$1 : jsxRuntime.jsx(goToTop.GoToTop, {}) : null] }))] }));
+    const header = (jsxRuntime.jsx(customHeader.CustomHomeHeader, Object.assign({}, homeLayoutProps, { nav: navOptions, themeSwitch: themeSwitch, bannerHeight: resolvedBannerHeight, headerHeight: headerHeight, navbarClassName: navbarClassName, floating: floatingNav, desktopActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.desktop, mobileBarActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileBar, mobileMenuActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileMenu })));
+    const themeMode = (_a = themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode) !== null && _a !== void 0 ? _a : 'light-dark-system';
+    return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [banner !== null && banner !== void 0 ? banner : (jsxRuntime.jsx(fumaBannerSuit.FumaBannerSuit, { locale: locale, showBanner: showBanner, floating: floatingNav })), jsxRuntime.jsx(siteThemeProvider.SiteThemeProvider, { mode: themeMode, children: jsxRuntime.jsxs(home.HomeLayout, Object.assign({}, homeLayoutProps, { nav: Object.assign(Object.assign({}, navOptions), { component: header }), className: 'bg-neutral-100 dark:bg-neutral-900', style: layoutStyle, children: [children, showFooter ? footer$1 !== null && footer$1 !== void 0 ? footer$1 : jsxRuntime.jsx(footer.Footer, { locale: locale, localePrefixAsNeeded: localePrefixAsNeeded, defaultLocale: defaultLocale }) : null, showGoToTop ? goToTop$1 !== null && goToTop$1 !== void 0 ? goToTop$1 : jsxRuntime.jsx(goToTop.GoToTop, {}) : null] })) })] }));
 }
 function HomeTitle({ children, className, }) {
     return (jsxRuntime.jsx("span", { className: `font-medium in-[.uwu]:hidden in-[header]:text-[clamp(12px,3vw,15px)]! ${className !== null && className !== void 0 ? className : ''}`, children: children }));

package/dist/fuma/base/custom-home-layout.mjs

@@ -4,9 +4,11 @@ import { HomeLayout } from 'fumadocs-ui/layouts/home';
 import { FumaBannerSuit } from '../fuma-banner-suit.mjs';
 import { Footer } from '../../main/footer.mjs';
 import { GoToTop } from '../../main/go-to-top.mjs';
+import { SiteThemeProvider } from './site-theme-provider.mjs';
 import { CustomHomeHeader } from './custom-header.mjs';
 
-function CustomHomeLayout({ locale, options, children, showBanner = false, bannerHeight, headerHeight = 2.5, headerPaddingTop, navbarClassName, banner, footer, goToTop, showFooter = true, showGoToTop = true, style, floatingNav = false, actionOrders, localePrefixAsNeeded = true, defaultLocale = 'en', }) {
+function CustomHomeLayout({ locale, options, children, showBanner = false, bannerHeight, headerHeight = 2.5, headerPaddingTop, navbarClassName, banner, footer, goToTop, showFooter = true, showGoToTop = true, style, floatingNav = false, actionOrders, localePrefixAsNeeded = true, defaultLocale = 'en', themeSwitch, }) {
+    var _a;
     const resolvedBannerHeight = bannerHeight !== null && bannerHeight !== void 0 ? bannerHeight : (showBanner ? 3 : 0.5);
     const resolvedPaddingTop = headerPaddingTop !== null && headerPaddingTop !== void 0 ? headerPaddingTop : (showBanner ? 0 : 0.5);
     const layoutStyle = Object.assign({ '--fd-banner-height': `${resolvedBannerHeight}rem`, '--fd-header-height': `${headerHeight}rem`, paddingTop: floatingNav
@@ -14,8 +16,9 @@ function CustomHomeLayout({ locale, options, children, showBanner = false, banne
             : `${resolvedPaddingTop}rem` }, style);
     const { nav } = options, homeLayoutProps = __rest(options, ["nav"]);
     const navOptions = nav !== null && nav !== void 0 ? nav : {};
-    const header = (jsx(CustomHomeHeader, Object.assign({}, homeLayoutProps, { nav: navOptions, bannerHeight: resolvedBannerHeight, headerHeight: headerHeight, navbarClassName: navbarClassName, floating: floatingNav, desktopActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.desktop, mobileBarActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileBar, mobileMenuActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileMenu })));
-    return (jsxs(Fragment, { children: [banner !== null && banner !== void 0 ? banner : (jsx(FumaBannerSuit, { locale: locale, showBanner: showBanner, floating: floatingNav })), jsxs(HomeLayout, Object.assign({}, homeLayoutProps, { nav: Object.assign(Object.assign({}, navOptions), { component: header }), className: 'bg-neutral-100 dark:bg-neutral-900', style: layoutStyle, children: [children, showFooter ? footer !== null && footer !== void 0 ? footer : jsx(Footer, { locale: locale, localePrefixAsNeeded: localePrefixAsNeeded, defaultLocale: defaultLocale }) : null, showGoToTop ? goToTop !== null && goToTop !== void 0 ? goToTop : jsx(GoToTop, {}) : null] }))] }));
+    const header = (jsx(CustomHomeHeader, Object.assign({}, homeLayoutProps, { nav: navOptions, themeSwitch: themeSwitch, bannerHeight: resolvedBannerHeight, headerHeight: headerHeight, navbarClassName: navbarClassName, floating: floatingNav, desktopActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.desktop, mobileBarActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileBar, mobileMenuActionsOrder: actionOrders === null || actionOrders === void 0 ? void 0 : actionOrders.mobileMenu })));
+    const themeMode = (_a = themeSwitch === null || themeSwitch === void 0 ? void 0 : themeSwitch.mode) !== null && _a !== void 0 ? _a : 'light-dark-system';
+    return (jsxs(Fragment, { children: [banner !== null && banner !== void 0 ? banner : (jsx(FumaBannerSuit, { locale: locale, showBanner: showBanner, floating: floatingNav })), jsx(SiteThemeProvider, { mode: themeMode, children: jsxs(HomeLayout, Object.assign({}, homeLayoutProps, { nav: Object.assign(Object.assign({}, navOptions), { component: header }), className: 'bg-neutral-100 dark:bg-neutral-900', style: layoutStyle, children: [children, showFooter ? footer !== null && footer !== void 0 ? footer : jsx(Footer, { locale: locale, localePrefixAsNeeded: localePrefixAsNeeded, defaultLocale: defaultLocale }) : null, showGoToTop ? goToTop !== null && goToTop !== void 0 ? goToTop : jsx(GoToTop, {}) : null] })) })] }));
 }
 function HomeTitle({ children, className, }) {
     return (jsx("span", { className: `font-medium in-[.uwu]:hidden in-[header]:text-[clamp(12px,3vw,15px)]! ${className !== null && className !== void 0 ? className : ''}`, children: children }));

package/dist/fuma/base/docs-root-provider.d.ts

@@ -1,19 +1,14 @@
 import type { ComponentProps, ReactNode } from 'react';
 import { NextProvider } from 'fumadocs-core/framework/next';
 import { type I18nProviderProps } from 'fumadocs-ui/contexts/i18n';
-import { type ThemeProviderProps } from 'next-themes';
 type NextProviderComponents = {
     Link?: ComponentProps<typeof NextProvider>['Link'];
     Image?: ComponentProps<typeof NextProvider>['Image'];
 };
-type ThemeOptions = ThemeProviderProps & {
-    enabled?: boolean;
-};
 export interface DocsRootProviderProps {
     i18n: Omit<I18nProviderProps, 'children'>;
-    theme?: ThemeOptions;
     components?: NextProviderComponents;
     children: ReactNode;
 }
-export declare function DocsRootProvider({ i18n, theme, components, children, }: DocsRootProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function DocsRootProvider({ i18n, components, children, }: DocsRootProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/fuma/base/docs-root-provider.js

@@ -3,15 +3,9 @@
 var jsxRuntime = require('react/jsx-runtime');
 var next = require('fumadocs-core/framework/next');
 var i18n = require('fumadocs-ui/contexts/i18n');
-var nextThemes = require('next-themes');
 
-function DocsRootProvider({ i18n: i18n$1, theme = {}, components, children, }) {
-    let body = children;
-    if (theme.enabled !== false) {
-        body = (jsxRuntime.jsx(nextThemes.ThemeProvider, Object.assign({ attribute: "class", defaultTheme: "system", enableSystem: true, disableTransitionOnChange: true }, theme, { children: body })));
-    }
-    body = (jsxRuntime.jsx(i18n.I18nProvider, Object.assign({}, i18n$1, { children: body })));
-    return (jsxRuntime.jsx(next.NextProvider, { Link: components === null || components === void 0 ? void 0 : components.Link, Image: components === null || components === void 0 ? void 0 : components.Image, children: body }));
+function DocsRootProvider({ i18n: i18n$1, components, children, }) {
+    return (jsxRuntime.jsx(next.NextProvider, { Link: components === null || components === void 0 ? void 0 : components.Link, Image: components === null || components === void 0 ? void 0 : components.Image, children: jsxRuntime.jsx(i18n.I18nProvider, Object.assign({}, i18n$1, { children: children })) }));
 }
 
 exports.DocsRootProvider = DocsRootProvider;

package/dist/fuma/base/docs-root-provider.mjs

@@ -1,15 +1,9 @@
 import { jsx } from 'react/jsx-runtime';
 import { NextProvider } from 'fumadocs-core/framework/next';
 import { I18nProvider } from 'fumadocs-ui/contexts/i18n';
-import { ThemeProvider } from 'next-themes';
 
-function DocsRootProvider({ i18n, theme = {}, components, children, }) {
-    let body = children;
-    if (theme.enabled !== false) {
-        body = (jsx(ThemeProvider, Object.assign({ attribute: "class", defaultTheme: "system", enableSystem: true, disableTransitionOnChange: true }, theme, { children: body })));
-    }
-    body = (jsx(I18nProvider, Object.assign({}, i18n, { children: body })));
-    return (jsx(NextProvider, { Link: components === null || components === void 0 ? void 0 : components.Link, Image: components === null || components === void 0 ? void 0 : components.Image, children: body }));
+function DocsRootProvider({ i18n, components, children, }) {
+    return (jsx(NextProvider, { Link: components === null || components === void 0 ? void 0 : components.Link, Image: components === null || components === void 0 ? void 0 : components.Image, children: jsx(I18nProvider, Object.assign({}, i18n, { children: children })) }));
 }
 
 export { DocsRootProvider };

package/dist/fuma/base/header-theme-switch.d.ts

@@ -1,5 +1,6 @@
 import { type ComponentProps } from 'react';
+import type { SiteThemeSwitchMode } from './site-layout-shared';
 export interface HeaderThemeSwitchProps extends ComponentProps<'div'> {
-    mode?: 'light-dark' | 'light-dark-system';
+    mode?: Exclude<SiteThemeSwitchMode, 'light-only' | 'dark-only'>;
 }
 export declare function HeaderThemeSwitch({ className, mode, ...props }: HeaderThemeSwitchProps): import("react/jsx-runtime").JSX.Element;

package/dist/fuma/base/site-docs-layout.d.ts

@@ -4,6 +4,7 @@ import { type SiteBaseLayoutConfig } from './site-layout-shared';
 export interface SiteDocsLayoutConfig extends SiteBaseLayoutConfig {
     tree: DocsLayoutProps['tree'];
     sidebar?: DocsLayoutProps['sidebar'];
+    themeProvider?: boolean;
 }
 export declare function SiteDocsLayout({ config, children, }: {
     config: SiteDocsLayoutConfig;

package/dist/fuma/base/site-docs-layout.js

@@ -3,13 +3,33 @@
 var jsxRuntime = require('react/jsx-runtime');
 var docs = require('fumadocs-ui/layouts/docs');
 var siteLayoutShared = require('./site-layout-shared.js');
+var siteThemeProvider = require('./site-theme-provider.js');
 
 function toDocsLayoutOptions(config) {
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: siteLayoutShared.normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {})), (config.themeSwitch ? { themeSwitch: config.themeSwitch } : {})), (config.sidebar ? { sidebar: config.sidebar } : {})), { tree: config.tree });
+    var _a, _b;
+    const themeMode = (_b = (_a = config.themeSwitch) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : 'light-dark-system';
+    const shouldShowThemeSwitch = config.themeProvider !== false &&
+        (themeMode === 'light-dark' || themeMode === 'light-dark-system');
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: siteLayoutShared.normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {})), (shouldShowThemeSwitch
+        ? {
+            themeSwitch: {
+                mode: themeMode,
+            },
+        }
+        : {
+            themeSwitch: {
+                enabled: false,
+            },
+        })), (config.sidebar ? { sidebar: config.sidebar } : {})), { tree: config.tree });
 }
 function SiteDocsLayout({ config, children, }) {
+    var _a, _b;
     const options = toDocsLayoutOptions(config);
-    return jsxRuntime.jsx(docs.DocsLayout, Object.assign({}, options, { children: children }));
+    const themeMode = (_b = (_a = config.themeSwitch) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : 'light-dark-system';
+    const body = jsxRuntime.jsx(docs.DocsLayout, Object.assign({}, options, { children: children }));
+    if (config.themeProvider === false)
+        return body;
+    return jsxRuntime.jsx(siteThemeProvider.SiteThemeProvider, { mode: themeMode, children: body });
 }
 
 exports.SiteDocsLayout = SiteDocsLayout;

package/dist/fuma/base/site-docs-layout.mjs

@@ -1,13 +1,33 @@
 import { jsx } from 'react/jsx-runtime';
 import { DocsLayout } from 'fumadocs-ui/layouts/docs';
 import { normalizeNavItems } from './site-layout-shared.mjs';
+import { SiteThemeProvider } from './site-theme-provider.mjs';
 
 function toDocsLayoutOptions(config) {
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {})), (config.themeSwitch ? { themeSwitch: config.themeSwitch } : {})), (config.sidebar ? { sidebar: config.sidebar } : {})), { tree: config.tree });
+    var _a, _b;
+    const themeMode = (_b = (_a = config.themeSwitch) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : 'light-dark-system';
+    const shouldShowThemeSwitch = config.themeProvider !== false &&
+        (themeMode === 'light-dark' || themeMode === 'light-dark-system');
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {})), (shouldShowThemeSwitch
+        ? {
+            themeSwitch: {
+                mode: themeMode,
+            },
+        }
+        : {
+            themeSwitch: {
+                enabled: false,
+            },
+        })), (config.sidebar ? { sidebar: config.sidebar } : {})), { tree: config.tree });
 }
 function SiteDocsLayout({ config, children, }) {
+    var _a, _b;
     const options = toDocsLayoutOptions(config);
-    return jsx(DocsLayout, Object.assign({}, options, { children: children }));
+    const themeMode = (_b = (_a = config.themeSwitch) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : 'light-dark-system';
+    const body = jsx(DocsLayout, Object.assign({}, options, { children: children }));
+    if (config.themeProvider === false)
+        return body;
+    return jsx(SiteThemeProvider, { mode: themeMode, children: body });
 }
 
 export { SiteDocsLayout };

package/dist/fuma/base/site-home-layout.js

@@ -8,8 +8,8 @@ var siteLayoutShared = require('./site-layout-shared.js');
 function SiteHomeLayout({ locale, config, children, }) {
     const { actionOrders, banner, bannerHeight, defaultLocale, floatingNav, footer, goToTop, headerHeight, headerPaddingTop, localePrefixAsNeeded, navbarClassName, showBanner, showFooter, showGoToTop } = config, baseConfig = tslib.__rest(config, ["actionOrders", "banner", "bannerHeight", "defaultLocale", "floatingNav", "footer", "goToTop", "headerHeight", "headerPaddingTop", "localePrefixAsNeeded", "navbarClassName", "showBanner", "showFooter", "showGoToTop"]);
     const options = siteLayoutShared.toHomeLayoutOptions(baseConfig);
-    const layoutProps = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ locale,
-        options }, (actionOrders ? { actionOrders } : {})), (banner ? { banner } : {})), (bannerHeight != null ? { bannerHeight } : {})), (defaultLocale ? { defaultLocale } : {})), (floatingNav != null ? { floatingNav } : {})), (footer ? { footer } : {})), (goToTop ? { goToTop } : {})), (headerHeight != null ? { headerHeight } : {})), (headerPaddingTop != null ? { headerPaddingTop } : {})), (localePrefixAsNeeded != null ? { localePrefixAsNeeded } : {})), (navbarClassName ? { navbarClassName } : {})), (showBanner != null ? { showBanner } : {})), (showFooter != null ? { showFooter } : {})), (showGoToTop != null ? { showGoToTop } : {}));
+    const layoutProps = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ locale,
+        options }, (actionOrders ? { actionOrders } : {})), (banner ? { banner } : {})), (bannerHeight != null ? { bannerHeight } : {})), (defaultLocale ? { defaultLocale } : {})), (floatingNav != null ? { floatingNav } : {})), (footer ? { footer } : {})), (goToTop ? { goToTop } : {})), (headerHeight != null ? { headerHeight } : {})), (headerPaddingTop != null ? { headerPaddingTop } : {})), (localePrefixAsNeeded != null ? { localePrefixAsNeeded } : {})), (navbarClassName ? { navbarClassName } : {})), (showBanner != null ? { showBanner } : {})), (showFooter != null ? { showFooter } : {})), (showGoToTop != null ? { showGoToTop } : {})), (config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}));
     return jsxRuntime.jsx(customHomeLayout.CustomHomeLayout, Object.assign({}, layoutProps, { children: children }));
 }
 

package/dist/fuma/base/site-home-layout.mjs

@@ -6,8 +6,8 @@ import { toHomeLayoutOptions } from './site-layout-shared.mjs';
 function SiteHomeLayout({ locale, config, children, }) {
     const { actionOrders, banner, bannerHeight, defaultLocale, floatingNav, footer, goToTop, headerHeight, headerPaddingTop, localePrefixAsNeeded, navbarClassName, showBanner, showFooter, showGoToTop } = config, baseConfig = __rest(config, ["actionOrders", "banner", "bannerHeight", "defaultLocale", "floatingNav", "footer", "goToTop", "headerHeight", "headerPaddingTop", "localePrefixAsNeeded", "navbarClassName", "showBanner", "showFooter", "showGoToTop"]);
     const options = toHomeLayoutOptions(baseConfig);
-    const layoutProps = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ locale,
-        options }, (actionOrders ? { actionOrders } : {})), (banner ? { banner } : {})), (bannerHeight != null ? { bannerHeight } : {})), (defaultLocale ? { defaultLocale } : {})), (floatingNav != null ? { floatingNav } : {})), (footer ? { footer } : {})), (goToTop ? { goToTop } : {})), (headerHeight != null ? { headerHeight } : {})), (headerPaddingTop != null ? { headerPaddingTop } : {})), (localePrefixAsNeeded != null ? { localePrefixAsNeeded } : {})), (navbarClassName ? { navbarClassName } : {})), (showBanner != null ? { showBanner } : {})), (showFooter != null ? { showFooter } : {})), (showGoToTop != null ? { showGoToTop } : {}));
+    const layoutProps = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ locale,
+        options }, (actionOrders ? { actionOrders } : {})), (banner ? { banner } : {})), (bannerHeight != null ? { bannerHeight } : {})), (defaultLocale ? { defaultLocale } : {})), (floatingNav != null ? { floatingNav } : {})), (footer ? { footer } : {})), (goToTop ? { goToTop } : {})), (headerHeight != null ? { headerHeight } : {})), (headerPaddingTop != null ? { headerPaddingTop } : {})), (localePrefixAsNeeded != null ? { localePrefixAsNeeded } : {})), (navbarClassName ? { navbarClassName } : {})), (showBanner != null ? { showBanner } : {})), (showFooter != null ? { showFooter } : {})), (showGoToTop != null ? { showGoToTop } : {})), (config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}));
     return jsx(CustomHomeLayout, Object.assign({}, layoutProps, { children: children }));
 }
 

package/dist/fuma/base/site-layout-shared.d.ts

@@ -47,7 +47,11 @@ export interface SiteBaseLayoutConfig {
     githubUrl?: string;
     links?: SiteNavItemConfig[];
     searchToggle?: HomeLayoutProps['searchToggle'];
-    themeSwitch?: HomeLayoutProps['themeSwitch'];
+    themeSwitch?: SiteThemeSwitchConfig;
+}
+export type SiteThemeSwitchMode = 'light-dark-system' | 'light-dark' | 'light-only' | 'dark-only';
+export interface SiteThemeSwitchConfig {
+    mode?: SiteThemeSwitchMode;
 }
 export interface SiteMenuLeafConfig {
     text: ReactNode;

package/dist/fuma/base/site-layout-shared.js

@@ -38,7 +38,7 @@ function createSiteBaseLayoutConfig(options) {
         } }, (options.i18n ? { i18n: options.i18n } : {})), (options.githubUrl ? { githubUrl: options.githubUrl } : {}));
 }
 function toHomeLayoutOptions(config) {
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {})), (config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}));
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {}));
 }
 
 exports.createSiteBaseLayoutConfig = createSiteBaseLayoutConfig;

package/dist/fuma/base/site-layout-shared.mjs

@@ -36,7 +36,7 @@ function createSiteBaseLayoutConfig(options) {
         } }, (options.i18n ? { i18n: options.i18n } : {})), (options.githubUrl ? { githubUrl: options.githubUrl } : {}));
 }
 function toHomeLayoutOptions(config) {
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {})), (config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}));
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (config.nav ? { nav: config.nav } : {})), (config.i18n ? { i18n: config.i18n } : {})), (config.githubUrl ? { githubUrl: config.githubUrl } : {})), (config.links ? { links: normalizeNavItems(config.links) } : {})), (config.searchToggle ? { searchToggle: config.searchToggle } : {}));
 }
 
 export { createSiteBaseLayoutConfig, createSiteNavGroup, createSiteNavLink, normalizeNavItems, toHomeLayoutOptions };

package/dist/fuma/base/site-theme-provider.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+import { type ThemeProviderProps } from 'next-themes';
+import type { SiteThemeSwitchMode } from './site-layout-shared';
+export interface SiteThemeProviderProps extends Omit<ThemeProviderProps, 'children'> {
+    mode?: SiteThemeSwitchMode;
+    children: ReactNode;
+}
+export declare function SiteThemeProvider({ mode, children, ...props }: SiteThemeProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/fuma/base/site-theme-provider.js

@@ -0,0 +1,41 @@
+"use client";
+'use strict';
+
+var tslib = require('tslib');
+var jsxRuntime = require('react/jsx-runtime');
+var nextThemes = require('next-themes');
+
+function SiteThemeProvider(_a) {
+    var { mode = 'light-dark-system', children } = _a, props = tslib.__rest(_a, ["mode", "children"]);
+    return (jsxRuntime.jsx(nextThemes.ThemeProvider, Object.assign({ attribute: "class", disableTransitionOnChange: true }, resolveThemeProviderProps(mode), props, { children: children })));
+}
+function resolveThemeProviderProps(mode) {
+    if (mode === 'light-only') {
+        return {
+            forcedTheme: 'light',
+            enableSystem: false,
+            defaultTheme: 'light',
+        };
+    }
+    if (mode === 'dark-only') {
+        return {
+            forcedTheme: 'dark',
+            enableSystem: false,
+            defaultTheme: 'dark',
+        };
+    }
+    if (mode === 'light-dark') {
+        return {
+            enableSystem: false,
+            defaultTheme: 'light',
+            forcedTheme: undefined,
+        };
+    }
+    return {
+        enableSystem: true,
+        defaultTheme: 'system',
+        forcedTheme: undefined,
+    };
+}
+
+exports.SiteThemeProvider = SiteThemeProvider;

package/dist/fuma/base/site-theme-provider.mjs

@@ -0,0 +1,39 @@
+"use client";
+import { __rest } from 'tslib';
+import { jsx } from 'react/jsx-runtime';
+import { ThemeProvider } from 'next-themes';
+
+function SiteThemeProvider(_a) {
+    var { mode = 'light-dark-system', children } = _a, props = __rest(_a, ["mode", "children"]);
+    return (jsx(ThemeProvider, Object.assign({ attribute: "class", disableTransitionOnChange: true }, resolveThemeProviderProps(mode), props, { children: children })));
+}
+function resolveThemeProviderProps(mode) {
+    if (mode === 'light-only') {
+        return {
+            forcedTheme: 'light',
+            enableSystem: false,
+            defaultTheme: 'light',
+        };
+    }
+    if (mode === 'dark-only') {
+        return {
+            forcedTheme: 'dark',
+            enableSystem: false,
+            defaultTheme: 'dark',
+        };
+    }
+    if (mode === 'light-dark') {
+        return {
+            enableSystem: false,
+            defaultTheme: 'light',
+            forcedTheme: undefined,
+        };
+    }
+    return {
+        enableSystem: true,
+        defaultTheme: 'system',
+        forcedTheme: undefined,
+    };
+}
+
+export { SiteThemeProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "31.0.1",
+  "version": "31.1.0",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "exports": {
     "./clerk": {

package/src/fuma/base/custom-header.tsx

@@ -35,7 +35,11 @@ import { Popover, PopoverContent, PopoverTrigger } from 'fumadocs-ui/components/
 import { buttonVariants } from 'fumadocs-ui/components/ui/button';
 import { useI18n } from 'fumadocs-ui/contexts/i18n';
 import { HeaderThemeSwitch } from './header-theme-switch';
-import type { ExtendedLinkItem } from './site-layout-shared';
+import type {
+  ExtendedLinkItem,
+  SiteThemeSwitchConfig,
+  SiteThemeSwitchMode,
+} from './site-layout-shared';
 
 export type NavbarCSSVars = CSSProperties & {
   '--fd-banner-height'?: string;
@@ -47,7 +51,8 @@ const PrefetchLinkItem = LinkItem as (
   props: ComponentProps<typeof LinkItem> & { prefetch?: boolean },
 ) => ReactNode;
 
-export interface CustomHomeHeaderProps extends HomeLayoutProps {
+export interface CustomHomeHeaderProps
+  extends Omit<HomeLayoutProps, 'themeSwitch'> {
   /**
    * Banner height in rem units
    *
@@ -92,6 +97,7 @@ export interface CustomHomeHeaderProps extends HomeLayoutProps {
    * Control order of utilities inside the mobile dropdown.
    */
   mobileMenuActionsOrder?: MobileMenuAction[];
+  themeSwitch?: SiteThemeSwitchConfig;
 }
 
 export type DesktopAction =
@@ -175,8 +181,12 @@ export function CustomHomeHeader({
         ? searchToggle.components?.lg ?? null
         : null,
     theme:
-      themeSwitch.enabled !== false
-        ? themeSwitch.component ?? <HeaderThemeSwitch mode={themeSwitch?.mode} />
+      shouldShowThemeSwitch(themeSwitch?.mode)
+        ? (
+            <HeaderThemeSwitch
+              mode={normalizeThemeSwitchMode(themeSwitch?.mode)}
+            />
+          )
         : null,
     i18n: i18n ? (
       <CompactLanguageToggle>
@@ -238,8 +248,12 @@ export function CustomHomeHeader({
       </CompactLanguageToggle>
     ) : null,
     theme:
-      themeSwitch.enabled !== false
-        ? themeSwitch.component ?? <HeaderThemeSwitch mode={themeSwitch?.mode} />
+      shouldShowThemeSwitch(themeSwitch?.mode)
+        ? (
+            <HeaderThemeSwitch
+              mode={normalizeThemeSwitchMode(themeSwitch?.mode)}
+            />
+          )
         : null,
   };
   const shouldRenderMobileUtilities = mobileMenuActionsOrder.some(
@@ -356,6 +370,16 @@ export function CustomHomeHeader({
   );
 }
 
+function shouldShowThemeSwitch(mode?: SiteThemeSwitchMode): boolean {
+  return mode === 'light-dark' || mode === 'light-dark-system' || mode == null;
+}
+
+function normalizeThemeSwitchMode(
+  mode?: SiteThemeSwitchMode,
+): 'light-dark' | 'light-dark-system' {
+  return mode === 'light-dark' ? 'light-dark' : 'light-dark-system';
+}
+
 interface CustomNavbarProps extends ComponentProps<'div'> {
   bannerHeight?: number;
   headerHeight?: number;

package/src/fuma/base/custom-home-layout.tsx

@@ -3,13 +3,16 @@ import { HomeLayout, type HomeLayoutProps } from 'fumadocs-ui/layouts/home';
 import { FumaBannerSuit } from '../fuma-banner-suit';
 import { Footer } from '../../main/footer';
 import { GoToTop } from '../../main/go-to-top';
+import { SiteThemeProvider } from './site-theme-provider';
 import {
   NavbarCSSVars,
   CustomHomeHeader,
   type DesktopAction,
   type MobileBarAction,
   type MobileMenuAction,
+  type CustomHomeHeaderProps,
 } from './custom-header';
+import type { SiteThemeSwitchConfig } from './site-layout-shared';
 
 // - Set bannerHeight/headerHeight to the rem values expected by the project. Use bannerHeight = 0 when there is no banner.
 // - layoutStyle passes the variables to HomeLayout's main element, offsetting content without has-banner/no-banner classes.
@@ -91,6 +94,10 @@ export interface CustomHomeLayoutProps {
    * The default locale for the application (default: 'en')
    */
   defaultLocale?: string;
+  /**
+   * Theme mode for this layout group.
+   */
+  themeSwitch?: SiteThemeSwitchConfig;
   children?: ReactNode;
 }
 
@@ -119,6 +126,7 @@ export function CustomHomeLayout({
   actionOrders,
   localePrefixAsNeeded = true,
   defaultLocale = 'en',
+  themeSwitch,
 }: CustomHomeLayoutProps) {
   const resolvedBannerHeight = bannerHeight ?? (showBanner ? 3 : 0.5);
   const resolvedPaddingTop =
@@ -139,6 +147,7 @@ export function CustomHomeLayout({
     <CustomHomeHeader
       {...homeLayoutProps}
       nav={navOptions}
+      themeSwitch={themeSwitch}
       bannerHeight={resolvedBannerHeight}
       headerHeight={headerHeight}
       navbarClassName={navbarClassName}
@@ -148,6 +157,7 @@ export function CustomHomeLayout({
       mobileMenuActionsOrder={actionOrders?.mobileMenu}
     />
   );
+  const themeMode = themeSwitch?.mode ?? 'light-dark-system';
 
   return (
     <>
@@ -158,19 +168,21 @@ export function CustomHomeLayout({
           floating={floatingNav}
         />
       )}
+    <SiteThemeProvider mode={themeMode}>
       <HomeLayout
-        {...homeLayoutProps}
-        nav={{
-          ...navOptions,
-          component: header,
-        }}
-        className='bg-neutral-100 dark:bg-neutral-900'
-        style={layoutStyle}
-      >
-        {children}
-        {showFooter ? footer ?? <Footer locale={locale} localePrefixAsNeeded={localePrefixAsNeeded} defaultLocale={defaultLocale} /> : null}
-        {showGoToTop ? goToTop ?? <GoToTop /> : null}
-      </HomeLayout>
+          {...homeLayoutProps}
+          nav={{
+            ...navOptions,
+            component: header,
+          }}
+          className='bg-neutral-100 dark:bg-neutral-900'
+          style={layoutStyle}
+        >
+          {children}
+          {showFooter ? footer ?? <Footer locale={locale} localePrefixAsNeeded={localePrefixAsNeeded} defaultLocale={defaultLocale} /> : null}
+          {showGoToTop ? goToTop ?? <GoToTop /> : null}
+        </HomeLayout>
+      </SiteThemeProvider>
     </>
   );
 }

package/src/fuma/base/docs-root-provider.tsx

@@ -1,58 +1,31 @@
 import type { ComponentProps, ReactNode } from 'react';
 import { NextProvider } from 'fumadocs-core/framework/next';
 import { I18nProvider, type I18nProviderProps } from 'fumadocs-ui/contexts/i18n';
-import { ThemeProvider, type ThemeProviderProps } from 'next-themes';
 
 type NextProviderComponents = {
   Link?: ComponentProps<typeof NextProvider>['Link'];
   Image?: ComponentProps<typeof NextProvider>['Image'];
 };
 
-type ThemeOptions = ThemeProviderProps & {
-  enabled?: boolean;
-};
-
 export interface DocsRootProviderProps {
   i18n: Omit<I18nProviderProps, 'children'>;
-  theme?: ThemeOptions;
   components?: NextProviderComponents;
   children: ReactNode;
 }
 
 export function DocsRootProvider({
   i18n,
-  theme = {},
   components,
   children,
 }: DocsRootProviderProps) {
-  let body = children;
-
-  if (theme.enabled !== false) {
-    body = (
-      <ThemeProvider
-        attribute="class"
-        defaultTheme="system"
-        enableSystem
-        disableTransitionOnChange
-        {...theme}
-      >
-        {body}
-      </ThemeProvider>
-    );
-  }
-
-  body = (
-    <I18nProvider {...i18n}>
-      {body}
-    </I18nProvider>
-  );
-
   return (
     <NextProvider
       Link={components?.Link}
       Image={components?.Image}
     >
-      {body}
+      <I18nProvider {...i18n}>
+        {children}
+      </I18nProvider>
     </NextProvider>
   );
 }

package/src/fuma/base/header-theme-switch.tsx

@@ -5,6 +5,7 @@ import { AirplayIcon, MoonIcon, SunIcon } from '@windrun-huaiin/base-ui/icons';
 import { useTheme } from 'next-themes';
 import { type ComponentProps, useEffect, useState } from 'react';
 import { cn } from '@windrun-huaiin/lib/utils';
+import type { SiteThemeSwitchMode } from './site-layout-shared';
 
 const itemVariants = cva('inline-flex size-6.5 items-center justify-center rounded-full p-1.5', {
   variants: {
@@ -18,7 +19,7 @@ const itemVariants = cva('inline-flex size-6.5 items-center justify-center round
 const full = [['light', SunIcon] as const, ['dark', MoonIcon] as const, ['system', AirplayIcon] as const];
 
 export interface HeaderThemeSwitchProps extends ComponentProps<'div'> {
-  mode?: 'light-dark' | 'light-dark-system';
+  mode?: Exclude<SiteThemeSwitchMode, 'light-only' | 'dark-only'>;
 }
 
 export function HeaderThemeSwitch({

package/src/fuma/base/site-docs-layout.tsx

@@ -4,20 +4,36 @@ import {
   normalizeNavItems,
   type SiteBaseLayoutConfig,
 } from './site-layout-shared';
+import { SiteThemeProvider } from './site-theme-provider';
 
 export interface SiteDocsLayoutConfig extends SiteBaseLayoutConfig {
   tree: DocsLayoutProps['tree'];
   sidebar?: DocsLayoutProps['sidebar'];
+  themeProvider?: boolean;
 }
 
 function toDocsLayoutOptions(config: SiteDocsLayoutConfig): DocsLayoutProps {
+  const themeMode = config.themeSwitch?.mode ?? 'light-dark-system';
+  const shouldShowThemeSwitch =
+    config.themeProvider !== false &&
+    (themeMode === 'light-dark' || themeMode === 'light-dark-system');
   return {
     ...(config.nav ? { nav: config.nav } : {}),
     ...(config.i18n ? { i18n: config.i18n } : {}),
     ...(config.githubUrl ? { githubUrl: config.githubUrl } : {}),
     ...(config.links ? { links: normalizeNavItems(config.links) } : {}),
     ...(config.searchToggle ? { searchToggle: config.searchToggle } : {}),
-    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
+    ...(shouldShowThemeSwitch
+      ? {
+          themeSwitch: {
+            mode: themeMode,
+          },
+        }
+      : {
+          themeSwitch: {
+            enabled: false,
+          },
+        }),
     ...(config.sidebar ? { sidebar: config.sidebar } : {}),
     tree: config.tree,
   };
@@ -31,5 +47,10 @@ export function SiteDocsLayout({
   children: ReactNode;
 }) {
   const options = toDocsLayoutOptions(config);
-  return <DocsLayout {...options}>{children}</DocsLayout>;
+  const themeMode = config.themeSwitch?.mode ?? 'light-dark-system';
+  const body = <DocsLayout {...options}>{children}</DocsLayout>;
+
+  if (config.themeProvider === false) return body;
+
+  return <SiteThemeProvider mode={themeMode}>{body}</SiteThemeProvider>;
 }

package/src/fuma/base/site-home-layout.tsx

@@ -72,6 +72,7 @@ export function SiteHomeLayout({
     ...(showBanner != null ? { showBanner } : {}),
     ...(showFooter != null ? { showFooter } : {}),
     ...(showGoToTop != null ? { showGoToTop } : {}),
+    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
   };
 
   return <CustomHomeLayout {...layoutProps}>{children}</CustomHomeLayout>;

package/src/fuma/base/site-layout-shared.tsx

@@ -58,7 +58,17 @@ export interface SiteBaseLayoutConfig {
   githubUrl?: string;
   links?: SiteNavItemConfig[];
   searchToggle?: HomeLayoutProps['searchToggle'];
-  themeSwitch?: HomeLayoutProps['themeSwitch'];
+  themeSwitch?: SiteThemeSwitchConfig;
+}
+
+export type SiteThemeSwitchMode =
+  | 'light-dark-system'
+  | 'light-dark'
+  | 'light-only'
+  | 'dark-only';
+
+export interface SiteThemeSwitchConfig {
+  mode?: SiteThemeSwitchMode;
 }
 
 export interface SiteMenuLeafConfig {
@@ -185,6 +195,5 @@ export function toHomeLayoutOptions(config: SiteBaseLayoutConfig): HomeLayoutPro
     ...(config.githubUrl ? { githubUrl: config.githubUrl } : {}),
     ...(config.links ? { links: normalizeNavItems(config.links) } : {}),
     ...(config.searchToggle ? { searchToggle: config.searchToggle } : {}),
-    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
   };
 }

package/src/fuma/base/site-theme-provider.tsx

@@ -0,0 +1,59 @@
+'use client';
+
+import type { ReactNode } from 'react';
+import { ThemeProvider, type ThemeProviderProps } from 'next-themes';
+import type { SiteThemeSwitchMode } from './site-layout-shared';
+
+export interface SiteThemeProviderProps extends Omit<ThemeProviderProps, 'children'> {
+  mode?: SiteThemeSwitchMode;
+  children: ReactNode;
+}
+
+export function SiteThemeProvider({
+  mode = 'light-dark-system',
+  children,
+  ...props
+}: SiteThemeProviderProps) {
+  return (
+    <ThemeProvider
+      attribute="class"
+      disableTransitionOnChange
+      {...resolveThemeProviderProps(mode)}
+      {...props}
+    >
+      {children}
+    </ThemeProvider>
+  );
+}
+
+function resolveThemeProviderProps(mode: SiteThemeSwitchMode): ThemeProviderProps {
+  if (mode === 'light-only') {
+    return {
+      forcedTheme: 'light',
+      enableSystem: false,
+      defaultTheme: 'light',
+    };
+  }
+
+  if (mode === 'dark-only') {
+    return {
+      forcedTheme: 'dark',
+      enableSystem: false,
+      defaultTheme: 'dark',
+    };
+  }
+
+  if (mode === 'light-dark') {
+    return {
+      enableSystem: false,
+      defaultTheme: 'light',
+      forcedTheme: undefined,
+    };
+  }
+
+  return {
+    enableSystem: true,
+    defaultTheme: 'system',
+    forcedTheme: undefined,
+  };
+}