@windrun-huaiin/third-ui 20.1.0 → 21.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 D8ger
+Copyright (c) 2025 D8ger
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/clerk/clerk-page-generator.d.ts

@@ -1,11 +1,3 @@
-/**
- * @license
- * MIT License
- * Copyright (c) 2026 D8ger
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
 export declare function createSignInPage(): () => import("react/jsx-runtime").JSX.Element;
 export declare function createSignUpPage(): () => import("react/jsx-runtime").JSX.Element;
 export declare function createWaitlistPage(): () => import("react/jsx-runtime").JSX.Element;

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

@@ -2,7 +2,7 @@ import { ReactNode, ReactElement } from 'react';
 import type { LLMCopyButtonProps, LLMCopyButton } from '@third-ui/fuma/mdx/toc-base';
 interface FumaPageParams {
     sourceKey: string;
-    mdxContentSource: any;
+    mdxContentSource: any | (() => Promise<any>);
     getMDXComponents: () => any;
     mdxSourceDir: string;
     githubBaseUrl?: string;
@@ -25,7 +25,7 @@ export declare function createFumaPage({ sourceKey, mdxContentSource, getMDXComp
             slug?: string[];
         }>;
     }) => Promise<import("react/jsx-runtime").JSX.Element>;
-    generateStaticParams: () => any;
+    generateStaticParams: () => Promise<any>;
     generateMetadata: (props: {
         params: Promise<{
             slug?: string[];

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

@@ -9,36 +9,49 @@ var lib = require('@windrun-huaiin/lib');
 var tocClerkPortable = require('./mdx/toc-clerk-portable.js');
 
 function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], showBreadcrumb = true, showTableOfContent = true, showTableOfContentPopover = false, localePrefixAsNeeded = true, defaultLocale = 'en', }) {
+    const getSource = () => tslib.__awaiter(this, void 0, void 0, function* () {
+        if (typeof mdxContentSource === 'function') {
+            return yield mdxContentSource();
+        }
+        return mdxContentSource;
+    });
     const Page = function Page(_a) {
         return tslib.__awaiter(this, arguments, void 0, function* ({ params }) {
-            var _b, _c, _d;
+            var _b, _c, _d, _e;
             const { slug, locale } = yield params;
-            const page$1 = mdxContentSource.getPage(slug, locale);
+            const source = yield getSource();
+            const page$1 = source.getPage(slug, locale);
             if (!page$1) {
-                console.log('[FumaPage] missing page', { slug, locale, available: (_d = (_c = (_b = mdxContentSource.pageTree) === null || _b === void 0 ? void 0 : _b[locale]) === null || _c === void 0 ? void 0 : _c.children) === null || _d === void 0 ? void 0 : _d.map((c) => c.url) });
+                console.log('[FumaPage] missing page', { slug, locale, available: (_d = (_c = (_b = source.pageTree) === null || _b === void 0 ? void 0 : _b[locale]) === null || _c === void 0 ? void 0 : _c.children) === null || _d === void 0 ? void 0 : _d.map((c) => c.url) });
                 return jsxRuntime.jsx(FallbackPage, { siteIcon: siteIcon });
             }
             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;
+            const content = typeof page$1.data.load === 'function'
+                ? yield page$1.data.load(getMDXComponents())
+                : {
+                    body: yield page$1.data.body({ components: getMDXComponents() }),
+                    toc: (_e = page$1.data.toc) !== null && _e !== void 0 ? _e : [],
+                };
             return (jsxRuntime.jsxs(page.DocsPage, { breadcrumb: { enabled: showBreadcrumb }, tableOfContent: {
                     enabled: showTableOfContent,
                     single: false,
-                    component: (jsxRuntime.jsx(tocClerkPortable.PortableClerkTOC, { toc: page$1.data.toc, footer: tocFooterElement })),
+                    component: (jsxRuntime.jsx(tocClerkPortable.PortableClerkTOC, { toc: content.toc, footer: tocFooterElement })),
                 }, tableOfContentPopover: {
                     enabled: false,
-                }, toc: page$1.data.toc, 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() }) })] }));
+                }, toc: content.toc, 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: content.body })] }));
         });
     };
     function generateStaticParams() {
-        return mdxContentSource.generateParams('slug', 'locale');
+        return getSource().then((source) => source.generateParams('slug', 'locale'));
     }
     function generateMetadata(props) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
             const { slug, locale } = yield props.params;
-            const page = mdxContentSource.getPage(slug, locale);
+            const source = yield getSource();
+            const page = source.getPage(slug, locale);
             if (!page) {
                 return {
                     title: '404 - Page Not Found',

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

@@ -7,36 +7,49 @@ import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
 import { PortableClerkTOC } from './mdx/toc-clerk-portable.mjs';
 
 function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], showBreadcrumb = true, showTableOfContent = true, showTableOfContentPopover = false, localePrefixAsNeeded = true, defaultLocale = 'en', }) {
+    const getSource = () => __awaiter(this, void 0, void 0, function* () {
+        if (typeof mdxContentSource === 'function') {
+            return yield mdxContentSource();
+        }
+        return mdxContentSource;
+    });
     const Page = function Page(_a) {
         return __awaiter(this, arguments, void 0, function* ({ params }) {
-            var _b, _c, _d;
+            var _b, _c, _d, _e;
             const { slug, locale } = yield params;
-            const page = mdxContentSource.getPage(slug, locale);
+            const source = yield getSource();
+            const page = source.getPage(slug, locale);
             if (!page) {
-                console.log('[FumaPage] missing page', { slug, locale, available: (_d = (_c = (_b = mdxContentSource.pageTree) === null || _b === void 0 ? void 0 : _b[locale]) === null || _c === void 0 ? void 0 : _c.children) === null || _d === void 0 ? void 0 : _d.map((c) => c.url) });
+                console.log('[FumaPage] missing page', { slug, locale, available: (_d = (_c = (_b = source.pageTree) === null || _b === void 0 ? void 0 : _b[locale]) === null || _c === void 0 ? void 0 : _c.children) === null || _d === void 0 ? void 0 : _d.map((c) => c.url) });
                 return jsx(FallbackPage, { siteIcon: siteIcon });
             }
             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;
+            const content = typeof page.data.load === 'function'
+                ? yield page.data.load(getMDXComponents())
+                : {
+                    body: yield page.data.body({ components: getMDXComponents() }),
+                    toc: (_e = page.data.toc) !== null && _e !== void 0 ? _e : [],
+                };
             return (jsxs(DocsPage, { breadcrumb: { enabled: showBreadcrumb }, tableOfContent: {
                     enabled: showTableOfContent,
                     single: false,
-                    component: (jsx(PortableClerkTOC, { toc: page.data.toc, footer: tocFooterElement })),
+                    component: (jsx(PortableClerkTOC, { toc: content.toc, footer: tocFooterElement })),
                 }, tableOfContentPopover: {
                     enabled: false,
-                }, toc: page.data.toc, 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() }) })] }));
+                }, toc: content.toc, 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: content.body })] }));
         });
     };
     function generateStaticParams() {
-        return mdxContentSource.generateParams('slug', 'locale');
+        return getSource().then((source) => source.generateParams('slug', 'locale'));
     }
     function generateMetadata(props) {
         return __awaiter(this, void 0, void 0, function* () {
             const { slug, locale } = yield props.params;
-            const page = mdxContentSource.getPage(slug, locale);
+            const source = yield getSource();
+            const page = source.getPage(slug, locale);
             if (!page) {
                 return {
                     title: '404 - Page Not Found',

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

@@ -11,6 +11,7 @@ var llmUtils = require('@windrun-huaiin/lib/llm-utils');
  */
 function LLMCopyHandler(options) {
     return tslib.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
         const { sourceDir, dataSource, requestedPath, locale } = options;
         // log received parameters
         console.log(`[LLMCopy] Received, locale=${locale}, path=${requestedPath}`);
@@ -28,8 +29,8 @@ function LLMCopyHandler(options) {
                 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.title;
-            const description = page.description;
+            const title = (_b = (_a = page.data) === null || _a === void 0 ? void 0 : _a.title) !== null && _b !== void 0 ? _b : page.title;
+            const description = (_d = (_c = page.data) === null || _c === void 0 ? void 0 : _c.description) !== null && _d !== void 0 ? _d : page.description;
             const relativeMdxFilePath = page.path;
             const absoluteFilePath = nodePath.join(process.cwd(), sourceDir, relativeMdxFilePath);
             console.log(`[LLMCopy] Attempting to read MDX content from: ${absoluteFilePath}`);

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

@@ -9,6 +9,7 @@ import { getLLMText } from '@windrun-huaiin/lib/llm-utils';
  */
 function LLMCopyHandler(options) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
         const { sourceDir, dataSource, requestedPath, locale } = options;
         // log received parameters
         console.log(`[LLMCopy] Received, locale=${locale}, path=${requestedPath}`);
@@ -26,8 +27,8 @@ function LLMCopyHandler(options) {
                 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.title;
-            const description = page.description;
+            const title = (_b = (_a = page.data) === null || _a === void 0 ? void 0 : _a.title) !== null && _b !== void 0 ? _b : page.title;
+            const description = (_d = (_c = page.data) === null || _c === void 0 ? void 0 : _c.description) !== null && _d !== void 0 ? _d : page.description;
             const relativeMdxFilePath = page.path;
             const absoluteFilePath = nodePath.join(process.cwd(), sourceDir, relativeMdxFilePath);
             console.log(`[LLMCopy] Attempting to read MDX content from: ${absoluteFilePath}`);

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

@@ -12,3 +12,4 @@ export * from './toc-clerk-portable';
 export * from './banner';
 export * from './suno-embed';
 export * from './markdown-component-map';
+export * from './math';

package/dist/fuma/mdx/index.js

@@ -15,6 +15,7 @@ var tocClerkPortable = require('./toc-clerk-portable.js');
 var banner = require('./banner.js');
 var sunoEmbed = require('./suno-embed.js');
 var markdownComponentMap = require('./markdown-component-map.js');
+var math = require('./math.js');
 
 
 
@@ -38,3 +39,5 @@ exports.PortableClerkTOCScrollArea = tocClerkPortable.PortableClerkTOCScrollArea
 exports.Banner = banner.Banner;
 exports.SunoEmbed = sunoEmbed.SunoEmbed;
 exports.baseMarkdownComponents = markdownComponentMap.baseMarkdownComponents;
+exports.InlineMath = math.InlineMath;
+exports.MathBlock = math.MathBlock;

package/dist/fuma/mdx/index.mjs

@@ -13,3 +13,4 @@ export { PortableClerkTOC, PortableClerkTOCItems, PortableClerkTOCPopover, Porta
 export { Banner } from './banner.mjs';
 export { SunoEmbed } from './suno-embed.mjs';
 export { baseMarkdownComponents } from './markdown-component-map.mjs';
+export { InlineMath, MathBlock } from './math.mjs';

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

@@ -0,0 +1,17 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+type MathSourceProps = {
+    children?: ReactNode;
+    math?: string;
+    formula?: string;
+};
+type Align = 'left' | 'center' | 'right';
+export type MathBlockProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & MathSourceProps & {
+    title?: ReactNode;
+    titleAlign?: Align;
+};
+export type InlineMathProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & MathSourceProps & {
+    align?: Align;
+};
+export declare function MathBlock({ title, titleAlign, children, math, formula, className, ...props }: MathBlockProps): import("react/jsx-runtime").JSX.Element;
+export declare function InlineMath({ children, math, formula, align, className, ...props }: InlineMathProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/fuma/mdx/math.js

@@ -0,0 +1,60 @@
+'use strict';
+
+var tslib = require('tslib');
+var jsxRuntime = require('react/jsx-runtime');
+var katex = require('katex');
+var utils = require('@windrun-huaiin/lib/utils');
+
+const alignClassMap = {
+    left: 'text-left justify-start',
+    center: 'text-center justify-center',
+    right: 'text-right justify-end',
+};
+const textAlignClassMap = {
+    left: 'text-left',
+    center: 'text-center',
+    right: 'text-right',
+};
+function getMathSource({ children, math, formula }) {
+    if (typeof math === 'string' && math.trim() !== '')
+        return math.trim();
+    if (typeof formula === 'string' && formula.trim() !== '')
+        return formula.trim();
+    if (typeof children === 'string' && children.trim() !== '')
+        return children.trim();
+    if (Array.isArray(children)) {
+        const text = children
+            .map((item) => (typeof item === 'string' ? item : ''))
+            .join('')
+            .trim();
+        if (text !== '')
+            return text;
+    }
+    return '';
+}
+function renderMath(source, displayMode) {
+    if (source === '')
+        return '';
+    return katex.renderToString(source, {
+        displayMode,
+        throwOnError: false,
+        output: 'html',
+        strict: 'ignore',
+        trust: false,
+    });
+}
+function MathBlock(_a) {
+    var { title, titleAlign = 'center', children, math, formula, className } = _a, props = tslib.__rest(_a, ["title", "titleAlign", "children", "math", "formula", "className"]);
+    const source = getMathSource({ children, math, formula });
+    const html = renderMath(source, true);
+    return (jsxRuntime.jsxs("div", Object.assign({}, props, { className: utils.cn('not-prose my-6 overflow-x-auto rounded-xl border bg-fd-card p-4 text-fd-card-foreground', className), children: [title ? (jsxRuntime.jsx("div", { className: utils.cn('mb-3 text-sm font-medium text-fd-muted-foreground', alignClassMap[titleAlign].split(' ')[0]), children: title })) : null, html ? (jsxRuntime.jsx("div", { className: "min-w-fit [&_.katex-display]:my-0 [&_.katex-display]:overflow-x-auto [&_.katex-display]:overflow-y-hidden", dangerouslySetInnerHTML: { __html: html } })) : (jsxRuntime.jsx("div", { className: "text-sm text-fd-muted-foreground", children: "Empty math block." }))] })));
+}
+function InlineMath(_a) {
+    var { children, math, formula, align = 'center', className } = _a, props = tslib.__rest(_a, ["children", "math", "formula", "align", "className"]);
+    const source = getMathSource({ children, math, formula });
+    const html = renderMath(source, false);
+    return (jsxRuntime.jsx("span", Object.assign({}, props, { className: utils.cn('mx-1 inline-flex max-w-full align-middle rounded-md bg-neutral-200 px-2 py-0.5 text-sm leading-none dark:bg-white/20 [&_.katex]:text-inherit', textAlignClassMap[align], className), children: jsxRuntime.jsx("span", { dangerouslySetInnerHTML: { __html: html } }) })));
+}
+
+exports.InlineMath = InlineMath;
+exports.MathBlock = MathBlock;

package/dist/fuma/mdx/math.mjs

@@ -0,0 +1,57 @@
+import { __rest } from 'tslib';
+import { jsxs, jsx } from 'react/jsx-runtime';
+import katex from 'katex';
+import { cn } from '@windrun-huaiin/lib/utils';
+
+const alignClassMap = {
+    left: 'text-left justify-start',
+    center: 'text-center justify-center',
+    right: 'text-right justify-end',
+};
+const textAlignClassMap = {
+    left: 'text-left',
+    center: 'text-center',
+    right: 'text-right',
+};
+function getMathSource({ children, math, formula }) {
+    if (typeof math === 'string' && math.trim() !== '')
+        return math.trim();
+    if (typeof formula === 'string' && formula.trim() !== '')
+        return formula.trim();
+    if (typeof children === 'string' && children.trim() !== '')
+        return children.trim();
+    if (Array.isArray(children)) {
+        const text = children
+            .map((item) => (typeof item === 'string' ? item : ''))
+            .join('')
+            .trim();
+        if (text !== '')
+            return text;
+    }
+    return '';
+}
+function renderMath(source, displayMode) {
+    if (source === '')
+        return '';
+    return katex.renderToString(source, {
+        displayMode,
+        throwOnError: false,
+        output: 'html',
+        strict: 'ignore',
+        trust: false,
+    });
+}
+function MathBlock(_a) {
+    var { title, titleAlign = 'center', children, math, formula, className } = _a, props = __rest(_a, ["title", "titleAlign", "children", "math", "formula", "className"]);
+    const source = getMathSource({ children, math, formula });
+    const html = renderMath(source, true);
+    return (jsxs("div", Object.assign({}, props, { className: cn('not-prose my-6 overflow-x-auto rounded-xl border bg-fd-card p-4 text-fd-card-foreground', className), children: [title ? (jsx("div", { className: cn('mb-3 text-sm font-medium text-fd-muted-foreground', alignClassMap[titleAlign].split(' ')[0]), children: title })) : null, html ? (jsx("div", { className: "min-w-fit [&_.katex-display]:my-0 [&_.katex-display]:overflow-x-auto [&_.katex-display]:overflow-y-hidden", dangerouslySetInnerHTML: { __html: html } })) : (jsx("div", { className: "text-sm text-fd-muted-foreground", children: "Empty math block." }))] })));
+}
+function InlineMath(_a) {
+    var { children, math, formula, align = 'center', className } = _a, props = __rest(_a, ["children", "math", "formula", "align", "className"]);
+    const source = getMathSource({ children, math, formula });
+    const html = renderMath(source, false);
+    return (jsx("span", Object.assign({}, props, { className: cn('mx-1 inline-flex max-w-full align-middle rounded-md bg-neutral-200 px-2 py-0.5 text-sm leading-none dark:bg-white/20 [&_.katex]:text-inherit', textAlignClassMap[align], className), children: jsx("span", { dangerouslySetInnerHTML: { __html: html } }) })));
+}
+
+export { InlineMath, MathBlock };

package/dist/fuma/mdx/zia-card.js

@@ -12,7 +12,7 @@ function ZiaCard(_a) {
     const validHref = typeof props.href === 'string' && props.href.trim() !== '';
     const validDescription = typeof description === 'string' && (description === null || description === void 0 ? void 0 : description.trim()) !== '';
     if (validHref) {
-        return (jsxRuntime.jsxs(Link, Object.assign({ href: props.href, "data-card": true, className: utils.cn('block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full', 'hover:bg-fd-accent/80', props.className) }, props, { children: [jsxRuntime.jsx("div", { className: "not-prose mb-2 w-fit rounded-md border bg-fd-muted p-1.5 text-fd-muted-foreground [&_svg]:size-4", children: icon ? icon : jsxRuntime.jsx(icons.CircleSmallIcon, {}) }), jsxRuntime.jsx("h3", { className: "not-prose mb-1 text-sm font-medium line-clamp-2 min-h-10", children: title }), validDescription ? (jsxRuntime.jsx("p", { className: "my-0! text-sm text-fd-muted-foreground", children: description })) : (jsxRuntime.jsx("p", { className: "my-0! text-sm text-fd-muted-foreground opacity-0 select-none", children: "\u00A0" })), props.children ? (jsxRuntime.jsx("div", { className: "text-sm text-fd-muted-foreground prose-no-margin", children: props.children })) : null] })));
+        return (jsxRuntime.jsxs(Link, Object.assign({ href: props.href, prefetch: false, "data-card": true, className: utils.cn('block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full', 'hover:bg-fd-accent/80', props.className) }, props, { children: [jsxRuntime.jsx("div", { className: "not-prose mb-2 w-fit rounded-md border bg-fd-muted p-1.5 text-fd-muted-foreground [&_svg]:size-4", children: icon ? icon : jsxRuntime.jsx(icons.CircleSmallIcon, {}) }), jsxRuntime.jsx("h3", { className: "not-prose mb-1 text-sm font-medium line-clamp-2 min-h-10", children: title }), validDescription ? (jsxRuntime.jsx("p", { className: "my-0! text-sm text-fd-muted-foreground", children: description })) : (jsxRuntime.jsx("p", { className: "my-0! text-sm text-fd-muted-foreground opacity-0 select-none", children: "\u00A0" })), props.children ? (jsxRuntime.jsx("div", { className: "text-sm text-fd-muted-foreground prose-no-margin", children: props.children })) : null] })));
     }
     return (jsxRuntime.jsxs("div", Object.assign({ "data-card": true, className: utils.cn('block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full', props.className) }, props, { children: [jsxRuntime.jsx("div", { className: "not-prose mb-2 w-fit rounded-md border bg-fd-muted p-1.5 text-fd-muted-foreground [&_svg]:size-4", children: icon ? icon : jsxRuntime.jsx(icons.CircleSmallIcon, {}) }), jsxRuntime.jsx("h3", { className: "not-prose mb-1 text-sm font-medium line-clamp-2 min-h-10", children: title }), validDescription ? (jsxRuntime.jsx("p", { className: "my-0! text-sm text-fd-muted-foreground", children: description })) : (jsxRuntime.jsx("p", { className: "my-0! text-sm text-fd-muted-foreground opacity-0 select-none", children: "\u00A0" })), props.children ? (jsxRuntime.jsx("div", { className: "text-sm text-fd-muted-foreground prose-no-margin", children: props.children })) : null] })));
 }

package/dist/fuma/mdx/zia-card.mjs

@@ -10,7 +10,7 @@ function ZiaCard(_a) {
     const validHref = typeof props.href === 'string' && props.href.trim() !== '';
     const validDescription = typeof description === 'string' && (description === null || description === void 0 ? void 0 : description.trim()) !== '';
     if (validHref) {
-        return (jsxs(Link, Object.assign({ href: props.href, "data-card": true, className: cn('block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full', 'hover:bg-fd-accent/80', props.className) }, props, { children: [jsx("div", { className: "not-prose mb-2 w-fit rounded-md border bg-fd-muted p-1.5 text-fd-muted-foreground [&_svg]:size-4", children: icon ? icon : jsx(CircleSmallIcon, {}) }), jsx("h3", { className: "not-prose mb-1 text-sm font-medium line-clamp-2 min-h-10", children: title }), validDescription ? (jsx("p", { className: "my-0! text-sm text-fd-muted-foreground", children: description })) : (jsx("p", { className: "my-0! text-sm text-fd-muted-foreground opacity-0 select-none", children: "\u00A0" })), props.children ? (jsx("div", { className: "text-sm text-fd-muted-foreground prose-no-margin", children: props.children })) : null] })));
+        return (jsxs(Link, Object.assign({ href: props.href, prefetch: false, "data-card": true, className: cn('block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full', 'hover:bg-fd-accent/80', props.className) }, props, { children: [jsx("div", { className: "not-prose mb-2 w-fit rounded-md border bg-fd-muted p-1.5 text-fd-muted-foreground [&_svg]:size-4", children: icon ? icon : jsx(CircleSmallIcon, {}) }), jsx("h3", { className: "not-prose mb-1 text-sm font-medium line-clamp-2 min-h-10", children: title }), validDescription ? (jsx("p", { className: "my-0! text-sm text-fd-muted-foreground", children: description })) : (jsx("p", { className: "my-0! text-sm text-fd-muted-foreground opacity-0 select-none", children: "\u00A0" })), props.children ? (jsx("div", { className: "text-sm text-fd-muted-foreground prose-no-margin", children: props.children })) : null] })));
     }
     return (jsxs("div", Object.assign({ "data-card": true, className: cn('block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full', props.className) }, props, { children: [jsx("div", { className: "not-prose mb-2 w-fit rounded-md border bg-fd-muted p-1.5 text-fd-muted-foreground [&_svg]:size-4", children: icon ? icon : jsx(CircleSmallIcon, {}) }), jsx("h3", { className: "not-prose mb-1 text-sm font-medium line-clamp-2 min-h-10", children: title }), validDescription ? (jsx("p", { className: "my-0! text-sm text-fd-muted-foreground", children: description })) : (jsx("p", { className: "my-0! text-sm text-fd-muted-foreground opacity-0 select-none", children: "\u00A0" })), props.children ? (jsx("div", { className: "text-sm text-fd-muted-foreground prose-no-margin", children: props.children })) : null] })));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "20.1.0",
+  "version": "21.0.0",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -102,9 +102,9 @@
     "tslib": "^2.8.1",
     "unified": "^11.0.5",
     "zod": "^4.3.6",
-    "@windrun-huaiin/base-ui": "^20.1.0",
-    "@windrun-huaiin/contracts": "^20.0.0",
-    "@windrun-huaiin/lib": "^20.0.0"
+    "@windrun-huaiin/lib": "^21.0.0",
+    "@windrun-huaiin/base-ui": "^21.0.0",
+    "@windrun-huaiin/contracts": "^21.0.0"
   },
   "peerDependencies": {
     "clsx": "^2.1.1",

package/src/clerk/clerk-page-generator.tsx

@@ -1,12 +1,3 @@
-/**
- * @license
- * MIT License
- * Copyright (c) 2026 D8ger
- * 
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
 import { SignIn, SignUp, Waitlist } from '@clerk/nextjs';
 
 // Legacy page generators (for backward compatibility)

package/src/fuma/fuma-page-genarator.tsx

@@ -13,7 +13,7 @@ interface FumaPageParams {
   /* 
    * The source of the mdx content
    */
-  mdxContentSource: any;
+  mdxContentSource: any | (() => Promise<any>);
   /* 
    * The  mdx components handler, refer to fumadocs 
    */
@@ -81,11 +81,20 @@ export function createFumaPage({
   localePrefixAsNeeded = true,
   defaultLocale = 'en',
 }: FumaPageParams) {
+  const getSource = async () => {
+    if (typeof mdxContentSource === 'function') {
+      return await mdxContentSource();
+    }
+
+    return mdxContentSource;
+  };
+
   const Page = async function Page({ params }: { params: Promise<{ locale: string; slug?: string[] }> }) {
     const { slug, locale } = await params;
-    const page = mdxContentSource.getPage(slug, locale);
+    const source = await getSource();
+    const page = source.getPage(slug, locale);
     if (!page) {
-      console.log('[FumaPage] missing page', { slug, locale, available: mdxContentSource.pageTree?.[locale]?.children?.map((c: any) => c.url) });
+      console.log('[FumaPage] missing page', { slug, locale, available: source.pageTree?.[locale]?.children?.map((c: any) => c.url) });
       return <FallbackPage siteIcon={siteIcon} />;
     }
 
@@ -103,7 +112,14 @@ export function createFumaPage({
       />
     );
 
-    const MDX = page.data.body;
+    const content =
+      typeof page.data.load === 'function'
+        ? await page.data.load(getMDXComponents())
+        : {
+            body: await page.data.body({ components: getMDXComponents() }),
+            toc: page.data.toc ?? [],
+          };
+
     return (
       <DocsPage
         breadcrumb={{enabled: showBreadcrumb}}
@@ -112,7 +128,7 @@ export function createFumaPage({
           single: false,
           component: (
             <PortableClerkTOC
-              toc={page.data.toc}
+              toc={content.toc}
               footer={tocFooterElement}
             />
           ),
@@ -120,25 +136,26 @@ export function createFumaPage({
         tableOfContentPopover={{
           enabled: false,
         }}
-        toc={page.data.toc}
+        toc={content.toc}
         article={{ className: 'max-sm:pb-16' }}
       >
         <DocsTitle>{page.data.title}</DocsTitle>
         <DocsDescription className="mb-2">{page.data.description}</DocsDescription>
         <DocsBody className="text-fd-foreground/80">
-          <MDX components={getMDXComponents()} />
+          {content.body}
         </DocsBody>
       </DocsPage>
     );
   };
 
   function generateStaticParams() {
-    return mdxContentSource.generateParams('slug', 'locale');
+    return getSource().then((source) => source.generateParams('slug', 'locale'));
   }
 
   async function generateMetadata(props: { params: Promise<{ slug?: string[]; locale?: string }> }) {
     const { slug, locale } = await props.params;
-    const page = mdxContentSource.getPage(slug, locale);
+    const source = await getSource();
+    const page = source.getPage(slug, locale);
     if (!page) {
       return {
         title: '404 - Page Not Found',

package/src/fuma/llm-copy-handler.ts

@@ -42,8 +42,8 @@ export async function LLMCopyHandler(options: LLMCopyHandlerOptions): Promise<{
       return { error: 'Page file path information missing', status: 500 };
     }
 
-    const title = page.title;
-    const description = page.description;
+    const title = page.data?.title ?? page.title;
+    const description = page.data?.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}`);
@@ -90,4 +90,4 @@ export async function LLMCopyHandler(options: LLMCopyHandlerOptions): Promise<{
     console.error('[LLMCopy] General Error object details:', JSON.stringify(error, Object.getOwnPropertyNames(error), 2));
     return { error: 'Internal Server Error', status: 500 };
   }
-} 
+} 

package/src/fuma/mdx/index.ts

@@ -14,3 +14,4 @@ export * from './toc-clerk-portable';
 export * from './banner';
 export * from './suno-embed';
 export * from './markdown-component-map';
+export * from './math';

package/src/fuma/mdx/math.tsx

@@ -0,0 +1,130 @@
+import katex from 'katex';
+import { cn } from '@windrun-huaiin/lib/utils';
+import type { HTMLAttributes, ReactNode } from 'react';
+
+type MathSourceProps = {
+  children?: ReactNode;
+  math?: string;
+  formula?: string;
+};
+
+type Align = 'left' | 'center' | 'right';
+
+export type MathBlockProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> &
+  MathSourceProps & {
+    title?: ReactNode;
+    titleAlign?: Align;
+  };
+
+export type InlineMathProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> &
+  MathSourceProps & {
+    align?: Align;
+  };
+
+const alignClassMap: Record<Align, string> = {
+  left: 'text-left justify-start',
+  center: 'text-center justify-center',
+  right: 'text-right justify-end',
+};
+
+const textAlignClassMap: Record<Align, string> = {
+  left: 'text-left',
+  center: 'text-center',
+  right: 'text-right',
+};
+
+function getMathSource({ children, math, formula }: MathSourceProps): string {
+  if (typeof math === 'string' && math.trim() !== '') return math.trim();
+  if (typeof formula === 'string' && formula.trim() !== '') return formula.trim();
+  if (typeof children === 'string' && children.trim() !== '') return children.trim();
+
+  if (Array.isArray(children)) {
+    const text = children
+      .map((item) => (typeof item === 'string' ? item : ''))
+      .join('')
+      .trim();
+
+    if (text !== '') return text;
+  }
+
+  return '';
+}
+
+function renderMath(source: string, displayMode: boolean) {
+  if (source === '') return '';
+
+  return katex.renderToString(source, {
+    displayMode,
+    throwOnError: false,
+    output: 'html',
+    strict: 'ignore',
+    trust: false,
+  });
+}
+
+export function MathBlock({
+  title,
+  titleAlign = 'center',
+  children,
+  math,
+  formula,
+  className,
+  ...props
+}: MathBlockProps) {
+  const source = getMathSource({ children, math, formula });
+  const html = renderMath(source, true);
+
+  return (
+    <div
+      {...props}
+      className={cn(
+        'not-prose my-6 overflow-x-auto rounded-xl border bg-fd-card p-4 text-fd-card-foreground',
+        className,
+      )}
+    >
+      {title ? (
+        <div
+          className={cn(
+            'mb-3 text-sm font-medium text-fd-muted-foreground',
+            alignClassMap[titleAlign].split(' ')[0],
+          )}
+        >
+          {title}
+        </div>
+      ) : null}
+      {html ? (
+        <div
+          className="min-w-fit [&_.katex-display]:my-0 [&_.katex-display]:overflow-x-auto [&_.katex-display]:overflow-y-hidden"
+          dangerouslySetInnerHTML={{ __html: html }}
+        />
+      ) : (
+        <div className="text-sm text-fd-muted-foreground">Empty math block.</div>
+      )}
+    </div>
+  );
+}
+
+export function InlineMath({
+  children,
+  math,
+  formula,
+  align = 'center',
+  className,
+  ...props
+}: InlineMathProps) {
+  const source = getMathSource({ children, math, formula });
+  const html = renderMath(source, false);
+
+  return (
+    <span
+      {...props}
+      className={cn(
+        'mx-1 inline-flex max-w-full align-middle rounded-md bg-neutral-200 px-2 py-0.5 text-sm leading-none dark:bg-white/20 [&_.katex]:text-inherit',
+        textAlignClassMap[align],
+        className,
+      )}
+    >
+      <span dangerouslySetInnerHTML={{ __html: html }} />
+    </span>
+  );
+}

package/src/fuma/mdx/zia-card.tsx

@@ -22,6 +22,7 @@ export function ZiaCard({ icon, title, description, ...props }: ZiaCardProps) {
     return (
       <Link
         href={props.href!}
+        prefetch={false}
         data-card
         className={cn(
           'block rounded-lg border bg-fd-card p-4 text-fd-card-foreground shadow-md transition-colors @max-lg:col-span-full',

package/src/main/language-detector.tsx

@@ -1,11 +1,3 @@
-/**
- * @license
- * MIT License
- * Copyright (c) 2026 D8ger
- * 
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
 'use client'
 
 import { XIcon } from "@windrun-huaiin/base-ui/icons"

package/dist/main/ads-alert-dialog.d.ts

@@ -1,15 +0,0 @@
-import React from "react";
-interface AdsAlertDialogProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    title: React.ReactNode;
-    description: React.ReactNode;
-    imgSrc?: string;
-    imgHref?: string;
-    onCancel?: () => void;
-    cancelText?: string;
-    confirmText?: string;
-    onConfirm?: () => void;
-}
-export declare function AdsAlertDialog({ open, onOpenChange, title, description, imgSrc, imgHref, cancelText, onCancel, confirmText, onConfirm, }: AdsAlertDialogProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/main/ads-alert-dialog.js

@@ -1,21 +0,0 @@
-"use client";
-'use strict';
-
-var jsxRuntime = require('react/jsx-runtime');
-var React = require('react');
-var Image = require('next/image');
-var icons = require('@windrun-huaiin/base-ui/icons');
-var ui = require('@windrun-huaiin/base-ui/ui');
-
-function AdsAlertDialog({ open, onOpenChange, title, description, imgSrc, imgHref, cancelText, onCancel, confirmText, onConfirm, }) {
-    const [imgError, setImgError] = React.useState(false);
-    return (jsxRuntime.jsx(ui.AlertDialog, { open: open, onOpenChange: onOpenChange, children: jsxRuntime.jsxs(ui.AlertDialogContent, { className: "fixed left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 bg-white dark:bg-neutral-900 rounded-2xl shadow-2xl border border-neutral-200 dark:border-neutral-700 max-w-md w-full min-w-[320px] p-4 flex flex-col items-stretch", children: [jsxRuntime.jsxs("div", { className: "flex flex-row items-center justify-between mb-2", children: [jsxRuntime.jsx(ui.AlertDialogTitle, { asChild: true, children: jsxRuntime.jsxs("div", { className: "flex flex-row items-center gap-1 min-w-0 text-xl font-semibold", children: [jsxRuntime.jsx(icons.InfoIcon, { className: "w-5 h-5" }), jsxRuntime.jsx("span", { className: "truncate", children: title })] }) }), jsxRuntime.jsx("button", { className: "text-neutral-400 hover:text-neutral-700 dark:hover:text-neutral-200 text-xl ml-4", onClick: () => onOpenChange(false), "aria-label": "Close", tabIndex: 0, children: jsxRuntime.jsx(icons.XIcon, { className: "w-5 h-5" }) })] }), jsxRuntime.jsx(ui.AlertDialogDescription, { className: "text-base font-medium text-neutral-800 dark:text-neutral-100 mb-2", children: description }), imgSrc && (jsxRuntime.jsx("div", { className: "w-full max-w-[400px] h-[220px] relative flex items-center justify-center mb-2", children: imgError ? (jsxRuntime.jsxs("div", { className: "absolute inset-0 flex flex-col items-center justify-center bg-gray-100 dark:bg-neutral-800 border border-dashed border-neutral-300 dark:border-neutral-700 rounded-lg text-neutral-400 text-sm", children: [jsxRuntime.jsx(icons.ImageOffIcon, { className: "w-12 h-12 mb-2" }), jsxRuntime.jsx("span", { children: "Image loading failed" })] })) : imgHref ? (jsxRuntime.jsx("a", { href: imgHref, target: "_blank", rel: "noopener noreferrer", className: "block w-full h-full", children: jsxRuntime.jsx(Image, { src: imgSrc, alt: "image", fill: true, className: "object-contain rounded-lg", priority: false, placeholder: "empty", unoptimized: true, onError: () => setImgError(true), sizes: "(max-width: 400px) 100vw, 400px" }) })) : (jsxRuntime.jsx(Image, { src: imgSrc, alt: "image", fill: true, className: "object-contain rounded-lg", priority: false, placeholder: "empty", unoptimized: true, onError: () => setImgError(true), sizes: "(max-width: 400px) 100vw, 400px" })) })), (cancelText || confirmText) && (jsxRuntime.jsxs("div", { className: "flex justify-end gap-2 mt-2", children: [cancelText && (jsxRuntime.jsx("button", { onClick: () => {
-                                onOpenChange(false);
-                                onCancel === null || onCancel === void 0 ? void 0 : onCancel();
-                            }, className: "px-6 py-2 rounded-lg border border-neutral-300 dark:border-neutral-600 bg-white dark:bg-neutral-800 text-neutral-700 dark:text-neutral-200 font-semibold hover:bg-neutral-100 dark:hover:bg-neutral-700 transition", children: cancelText })), confirmText && (jsxRuntime.jsx(ui.AlertDialogAction, { onClick: () => {
-                                onOpenChange(false);
-                                onConfirm === null || onConfirm === void 0 ? void 0 : onConfirm();
-                            }, className: "px-6 py-2 rounded-lg bg-purple-500 text-white font-semibold hover:bg-purple-600 transition", children: confirmText }))] }))] }) }));
-}
-
-exports.AdsAlertDialog = AdsAlertDialog;

package/dist/main/ads-alert-dialog.mjs

@@ -1,19 +0,0 @@
-"use client";
-import { jsx, jsxs } from 'react/jsx-runtime';
-import { useState } from 'react';
-import Image from 'next/image';
-import { InfoIcon, XIcon, ImageOffIcon } from '@windrun-huaiin/base-ui/icons';
-import { AlertDialog, AlertDialogContent, AlertDialogTitle, AlertDialogDescription, AlertDialogAction } from '@windrun-huaiin/base-ui/ui';
-
-function AdsAlertDialog({ open, onOpenChange, title, description, imgSrc, imgHref, cancelText, onCancel, confirmText, onConfirm, }) {
-    const [imgError, setImgError] = useState(false);
-    return (jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: jsxs(AlertDialogContent, { className: "fixed left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 bg-white dark:bg-neutral-900 rounded-2xl shadow-2xl border border-neutral-200 dark:border-neutral-700 max-w-md w-full min-w-[320px] p-4 flex flex-col items-stretch", children: [jsxs("div", { className: "flex flex-row items-center justify-between mb-2", children: [jsx(AlertDialogTitle, { asChild: true, children: jsxs("div", { className: "flex flex-row items-center gap-1 min-w-0 text-xl font-semibold", children: [jsx(InfoIcon, { className: "w-5 h-5" }), jsx("span", { className: "truncate", children: title })] }) }), jsx("button", { className: "text-neutral-400 hover:text-neutral-700 dark:hover:text-neutral-200 text-xl ml-4", onClick: () => onOpenChange(false), "aria-label": "Close", tabIndex: 0, children: jsx(XIcon, { className: "w-5 h-5" }) })] }), jsx(AlertDialogDescription, { className: "text-base font-medium text-neutral-800 dark:text-neutral-100 mb-2", children: description }), imgSrc && (jsx("div", { className: "w-full max-w-[400px] h-[220px] relative flex items-center justify-center mb-2", children: imgError ? (jsxs("div", { className: "absolute inset-0 flex flex-col items-center justify-center bg-gray-100 dark:bg-neutral-800 border border-dashed border-neutral-300 dark:border-neutral-700 rounded-lg text-neutral-400 text-sm", children: [jsx(ImageOffIcon, { className: "w-12 h-12 mb-2" }), jsx("span", { children: "Image loading failed" })] })) : imgHref ? (jsx("a", { href: imgHref, target: "_blank", rel: "noopener noreferrer", className: "block w-full h-full", children: jsx(Image, { src: imgSrc, alt: "image", fill: true, className: "object-contain rounded-lg", priority: false, placeholder: "empty", unoptimized: true, onError: () => setImgError(true), sizes: "(max-width: 400px) 100vw, 400px" }) })) : (jsx(Image, { src: imgSrc, alt: "image", fill: true, className: "object-contain rounded-lg", priority: false, placeholder: "empty", unoptimized: true, onError: () => setImgError(true), sizes: "(max-width: 400px) 100vw, 400px" })) })), (cancelText || confirmText) && (jsxs("div", { className: "flex justify-end gap-2 mt-2", children: [cancelText && (jsx("button", { onClick: () => {
-                                onOpenChange(false);
-                                onCancel === null || onCancel === void 0 ? void 0 : onCancel();
-                            }, className: "px-6 py-2 rounded-lg border border-neutral-300 dark:border-neutral-600 bg-white dark:bg-neutral-800 text-neutral-700 dark:text-neutral-200 font-semibold hover:bg-neutral-100 dark:hover:bg-neutral-700 transition", children: cancelText })), confirmText && (jsx(AlertDialogAction, { onClick: () => {
-                                onOpenChange(false);
-                                onConfirm === null || onConfirm === void 0 ? void 0 : onConfirm();
-                            }, className: "px-6 py-2 rounded-lg bg-purple-500 text-white font-semibold hover:bg-purple-600 transition", children: confirmText }))] }))] }) }));
-}
-
-export { AdsAlertDialog };