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

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: 1,
+    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,65 +1,15 @@
 import { useEffect } from "react";
-import { 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 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 (isClassListCorrect && isDataThemeCorrect && isDataPrefersColorCorrect) 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(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);
@@ -97,6 +47,11 @@ const useTheme = ()=>{
         applyTheme(theme);
         debouncedApplyFont(fontUrl, theme.fontName);
     }, []);
+    useEffect(()=>{
+        applyTheme(theme);
+    }, [
+        theme
+    ]);
     const setTheme = (theme)=>{
         storeSetTheme(theme);
         applyTheme(theme);
@@ -114,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;

package/dist/components/UXThemeSwitch/utils.js

@@ -0,0 +1,202 @@
+import { hexColorToHSLValue, themeKeys } from "@particle-network/ui-shared";
+import { readableColor } from "color2k";
+import { generateThemeColor } from "../../heroui/utils/colors.js";
+import { DEFAULT_FONT_FAMILY, PRELOAD_FONTS_URL } from "./constants.js";
+const getCSSProperties = (theme)=>{
+    const { colorVariables } = theme;
+    return {
+        foreground: [
+            [
+                '--heroui-foreground',
+                colorVariables.foreground
+            ]
+        ],
+        secondary: [
+            ...generateThemeColor(colorVariables.secondary, 'secondary', theme.colorScheme).cssVariables,
+            [
+                '--heroui-foreground-300',
+                colorVariables.secondary
+            ]
+        ],
+        tertiary: [
+            [
+                '--heroui-tertiary',
+                colorVariables.tertiary
+            ],
+            [
+                '--heroui-foreground-100',
+                colorVariables.tertiary
+            ],
+            [
+                '--heroui-tertiary-foreground',
+                readableColor(colorVariables.tertiary)
+            ]
+        ],
+        primary: generateThemeColor(colorVariables.primary, 'primary', theme.colorScheme).cssVariables,
+        success: generateThemeColor(colorVariables.success, 'success', theme.colorScheme).cssVariables,
+        danger: generateThemeColor(colorVariables.danger, 'danger', theme.colorScheme).cssVariables,
+        alert: [
+            [
+                '--heroui-alert',
+                colorVariables.alert
+            ],
+            [
+                '--heroui-alert-foreground',
+                readableColor(colorVariables.alert)
+            ]
+        ],
+        warning: generateThemeColor(colorVariables.warning, 'warning', theme.colorScheme).cssVariables,
+        'bg-default': [
+            [
+                '--heroui-background',
+                colorVariables['bg-default']
+            ],
+            [
+                '--heroui-background-500',
+                colorVariables['bg-default']
+            ]
+        ],
+        'bg-200': [
+            [
+                '--heroui-background-200',
+                colorVariables['bg-200']
+            ]
+        ],
+        'bg-300': [
+            [
+                '--heroui-background-300',
+                colorVariables['bg-300']
+            ]
+        ],
+        'bg-400': [
+            [
+                '--heroui-background-400',
+                colorVariables['bg-400']
+            ]
+        ],
+        overlay: [
+            [
+                '--heroui-overlay',
+                colorVariables.overlay
+            ],
+            [
+                '--heroui-content1',
+                colorVariables.overlay
+            ],
+            [
+                '--heroui-overlay-foreground',
+                readableColor(colorVariables.overlay)
+            ],
+            [
+                '--heroui-content1-foreground',
+                readableColor(colorVariables.overlay)
+            ]
+        ],
+        divider: [
+            [
+                '--heroui-divider',
+                colorVariables.divider
+            ],
+            [
+                '--heroui-divider-foreground',
+                readableColor(colorVariables.divider)
+            ]
+        ],
+        bullish: [
+            [
+                '--heroui-bullish',
+                colorVariables.bullish
+            ],
+            [
+                '--heroui-bullish-foreground',
+                readableColor(colorVariables.bullish)
+            ]
+        ],
+        bearish: [
+            [
+                '--heroui-bearish',
+                colorVariables.bearish
+            ],
+            [
+                '--heroui-bearish-foreground',
+                readableColor(colorVariables.bearish)
+            ]
+        ]
+    };
+};
+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 setCSSProperty = (property, value)=>{
+    if ('undefined' == typeof window) return;
+    const root = document.documentElement;
+    root.style.setProperty(property, hexColorToHSLValue(value));
+};
+const applyCustomThemeColors = (theme)=>{
+    if ('undefined' == typeof window) return;
+    const cssProperties = getCSSProperties(theme);
+    Object.entries(cssProperties).forEach(([, value])=>{
+        value.forEach(([variable, value])=>{
+            setCSSProperty(variable, value);
+        });
+    });
+};
+const clearCustomThemeColors = ()=>{
+    if ('undefined' == typeof window) return;
+    const rootStyles = getComputedStyle(document.documentElement);
+    Array.from(rootStyles).filter((prop)=>prop.startsWith('--heroui')).forEach((prop)=>{
+        document.documentElement.style.removeProperty(prop);
+    });
+};
+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;
+    }
+};
+export { applyCustomThemeColors, applyFont, applyTheme, clearCustomThemeColors, extractFontFamilyFromLink, preloadFonts, setCSSProperty };

