@windrun-huaiin/third-ui 7.6.1 → 10.0.0

package/dist/fuma/base/index.js

@@ -0,0 +1,9 @@
+'use strict';
+
+var customHeader = require('./custom-header.js');
+var customHomeLayout = require('./custom-home-layout.js');
+
+
+
+exports.CustomHomeHeader = customHeader.CustomHomeHeader;
+exports.CustomHomeLayout = customHomeLayout.CustomHomeLayout;

package/dist/fuma/base/index.mjs

@@ -0,0 +1,2 @@
+export { CustomHomeHeader } from './custom-header.mjs';
+export { CustomHomeLayout } from './custom-home-layout.mjs';

package/dist/fuma/fuma-banner-suit.d.ts

@@ -1,4 +1,5 @@
-export declare function FumaBannerSuit({ locale, showBanner }: {
+export declare function FumaBannerSuit({ locale, showBanner, floating, }: {
     locale: string;
     showBanner: boolean;
+    floating?: boolean;
 }): Promise<import("react/jsx-runtime").JSX.Element>;

package/dist/fuma/fuma-banner-suit.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
 var jsxRuntime = require('react/jsx-runtime');
 var server = require('next-intl/server');
 require('@windrun-huaiin/base-ui/components/server');
@@ -11,18 +11,24 @@ require('@windrun-huaiin/lib/utils');
 require('next/link');
 require('@windrun-huaiin/base-ui/ui');
 require('next/navigation');
+require('next-intl');
 require('fumadocs-ui/utils/use-copy-button');
 require('fumadocs-core/link');
 require('fumadocs-ui/components/ui/collapsible');
 var banner = require('./mdx/banner.js');
 
 function FumaBannerSuit(_a) {
-    return tslib_es6.__awaiter(this, arguments, void 0, function* ({ locale, showBanner }) {
+    return tslib_es6.__awaiter(this, arguments, void 0, function* ({ locale, showBanner, floating = true, }) {
         const t = yield server.getTranslations({ locale, namespace: 'home' });
         const heightValue = showBanner ? 3 : 0.5;
         const height = `${heightValue}rem`;
         const bannerText = t('banner');
-        return (jsxRuntime.jsx(jsxRuntime.Fragment, { children: showBanner ? (jsxRuntime.jsx(banner.Banner, { variant: "rainbow", changeLayout: true, height: heightValue, children: jsxRuntime.jsx("p", { className: "text-xl", children: bannerText }) })) : (jsxRuntime.jsx("div", { className: "fixed top-0 left-0 w-screen z-[1001] m-0 rounded-none bg-neutral-100 dark:bg-neutral-900", style: {
+        return (jsxRuntime.jsx(jsxRuntime.Fragment, { children: showBanner ? (jsxRuntime.jsx(banner.Banner, { variant: "rainbow", changeLayout: true, height: heightValue, floating: floating, children: jsxRuntime.jsx("p", { className: "text-xl", children: bannerText }) })) : (jsxRuntime.jsx("div", { className: "m-0 rounded-none bg-neutral-100 dark:bg-neutral-900", style: {
+                    position: floating ? 'fixed' : 'relative',
+                    top: floating ? 0 : undefined,
+                    left: floating ? 0 : undefined,
+                    width: floating ? '100vw' : '100%',
+                    zIndex: floating ? 1001 : undefined,
                     height: height,
                     minHeight: height,
                     maxHeight: height,

package/dist/fuma/fuma-banner-suit.mjs

@@ -1,4 +1,4 @@
-import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
+import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
 import { jsx, Fragment } from 'react/jsx-runtime';
 import { getTranslations } from 'next-intl/server';
 import '@windrun-huaiin/base-ui/components/server';
@@ -9,18 +9,24 @@ import '@windrun-huaiin/lib/utils';
 import 'next/link';
 import '@windrun-huaiin/base-ui/ui';
 import 'next/navigation';
+import 'next-intl';
 import 'fumadocs-ui/utils/use-copy-button';
 import 'fumadocs-core/link';
 import 'fumadocs-ui/components/ui/collapsible';
 import { Banner } from './mdx/banner.mjs';
 
 function FumaBannerSuit(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ locale, showBanner }) {
+    return __awaiter(this, arguments, void 0, function* ({ locale, showBanner, floating = true, }) {
         const t = yield getTranslations({ locale, namespace: 'home' });
         const heightValue = showBanner ? 3 : 0.5;
         const height = `${heightValue}rem`;
         const bannerText = t('banner');
-        return (jsx(Fragment, { children: showBanner ? (jsx(Banner, { variant: "rainbow", changeLayout: true, height: heightValue, children: jsx("p", { className: "text-xl", children: bannerText }) })) : (jsx("div", { className: "fixed top-0 left-0 w-screen z-[1001] m-0 rounded-none bg-neutral-100 dark:bg-neutral-900", style: {
+        return (jsx(Fragment, { children: showBanner ? (jsx(Banner, { variant: "rainbow", changeLayout: true, height: heightValue, floating: floating, children: jsx("p", { className: "text-xl", children: bannerText }) })) : (jsx("div", { className: "m-0 rounded-none bg-neutral-100 dark:bg-neutral-900", style: {
+                    position: floating ? 'fixed' : 'relative',
+                    top: floating ? 0 : undefined,
+                    left: floating ? 0 : undefined,
+                    width: floating ? '100vw' : '100%',
+                    zIndex: floating ? 1001 : undefined,
                     height: height,
                     minHeight: height,
                     maxHeight: height,

package/dist/fuma/fuma-page-genarator.d.ts

@@ -12,8 +12,11 @@ interface FumaPageParams {
         siteIcon: ReactNode;
     }>;
     supportedLocales?: string[];
+    showBreadcrumb?: boolean;
+    showTableOfContent?: boolean;
+    showTableOfContentPopover?: boolean;
 }
-export declare function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales, }: FumaPageParams): {
+export declare function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales, showBreadcrumb, showTableOfContent, showTableOfContentPopover, }: FumaPageParams): {
     Page: ({ params }: {
         params: Promise<{
             locale: string;

package/dist/fuma/fuma-page-genarator.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
 var jsxRuntime = require('react/jsx-runtime');
 var page = require('fumadocs-ui/page');
 var React = require('react');
@@ -11,13 +11,14 @@ require('@windrun-huaiin/lib/utils');
 require('next/link');
 require('@windrun-huaiin/base-ui/ui');
 require('next/navigation');
+require('next-intl');
 require('fumadocs-ui/utils/use-copy-button');
 require('fumadocs-core/link');
 require('fumadocs-ui/components/ui/collapsible');
 var tocFooterWrapper = require('./mdx/toc-footer-wrapper.js');
 require('./mdx/banner.js');
 
-function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], }) {
+function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], showBreadcrumb = true, showTableOfContent = true, showTableOfContentPopover = false, }) {
     const Page = function Page(_a) {
         return tslib_es6.__awaiter(this, arguments, void 0, function* ({ params }) {
             const { slug, locale } = yield params;
@@ -25,12 +26,20 @@ function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSour
             if (!page$1) {
                 return jsxRuntime.jsx(FallbackPage, { siteIcon: siteIcon });
             }
-            const path = githubBaseUrl ? `${mdxSourceDir}/${page$1.file.path}` : undefined;
+            const path = githubBaseUrl ? `${mdxSourceDir}/${page$1.path}` : undefined;
             const tocFooterElement = (jsxRuntime.jsx(tocFooterWrapper.TocFooterWrapper, { lastModified: page$1.data.date, copyButtonComponent: copyButtonComponent
                     ? React.cloneElement(copyButtonComponent, { sourceKey })
                     : undefined, editPath: path, githubBaseUrl: githubBaseUrl }));
             const MDX = page$1.data.body;
-            return (jsxRuntime.jsxs(page.DocsPage, { tableOfContent: { style: 'clerk', single: false, footer: tocFooterElement }, tableOfContentPopover: { footer: tocFooterElement }, toc: page$1.data.toc, full: page$1.data.full, article: { className: 'max-sm:pb-16' }, children: [jsxRuntime.jsx(page.DocsTitle, { children: page$1.data.title }), jsxRuntime.jsx(page.DocsDescription, { className: "mb-2", children: page$1.data.description }), jsxRuntime.jsx(page.DocsBody, { className: "text-fd-foreground/80", children: jsxRuntime.jsx(MDX, { components: getMDXComponents() }) })] }));
+            return (jsxRuntime.jsxs(page.DocsPage, { breadcrumb: { enabled: showBreadcrumb }, tableOfContent: {
+                    enabled: showTableOfContent,
+                    style: 'clerk',
+                    single: false,
+                    footer: tocFooterElement,
+                }, tableOfContentPopover: {
+                    enabled: showTableOfContentPopover,
+                    footer: tocFooterElement,
+                }, toc: page$1.data.toc, article: { className: 'max-sm:pb-16' }, children: [jsxRuntime.jsx(page.DocsTitle, { children: page$1.title }), jsxRuntime.jsx(page.DocsDescription, { className: "mb-2", children: page$1.description }), jsxRuntime.jsx(page.DocsBody, { className: "text-fd-foreground/80", children: jsxRuntime.jsx(MDX, { components: getMDXComponents() }) })] }));
         });
     };
     function generateStaticParams() {
@@ -58,8 +67,8 @@ function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSour
             });
             return {
                 metadataBase: new URL(baseUrl),
-                title: page.data.title,
-                description: page.data.description,
+                title: page.title,
+                description: page.description,
                 alternates: {
                     canonical: currentUrl,
                     languages: seoLanguageMap

package/dist/fuma/fuma-page-genarator.mjs

@@ -1,4 +1,4 @@
-import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
+import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { DocsPage, DocsTitle, DocsDescription, DocsBody } from 'fumadocs-ui/page';
 import { cloneElement } from 'react';
@@ -9,13 +9,14 @@ import '@windrun-huaiin/lib/utils';
 import 'next/link';
 import '@windrun-huaiin/base-ui/ui';
 import 'next/navigation';
+import 'next-intl';
 import 'fumadocs-ui/utils/use-copy-button';
 import 'fumadocs-core/link';
 import 'fumadocs-ui/components/ui/collapsible';
 import { TocFooterWrapper } from './mdx/toc-footer-wrapper.mjs';
 import './mdx/banner.mjs';
 
-function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], }) {
+function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], showBreadcrumb = true, showTableOfContent = true, showTableOfContentPopover = false, }) {
     const Page = function Page(_a) {
         return __awaiter(this, arguments, void 0, function* ({ params }) {
             const { slug, locale } = yield params;
@@ -23,12 +24,20 @@ function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSour
             if (!page) {
                 return jsx(FallbackPage, { siteIcon: siteIcon });
             }
-            const path = githubBaseUrl ? `${mdxSourceDir}/${page.file.path}` : undefined;
+            const path = githubBaseUrl ? `${mdxSourceDir}/${page.path}` : undefined;
             const tocFooterElement = (jsx(TocFooterWrapper, { lastModified: page.data.date, copyButtonComponent: copyButtonComponent
                     ? cloneElement(copyButtonComponent, { sourceKey })
                     : undefined, editPath: path, githubBaseUrl: githubBaseUrl }));
             const MDX = page.data.body;
-            return (jsxs(DocsPage, { tableOfContent: { style: 'clerk', single: false, footer: tocFooterElement }, tableOfContentPopover: { footer: tocFooterElement }, toc: page.data.toc, full: page.data.full, article: { className: 'max-sm:pb-16' }, children: [jsx(DocsTitle, { children: page.data.title }), jsx(DocsDescription, { className: "mb-2", children: page.data.description }), jsx(DocsBody, { className: "text-fd-foreground/80", children: jsx(MDX, { components: getMDXComponents() }) })] }));
+            return (jsxs(DocsPage, { breadcrumb: { enabled: showBreadcrumb }, tableOfContent: {
+                    enabled: showTableOfContent,
+                    style: 'clerk',
+                    single: false,
+                    footer: tocFooterElement,
+                }, tableOfContentPopover: {
+                    enabled: showTableOfContentPopover,
+                    footer: tocFooterElement,
+                }, toc: page.data.toc, article: { className: 'max-sm:pb-16' }, children: [jsx(DocsTitle, { children: page.title }), jsx(DocsDescription, { className: "mb-2", children: page.description }), jsx(DocsBody, { className: "text-fd-foreground/80", children: jsx(MDX, { components: getMDXComponents() }) })] }));
         });
     };
     function generateStaticParams() {
@@ -56,8 +65,8 @@ function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSour
             });
             return {
                 metadataBase: new URL(baseUrl),
-                title: page.data.title,
-                description: page.data.description,
+                title: page.title,
+                description: page.description,
                 alternates: {
                     canonical: currentUrl,
                     languages: seoLanguageMap

package/dist/fuma/fuma-translate-util.d.ts

@@ -0,0 +1,2 @@
+import { Translations } from 'fumadocs-ui/i18n';
+export declare function getFumaTranslations(locale: string): Promise<Partial<Translations>>;

package/dist/fuma/fuma-translate-util.js

@@ -0,0 +1,40 @@
+'use strict';
+
+var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
+var server = require('next-intl/server');
+
+const defaultFumaTranslations = {
+    search: 'Search',
+    searchNoResult: 'No results found',
+    toc: 'On this page',
+    tocNoHeadings: 'No Headings',
+    lastUpdate: 'Last updated on',
+    chooseLanguage: 'Choose a language',
+    nextPage: 'Next Page',
+    previousPage: 'Previous Page',
+    chooseTheme: 'Theme',
+    editOnGithub: 'Edit on GitHub',
+};
+function resolveTranslation(t, key) {
+    const value = t.raw(key);
+    return typeof value === 'string' ? value : defaultFumaTranslations[key];
+}
+function getFumaTranslations(locale) {
+    return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        const t = yield server.getTranslations({ locale, namespace: 'fuma' });
+        return {
+            search: resolveTranslation(t, 'search'),
+            searchNoResult: resolveTranslation(t, 'searchNoResult'),
+            toc: resolveTranslation(t, 'toc'),
+            tocNoHeadings: resolveTranslation(t, 'tocNoHeadings'),
+            lastUpdate: resolveTranslation(t, 'lastUpdate'),
+            chooseLanguage: resolveTranslation(t, 'chooseLanguage'),
+            nextPage: resolveTranslation(t, 'nextPage'),
+            previousPage: resolveTranslation(t, 'previousPage'),
+            chooseTheme: resolveTranslation(t, 'chooseTheme'),
+            editOnGithub: resolveTranslation(t, 'editOnGithub'),
+        };
+    });
+}
+
+exports.getFumaTranslations = getFumaTranslations;

package/dist/fuma/fuma-translate-util.mjs

@@ -0,0 +1,38 @@
+import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
+import { getTranslations } from 'next-intl/server';
+
+const defaultFumaTranslations = {
+    search: 'Search',
+    searchNoResult: 'No results found',
+    toc: 'On this page',
+    tocNoHeadings: 'No Headings',
+    lastUpdate: 'Last updated on',
+    chooseLanguage: 'Choose a language',
+    nextPage: 'Next Page',
+    previousPage: 'Previous Page',
+    chooseTheme: 'Theme',
+    editOnGithub: 'Edit on GitHub',
+};
+function resolveTranslation(t, key) {
+    const value = t.raw(key);
+    return typeof value === 'string' ? value : defaultFumaTranslations[key];
+}
+function getFumaTranslations(locale) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const t = yield getTranslations({ locale, namespace: 'fuma' });
+        return {
+            search: resolveTranslation(t, 'search'),
+            searchNoResult: resolveTranslation(t, 'searchNoResult'),
+            toc: resolveTranslation(t, 'toc'),
+            tocNoHeadings: resolveTranslation(t, 'tocNoHeadings'),
+            lastUpdate: resolveTranslation(t, 'lastUpdate'),
+            chooseLanguage: resolveTranslation(t, 'chooseLanguage'),
+            nextPage: resolveTranslation(t, 'nextPage'),
+            previousPage: resolveTranslation(t, 'previousPage'),
+            chooseTheme: resolveTranslation(t, 'chooseTheme'),
+            editOnGithub: resolveTranslation(t, 'editOnGithub'),
+        };
+    });
+}
+
+export { getFumaTranslations };

package/dist/fuma/llm-copy-handler.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var tslib_es6 = require('../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
 var fs = require('node:fs');
 var nodePath = require('node:path');
 var llmUtils = require('@windrun-huaiin/lib/llm-utils');
@@ -18,18 +18,19 @@ function LLMCopyHandler(options) {
         try {
             console.log('[LLMCopy] Attempting to call getPage()');
             const page = dataSource.getPage(slug, locale);
+            // console.log(page);
             console.log('[LLMCopy] Call to getPage() completed.');
-            if (!page || !page.data) {
-                console.error(`[LLMCopy] Page or page.data not found for locale=${locale}, path=${requestedPath}`);
+            if (!page) {
+                console.error(`[LLMCopy] Page or page data not found for locale=${locale}, path=${requestedPath}`);
                 return { error: 'Page data not found', status: 404 };
             }
-            if (!page.data._file || !page.data._file.path) {
-                console.error(`[LLMCopy] _file path information missing in page.data for locale=${locale}, path=${requestedPath}`);
+            if (!page.path) {
+                console.error(`[LLMCopy] file path information missing in page data for locale=${locale}, path=${requestedPath}`);
                 return { error: 'Page file path information missing', status: 500 };
             }
-            const title = page.data.title;
-            const description = page.data.description;
-            const relativeMdxFilePath = page.data._file.path;
+            const title = page.title;
+            const description = page.description;
+            const relativeMdxFilePath = page.path;
             const absoluteFilePath = nodePath.join(process.cwd(), sourceDir, relativeMdxFilePath);
             console.log(`[LLMCopy] Attempting to read MDX content from: ${absoluteFilePath}`);
             let mdxContent;

package/dist/fuma/llm-copy-handler.mjs

@@ -1,4 +1,4 @@
-import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
+import { __awaiter } from '../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
 import fs from 'node:fs';
 import nodePath from 'node:path';
 import { getLLMText } from '@windrun-huaiin/lib/llm-utils';
@@ -16,18 +16,19 @@ function LLMCopyHandler(options) {
         try {
             console.log('[LLMCopy] Attempting to call getPage()');
             const page = dataSource.getPage(slug, locale);
+            // console.log(page);
             console.log('[LLMCopy] Call to getPage() completed.');
-            if (!page || !page.data) {
-                console.error(`[LLMCopy] Page or page.data not found for locale=${locale}, path=${requestedPath}`);
+            if (!page) {
+                console.error(`[LLMCopy] Page or page data not found for locale=${locale}, path=${requestedPath}`);
                 return { error: 'Page data not found', status: 404 };
             }
-            if (!page.data._file || !page.data._file.path) {
-                console.error(`[LLMCopy] _file path information missing in page.data for locale=${locale}, path=${requestedPath}`);
+            if (!page.path) {
+                console.error(`[LLMCopy] file path information missing in page data for locale=${locale}, path=${requestedPath}`);
                 return { error: 'Page file path information missing', status: 500 };
             }
-            const title = page.data.title;
-            const description = page.data.description;
-            const relativeMdxFilePath = page.data._file.path;
+            const title = page.title;
+            const description = page.description;
+            const relativeMdxFilePath = page.path;
             const absoluteFilePath = nodePath.join(process.cwd(), sourceDir, relativeMdxFilePath);
             console.log(`[LLMCopy] Attempting to read MDX content from: ${absoluteFilePath}`);
             let mdxContent;

package/dist/fuma/mdx/banner.d.ts

@@ -1,5 +1,5 @@
 import { type HTMLAttributes } from 'react';
-export declare function Banner({ id, variant, changeLayout, height, ...props }: HTMLAttributes<HTMLDivElement> & {
+export declare function Banner({ id, variant, changeLayout, height, floating, className, style, ...props }: HTMLAttributes<HTMLDivElement> & {
     /**
      * @defaultValue default is 3 rem
      */
@@ -14,4 +14,10 @@ export declare function Banner({ id, variant, changeLayout, height, ...props }:
      * @defaultValue true
      */
     changeLayout?: boolean;
+    /**
+     * Render the banner as a floating fixed element.
+     *
+     * @defaultValue true
+     */
+    floating?: boolean;
 }): import("react/jsx-runtime").JSX.Element | null;

package/dist/fuma/mdx/banner.js

@@ -1,7 +1,7 @@
 "use client";
 'use strict';
 
-var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
 var jsxRuntime = require('react/jsx-runtime');
 var index = require('../../node_modules/.pnpm/class-variance-authority@0.7.1/node_modules/class-variance-authority/dist/index.js');
 var React = require('react');
@@ -52,7 +52,7 @@ const rainbowLayer = (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRunti
             to { background-position: 100% 0;  }
          }` })] }));
 function Banner(_a) {
-    var { id, variant = 'rainbow', changeLayout = true, height = 3 } = _a, props = tslib_es6.__rest(_a, ["id", "variant", "changeLayout", "height"]);
+    var { id, variant = 'rainbow', changeLayout = true, height = 3, floating = true, className, style } = _a, props = tslib_es6.__rest(_a, ["id", "variant", "changeLayout", "height", "floating", "className", "style"]);
     const [open, setOpen] = React.useState(true);
     const globalKey = id ? `nd-banner-${id}` : null;
     const bannerHeight = `${height}rem`;
@@ -62,19 +62,19 @@ function Banner(_a) {
     }, [globalKey]);
     if (!open)
         return null;
-    return (jsxRuntime.jsxs("div", Object.assign({ id: id }, props, { className: utils.cn('flex flex-row items-center justify-center px-4 text-center text-sm font-medium', 'bg-neutral-100 dark:bg-neutral-900', !open && 'hidden', props.className), style: {
-            // 将 fuma.css 中的 .sticky.top-0.z-40 样式完全移到这里
-            position: 'fixed',
-            top: 0,
-            left: 0,
-            width: '100vw',
-            zIndex: 1001,
-            height: bannerHeight,
-            minHeight: bannerHeight,
-            maxHeight: bannerHeight,
-            margin: 0,
-            borderRadius: 0,
-        }, children: [globalKey ? (jsxRuntime.jsx("style", { children: `.${globalKey} #${id} { display: none; }` })) : null, globalKey ? (jsxRuntime.jsx("script", { dangerouslySetInnerHTML: {
+    return (jsxRuntime.jsxs("div", Object.assign({ id: id }, props, { className: utils.cn('flex flex-row items-center justify-center px-4 text-center text-sm font-medium', 'bg-neutral-100 dark:bg-neutral-900', !open && 'hidden', className), style: Object.assign(Object.assign({ height: bannerHeight, minHeight: bannerHeight, maxHeight: bannerHeight, margin: 0, borderRadius: 0, overflow: 'hidden' }, (floating
+            ? {
+                position: 'fixed',
+                top: 0,
+                left: 0,
+                width: '100vw',
+                zIndex: 1001,
+            }
+            : {
+                position: 'relative',
+                width: '100%',
+                zIndex: 0,
+            })), style), children: [globalKey ? (jsxRuntime.jsx("style", { children: `.${globalKey} #${id} { display: none; }` })) : null, globalKey ? (jsxRuntime.jsx("script", { dangerouslySetInnerHTML: {
                     __html: `if (localStorage.getItem('${globalKey}') === 'true') document.documentElement.classList.add('${globalKey}');`,
                 } })) : null, variant === 'rainbow' ? rainbowLayer : null, props.children, id ? (jsxRuntime.jsx("button", { type: "button", "aria-label": "Close Banner", onClick: () => {
                     setOpen(false);

package/dist/fuma/mdx/banner.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { __rest } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
+import { __rest } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { cva } from '../../node_modules/.pnpm/class-variance-authority@0.7.1/node_modules/class-variance-authority/dist/index.mjs';
 import { useState, useEffect } from 'react';
@@ -50,7 +50,7 @@ const rainbowLayer = (jsxs(Fragment, { children: [jsx("div", { className: "absol
             to { background-position: 100% 0;  }
          }` })] }));
 function Banner(_a) {
-    var { id, variant = 'rainbow', changeLayout = true, height = 3 } = _a, props = __rest(_a, ["id", "variant", "changeLayout", "height"]);
+    var { id, variant = 'rainbow', changeLayout = true, height = 3, floating = true, className, style } = _a, props = __rest(_a, ["id", "variant", "changeLayout", "height", "floating", "className", "style"]);
     const [open, setOpen] = useState(true);
     const globalKey = id ? `nd-banner-${id}` : null;
     const bannerHeight = `${height}rem`;
@@ -60,19 +60,19 @@ function Banner(_a) {
     }, [globalKey]);
     if (!open)
         return null;
-    return (jsxs("div", Object.assign({ id: id }, props, { className: cn('flex flex-row items-center justify-center px-4 text-center text-sm font-medium', 'bg-neutral-100 dark:bg-neutral-900', !open && 'hidden', props.className), style: {
-            // 将 fuma.css 中的 .sticky.top-0.z-40 样式完全移到这里
-            position: 'fixed',
-            top: 0,
-            left: 0,
-            width: '100vw',
-            zIndex: 1001,
-            height: bannerHeight,
-            minHeight: bannerHeight,
-            maxHeight: bannerHeight,
-            margin: 0,
-            borderRadius: 0,
-        }, children: [globalKey ? (jsx("style", { children: `.${globalKey} #${id} { display: none; }` })) : null, globalKey ? (jsx("script", { dangerouslySetInnerHTML: {
+    return (jsxs("div", Object.assign({ id: id }, props, { className: cn('flex flex-row items-center justify-center px-4 text-center text-sm font-medium', 'bg-neutral-100 dark:bg-neutral-900', !open && 'hidden', className), style: Object.assign(Object.assign({ height: bannerHeight, minHeight: bannerHeight, maxHeight: bannerHeight, margin: 0, borderRadius: 0, overflow: 'hidden' }, (floating
+            ? {
+                position: 'fixed',
+                top: 0,
+                left: 0,
+                width: '100vw',
+                zIndex: 1001,
+            }
+            : {
+                position: 'relative',
+                width: '100%',
+                zIndex: 0,
+            })), style), children: [globalKey ? (jsx("style", { children: `.${globalKey} #${id} { display: none; }` })) : null, globalKey ? (jsx("script", { dangerouslySetInnerHTML: {
                     __html: `if (localStorage.getItem('${globalKey}') === 'true') document.documentElement.classList.add('${globalKey}');`,
                 } })) : null, variant === 'rainbow' ? rainbowLayer : null, props.children, id ? (jsx("button", { type: "button", "aria-label": "Close Banner", onClick: () => {
                     setOpen(false);

package/dist/fuma/mdx/fuma-github-info.js

@@ -1,7 +1,7 @@
 "use client";
 'use strict';
 
-var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
 var jsxRuntime = require('react/jsx-runtime');
 var React = require('react');
 var server = require('@windrun-huaiin/base-ui/components/server');

package/dist/fuma/mdx/fuma-github-info.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
+import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { useState, useEffect } from 'react';
 import { globalLucideIcons } from '@windrun-huaiin/base-ui/components/server';

package/dist/fuma/mdx/gradient-button.js

@@ -1,9 +1,10 @@
 "use client";
 'use strict';
 
-var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
 var jsxRuntime = require('react/jsx-runtime');
 var ui = require('@windrun-huaiin/base-ui/ui');
+var utils = require('@windrun-huaiin/lib/utils');
 var server = require('@windrun-huaiin/base-ui/components/server');
 var Link = require('next/link');
 var React = require('react');
@@ -48,23 +49,33 @@ function GradientButton({ title, icon, align = 'left', disabled = false, classNa
     const isDisabled = disabled || isLoading;
     const displayTitle = isLoading ? actualLoadingText : title;
     // icon
-    const displayIcon = isLoading ? (jsxRuntime.jsx(server.globalLucideIcons.Loader2, { className: "h-4 w-4 text-white animate-spin" })) : icon ? (React.cloneElement(icon, {
-        className: "h-4 w-4 text-white"
-    })) : (jsxRuntime.jsx(server.globalLucideIcons.ArrowRight, { className: "h-4 w-4 text-white" }));
-    const buttonContent = onClick ? (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsx("span", { children: displayIcon }), jsxRuntime.jsx("span", { className: "ml-1", children: displayTitle })] })) : (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsx("span", { children: displayTitle }), jsxRuntime.jsx("span", { className: "ml-1", children: displayIcon })] }));
-    const buttonClassName = `
-    bg-gradient-to-r 
-    from-purple-400 to-pink-500 
-    hover:from-purple-500 hover:to-pink-600
-    dark:from-purple-500 dark:to-pink-600 
-    dark:hover:from-purple-600 dark:hover:to-pink-700
-    text-white text-base font-bold shadow-lg hover:shadow-xl
-    transition-all duration-300
-    rounded-full
-    ${isDisabled ? 'opacity-50 cursor-not-allowed' : ''}
-    ${className}
-  `;
-    return (jsxRuntime.jsx("div", { className: `flex flex-col sm:flex-row gap-3 ${getAlignmentClass()}`, children: onClick ? (
+    const iconProvided = icon !== undefined;
+    const iconNode = (() => {
+        if (isLoading) {
+            return jsxRuntime.jsx(server.globalLucideIcons.Loader2, { className: "h-4 w-4 text-white animate-spin" });
+        }
+        if (iconProvided) {
+            if (icon === null || icon === false) {
+                return null;
+            }
+            if (React.isValidElement(icon)) {
+                return React.cloneElement(icon, {
+                    className: utils.cn('h-4 w-4 text-white', icon.props.className),
+                });
+            }
+            return icon;
+        }
+        return jsxRuntime.jsx(server.globalLucideIcons.ArrowRight, { className: "h-4 w-4 text-white" });
+    })();
+    const shouldRenderIcon = iconNode !== null && iconNode !== undefined;
+    const buttonContent = onClick ? (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [shouldRenderIcon ? jsxRuntime.jsx("span", { children: iconNode }) : null, jsxRuntime.jsx("span", { className: utils.cn(shouldRenderIcon && 'ml-1'), children: displayTitle })] })) : (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsx("span", { children: displayTitle }), shouldRenderIcon ? jsxRuntime.jsx("span", { className: "ml-1", children: iconNode }) : null] }));
+    const alignmentClass = align === 'right'
+        ? 'justify-end'
+        : align === 'center'
+            ? 'justify-center'
+            : 'justify-start';
+    const buttonClassName = utils.cn('bg-gradient-to-r from-purple-400 to-pink-500 hover:from-purple-500 hover:to-pink-600 dark:from-purple-500 dark:to-pink-600 dark:hover:from-purple-600 dark:hover:to-pink-700 text-white text-base font-bold shadow-lg hover:shadow-xl transition-all duration-300 rounded-full', alignmentClass, isDisabled && 'opacity-50 cursor-not-allowed', className);
+    return (jsxRuntime.jsx("div", { className: `flex flex-row gap-3 ${getAlignmentClass()}`, children: onClick ? (
         // for click
         jsxRuntime.jsx(ui.Button, { size: "lg", className: buttonClassName, onClick: handleClick, disabled: isDisabled, children: buttonContent })) : (
         // for Link