@particle-network/ui-react 0.5.1-beta.4 → 0.5.1-beta.5

package/dist/components/ProgressWrapper/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type UXForegroundColor, type UXRadius } from '@particle-network/ui-shared';
+import { type HexColor, type UXForegroundColor, type UXRadius } from '@particle-network/ui-shared';
 export interface ProgressWrapperProps extends React.HTMLAttributes<HTMLDivElement> {
     /**
      * 进度 (%)
@@ -24,7 +24,7 @@ export interface ProgressWrapperProps extends React.HTMLAttributes<HTMLDivElemen
     /**
      * 进度条颜色
      */
-    color?: UXForegroundColor | 'transparent' | `#${string}`;
+    color?: Exclude<UXForegroundColor, 'default' | 'white'> | 'transparent' | HexColor;
     /**
      * 进度条 SVG 样式
      */

package/dist/components/UXChip/chip.extend.d.ts

@@ -1,7 +1,8 @@
 import type React from 'react';
 import { type ChipProps } from '@heroui/chip';
+import type { HexColor } from '@particle-network/ui-shared';
 type ExtendedChipProps = Omit<ChipProps, 'color'> & {
-    color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'alert' | 'danger' | 'bullish' | 'bearish' | `#${string}`;
+    color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'alert' | 'danger' | 'bullish' | 'bearish' | HexColor;
 };
 declare const ExtendedChip: React.ForwardRefExoticComponent<ExtendedChipProps>;
 export default ExtendedChip;

package/dist/components/UXChip/index.d.ts

@@ -2,5 +2,5 @@ import React from 'react';
 import ExtendedChip from './chip.extend';
 export type UXChipProps = React.ComponentPropsWithRef<typeof ExtendedChip>;
 export declare const UXChip: import("@heroui/system-rsc").InternalForwardRefRenderFunction<"div", Omit<import("@heroui/chip").ChipProps, "color"> & {
-    color?: "default" | "primary" | "secondary" | "success" | "warning" | "alert" | "danger" | "bullish" | "bearish" | `#${string}`;
+    color?: "default" | "primary" | "secondary" | "success" | "warning" | "alert" | "danger" | "bullish" | "bearish" | import("@particle-network/ui-shared").HexColor;
 }, never>;

package/dist/components/UXColorPicker/color-picker.js

@@ -201,7 +201,7 @@ const UXColorPicker = ({ className, isDisabled, placement = 'bottom-start', valu
                 }),
                 /*#__PURE__*/ jsx(ColorInput, {
                     isDisabled: isDisabled,
-                    inputClassName: "focus:ring-0 px-0 text-left flex-1 relative h-7",
+                    inputClassName: "focus:ring-0 px-0 text-left flex-1 relative bg-transparent",
                     value: value,
                     defaultValue: !isControlled && pickerKey > 0 ? internalColor : defaultValue,
                     onChange: handleColorFieldsChange,

package/dist/components/UXColorPicker/types.d.ts

@@ -27,7 +27,7 @@ export interface UXColorPickerProps {
      */
     onValueChangeEnd?: (color: string) => void;
     /**
-     * 是否已改变
+     * 是否已改变（展示 reset 按钮）
      */
     isChanged?: boolean;
     /**

package/dist/components/UXThemeSwitch/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 默认字体
+ */
+export declare const DEFAULT_FONT_FAMILY = "Inter,system-ui,sans-serif,\"Microsoft YaHei\"";
+/**
+ * 预加载所有主题字体的 Google Fonts CSS
+ * 包含所有可能用到的字体，一次性加载，避免切换主题时重复加载
+ */
+export declare const PRELOAD_FONTS_URL = "https://fonts.googleapis.com/css2?family=Geist:wght@100..900&family=IBM+Plex+Sans:ital,wght@0,100..700;1,100..700&display=swap";

package/dist/components/UXThemeSwitch/constants.js

@@ -0,0 +1,3 @@
+const DEFAULT_FONT_FAMILY = 'Inter,system-ui,sans-serif,"Microsoft YaHei"';
+const PRELOAD_FONTS_URL = 'https://fonts.googleapis.com/css2?family=Geist:wght@100..900&family=IBM+Plex+Sans:ital,wght@0,100..700;1,100..700&display=swap';
+export { DEFAULT_FONT_FAMILY, PRELOAD_FONTS_URL };

package/dist/components/UXThemeSwitch/custom-theme-config.js

@@ -5,6 +5,7 @@ import { produce } from "immer";
 import { useI18n, useLang } from "../../hooks/index.js";
 import { HStack, VStack } from "../layout/index.js";
 import { Text } from "../typography/Text.js";
+import { UXButton } from "../UXButton/index.js";
 import { UXColorPicker } from "../UXColorPicker/index.js";
 import { UXSelect, UXSelectItem } from "../UXSelect/index.js";
 import { UXTab, UXTabs } from "../UXTabs/index.js";
@@ -28,17 +29,25 @@ const COLOR_CATEGORIES = {
         'secondary',
         'tertiary'
     ],
+    candle: [
+        'candleUp',
+        'candleBorderUp',
+        'candleWickUp',
+        'candleDown',
+        'candleBorderDown',
+        'candleWickDown'
+    ],
     signal: [
         'success',
         'danger',
-        'alert',
-        'gold'
+        'warning',
+        'alert'
     ]
 };
 const CustomThemeConfig = ()=>{
     const { lang } = useLang();
     const i18n = useI18n();
-    const { theme, setTheme } = useTheme();
+    const { theme, setTheme, setCustomTheme } = useTheme();
     const baseThemes = useMemo(()=>themeData.filter((t)=>'custom' !== t.id), []);
     const baseThemeId = theme.baseThemeId || DEFAULT_THEME_ID;
     const baseTheme = useMemo(()=>themeData.find((t)=>t.id === baseThemeId) || themeData.find((t)=>t.id === DEFAULT_THEME_ID), [
@@ -46,18 +55,38 @@ const CustomThemeConfig = ()=>{
     ]);
     const handleBaseThemeChange = (themeId)=>{
         const selectedBaseTheme = themeData.find((t)=>t.id === themeId);
-        if (selectedBaseTheme) setTheme({
-            ...theme,
-            baseThemeId: themeId,
-            colorScheme: selectedBaseTheme.colorScheme,
-            colorVariables: selectedBaseTheme.colorVariables
-        });
+        if (selectedBaseTheme) {
+            const updatedTheme = {
+                ...theme,
+                baseThemeId: themeId,
+                colorScheme: selectedBaseTheme.colorScheme,
+                colorVariables: selectedBaseTheme.colorVariables
+            };
+            setTheme(updatedTheme);
+            setCustomTheme(updatedTheme);
+        }
     };
     const handleColorChange = (color, value)=>{
         const updatedTheme = produce(theme, (draft)=>{
             draft.colorVariables[color] = value;
         });
         setTheme(updatedTheme);
+        setCustomTheme(updatedTheme);
+    };
+    const handleSwapUpDown = ()=>{
+        const updatedTheme = produce(theme, (draft)=>{
+            const { bullish, bearish, candleUp, candleDown, candleWickUp, candleWickDown, candleBorderUp, candleBorderDown } = draft.colorVariables;
+            draft.colorVariables.bullish = bearish;
+            draft.colorVariables.bearish = bullish;
+            draft.colorVariables.candleUp = candleDown;
+            draft.colorVariables.candleDown = candleUp;
+            draft.colorVariables.candleWickUp = candleWickDown;
+            draft.colorVariables.candleWickDown = candleWickUp;
+            draft.colorVariables.candleBorderUp = candleBorderDown;
+            draft.colorVariables.candleBorderDown = candleBorderUp;
+        });
+        setTheme(updatedTheme);
+        setCustomTheme(updatedTheme);
     };
     const getColorValue = (color)=>theme.colorVariables[color] || baseTheme.colorVariables[color] || '#000000';
     const renderColorItem = (color, label)=>{
@@ -82,12 +111,20 @@ const CustomThemeConfig = ()=>{
     return /*#__PURE__*/ jsxs(VStack, {
         gap: "lg",
         children: [
-            /*#__PURE__*/ jsx(HStack, {
+            /*#__PURE__*/ jsxs(HStack, {
                 justify: "between",
-                children: /*#__PURE__*/ jsx(Text, {
-                    body1Bold: true,
-                    children: i18n.theme.custom.title
-                })
+                children: [
+                    /*#__PURE__*/ jsx(Text, {
+                        body1Bold: true,
+                        children: i18n.theme.custom.title
+                    }),
+                    /*#__PURE__*/ jsx(UXButton, {
+                        variant: "text",
+                        color: "primary",
+                        onPress: handleSwapUpDown,
+                        children: i18n.theme.custom.swapUpDown
+                    })
+                ]
             }),
             /*#__PURE__*/ jsxs(HStack, {
                 justify: "between",
@@ -120,7 +157,7 @@ const CustomThemeConfig = ()=>{
                             gap: "md",
                             className: "pt-md",
                             children: colors.map((color)=>{
-                                const label = i18n.theme.custom.colors[color] || color;
+                                const label = i18n.colors[color] || color;
                                 return renderColorItem(color, label);
                             })
                         })

package/dist/components/UXThemeSwitch/theme-item.js

@@ -4,8 +4,11 @@ import { cn } from "@heroui/theme";
 import { useLang } from "../../hooks/index.js";
 import { VStack } from "../layout/index.js";
 import { Text } from "../typography/Text.js";
+import { useTheme } from "./use-theme.js";
 const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
     const { lang } = useLang();
+    const { customTheme } = useTheme();
+    const customColors = customTheme.colorVariables;
     return /*#__PURE__*/ jsxs(VStack, {
         gap: 2,
         items: "center",
@@ -13,7 +16,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
         onClick: onClick,
         children: [
             /*#__PURE__*/ jsx("div", {
-                className: cn('rounded-medium border-2 transition-all duration-300 hover:scale-105', 'h-[59px] w-[100px] md:h-[71px] md:w-[120px]', isSelected ? 'border-primary' : 'border-transparent'),
+                className: cn('rounded-medium border-2 border-transparent transition-all duration-300 hover:scale-105', 'h-[59px] w-[100px] md:h-[71px] md:w-[120px]', isSelected && 'border-primary'),
+                style: {
+                    borderColor: isSelected && 'custom' === id ? customColors.primary : void 0
+                },
                 children: /*#__PURE__*/ jsxs("svg", {
                     xmlns: "http://www.w3.org/2000/svg",
                     viewBox: "0 0 120 71",
@@ -27,7 +33,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "67",
                             rx: "5",
                             fill: "currentColor",
-                            className: "text-primary"
+                            className: "text-primary",
+                            style: {
+                                color: 'custom' === id ? customColors.primary : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("mask", {
                             id: "mask0_40928_218196",
@@ -46,7 +55,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                                 height: "67",
                                 rx: "5",
                                 fill: "currentColor",
-                                className: "text-background"
+                                className: "text-background",
+                                style: {
+                                    color: 'custom' === id ? customColors['bg-default'] : void 0
+                                }
                             })
                         }),
                         /*#__PURE__*/ jsx("g", {
@@ -58,7 +70,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                                 height: "67",
                                 rx: "6",
                                 fill: "currentColor",
-                                className: "text-background"
+                                className: "text-background",
+                                style: {
+                                    color: 'custom' === id ? customColors['bg-default'] : void 0
+                                }
                             })
                         }),
                         /*#__PURE__*/ jsx("rect", {
@@ -67,7 +82,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             width: "100",
                             height: "1",
                             fill: "currentColor",
-                            className: "text-divider"
+                            className: "text-divider",
+                            style: {
+                                color: 'custom' === id ? customColors.divider : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("rect", {
                             x: "54.082",
@@ -76,7 +94,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "6.01835",
                             rx: "3.00917",
                             fill: "currentColor",
-                            className: "text-foreground"
+                            className: "text-foreground",
+                            style: {
+                                color: 'custom' === id ? customColors.foreground : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("rect", {
                             x: "54.082",
@@ -85,7 +106,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "6.01835",
                             rx: "3.00917",
                             fill: "currentColor",
-                            className: "text-bullish"
+                            className: "text-bullish",
+                            style: {
+                                color: 'custom' === id ? customColors.bullish : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("rect", {
                             x: "75.8994",
@@ -94,7 +118,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "6.01835",
                             rx: "3.00917",
                             fill: "currentColor",
-                            className: "text-bearish"
+                            className: "text-bearish",
+                            style: {
+                                color: 'custom' === id ? customColors.bearish : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("rect", {
                             x: "86.4316",
@@ -103,7 +130,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "6.01835",
                             rx: "3.00917",
                             fill: "currentColor",
-                            className: "text-secondary"
+                            className: "text-secondary",
+                            style: {
+                                color: 'custom' === id ? customColors.secondary : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("rect", {
                             x: "94.707",
@@ -112,7 +142,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "6.01835",
                             rx: "3.00917",
                             fill: "currentColor",
-                            className: "text-secondary"
+                            className: "text-secondary",
+                            style: {
+                                color: 'custom' === id ? customColors.secondary : void 0
+                            }
                         }),
                         /*#__PURE__*/ jsx("rect", {
                             x: "102.981",
@@ -121,7 +154,10 @@ const ThemeItem = ({ id, zhName, enName, isSelected, onClick })=>{
                             height: "6.01835",
                             rx: "3.00917",
                             fill: "currentColor",
-                            className: "text-secondary"
+                            className: "text-secondary",
+                            style: {
+                                color: 'custom' === id ? customColors.secondary : void 0
+                            }
                         }),
                         'custom' === id ? /*#__PURE__*/ jsxs(Fragment, {
                             children: [

package/dist/components/UXThemeSwitch/theme-switch.js

@@ -34,14 +34,15 @@ const FONT_EXAMPLES = [
 ];
 const UXThemeSwitchModal = ({ as = 'modal', omitThemes = [], backdrop, isOpen, onClose, onOpenChange })=>{
     const i18n = useI18n();
-    const { theme: selectedTheme, setTheme, fontUrl, setFontUrl, fontName, fontLoadStatus, clearFontUrl } = useTheme();
+    const { theme: selectedTheme, customTheme: savedCustomTheme, setTheme, fontUrl, setFontUrl, fontName, fontLoadStatus, clearFontUrl } = useTheme();
     const [isFontExampleOpen, setIsFontExampleOpen] = useState(false);
     const Component = 'modal' === as ? UXModal : UXDrawer;
     const themes = useMemo(()=>themeData.filter((theme)=>!omitThemes.includes(theme.id)), [
         omitThemes
     ]);
     const handleThemeSelect = (theme)=>{
-        if ('custom' === theme.id && 'custom' !== selectedTheme.id) {
+        if ('custom' === theme.id) if (savedCustomTheme) setTheme(savedCustomTheme);
+        else {
             const baseTheme = themeData.find((t)=>t.id === DEFAULT_THEME_ID) || themeData["0"];
             const customTheme = {
                 ...theme,
@@ -50,7 +51,8 @@ const UXThemeSwitchModal = ({ as = 'modal', omitThemes = [], backdrop, isOpen, o
                 colorVariables: baseTheme.colorVariables
             };
             setTheme(customTheme);
-        } else setTheme(theme);
+        }
+        else setTheme(theme);
     };
     return /*#__PURE__*/ jsx(Component, {
         isOpen: isOpen,
@@ -81,8 +83,7 @@ const UXThemeSwitchModal = ({ as = 'modal', omitThemes = [], backdrop, isOpen, o
                 'custom' === selectedTheme.id && /*#__PURE__*/ jsxs(Fragment, {
                     children: [
                         /*#__PURE__*/ jsx(UXDivider, {}),
-                        /*#__PURE__*/ jsx(CustomThemeConfig, {}),
-                        /*#__PURE__*/ jsx(UXDivider, {})
+                        /*#__PURE__*/ jsx(CustomThemeConfig, {})
                     ]
                 }),
                 /*#__PURE__*/ jsx(UXDivider, {}),

package/dist/components/UXThemeSwitch/use-theme-color.d.ts

@@ -1,22 +1 @@
-export declare const useThemeColor: () => {
-    transparent: string;
-    white: string;
-    default: string;
-    alert: string;
-    success: string;
-    foreground: string;
-    secondary: string;
-    tertiary: string;
-    primary: string;
-    danger: string;
-    warning: string;
-    gold: string;
-    bullish: string;
-    bearish: string;
-    "bg-default": string;
-    "bg-300": string;
-    "bg-200": string;
-    "bg-400": string;
-    divider: string;
-    overlay: string;
-};
+export declare const useThemeColor: () => Record<import("@particle-network/ui-shared").ThemeColorVariable, string>;

package/dist/components/UXThemeSwitch/use-theme-color.js

@@ -1,14 +1,6 @@
-import { useMemo } from "react";
 import { useThemeStore } from "./use-theme-store.js";
 const useThemeColor = ()=>{
     const { colorVariables } = useThemeStore((state)=>state.theme);
-    const themeColor = useMemo(()=>({
-            ...colorVariables,
-            transparent: 'transparent',
-            white: '#FFFFFF'
-        }), [
-        colorVariables
-    ]);
-    return themeColor;
+    return colorVariables;
 };
 export { useThemeColor };

package/dist/components/UXThemeSwitch/use-theme-store.d.ts

@@ -5,6 +5,10 @@ interface State {
      * 保存的主题
      */
     theme: ThemeItemType;
+    /**
+     * 保存的自定义主题配置（当切换到其他主题时保存，切回 custom 时恢复）
+     */
+    customTheme: ThemeItemType;
     /**
      * 保存的字体链接
      */
@@ -20,6 +24,7 @@ interface State {
 }
 interface Actions {
     setTheme: (theme: ThemeItemType) => void;
+    setCustomTheme: (customTheme: ThemeItemType) => void;
     setFontUrl: (fontUrl: string) => void;
     setFontLoadStatus: (status: FontLoadStatus) => void;
     setFontName: (name: string) => void;

package/dist/components/UXThemeSwitch/use-theme-store.js

@@ -1,14 +1,18 @@
-import { themeData } from "@particle-network/ui-shared";
+import { CustomTheme, UXDarkTheme } from "@particle-network/ui-shared";
 import { create } from "zustand";
 import { createJSONStorage, persist } from "zustand/middleware";
 const useThemeStore = create()(persist((set)=>({
-        theme: themeData["0"],
+        theme: UXDarkTheme,
+        customTheme: CustomTheme,
         fontUrl: '',
         fontName: '',
         fontLoadStatus: 'idle',
         setTheme: (theme)=>set({
                 theme
             }),
+        setCustomTheme: (customTheme)=>set({
+                customTheme
+            }),
         setFontUrl: (fontUrl)=>set({
                 fontUrl
             }),
@@ -19,11 +23,12 @@ const useThemeStore = create()(persist((set)=>({
                 fontName
             })
     }), {
-    name: 'ux-preferences-theme',
-    version: 2,
+    name: 'ux-preference-theme',
+    version: 0,
     storage: createJSONStorage(()=>'undefined' != typeof window ? window.localStorage : {}),
     partialize: (state)=>({
             theme: state.theme,
+            customTheme: state.customTheme,
             fontName: state.fontName,
             fontUrl: state.fontUrl
         })

package/dist/components/UXThemeSwitch/use-theme.d.ts

@@ -4,7 +4,9 @@ import { type ThemeItemType } from '@particle-network/ui-shared';
  */
 export declare const useTheme: () => {
     theme: ThemeItemType;
+    customTheme: ThemeItemType;
     setTheme: (theme: ThemeItemType) => void;
+    setCustomTheme: (customTheme: ThemeItemType) => void;
     fontUrl: string;
     setFontUrl: (link: string) => void;
     clearFontUrl: () => void;

package/dist/components/UXThemeSwitch/use-theme.js

@@ -1,88 +1,15 @@
 import { useEffect } from "react";
-import { colorToCSSVariable, hexColorToHSLValue, themeKeys } from "@particle-network/ui-shared";
 import { useDebounceFn } from "ahooks";
 import { useThemeStore } from "./use-theme-store.js";
-const DEFAULT_FONT_FAMILY = 'Inter,system-ui,sans-serif,"Microsoft YaHei"';
-const PRELOAD_FONTS_URL = 'https://fonts.googleapis.com/css2?family=Geist:wght@100..900&family=IBM+Plex+Sans:ital,wght@0,100..700;1,100..700&display=swap';
-const preloadFonts = ()=>{
-    if ('undefined' == typeof window) return;
-    const existingLink = document.getElementById('ux-preload-fonts-link');
-    if (existingLink) return;
-    const linkElement = document.createElement('link');
-    linkElement.id = 'ux-preload-fonts-link';
-    linkElement.rel = 'stylesheet';
-    linkElement.href = PRELOAD_FONTS_URL;
-    document.head.appendChild(linkElement);
-};
-const applyCustomThemeColors = (theme)=>{
-    if ('undefined' == typeof window) return;
-    const root = document.documentElement;
-    Object.entries(theme.colorVariables).forEach(([color, value])=>{
-        const cssVariable = colorToCSSVariable[color]?.self;
-        if (cssVariable) cssVariable.forEach((variable)=>{
-            root.style.setProperty(variable, hexColorToHSLValue(value));
-        });
-    });
-};
-const clearCustomThemeColors = ()=>{
-    if ('undefined' == typeof window) return;
-    const root = document.documentElement;
-    Object.values(colorToCSSVariable).forEach((cssVar)=>{
-        cssVar.self?.forEach((variable)=>{
-            root.style.removeProperty(variable);
-        });
-    });
-};
-const applyTheme = (theme)=>{
-    if ('undefined' == typeof window) return;
-    const root = document.documentElement;
-    const isClassListCorrect = root.classList.contains(theme.id);
-    const isDataThemeCorrect = root.getAttribute('data-theme') === theme.colorScheme;
-    const isDataPrefersColorCorrect = root.getAttribute('data-prefers-color') === theme.colorScheme;
-    if ('custom' === theme.id) {
-        clearCustomThemeColors();
-        applyCustomThemeColors(theme);
-    } else clearCustomThemeColors();
-    if (isClassListCorrect && isDataThemeCorrect && isDataPrefersColorCorrect && 'custom' !== theme.id) return;
-    if (!isDataThemeCorrect) root.setAttribute('data-theme', theme.colorScheme);
-    if (!isDataPrefersColorCorrect) root.setAttribute('data-prefers-color', theme.colorScheme);
-    root.classList.remove('dark');
-    root.classList.remove('light');
-    if (!isClassListCorrect) {
-        themeKeys.forEach((key)=>{
-            root.classList.remove(key);
-        });
-        root.classList.add('custom' === theme.id ? theme.baseThemeId : theme.id);
-    }
-};
-const extractFontFamilyFromLink = (link)=>{
-    if (!link) return null;
-    try {
-        const url = new URL(link);
-        const familyParam = url.searchParams.get('family');
-        if (!familyParam) return null;
-        const firstFamily = familyParam.split('&family=')[0].split(':')[0].replace(/\+/g, ' ');
-        return firstFamily;
-    } catch  {
-        return null;
-    }
-};
-const applyFont = (fontName)=>{
-    if ('undefined' == typeof window) return;
-    if (fontName) {
-        document.documentElement.style.setProperty('--ux-font-family', `"${fontName}", ${DEFAULT_FONT_FAMILY}`);
-        document.body.style.fontFamily = `"${fontName}", ${DEFAULT_FONT_FAMILY}`;
-    } else {
-        document.documentElement.style.setProperty('--ux-font-family', DEFAULT_FONT_FAMILY);
-        document.body.style.fontFamily = DEFAULT_FONT_FAMILY;
-    }
-};
+import { applyFont, applyTheme, extractFontFamilyFromLink, preloadFonts } from "./utils.js";
 const useTheme = ()=>{
     const theme = useThemeStore((state)=>state.theme);
+    const customTheme = useThemeStore((state)=>state.customTheme);
     const fontUrl = useThemeStore((state)=>state.fontUrl);
     const fontName = useThemeStore((state)=>state.fontName);
     const fontLoadStatus = useThemeStore((state)=>state.fontLoadStatus);
     const storeSetTheme = useThemeStore((state)=>state.setTheme);
+    const storeSetCustomTheme = useThemeStore((state)=>state.setCustomTheme);
     const storeSetFontUrl = useThemeStore((state)=>state.setFontUrl);
     const storeSetFontLoadStatus = useThemeStore((state)=>state.setFontLoadStatus);
     const storeSetFontName = useThemeStore((state)=>state.setFontName);
@@ -142,7 +69,9 @@ const useTheme = ()=>{
     };
     return {
         theme,
+        customTheme,
         setTheme,
+        setCustomTheme: storeSetCustomTheme,
         fontUrl,
         setFontUrl,
         clearFontUrl,

package/dist/components/UXThemeSwitch/utils.d.ts

@@ -0,0 +1,28 @@
+import { type ThemeItemType } from '@particle-network/ui-shared';
+/**
+ * 初始化并预加载字体 CSS（仅执行一次）
+ */
+export declare const preloadFonts: () => void;
+export declare const setCSSProperty: (property: string, value: string) => void;
+/**
+ * 应用自定义主题的颜色到 CSS 变量
+ */
+export declare const applyCustomThemeColors: (theme: ThemeItemType) => void;
+/**
+ * 清除自定义主题的 CSS 变量（切换到其他主题时）
+ */
+export declare const clearCustomThemeColors: () => void;
+/**
+ * 应用主题到文档根元素
+ */
+export declare const applyTheme: (theme: ThemeItemType) => void;
+/**
+ * 从 Google Fonts 链接中提取字体名称
+ * 例如: https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&display=swap
+ * 提取: Roboto
+ */
+export declare const extractFontFamilyFromLink: (link: string) => string | null;
+/**
+ * 应用字体到 DOM
+ */
+export declare const applyFont: (fontName: string | undefined) => void;