package/dist/components/typography/Text.type.d.ts

@@ -1,5 +1,5 @@
 import type React from 'react';
-import type { UXForegroundColor } from '@particle-network/ui-shared';
+import type { HexColor, UXForegroundColor } from '@particle-network/ui-shared';
 type TextVariant = 'h1' | 'h2' | 'h3' | 'body1' | 'body1Bold' | 'body2' | 'body2Bold' | 'body3' | 'body3Bold' | 'caption1' | 'caption1Bold';
 type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold' | 'extrabold';
 type TextLineHeight = '1' | '1.4';
@@ -75,7 +75,7 @@ export interface TextProps extends React.HTMLAttributes<HTMLSpanElement> {
      * | extrabold | 800         |
      */
     fontWeight?: TextWeight;
-    color?: UXForegroundColor | `#${string}`;
+    color?: UXForegroundColor | HexColor;
     lineHeight?: TextLineHeight;
     align?: TextAlign;
 }

package/dist/components/typography/Text.type.js

@@ -23,7 +23,6 @@ const textClasses = {
         danger: 'text-danger',
         alert: 'text-alert',
         warning: 'text-warning',
-        gold: 'text-gold',
         bullish: 'text-bullish',
         bearish: 'text-bearish'
     },

package/dist/heroui/constants.d.ts

@@ -0,0 +1,18 @@
+import type { Config, ConfigColors, ConfigLayout } from './types';
+export declare const defaultDarkColorWeight = 20;
+export declare const defaultLightColorWeight = 17.5;
+export declare const colorWeight = 17.5;
+export declare const floatNumberPattern: RegExp;
+export declare const colorsId = "th-colors";
+export declare const defaultColorsId = "th-default-colors";
+export declare const baseColorsId = "th-base-colors";
+export declare const otherColorsId = "th-other-colors";
+export declare const showcaseId = "th-showcase";
+export declare const contentShowcaseId = "th-content-showcase";
+export declare const contentColorsId = "th-content-colors";
+export declare const configKey = "config";
+export declare const syncThemesKey = "sync-themes";
+export declare const initialLightTheme: ConfigColors;
+export declare const initialDarkTheme: ConfigColors;
+export declare const initialLayout: ConfigLayout;
+export declare const initialConfig: Config;

package/dist/heroui/constants.js

@@ -0,0 +1,98 @@
+import { colors } from "@heroui/theme";
+const defaultDarkColorWeight = 20;
+const defaultLightColorWeight = 17.5;
+const colorWeight = 17.5;
+const floatNumberPattern = /^\d+(\.\d*)?$/;
+const colorsId = 'th-colors';
+const defaultColorsId = 'th-default-colors';
+const baseColorsId = 'th-base-colors';
+const otherColorsId = 'th-other-colors';
+const showcaseId = 'th-showcase';
+const contentShowcaseId = 'th-content-showcase';
+const contentColorsId = 'th-content-colors';
+const configKey = 'config';
+const syncThemesKey = 'sync-themes';
+const initialLightTheme = {
+    defaultColor: {
+        default: '#d4d4d8'
+    },
+    baseColor: {
+        primary: colors.blue["500"],
+        secondary: colors.purple["500"],
+        success: colors.green["500"],
+        warning: colors.yellow["500"],
+        danger: colors.red["500"]
+    },
+    layoutColor: {
+        foreground: colors.black,
+        background: colors.white,
+        focus: colors.blue["500"],
+        overlay: colors.white
+    },
+    contentColor: {
+        content1: colors.white,
+        content2: colors.zinc["100"],
+        content3: colors.zinc["200"],
+        content4: colors.zinc["300"]
+    }
+};
+const initialDarkTheme = {
+    defaultColor: {
+        default: colors.zinc["700"]
+    },
+    baseColor: {
+        primary: colors.blue["500"],
+        secondary: colors.purple["500"],
+        success: colors.green["500"],
+        warning: colors.yellow["500"],
+        danger: colors.red["500"]
+    },
+    layoutColor: {
+        foreground: colors.white,
+        background: colors.black,
+        focus: colors.blue["500"],
+        overlay: colors.black
+    },
+    contentColor: {
+        content1: colors.zinc["900"],
+        content2: colors.zinc["800"],
+        content3: colors.zinc["700"],
+        content4: colors.zinc["600"]
+    }
+};
+const initialLayout = {
+    fontSize: {
+        tiny: '0.75',
+        small: '0.875',
+        medium: '1',
+        large: '1.125'
+    },
+    lineHeight: {
+        tiny: '1',
+        small: '1.25',
+        medium: '1.5',
+        large: '1.75'
+    },
+    radius: {
+        small: '0.5',
+        medium: '0.75',
+        large: '0.875'
+    },
+    borderWidth: {
+        small: '1',
+        medium: '2',
+        large: '3'
+    },
+    otherParams: {
+        disabledOpacity: '0.5',
+        dividerWeight: '1',
+        hoverOpacity: '0.9'
+    }
+};
+const initialConfig = {
+    name: 'heroui',
+    light: initialLightTheme,
+    dark: initialDarkTheme,
+    layout: initialLayout
+};
+export { baseColorsId, colorWeight, colorsId, configKey, contentColorsId, contentShowcaseId, defaultColorsId, defaultDarkColorWeight, defaultLightColorWeight, floatNumberPattern, initialConfig, initialDarkTheme, initialLayout, initialLightTheme, otherColorsId, showcaseId, syncThemesKey };

