@windrun-huaiin/third-ui 11.1.0 → 12.0.0

package/dist/lib/seo-util.mjs

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
 
 /**
  * Generate robots.txt content
@@ -21,9 +22,11 @@ function generateRobots(baseUrl) {
  * @param locales - Supported locales array
  * @param mdxSourceDir - MDX source directory path
  * @param openMdxSEOSiteMap - Whether to include MDX content in sitemap, default is true
+ * @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+ * @param defaultLocale - The default locale for the application (default: 'en')
  * @returns Sitemap entries
  */
-function generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap = true) {
+function generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap = true, localPrefixAsNeeded = true, defaultLocale = 'en') {
     // 2. handle index.mdx (blog start page) and other slugs
     const blogRoutes = [];
     // 1. read all blog mdx file names with error handling
@@ -36,8 +39,9 @@ function generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap = tru
                 for (const locale of locales) {
                     for (const f of blogFiles) {
                         if (f === 'index.mdx') {
+                            const localizedPath = getAsNeededLocalizedUrl(locale, '/blog', localPrefixAsNeeded, defaultLocale);
                             blogRoutes.push({
-                                url: `${baseUrl}/${locale}/blog`,
+                                url: `${baseUrl}${localizedPath}`,
                                 lastModified: new Date(),
                                 changeFrequency: 'daily',
                                 priority: 1.0
@@ -45,8 +49,9 @@ function generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap = tru
                         }
                         else {
                             const slug = f.replace(/\.mdx$/, '');
+                            const localizedPath = getAsNeededLocalizedUrl(locale, `/blog/${slug}`, localPrefixAsNeeded, defaultLocale);
                             blogRoutes.push({
-                                url: `${baseUrl}/${locale}/blog/${slug}`,
+                                url: `${baseUrl}${localizedPath}`,
                                 lastModified: new Date(),
                                 changeFrequency: f === 'ioc.mdx' ? 'daily' : 'monthly',
                                 priority: 0.8
@@ -62,12 +67,15 @@ function generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap = tru
         }
     }
     // 3. main page (all language versions)
-    const mainRoutes = locales.map(locale => ({
-        url: `${baseUrl}/${locale}`,
-        lastModified: new Date(),
-        changeFrequency: 'weekly',
-        priority: 1.0
-    }));
+    const mainRoutes = locales.map(locale => {
+        const localizedPath = getAsNeededLocalizedUrl(locale, '/', localPrefixAsNeeded, defaultLocale);
+        return {
+            url: `${baseUrl}${localizedPath}`,
+            lastModified: new Date(),
+            changeFrequency: 'weekly',
+            priority: 1.0
+        };
+    });
     return openMdxSEOSiteMap ? [...mainRoutes, ...blogRoutes] : [...mainRoutes];
 }
 /**
@@ -86,12 +94,14 @@ function createRobotsHandler(baseUrl) {
  * @param locales - Supported locales array
  * @param mdxSourceDir - MDX source directory path, default is empty
  * @param openMdxSEOSiteMap - Whether to include MDX content in sitemap, default is true
+ * @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+ * @param defaultLocale - The default locale for the application (default: 'en')
  * @returns Sitemap handler function
  */
-function createSitemapHandler(baseUrl, locales, mdxSourceDir = '', openMdxSEOSiteMap = true) {
+function createSitemapHandler(baseUrl, locales, mdxSourceDir = '', openMdxSEOSiteMap = true, localPrefixAsNeeded = true, defaultLocale = 'en') {
     // force static generation
     const sitemapHandler = function sitemap() {
-        return generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap);
+        return generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap, localPrefixAsNeeded, defaultLocale);
     };
     // Add static generation directive
     sitemapHandler.dynamic = 'force-static';

package/dist/main/credit/credit-overview-client.js

@@ -231,9 +231,9 @@ function CreditOverviewClient({ data, locale, translations, className, expiringS
         userToggledRef.current = true;
         setBucketExpanded(true);
     }, []);
-    return (jsxRuntime.jsxs("section", { className: utils.cn("flex flex-col gap-2 p-2 shadow-inner rounded-xl bg-white dark:bg-slate-900", className), children: [jsxRuntime.jsxs("header", { className: "relative rounded-2xl bg-linear-to-bl from-indigo-200/60 via-indigo-400/90 to-purple-200/50 p-4 shadow-inner dark:from-indigo-300/20 dark:via-slate-400 dark:to-slate-500/50 sm:p-6", children: [jsxRuntime.jsxs("div", { className: "flex flex-col gap-2 sm:gap-3", children: [jsxRuntime.jsxs("div", { className: "flex items-center justify-start rounded-full ", children: [jsxRuntime.jsx(server.globalLucideIcons.Gem, { "aria-hidden": true, className: "mr-2 h-6 w-6 sm:h-8 sm:w-8" }), jsxRuntime.jsx("span", { className: "text-sm font-medium sm:text-base", children: translations.totalLabel })] }), jsxRuntime.jsx("div", { className: "flex justify-center text-3xl font-semibold leading-tight sm:text-4xl", children: formatNumber(locale, data.totalBalance) }), jsxRuntime.jsxs("div", { className: "flex-1 flex-col gap-1", children: [jsxRuntime.jsx("p", { className: "text-xs text-gray-700 dark:text-slate-100 sm:text-sm", children: translations.subscriptionPeriodLabel }), jsxRuntime.jsx("h4", { className: "text-xl font-semibold sm:text-2xl", children: subscription ? subscription.planName : translations.subscriptionInactive })] }), jsxRuntime.jsx("div", { className: "pt-2 sm:pt-0", children: jsxRuntime.jsx(gradientButton.GradientButton, { title: subscription ? translations.subscriptionManage : translations.subscribePay, align: "center", icon: subscription ? jsxRuntime.jsx(server.globalLucideIcons.Settings2, {}) : jsxRuntime.jsx(server.globalLucideIcons.Bell, {}), openInNewTab: false, className: "w-full", onClick: subscription ? handleManageAction : handleSubscribeAction }) })] }), jsxRuntime.jsx("div", { className: "absolute right-3 top-3 sm:right-6 sm:top-6", children: jsxRuntime.jsx(HoverInfo, { label: translations.totalLabel, description: translations.summaryDescription }) })] }), jsxRuntime.jsxs("section", { className: "relative flex flex-col gap-3 rounded-2xl border p-4 shadow-inner sm:gap-2 sm:p-5", children: [jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [jsxRuntime.jsx("h3", { className: "text-base font-semibold text-gray-500 dark:text-slate-100 sm:text-lg", children: translations.bucketsTitle }), hasBuckets ? (jsxRuntime.jsx("button", { type: "button", "aria-expanded": bucketExpanded, "aria-label": bucketExpanded ? translations.hiddenDetail : translations.expandDetail, onClick: toggleBucketExpanded, className: "flex h-7 w-7 items-center justify-center rounded-full border border-transparent bg-white text-purple-600 shadow-[0_6px_20px_rgba(99,102,241,0.25)] transition-colors hover:text-purple-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:ring-purple-500 dark:bg-[#1b1541] dark:text-purple-100 dark:hover:text-purple-50 dark:shadow-[0_6px_22px_rgba(112,86,255,0.35)]", children: bucketExpanded ? (jsxRuntime.jsx(server.globalLucideIcons.ChevronUp, { className: "h-4 w-4" })) : (jsxRuntime.jsx(server.globalLucideIcons.ChevronDown, { className: "h-4 w-4" })) })) : null] }), hasBuckets ? (bucketExpanded ? (jsxRuntime.jsx("ul", { className: "flex flex-col gap-2", children: buckets.map((bucket) => {
+    return (jsxRuntime.jsxs("section", { className: utils.cn("flex flex-col gap-2 p-2 shadow-inner rounded-xl bg-white dark:bg-slate-900", className), children: [jsxRuntime.jsxs("header", { className: "relative rounded-2xl bg-linear-to-bl from-indigo-200/60 via-indigo-400/90 to-purple-200/50 p-4 shadow-inner dark:from-indigo-300/20 dark:via-slate-400 dark:to-slate-500/50 sm:p-6", children: [jsxRuntime.jsxs("div", { className: "flex flex-col gap-2 sm:gap-3", children: [jsxRuntime.jsxs("div", { className: "flex items-center justify-start rounded-full ", children: [jsxRuntime.jsx(server.globalLucideIcons.Gem, { "aria-hidden": true, className: "mr-2 h-6 w-6 sm:h-8 sm:w-8" }), jsxRuntime.jsx("span", { className: "text-base sm:text-lg", children: translations.totalLabel })] }), jsxRuntime.jsx("div", { className: "flex justify-center text-3xl font-semibold leading-tight sm:text-4xl", children: formatNumber(locale, data.totalBalance) }), jsxRuntime.jsxs("div", { className: "flex-1 flex-col gap-1", children: [jsxRuntime.jsx("p", { className: "text-xs text-gray-700 dark:text-slate-100 sm:text-sm", children: translations.subscriptionPeriodLabel }), jsxRuntime.jsx("h4", { className: "text-xl font-semibold sm:text-2xl", children: subscription ? subscription.planName : translations.subscriptionInactive })] }), jsxRuntime.jsx("div", { className: "pt-2 sm:pt-0", children: jsxRuntime.jsx(gradientButton.GradientButton, { title: subscription ? translations.subscriptionManage : translations.subscribePay, align: "center", icon: subscription ? jsxRuntime.jsx(server.globalLucideIcons.Settings2, {}) : jsxRuntime.jsx(server.globalLucideIcons.Bell, {}), openInNewTab: false, className: "w-full", onClick: subscription ? handleManageAction : handleSubscribeAction }) })] }), jsxRuntime.jsx("div", { className: "absolute right-3 top-3 sm:right-6 sm:top-6", children: jsxRuntime.jsx(HoverInfo, { label: translations.totalLabel, description: translations.summaryDescription }) })] }), jsxRuntime.jsxs("section", { className: "relative flex flex-col gap-3 rounded-2xl border p-4 shadow-inner sm:gap-2 sm:p-5", children: [jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [jsxRuntime.jsx("h3", { className: "text-base text-gray-500 dark:text-slate-100 sm:text-lg", children: translations.bucketsTitle }), hasBuckets ? (jsxRuntime.jsx("button", { type: "button", "aria-expanded": bucketExpanded, "aria-label": bucketExpanded ? translations.hiddenDetail : translations.expandDetail, onClick: toggleBucketExpanded, className: "flex h-7 w-7 items-center justify-center rounded-full border border-transparent bg-white text-purple-600 shadow-[0_6px_20px_rgba(99,102,241,0.25)] transition-colors hover:text-purple-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:ring-purple-500 dark:bg-[#1b1541] dark:text-purple-100 dark:hover:text-purple-50 dark:shadow-[0_6px_22px_rgba(112,86,255,0.35)]", children: bucketExpanded ? (jsxRuntime.jsx(server.globalLucideIcons.ChevronUp, { className: "h-4 w-4" })) : (jsxRuntime.jsx(server.globalLucideIcons.ChevronDown, { className: "h-4 w-4" })) })) : null] }), hasBuckets ? (bucketExpanded ? (jsxRuntime.jsx("ul", { className: "flex flex-col gap-2", children: buckets.map((bucket) => {
                             const balanceDisplay = formatNumber(locale, bucket.balance);
-                            return (jsxRuntime.jsxs("li", { "data-credit-kind": bucket.kind, className: "rounded-2xl border border-slate-200/70 bg-white/85 px-3 py-3 text-sm shadow-sm transition-transform hover:-translate-y-0.5 hover:shadow-md dark:border-slate-800/60 dark:bg-slate-900/60 sm:px-4", children: [jsxRuntime.jsxs("div", { className: "grid grid-cols-[1fr_auto] items-center gap-3 text-xs sm:text-sm", children: [jsxRuntime.jsx("span", { className: "flex min-w-0 items-center gap-2", children: jsxRuntime.jsx("span", { className: "max-w-full truncate rounded-full bg-purple-50 px-2 py-1 text-xs font-semibold text-purple-600 shadow-sm dark:bg-purple-500/20 dark:text-purple-100 sm:text-sm", children: bucket.computedLabel }) }), jsxRuntime.jsx("span", { className: "flex min-w-0 justify-end", children: jsxRuntime.jsx("span", { className: "text-right text-base font-semibold leading-tight text-gray-500 dark:text-slate-100 sm:text-lg", title: balanceDisplay, children: balanceDisplay }) })] }), jsxRuntime.jsx("div", { className: "mt-3 flex justify-end gap-2", children: jsxRuntime.jsxs("span", { className: "text-[11px] font-semibold text-gray-500 dark:text-slate-100 sm:text-xs", children: [translations.expiredAtLabel, ": ", bucket.expiresAt] }) })] }, bucket.kind));
+                            return (jsxRuntime.jsxs("li", { "data-credit-kind": bucket.kind, className: "rounded-2xl border border-slate-200/70 bg-white/85 px-3 py-3 text-sm shadow-sm transition-transform hover:-translate-y-0.5 hover:shadow-md dark:border-slate-800/60 dark:bg-slate-900/60 sm:px-4", children: [jsxRuntime.jsxs("div", { className: "grid grid-cols-[1fr_auto] items-center gap-3 text-xs sm:text-sm", children: [jsxRuntime.jsx("span", { className: "flex min-w-0 items-center gap-2", children: jsxRuntime.jsx("span", { className: "max-w-full truncate rounded-full bg-purple-50 px-2 py-1 text-xs text-purple-600 shadow-sm dark:bg-purple-500/20 dark:text-purple-100 sm:text-sm", children: bucket.computedLabel }) }), jsxRuntime.jsx("span", { className: "flex min-w-0 justify-end", children: jsxRuntime.jsx("span", { className: "text-right text-base font-semibold leading-tight text-gray-500 dark:text-slate-100 sm:text-lg", title: balanceDisplay, children: balanceDisplay }) })] }), jsxRuntime.jsx("div", { className: "mt-3 flex justify-end gap-2", children: jsxRuntime.jsxs("span", { className: "text-[11px] text-gray-500 dark:text-slate-100 sm:text-xs", children: [translations.expiredAtLabel, ": ", bucket.expiresAt] }) })] }, bucket.kind));
                         }) })) : (jsxRuntime.jsx("button", { type: "button", onClick: expandBuckets, className: "w-full rounded-2xl border border-slate-200/70 bg-white/85 p-6 sm:px-4 text-sm shadow-sm transition-transform hover:-translate-y-0.5 hover:shadow-md dark:border-slate-800/60 dark:bg-slate-900/60 hover:text-purple-500", children: translations.expandDetail }))) : (jsxRuntime.jsx("div", { className: "w-full rounded-2xl border border-slate-200/70 bg-white/85 p-6 sm:px-4 text-sm shadow-sm transition-transform dark:border-slate-800/60 dark:bg-slate-900/60 text-center", children: translations.bucketsEmpty })), jsxRuntime.jsx(gradientButton.GradientButton, { title: translations.onetimeBuy, icon: jsxRuntime.jsx(server.globalLucideIcons.ShoppingCart, {}), align: "center", className: "w-full text-sm sm:text-base", onClick: handleOnetimeAction })] })] }));
 }
 function deriveStatus(expiresAt, thresholdDays = 7) {

package/dist/main/credit/credit-overview-client.mjs

@@ -229,9 +229,9 @@ function CreditOverviewClient({ data, locale, translations, className, expiringS
         userToggledRef.current = true;
         setBucketExpanded(true);
     }, []);
-    return (jsxs("section", { className: cn("flex flex-col gap-2 p-2 shadow-inner rounded-xl bg-white dark:bg-slate-900", className), children: [jsxs("header", { className: "relative rounded-2xl bg-linear-to-bl from-indigo-200/60 via-indigo-400/90 to-purple-200/50 p-4 shadow-inner dark:from-indigo-300/20 dark:via-slate-400 dark:to-slate-500/50 sm:p-6", children: [jsxs("div", { className: "flex flex-col gap-2 sm:gap-3", children: [jsxs("div", { className: "flex items-center justify-start rounded-full ", children: [jsx(globalLucideIcons.Gem, { "aria-hidden": true, className: "mr-2 h-6 w-6 sm:h-8 sm:w-8" }), jsx("span", { className: "text-sm font-medium sm:text-base", children: translations.totalLabel })] }), jsx("div", { className: "flex justify-center text-3xl font-semibold leading-tight sm:text-4xl", children: formatNumber(locale, data.totalBalance) }), jsxs("div", { className: "flex-1 flex-col gap-1", children: [jsx("p", { className: "text-xs text-gray-700 dark:text-slate-100 sm:text-sm", children: translations.subscriptionPeriodLabel }), jsx("h4", { className: "text-xl font-semibold sm:text-2xl", children: subscription ? subscription.planName : translations.subscriptionInactive })] }), jsx("div", { className: "pt-2 sm:pt-0", children: jsx(GradientButton, { title: subscription ? translations.subscriptionManage : translations.subscribePay, align: "center", icon: subscription ? jsx(globalLucideIcons.Settings2, {}) : jsx(globalLucideIcons.Bell, {}), openInNewTab: false, className: "w-full", onClick: subscription ? handleManageAction : handleSubscribeAction }) })] }), jsx("div", { className: "absolute right-3 top-3 sm:right-6 sm:top-6", children: jsx(HoverInfo, { label: translations.totalLabel, description: translations.summaryDescription }) })] }), jsxs("section", { className: "relative flex flex-col gap-3 rounded-2xl border p-4 shadow-inner sm:gap-2 sm:p-5", children: [jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [jsx("h3", { className: "text-base font-semibold text-gray-500 dark:text-slate-100 sm:text-lg", children: translations.bucketsTitle }), hasBuckets ? (jsx("button", { type: "button", "aria-expanded": bucketExpanded, "aria-label": bucketExpanded ? translations.hiddenDetail : translations.expandDetail, onClick: toggleBucketExpanded, className: "flex h-7 w-7 items-center justify-center rounded-full border border-transparent bg-white text-purple-600 shadow-[0_6px_20px_rgba(99,102,241,0.25)] transition-colors hover:text-purple-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:ring-purple-500 dark:bg-[#1b1541] dark:text-purple-100 dark:hover:text-purple-50 dark:shadow-[0_6px_22px_rgba(112,86,255,0.35)]", children: bucketExpanded ? (jsx(globalLucideIcons.ChevronUp, { className: "h-4 w-4" })) : (jsx(globalLucideIcons.ChevronDown, { className: "h-4 w-4" })) })) : null] }), hasBuckets ? (bucketExpanded ? (jsx("ul", { className: "flex flex-col gap-2", children: buckets.map((bucket) => {
+    return (jsxs("section", { className: cn("flex flex-col gap-2 p-2 shadow-inner rounded-xl bg-white dark:bg-slate-900", className), children: [jsxs("header", { className: "relative rounded-2xl bg-linear-to-bl from-indigo-200/60 via-indigo-400/90 to-purple-200/50 p-4 shadow-inner dark:from-indigo-300/20 dark:via-slate-400 dark:to-slate-500/50 sm:p-6", children: [jsxs("div", { className: "flex flex-col gap-2 sm:gap-3", children: [jsxs("div", { className: "flex items-center justify-start rounded-full ", children: [jsx(globalLucideIcons.Gem, { "aria-hidden": true, className: "mr-2 h-6 w-6 sm:h-8 sm:w-8" }), jsx("span", { className: "text-base sm:text-lg", children: translations.totalLabel })] }), jsx("div", { className: "flex justify-center text-3xl font-semibold leading-tight sm:text-4xl", children: formatNumber(locale, data.totalBalance) }), jsxs("div", { className: "flex-1 flex-col gap-1", children: [jsx("p", { className: "text-xs text-gray-700 dark:text-slate-100 sm:text-sm", children: translations.subscriptionPeriodLabel }), jsx("h4", { className: "text-xl font-semibold sm:text-2xl", children: subscription ? subscription.planName : translations.subscriptionInactive })] }), jsx("div", { className: "pt-2 sm:pt-0", children: jsx(GradientButton, { title: subscription ? translations.subscriptionManage : translations.subscribePay, align: "center", icon: subscription ? jsx(globalLucideIcons.Settings2, {}) : jsx(globalLucideIcons.Bell, {}), openInNewTab: false, className: "w-full", onClick: subscription ? handleManageAction : handleSubscribeAction }) })] }), jsx("div", { className: "absolute right-3 top-3 sm:right-6 sm:top-6", children: jsx(HoverInfo, { label: translations.totalLabel, description: translations.summaryDescription }) })] }), jsxs("section", { className: "relative flex flex-col gap-3 rounded-2xl border p-4 shadow-inner sm:gap-2 sm:p-5", children: [jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [jsx("h3", { className: "text-base text-gray-500 dark:text-slate-100 sm:text-lg", children: translations.bucketsTitle }), hasBuckets ? (jsx("button", { type: "button", "aria-expanded": bucketExpanded, "aria-label": bucketExpanded ? translations.hiddenDetail : translations.expandDetail, onClick: toggleBucketExpanded, className: "flex h-7 w-7 items-center justify-center rounded-full border border-transparent bg-white text-purple-600 shadow-[0_6px_20px_rgba(99,102,241,0.25)] transition-colors hover:text-purple-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:ring-purple-500 dark:bg-[#1b1541] dark:text-purple-100 dark:hover:text-purple-50 dark:shadow-[0_6px_22px_rgba(112,86,255,0.35)]", children: bucketExpanded ? (jsx(globalLucideIcons.ChevronUp, { className: "h-4 w-4" })) : (jsx(globalLucideIcons.ChevronDown, { className: "h-4 w-4" })) })) : null] }), hasBuckets ? (bucketExpanded ? (jsx("ul", { className: "flex flex-col gap-2", children: buckets.map((bucket) => {
                             const balanceDisplay = formatNumber(locale, bucket.balance);
-                            return (jsxs("li", { "data-credit-kind": bucket.kind, className: "rounded-2xl border border-slate-200/70 bg-white/85 px-3 py-3 text-sm shadow-sm transition-transform hover:-translate-y-0.5 hover:shadow-md dark:border-slate-800/60 dark:bg-slate-900/60 sm:px-4", children: [jsxs("div", { className: "grid grid-cols-[1fr_auto] items-center gap-3 text-xs sm:text-sm", children: [jsx("span", { className: "flex min-w-0 items-center gap-2", children: jsx("span", { className: "max-w-full truncate rounded-full bg-purple-50 px-2 py-1 text-xs font-semibold text-purple-600 shadow-sm dark:bg-purple-500/20 dark:text-purple-100 sm:text-sm", children: bucket.computedLabel }) }), jsx("span", { className: "flex min-w-0 justify-end", children: jsx("span", { className: "text-right text-base font-semibold leading-tight text-gray-500 dark:text-slate-100 sm:text-lg", title: balanceDisplay, children: balanceDisplay }) })] }), jsx("div", { className: "mt-3 flex justify-end gap-2", children: jsxs("span", { className: "text-[11px] font-semibold text-gray-500 dark:text-slate-100 sm:text-xs", children: [translations.expiredAtLabel, ": ", bucket.expiresAt] }) })] }, bucket.kind));
+                            return (jsxs("li", { "data-credit-kind": bucket.kind, className: "rounded-2xl border border-slate-200/70 bg-white/85 px-3 py-3 text-sm shadow-sm transition-transform hover:-translate-y-0.5 hover:shadow-md dark:border-slate-800/60 dark:bg-slate-900/60 sm:px-4", children: [jsxs("div", { className: "grid grid-cols-[1fr_auto] items-center gap-3 text-xs sm:text-sm", children: [jsx("span", { className: "flex min-w-0 items-center gap-2", children: jsx("span", { className: "max-w-full truncate rounded-full bg-purple-50 px-2 py-1 text-xs text-purple-600 shadow-sm dark:bg-purple-500/20 dark:text-purple-100 sm:text-sm", children: bucket.computedLabel }) }), jsx("span", { className: "flex min-w-0 justify-end", children: jsx("span", { className: "text-right text-base font-semibold leading-tight text-gray-500 dark:text-slate-100 sm:text-lg", title: balanceDisplay, children: balanceDisplay }) })] }), jsx("div", { className: "mt-3 flex justify-end gap-2", children: jsxs("span", { className: "text-[11px] text-gray-500 dark:text-slate-100 sm:text-xs", children: [translations.expiredAtLabel, ": ", bucket.expiresAt] }) })] }, bucket.kind));
                         }) })) : (jsx("button", { type: "button", onClick: expandBuckets, className: "w-full rounded-2xl border border-slate-200/70 bg-white/85 p-6 sm:px-4 text-sm shadow-sm transition-transform hover:-translate-y-0.5 hover:shadow-md dark:border-slate-800/60 dark:bg-slate-900/60 hover:text-purple-500", children: translations.expandDetail }))) : (jsx("div", { className: "w-full rounded-2xl border border-slate-200/70 bg-white/85 p-6 sm:px-4 text-sm shadow-sm transition-transform dark:border-slate-800/60 dark:bg-slate-900/60 text-center", children: translations.bucketsEmpty })), jsx(GradientButton, { title: translations.onetimeBuy, icon: jsx(globalLucideIcons.ShoppingCart, {}), align: "center", className: "w-full text-sm sm:text-base", onClick: handleOnetimeAction })] })] }));
 }
 function deriveStatus(expiresAt, thresholdDays = 7) {

package/dist/main/footer-email.js

@@ -23,7 +23,7 @@ function FooterEmail({ email, clickToCopyText, copiedText, children }) {
             // silent fail
         }
     });
-    return (jsxRuntime.jsxs("div", { className: "relative group", children: [jsxRuntime.jsx("div", { className: "absolute left-2/3 -translate-x-1/4 bottom-full pb-1 hidden group-hover:block z-10", children: jsxRuntime.jsx("div", { className: "bg-zinc-600 text-white text-xs rounded px-3 py-1 whitespace-nowrap shadow-lg cursor-pointer select-text", onMouseDown: handleCopy, title: displayTitle, children: copied ? displayCopied : email }) }), jsxRuntime.jsx("a", { href: `mailto:${email}`, className: "flex items-center space-x-1 underline cursor-pointer px-2", children: children })] }));
+    return (jsxRuntime.jsxs("div", { className: "relative group", children: [jsxRuntime.jsx("div", { className: "absolute right-0 sm:right-auto sm:left-2/3 sm:-translate-x-1/4 bottom-full pb-1 hidden group-hover:block z-10", children: jsxRuntime.jsx("div", { className: "bg-zinc-600 text-white text-xs rounded px-3 py-1 whitespace-nowrap shadow-lg cursor-pointer select-text", onMouseDown: handleCopy, title: displayTitle, children: copied ? displayCopied : email }) }), jsxRuntime.jsx("a", { href: `mailto:${email}`, className: "flex items-center space-x-1 underline cursor-pointer px-2", children: children })] }));
 }
 
 exports.FooterEmail = FooterEmail;

package/dist/main/footer-email.mjs

@@ -21,7 +21,7 @@ function FooterEmail({ email, clickToCopyText, copiedText, children }) {
             // silent fail
         }
     });
-    return (jsxs("div", { className: "relative group", children: [jsx("div", { className: "absolute left-2/3 -translate-x-1/4 bottom-full pb-1 hidden group-hover:block z-10", children: jsx("div", { className: "bg-zinc-600 text-white text-xs rounded px-3 py-1 whitespace-nowrap shadow-lg cursor-pointer select-text", onMouseDown: handleCopy, title: displayTitle, children: copied ? displayCopied : email }) }), jsx("a", { href: `mailto:${email}`, className: "flex items-center space-x-1 underline cursor-pointer px-2", children: children })] }));
+    return (jsxs("div", { className: "relative group", children: [jsx("div", { className: "absolute right-0 sm:right-auto sm:left-2/3 sm:-translate-x-1/4 bottom-full pb-1 hidden group-hover:block z-10", children: jsx("div", { className: "bg-zinc-600 text-white text-xs rounded px-3 py-1 whitespace-nowrap shadow-lg cursor-pointer select-text", onMouseDown: handleCopy, title: displayTitle, children: copied ? displayCopied : email }) }), jsx("a", { href: `mailto:${email}`, className: "flex items-center space-x-1 underline cursor-pointer px-2", children: children })] }));
 }
 
 export { FooterEmail };

package/dist/main/footer.d.ts

@@ -1,3 +1,7 @@
-export declare function Footer({ locale }: {
+interface FooterProps {
     locale: string;
-}): Promise<import("react/jsx-runtime").JSX.Element>;
+    localPrefixAsNeeded?: boolean;
+    defaultLocale?: string;
+}
+export declare function Footer({ locale, localPrefixAsNeeded, defaultLocale }: FooterProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export {};

package/dist/main/footer.js

@@ -7,9 +7,10 @@ var server$1 = require('@windrun-huaiin/base-ui/components/server');
 var Link = require('next/link');
 var footerEmail = require('./footer-email.js');
 var tIntl = require('../lib/t-intl.js');
+var lib = require('@windrun-huaiin/lib');
 
 function Footer(_a) {
-    return tslib_es6.__awaiter(this, arguments, void 0, function* ({ locale }) {
+    return tslib_es6.__awaiter(this, arguments, void 0, function* ({ locale, localPrefixAsNeeded = true, defaultLocale = 'en' }) {
         const tFooter = yield server.getTranslations({ locale, namespace: 'footer' });
         const company = tIntl.safeT(tFooter, 'company', '');
         const data = {
@@ -21,7 +22,7 @@ function Footer(_a) {
             clickToCopyText: tIntl.safeT(tFooter, 'clickToCopy', 'Click to copy'),
             copiedText: tIntl.safeT(tFooter, 'copied', 'Copied!'),
         };
-        return (jsxRuntime.jsx("div", { className: "mb-10 w-full mx-auto border-t-purple-700/80 border-t", children: jsxRuntime.jsx("footer", { children: jsxRuntime.jsxs("div", { className: "w-full flex flex-col items-center justify-center px-4 py-8 space-y-3", children: [jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center justify-center gap-x-2 gap-y-2 text-xs sm:text-sm sm:gap-x-6", children: [jsxRuntime.jsxs(Link, { href: `/${locale}/legal/terms`, className: "flex items-center space-x-1 hover:underline", children: [jsxRuntime.jsx(server$1.globalLucideIcons.ReceiptText, { className: "h-3.5 w-3.5" }), jsxRuntime.jsx("span", { children: data.terms })] }), jsxRuntime.jsxs(Link, { href: `/${locale}/legal/privacy`, className: "flex items-center space-x-1 hover:underline", children: [jsxRuntime.jsx(server$1.globalLucideIcons.ShieldUser, { className: "h-3.5 w-3.5" }), jsxRuntime.jsx("span", { children: data.privacy })] }), jsxRuntime.jsxs(footerEmail.FooterEmail, { email: data.email, clickToCopyText: data.clickToCopyText, copiedText: data.copiedText, children: [jsxRuntime.jsx(server$1.globalLucideIcons.Mail, { className: "h-3.5 w-3.5" }), jsxRuntime.jsx("span", { children: data.contactUs })] })] }), jsxRuntime.jsx("div", { className: "text-xs sm:text-sm text-center", children: jsxRuntime.jsx("span", { children: data.copyright }) })] }) }) }));
+        return (jsxRuntime.jsx("div", { className: "mb-10 w-full mx-auto border-t-purple-700/80 border-t", children: jsxRuntime.jsx("footer", { children: jsxRuntime.jsxs("div", { className: "w-full flex flex-col items-center justify-center px-4 py-8 space-y-3", children: [jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center justify-center gap-x-2 gap-y-2 text-xs sm:text-sm sm:gap-x-6", children: [jsxRuntime.jsxs(Link, { href: lib.getAsNeededLocalizedUrl(locale, "/legal/terms", localPrefixAsNeeded, defaultLocale), className: "flex items-center space-x-1 hover:underline", children: [jsxRuntime.jsx(server$1.globalLucideIcons.ReceiptText, { className: "h-3.5 w-3.5" }), jsxRuntime.jsx("span", { children: data.terms })] }), jsxRuntime.jsxs(Link, { href: lib.getAsNeededLocalizedUrl(locale, "/legal/privacy", localPrefixAsNeeded, defaultLocale), className: "flex items-center space-x-1 hover:underline", children: [jsxRuntime.jsx(server$1.globalLucideIcons.ShieldUser, { className: "h-3.5 w-3.5" }), jsxRuntime.jsx("span", { children: data.privacy })] }), jsxRuntime.jsxs(footerEmail.FooterEmail, { email: data.email, clickToCopyText: data.clickToCopyText, copiedText: data.copiedText, children: [jsxRuntime.jsx(server$1.globalLucideIcons.Mail, { className: "h-3.5 w-3.5" }), jsxRuntime.jsx("span", { children: data.contactUs })] })] }), jsxRuntime.jsx("div", { className: "text-xs sm:text-sm text-center", children: jsxRuntime.jsx("span", { children: data.copyright }) })] }) }) }));
     });
 }
 

package/dist/main/footer.mjs

@@ -5,9 +5,10 @@ import { globalLucideIcons } from '@windrun-huaiin/base-ui/components/server';
 import Link from 'next/link';
 import { FooterEmail } from './footer-email.mjs';
 import { safeT } from '../lib/t-intl.mjs';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
 
 function Footer(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ locale }) {
+    return __awaiter(this, arguments, void 0, function* ({ locale, localPrefixAsNeeded = true, defaultLocale = 'en' }) {
         const tFooter = yield getTranslations({ locale, namespace: 'footer' });
         const company = safeT(tFooter, 'company', '');
         const data = {
@@ -19,7 +20,7 @@ function Footer(_a) {
             clickToCopyText: safeT(tFooter, 'clickToCopy', 'Click to copy'),
             copiedText: safeT(tFooter, 'copied', 'Copied!'),
         };
-        return (jsx("div", { className: "mb-10 w-full mx-auto border-t-purple-700/80 border-t", children: jsx("footer", { children: jsxs("div", { className: "w-full flex flex-col items-center justify-center px-4 py-8 space-y-3", children: [jsxs("div", { className: "flex flex-wrap items-center justify-center gap-x-2 gap-y-2 text-xs sm:text-sm sm:gap-x-6", children: [jsxs(Link, { href: `/${locale}/legal/terms`, className: "flex items-center space-x-1 hover:underline", children: [jsx(globalLucideIcons.ReceiptText, { className: "h-3.5 w-3.5" }), jsx("span", { children: data.terms })] }), jsxs(Link, { href: `/${locale}/legal/privacy`, className: "flex items-center space-x-1 hover:underline", children: [jsx(globalLucideIcons.ShieldUser, { className: "h-3.5 w-3.5" }), jsx("span", { children: data.privacy })] }), jsxs(FooterEmail, { email: data.email, clickToCopyText: data.clickToCopyText, copiedText: data.copiedText, children: [jsx(globalLucideIcons.Mail, { className: "h-3.5 w-3.5" }), jsx("span", { children: data.contactUs })] })] }), jsx("div", { className: "text-xs sm:text-sm text-center", children: jsx("span", { children: data.copyright }) })] }) }) }));
+        return (jsx("div", { className: "mb-10 w-full mx-auto border-t-purple-700/80 border-t", children: jsx("footer", { children: jsxs("div", { className: "w-full flex flex-col items-center justify-center px-4 py-8 space-y-3", children: [jsxs("div", { className: "flex flex-wrap items-center justify-center gap-x-2 gap-y-2 text-xs sm:text-sm sm:gap-x-6", children: [jsxs(Link, { href: getAsNeededLocalizedUrl(locale, "/legal/terms", localPrefixAsNeeded, defaultLocale), className: "flex items-center space-x-1 hover:underline", children: [jsx(globalLucideIcons.ReceiptText, { className: "h-3.5 w-3.5" }), jsx("span", { children: data.terms })] }), jsxs(Link, { href: getAsNeededLocalizedUrl(locale, "/legal/privacy", localPrefixAsNeeded, defaultLocale), className: "flex items-center space-x-1 hover:underline", children: [jsx(globalLucideIcons.ShieldUser, { className: "h-3.5 w-3.5" }), jsx("span", { children: data.privacy })] }), jsxs(FooterEmail, { email: data.email, clickToCopyText: data.clickToCopyText, copiedText: data.copiedText, children: [jsx(globalLucideIcons.Mail, { className: "h-3.5 w-3.5" }), jsx("span", { children: data.contactUs })] })] }), jsx("div", { className: "text-xs sm:text-sm text-center", children: jsx("span", { children: data.copyright }) })] }) }) }));
     });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "11.1.0",
+  "version": "12.0.0",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,6 +16,11 @@
       "import": "./dist/clerk/server.mjs",
       "require": "./dist/clerk/server.js"
     },
+    "./clerk/patch/optional-auth": {
+      "types": "./dist/clerk/patch/optional-auth.d.ts",
+      "import": "./dist/clerk/patch/optional-auth.mjs",
+      "require": "./dist/clerk/patch/optional-auth.js"
+    },
     "./fingerprint": {
       "types": "./dist/clerk/fingerprint/index.d.ts",
       "import": "./dist/clerk/fingerprint/index.mjs",
@@ -81,8 +86,8 @@
     "react-medium-image-zoom": "^5.2.14",
     "swiper": "^12.0.3",
     "zod": "^4.1.12",
-    "@windrun-huaiin/base-ui": "^11.0.1",
-    "@windrun-huaiin/lib": "^11.0.1"
+    "@windrun-huaiin/base-ui": "^12.0.0",
+    "@windrun-huaiin/lib": "^12.0.0"
   },
   "peerDependencies": {
     "clsx": "^2.1.1",

package/src/clerk/clerk-provider-client.tsx

@@ -7,6 +7,10 @@ import React from 'react';
 interface ClerkProviderClientProps {
   children: React.ReactNode;
   locale: string;
+  // Whether localePrefix is set to 'as-needed' (default: true)
+  localPrefixAsNeeded?: boolean;
+  // The default locale used by the host app (default: 'en')
+  defaultLocale?: string;
   signInUrl?: string;
   signUpUrl?: string;
   fallbackSignInUrl?: string;
@@ -17,13 +21,25 @@ interface ClerkProviderClientProps {
 export function ClerkProviderClient({
   children,
   locale,
+  localPrefixAsNeeded = true,
+  defaultLocale = 'en',
   signInUrl,
   signUpUrl,
   fallbackSignInUrl,
   fallbackSignUpUrl,
   waitlistUrl,
 }: ClerkProviderClientProps) {
-  const currentLocalization = clerkIntl[locale as keyof typeof clerkIntl];
+  const currentLocalization =
+    clerkIntl[locale as keyof typeof clerkIntl] ??
+    clerkIntl[defaultLocale as keyof typeof clerkIntl] ??
+    clerkIntl.en;
+
+  // In as-needed mode, skip prefixing for the default locale so /sign-in stays unprefixed.
+  const shouldPrefixLocale = localPrefixAsNeeded ? locale !== defaultLocale : true;
+  const localeSegment = shouldPrefixLocale && locale ? `/${locale}` : '';
+
+  const buildUrl = (path?: string) =>
+    path ? `${localeSegment}${path}` : undefined;
 
   // build the ClerkProvider props, only add when the parameter is not empty
   const clerkProviderProps: Record<string, any> = {
@@ -31,20 +47,29 @@ export function ClerkProviderClient({
   };
 
   // Only add URL when the parameter is not empty
-  if (signInUrl) {
-    clerkProviderProps.signInUrl = `/${locale}${signInUrl}`;
+  const signInWithLocale = buildUrl(signInUrl);
+  if (signInWithLocale) {
+    clerkProviderProps.signInUrl = signInWithLocale;
   }
-  if (signUpUrl) {
-    clerkProviderProps.signUpUrl = `/${locale}${signUpUrl}`;
+
+  const signUpWithLocale = buildUrl(signUpUrl);
+  if (signUpWithLocale) {
+    clerkProviderProps.signUpUrl = signUpWithLocale;
   }
-  if (fallbackSignInUrl) {
-    clerkProviderProps.signInFallbackRedirectUrl = `/${locale}${fallbackSignInUrl}`;
+
+  const signInFallbackWithLocale = buildUrl(fallbackSignInUrl);
+  if (signInFallbackWithLocale) {
+    clerkProviderProps.signInFallbackRedirectUrl = signInFallbackWithLocale;
   }
-  if (fallbackSignUpUrl) {
-    clerkProviderProps.signUpFallbackRedirectUrl = `/${locale}${fallbackSignUpUrl}`;
+
+  const signUpFallbackWithLocale = buildUrl(fallbackSignUpUrl);
+  if (signUpFallbackWithLocale) {
+    clerkProviderProps.signUpFallbackRedirectUrl = signUpFallbackWithLocale;
   }
-  if (waitlistUrl) {
-    clerkProviderProps.waitlistUrl = `/${locale}${waitlistUrl}`;
+
+  const waitlistWithLocale = buildUrl(waitlistUrl);
+  if (waitlistWithLocale) {
+    clerkProviderProps.waitlistUrl = waitlistWithLocale;
   }
 
   // console.log('ClerkProviderClient props:', clerkProviderProps);
@@ -54,4 +79,4 @@ export function ClerkProviderClient({
       {children}
     </ClerkProvider>
   );
-} 
+} 

package/src/clerk/patch/optional-auth.ts

@@ -0,0 +1,24 @@
+import { auth } from '@clerk/nextjs/server';
+
+export type OptionalAuthResult = {
+  userId: string | null;
+  sessionId: string | null;
+  raw: Awaited<ReturnType<typeof auth>> | null;
+};
+
+/**
+ * 可选鉴权：在缺少 Clerk 标记或未登录时返回 null，避免 auth() 抛错。
+ * 仅供服务端使用，请从 @third-ui/clerk/patch/optional-auth 导入。
+ */
+export async function getOptionalAuth(): Promise<OptionalAuthResult> {
+  try {
+    const res = await auth();
+    return {
+      userId: res.userId ?? null,
+      sessionId: res.sessionId ?? null,
+      raw: res,
+    };
+  } catch {
+    return { userId: null, sessionId: null, raw: null };
+  }
+}

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

@@ -86,6 +86,14 @@ export interface CustomHomeLayoutProps {
    * Customize the order of header action items.
    */
   actionOrders?: HeaderActionOrders;
+  /**
+   * Whether localePrefix is set to 'as-needed' (default: true)
+   */
+  localPrefixAsNeeded?: boolean;
+  /**
+   * The default locale for the application (default: 'en')
+   */
+  defaultLocale?: string;
   children?: ReactNode;
 }
 
@@ -112,6 +120,8 @@ export function CustomHomeLayout({
   style,
   floatingNav = false,
   actionOrders,
+  localPrefixAsNeeded = true,
+  defaultLocale = 'en',
 }: CustomHomeLayoutProps) {
   const resolvedBannerHeight = bannerHeight ?? (showBanner ? 3 : 0.5);
   const resolvedPaddingTop =
@@ -161,7 +171,7 @@ export function CustomHomeLayout({
         style={layoutStyle}
       >
         {children}
-        {showFooter ? footer ?? <Footer locale={locale} /> : null}
+        {showFooter ? footer ?? <Footer locale={locale} localPrefixAsNeeded={localPrefixAsNeeded} defaultLocale={defaultLocale} /> : null}
         {showGoToTop ? goToTop ?? <GoToTop /> : null}
       </HomeLayout>
     </>

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

@@ -2,6 +2,7 @@ import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/page
 import { ReactNode, ReactElement, cloneElement } from 'react';
 import { TocFooterWrapper } from '@third-ui/fuma/mdx/toc-footer-wrapper';
 import type { LLMCopyButtonProps, LLMCopyButton } from '@third-ui/fuma/mdx/toc-base';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
 
 interface FumaPageParams {
   /* 
@@ -36,7 +37,7 @@ interface FumaPageParams {
    * The fallback page component to use when the page is not found
    */
   FallbackPage: React.ComponentType<{ siteIcon: ReactNode }>;
-  /* 
+  /*
    * Supported locales for generating alternates metadata, defaults to ['en']
    */
   supportedLocales?: string[];
@@ -49,6 +50,16 @@ interface FumaPageParams {
 
   // default false, for mobile style can cause issue
   showTableOfContentPopover?: boolean;
+
+  /*
+   * Whether localePrefix is set to 'as-needed' (default: true)
+   */
+  localPrefixAsNeeded?: boolean;
+
+  /*
+   * The default locale for the application (default: 'en')
+   */
+  defaultLocale?: string;
 }
 
 export function createFumaPage({
@@ -64,11 +75,14 @@ export function createFumaPage({
   showBreadcrumb = true,
   showTableOfContent = true,
   showTableOfContentPopover = false,
+  localPrefixAsNeeded = true,
+  defaultLocale = 'en',
 }: FumaPageParams) {
   const Page = async function Page({ params }: { params: Promise<{ locale: string; slug?: string[] }> }) {
     const { slug, locale } = await params;
     const page = mdxContentSource.getPage(slug, locale);
     if (!page) {
+      console.log('[FumaPage] missing page', { slug, locale, available: mdxContentSource.pageTree?.[locale]?.children?.map((c: any) => c.url) });
       return <FallbackPage siteIcon={siteIcon} />;
     }
 
@@ -129,14 +143,15 @@ export function createFumaPage({
     const baseRoute = mdxSourceDir.replace('src/mdx/', '');
     // build the current page path
     const currentPath = slug ? slug.join('/') : '';
-    const currentUrl = `${baseUrl}/${locale}/${baseRoute}${currentPath ? `/${currentPath}` : ''}`;
+    const localizedPath = getAsNeededLocalizedUrl(locale || defaultLocale, `/${baseRoute}${currentPath ? `/${currentPath}` : ''}`, localPrefixAsNeeded, defaultLocale);
+    const currentUrl = `${baseUrl}${localizedPath}`;
 
     // generate the seo language map
     const seoLanguageMap: Record<string, string> = {};
 
-    
     supportedLocales.forEach(loc => {
-      seoLanguageMap[loc] = `${baseUrl}/${loc}/${baseRoute}${currentPath ? `/${currentPath}` : ''}`;
+      const seoPath = getAsNeededLocalizedUrl(loc, `/${baseRoute}${currentPath ? `/${currentPath}` : ''}`, localPrefixAsNeeded, defaultLocale);
+      seoLanguageMap[loc] = `${baseUrl}${seoPath}`;
     });
 
     return {

package/src/lib/seo-util.ts

@@ -1,6 +1,7 @@
 import type { MetadataRoute } from 'next';
 import fs from 'fs';
 import path from 'path';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
 
 /**
  * Generate robots.txt content
@@ -23,13 +24,17 @@ export function generateRobots(baseUrl: string): MetadataRoute.Robots {
  * @param locales - Supported locales array
  * @param mdxSourceDir - MDX source directory path
  * @param openMdxSEOSiteMap - Whether to include MDX content in sitemap, default is true
+ * @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+ * @param defaultLocale - The default locale for the application (default: 'en')
  * @returns Sitemap entries
  */
 export function generateSitemap(
   baseUrl: string,
   locales: string[],
   mdxSourceDir: string,
-  openMdxSEOSiteMap: boolean = true
+  openMdxSEOSiteMap: boolean = true,
+  localPrefixAsNeeded: boolean = true,
+  defaultLocale: string = 'en'
 ): MetadataRoute.Sitemap {
   // 2. handle index.mdx (blog start page) and other slugs
   const blogRoutes: MetadataRoute.Sitemap = [];
@@ -46,16 +51,18 @@ export function generateSitemap(
         for (const locale of locales) {
           for (const f of blogFiles) {
             if (f === 'index.mdx') {
+              const localizedPath = getAsNeededLocalizedUrl(locale, '/blog', localPrefixAsNeeded, defaultLocale);
               blogRoutes.push({
-                url: `${baseUrl}/${locale}/blog`,
+                url: `${baseUrl}${localizedPath}`,
                 lastModified: new Date(),
                 changeFrequency: 'daily',
                 priority: 1.0
               });
             } else {
               const slug = f.replace(/\.mdx$/, '');
+              const localizedPath = getAsNeededLocalizedUrl(locale, `/blog/${slug}`, localPrefixAsNeeded, defaultLocale);
               blogRoutes.push({
-                url: `${baseUrl}/${locale}/blog/${slug}`,
+                url: `${baseUrl}${localizedPath}`,
                 lastModified: new Date(),
                 changeFrequency: f === 'ioc.mdx' ? 'daily' : 'monthly',
                 priority: 0.8
@@ -71,12 +78,15 @@ export function generateSitemap(
   }
 
   // 3. main page (all language versions)
-  const mainRoutes = locales.map(locale => ({
-    url: `${baseUrl}/${locale}`,
-    lastModified: new Date(),
-    changeFrequency: 'weekly' as const,
-    priority: 1.0
-  }));
+  const mainRoutes = locales.map(locale => {
+    const localizedPath = getAsNeededLocalizedUrl(locale, '/', localPrefixAsNeeded, defaultLocale);
+    return {
+      url: `${baseUrl}${localizedPath}`,
+      lastModified: new Date(),
+      changeFrequency: 'weekly' as const,
+      priority: 1.0
+    };
+  });
 
   return openMdxSEOSiteMap ? [...mainRoutes, ...blogRoutes] : [...mainRoutes];
 }
@@ -98,21 +108,25 @@ export function createRobotsHandler(baseUrl: string) {
  * @param locales - Supported locales array
  * @param mdxSourceDir - MDX source directory path, default is empty
  * @param openMdxSEOSiteMap - Whether to include MDX content in sitemap, default is true
+ * @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+ * @param defaultLocale - The default locale for the application (default: 'en')
  * @returns Sitemap handler function
  */
 export function createSitemapHandler(
   baseUrl: string,
   locales: string[],
   mdxSourceDir: string = '',
-  openMdxSEOSiteMap: boolean = true
+  openMdxSEOSiteMap: boolean = true,
+  localPrefixAsNeeded: boolean = true,
+  defaultLocale: string = 'en'
 ) {
   // force static generation
   const sitemapHandler = function sitemap(): MetadataRoute.Sitemap {
-    return generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap);
+    return generateSitemap(baseUrl, locales, mdxSourceDir, openMdxSEOSiteMap, localPrefixAsNeeded, defaultLocale);
   };
-  
+
   // Add static generation directive
   (sitemapHandler as any).dynamic = 'force-static';
-  
+
   return sitemapHandler;
 }

package/src/main/credit/credit-overview-client.tsx

@@ -370,7 +370,7 @@ export function CreditOverviewClient({
         <div className="flex flex-col gap-2 sm:gap-3">
           <div className="flex items-center justify-start rounded-full ">
             <icons.Gem aria-hidden className="mr-2 h-6 w-6 sm:h-8 sm:w-8" />
-            <span className="text-sm font-medium sm:text-base">{translations.totalLabel}</span>
+            <span className="text-base sm:text-lg">{translations.totalLabel}</span>
           </div>
           <div className="flex justify-center text-3xl font-semibold leading-tight sm:text-4xl">
             {formatNumber(locale, data.totalBalance)}
@@ -405,7 +405,7 @@ export function CreditOverviewClient({
       {/* Credit Details Section */}
       <section className="relative flex flex-col gap-3 rounded-2xl border p-4 shadow-inner sm:gap-2 sm:p-5">
         <div className="flex flex-wrap items-center justify-between gap-2">
-          <h3 className="text-base font-semibold text-gray-500 dark:text-slate-100 sm:text-lg">
+          <h3 className="text-base text-gray-500 dark:text-slate-100 sm:text-lg">
             {translations.bucketsTitle}
           </h3>
           {hasBuckets ? (
@@ -437,7 +437,7 @@ export function CreditOverviewClient({
                   >
                     <div className="grid grid-cols-[1fr_auto] items-center gap-3 text-xs sm:text-sm">
                       <span className="flex min-w-0 items-center gap-2">
-                        <span className="max-w-full truncate rounded-full bg-purple-50 px-2 py-1 text-xs font-semibold text-purple-600 shadow-sm dark:bg-purple-500/20 dark:text-purple-100 sm:text-sm">
+                        <span className="max-w-full truncate rounded-full bg-purple-50 px-2 py-1 text-xs text-purple-600 shadow-sm dark:bg-purple-500/20 dark:text-purple-100 sm:text-sm">
                           {bucket.computedLabel}
                         </span>
                       </span>
@@ -451,7 +451,7 @@ export function CreditOverviewClient({
                       </span>
                     </div>
                     <div className="mt-3 flex justify-end gap-2">
-                      <span className="text-[11px] font-semibold text-gray-500 dark:text-slate-100 sm:text-xs">
+                      <span className="text-[11px] text-gray-500 dark:text-slate-100 sm:text-xs">
                       {translations.expiredAtLabel}: {bucket.expiresAt}
                       </span>
                     </div>

package/src/main/footer-email.tsx

@@ -32,7 +32,7 @@ export function FooterEmail({ email, clickToCopyText, copiedText, children }: Fo
 
   return (
     <div className="relative group">
-      <div className="absolute left-2/3 -translate-x-1/4 bottom-full pb-1 hidden group-hover:block z-10">
+      <div className="absolute right-0 sm:right-auto sm:left-2/3 sm:-translate-x-1/4 bottom-full pb-1 hidden group-hover:block z-10">
         <div 
           className="bg-zinc-600 text-white text-xs rounded px-3 py-1 whitespace-nowrap shadow-lg cursor-pointer select-text"
           onMouseDown={handleCopy}