@admin-core/design 0.1.0 → 0.2.0

package/dist/theme/utils.d.ts

@@ -0,0 +1,230 @@
+import { ThemeMode, ThemeVariant, ThemeConfig, ThemeChangeOptions, ColorValue } from './types';
+/**
+ * 获取 HTML 根元素
+ */
+export declare function getHtmlElement(): HTMLElement;
+/**
+ * 从 localStorage 获取主题模式
+ */
+export declare function getStoredMode(): ThemeMode | null;
+/**
+ * 从 localStorage 获取主题变体
+ */
+export declare function getStoredVariant(): ThemeVariant | null;
+/**
+ * 保存主题模式到 localStorage
+ */
+export declare function storeMode(mode: ThemeMode): void;
+/**
+ * 保存主题变体到 localStorage
+ */
+export declare function storeVariant(variant: ThemeVariant): void;
+/**
+ * 清除存储的主题配置
+ */
+export declare function clearStoredTheme(): void;
+/**
+ * 应用主题模式到 DOM
+ */
+export declare function applyMode(mode: ThemeMode): void;
+/**
+ * 应用主题变体到 DOM
+ */
+export declare function applyVariant(variant: ThemeVariant): void;
+/**
+ * 获取当前主题模式
+ */
+export declare function getCurrentMode(): ThemeMode;
+/**
+ * 获取当前主题变体
+ */
+export declare function getCurrentVariant(): ThemeVariant;
+/**
+ * 应用主题配置
+ */
+export declare function applyTheme(config: Partial<ThemeConfig>, options?: ThemeChangeOptions): void;
+/**
+ * 启用主题切换过渡动画
+ */
+export declare function enableTransition(): void;
+/**
+ * 禁用主题切换过渡动画
+ */
+export declare function disableTransition(): void;
+/**
+ * 切换暗色模式
+ */
+export declare function toggleDarkMode(options?: ThemeChangeOptions): ThemeMode;
+/**
+ * 初始化主题
+ * 从 localStorage 恢复主题配置，如果没有则使用默认值
+ */
+export declare function initTheme(): ThemeConfig;
+/**
+ * 检测系统主题偏好
+ */
+export declare function detectSystemTheme(): ThemeMode;
+/**
+ * 监听系统主题变化
+ */
+export declare function watchSystemTheme(callback: (mode: ThemeMode) => void): () => void;
+/**
+ * 获取所有可用主题
+ */
+export declare function getAvailableThemes(): import('./types').ThemeMetadata[];
+/**
+ * 根据 ID 获取主题元数据
+ */
+export declare function getThemeMetadata(variant: ThemeVariant): import('./types').ThemeMetadata | undefined;
+/**
+ * 解析 HSL 颜色字符串
+ * @param hsl - HSL 颜色字符串，格式：'hsl(262.1, 83.3%, 57.8%)' 或 '262.1 83.3% 57.8%'
+ */
+export declare function parseHSL(hsl: string): ColorValue | null;
+/**
+ * 将 ColorValue 转换为 HSL 字符串
+ */
+export declare function toHSLString(color: ColorValue): string;
+/**
+ * 获取 CSS 变量值
+ */
+export declare function getCSSVariable(name: string): string;
+/**
+ * 设置 CSS 变量值
+ */
+export declare function setCSSVariable(name: string, value: string): void;
+/**
+ * 获取主题颜色
+ */
+export declare function getThemeColor(token: string): string;
+/**
+ * 验证主题变体是否有效
+ */
+export declare function isValidVariant(variant: string): variant is ThemeVariant;
+/**
+ * 验证主题模式是否有效
+ */
+export declare function isValidMode(mode: string): mode is ThemeMode;
+/**
+ * 自定义主题颜色配置
+ */
+export interface CustomThemeColors {
+    /** 主色 */
+    primary?: string;
+    /** 主色前景色 */
+    primaryForeground?: string;
+    /** 次要色 */
+    secondary?: string;
+    /** 次要色前景色 */
+    secondaryForeground?: string;
+    /** 强调色 */
+    accent?: string;
+    /** 强调色前景色 */
+    accentForeground?: string;
+    /** 柔和色 */
+    muted?: string;
+    /** 柔和色前景色 */
+    mutedForeground?: string;
+    /** 背景色 */
+    background?: string;
+    /** 深层背景色 */
+    backgroundDeep?: string;
+    /** 前景色 */
+    foreground?: string;
+    /** 卡片背景色 */
+    card?: string;
+    /** 卡片前景色 */
+    cardForeground?: string;
+    /** 边框色 */
+    border?: string;
+    /** 输入框边框色 */
+    input?: string;
+    /** 焦点环颜色 */
+    ring?: string;
+    /** 侧边栏背景色 */
+    sidebar?: string;
+    /** 侧边栏深层背景色 */
+    sidebarDeep?: string;
+    /** 头部背景色 */
+    header?: string;
+    /** 菜单背景色 */
+    menu?: string;
+}
+/**
+ * 应用自定义主题颜色
+ * @param colors - 自定义颜色配置（HSL 格式，如 '280 35% 65%' 或 'hsl(280, 35%, 65%)'）
+ * @param persist - 是否持久化到 localStorage
+ *
+ * @example
+ * ```typescript
+ * // 设置自定义主色
+ * applyCustomTheme({
+ *   primary: '280 35% 65%',
+ *   primaryForeground: '0 0% 98%'
+ * })
+ *
+ * // 使用完整的 HSL 格式
+ * applyCustomTheme({
+ *   primary: 'hsl(280, 35%, 65%)',
+ *   accent: 'hsl(200, 85%, 50%)'
+ * })
+ * ```
+ */
+export declare function applyCustomTheme(colors: CustomThemeColors, persist?: boolean): void;
+/**
+ * 获取存储的自定义主题颜色
+ */
+export declare function getStoredCustomTheme(): CustomThemeColors | null;
+/**
+ * 清除自定义主题颜色
+ */
+export declare function clearCustomTheme(): void;
+/**
+ * 恢复自定义主题颜色
+ */
+export declare function restoreCustomTheme(): boolean;
+/**
+ * 从 HEX 颜色转换为 HSL
+ * @param hex - HEX 颜色字符串，如 '#8B5CF6'
+ * @returns HSL 格式字符串，如 '280 35% 65%'
+ */
+export declare function hexToHSL(hex: string): string;
+/**
+ * 从 RGB 颜色转换为 HSL
+ * @param r - 红色值 (0-255)
+ * @param g - 绿色值 (0-255)
+ * @param b - 蓝色值 (0-255)
+ * @returns HSL 格式字符串，如 '280 35% 65%'
+ */
+export declare function rgbToHSL(r: number, g: number, b: number): string;
+/**
+ * 生成完整的主题配色方案（基于单一主色）
+ * @param primaryColor - 主色（HEX 或 HSL 格式）
+ * @param mode - 主题模式（light 或 dark）
+ * @returns 完整的主题颜色配置
+ *
+ * @example
+ * ```typescript
+ * // 从紫色生成完整配色
+ * const colors = generateThemeFromPrimary('#8B5CF6', 'light')
+ * applyCustomTheme(colors)
+ * ```
+ */
+export declare function generateThemeFromPrimary(primaryColor: string, mode?: ThemeMode): CustomThemeColors;
+/**
+ * 应用基于主色的完整主题
+ * @param primaryColor - 主色（HEX 或 HSL 格式）
+ * @param mode - 主题模式（默认使用当前模式）
+ * @param persist - 是否持久化
+ *
+ * @example
+ * ```typescript
+ * // 使用 HEX 颜色
+ * applyThemeFromPrimary('#8B5CF6')
+ *
+ * // 指定模式并持久化
+ * applyThemeFromPrimary('#8B5CF6', 'dark', true)
+ * ```
+ */
+export declare function applyThemeFromPrimary(primaryColor: string, mode?: ThemeMode, persist?: boolean): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/theme/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/theme/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@admin-core/design",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "description": "设计系统（样式、令牌）",
@@ -25,10 +25,23 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./style.css": "./dist/style.css",
     "./css": "./dist/style.css",
+    "./css/index.css": "./src/css/index.css",
+    "./tokens/light.css": "./src/tokens/light.css",
+    "./tokens/dark.css": "./src/tokens/dark.css",
     "./umd": "./dist/index.umd.js",
+    "./theme": {
+      "types": "./src/theme/index.ts",
+      "import": "./src/theme/index.ts"
+    },
     "./scss-bem": "./src/scss-bem/bem.scss",
-    "./scss-bem/*": "./src/scss-bem/*"
+    "./scss-bem/*": "./src/scss-bem/*",
+    "./tailwind.config": {
+      "types": "./tailwind.config.ts",
+      "import": "./tailwind.config.ts",
+      "require": "./tailwind.config.ts"
+    }
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -46,5 +59,13 @@
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "sass": "catalog:",
+    "tailwindcss": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vite-plugin-dts": "catalog:"
   }
 }