package/dist/heroui/types.d.ts

@@ -0,0 +1,91 @@
+export interface ColorShades {
+    50: string;
+    100: string;
+    200: string;
+    300: string;
+    400: string;
+    500: string;
+    600: string;
+    700: string;
+    800: string;
+    900: string;
+}
+export type ColorPickerType = 'background' | 'content1' | 'content2' | 'content3' | 'content4' | 'danger' | 'default' | 'divider' | 'focus' | 'foreground' | 'overlay' | 'primary' | 'secondary' | 'success' | 'warning';
+export type Color = 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
+export type Size = 'sm' | 'md' | 'lg';
+export type Variant = 'dot' | 'solid' | 'faded' | 'bordered' | 'light' | 'flat' | 'ghost' | 'shadow' | 'underlined';
+export type Radius = 'none' | 'sm' | 'md' | 'lg' | 'full';
+export type HeroUIScaling = 90 | 95 | 100 | 105 | 110;
+export type Border = 'thin' | 'medium' | 'thick';
+export type FontName = 'Inter' | 'Roboto' | 'Outfit' | 'Lora';
+export type ThemeType = 'light' | 'dark';
+export interface ThemeColor extends ColorShades {
+    foreground: string;
+    DEFAULT: string;
+}
+export interface Config {
+    name: TemplateType;
+    light: ConfigColors;
+    dark: ConfigColors;
+    layout: ConfigLayout;
+}
+export interface ConfigColors {
+    defaultColor: {
+        default: string;
+    };
+    baseColor: {
+        primary: string;
+        secondary: string;
+        success: string;
+        warning: string;
+        danger: string;
+    };
+    layoutColor: {
+        foreground: string;
+        background: string;
+        focus: string;
+        overlay: string;
+    };
+    contentColor: {
+        content1: string;
+        content2: string;
+        content3: string;
+        content4: string;
+    };
+}
+export interface ConfigLayout {
+    fontSize: {
+        tiny: string;
+        small: string;
+        medium: string;
+        large: string;
+    };
+    lineHeight: {
+        tiny: string;
+        small: string;
+        medium: string;
+        large: string;
+    };
+    radius: {
+        small: string;
+        medium: string;
+        large: string;
+    };
+    borderWidth: {
+        small: string;
+        medium: string;
+        large: string;
+    };
+    otherParams: {
+        disabledOpacity: string;
+        dividerWeight: string;
+        hoverOpacity: string;
+    };
+}
+export interface Template {
+    label: string;
+    name: TemplateType;
+    value: Config;
+}
+export type TemplateType = 'coffee' | 'emerald' | 'heroui' | 'elegant' | 'modern' | 'retro';
+export type FontType = 'Inter' | 'Roboto' | 'Outfit' | 'Lora';

package/dist/heroui/utils/colors.d.ts

@@ -0,0 +1,34 @@
+import type { ColorPickerType, ThemeType } from '../types';
+import Values from 'values.js';
+/**
+ * Convert color values to RGB
+ */
+export declare function colorValuesToRgb(value: Values): string;
+/**
+ * Convert hex color to HSL
+ */
+export declare function hexToHsl(hex: string): string;
+/**
+ * Get the color weight
+ */
+export declare function getColorWeight(colorType: ColorPickerType, theme: ThemeType): 20 | 17.5;
+/**
+ * Generate theme color
+ */
+export declare function generateThemeColor(color: string, type: ColorPickerType, theme: ThemeType): {
+    twTheme: {
+        foreground: string;
+        DEFAULT: string;
+        50: string;
+        100: string;
+        200: string;
+        300: string;
+        400: string;
+        500: string;
+        600: string;
+        700: string;
+        800: string;
+        900: string;
+    };
+    cssVariables: string[][];
+};