ice-render 1.0.3 → 1.0.5

package/dist/types/theme/ICETheme.d.mts

@@ -0,0 +1,382 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * 主题机制：三层 design token + 命名主题 + 优先级链。
+ *
+ * 分层（对齐设计 token 标准）：
+ *   ① base（基础）—— 原始值：色 ramp / spacing / radius / fontSize / fontFamily / fontWeight。
+ *   ② semantic（语义）—— 用途：primary / danger / text / border / palette / motion，引用 base。
+ *   ③ component（组件）—— STYLE_PRESETS 预设，引用 semantic + base。
+ *
+ * 优先级链（对齐 ECharts）：用户 props > 组件 preset > 语义 theme > 基础 default。
+ *
+ * 命名主题：registerTheme(name, theme) 注册，setTheme('dark') 按名切换；内置 default + dark。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+export declare const baseTokens: {
+    color: {
+        blue: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        emerald: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        amber: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        red: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        gray: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        violet: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        teal: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        pink: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        indigo: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+    };
+    spacing: {
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+        6: number;
+        8: number;
+        12: number;
+        16: number;
+    };
+    radius: {
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        full: number;
+    };
+    fontSize: {
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        '2xl': number;
+        '3xl': number;
+        '4xl': number;
+    };
+    fontFamily: {
+        base: string;
+    };
+    fontWeight: {
+        normal: number;
+        bold: number;
+    };
+};
+export interface ICESemanticTheme {
+    primary: string;
+    success: string;
+    warning: string;
+    danger: string;
+    info: string;
+    text: string;
+    muted: string;
+    hint: string;
+    border: string;
+    background: string;
+    palette: string[];
+    motion: {
+        duration: {
+            fast: number;
+            normal: number;
+            slow: number;
+            slower: number;
+        };
+        easing: {
+            linear: string;
+            out: string;
+            inOut: string;
+            outQuart: string;
+            spring: string;
+            springSoft: string;
+            springSnappy: string;
+        };
+    };
+}
+export interface ICETheme {
+    base: typeof baseTokens;
+    semantic: ICESemanticTheme;
+}
+export declare const DEFAULT_THEME: ICETheme;
+export declare const DARK_THEME: ICETheme;
+/**
+ * 注册命名主题（运行时注入，如多品牌 / 多租户）。
+ */
+export declare function registerTheme(name: string, theme: ICETheme): void;
+/**
+ * 解析主题但**不修改任何全局状态**：
+ * - string：按名查注册表（如 'dark'）；未注册时回退 DEFAULT_THEME。
+ * - object：浅合并到 `base` 的 semantic（兼容旧用法 `setTheme({ primary: ... })`）。
+ *
+ * 这是「实例级主题」的基础：`ICE` 用它把自己持有的主题解析出来，
+ * 不污染模块级当前主题（模块级只作为**默认值**）。
+ */
+export declare function resolveTheme(nameOrTheme: string | Partial<ICESemanticTheme>, base?: ICETheme): ICETheme;
+/**
+ * 切换**模块级默认主题**（全局单例）。
+ *
+ * 注意：这是「本进程默认值」，会影响此后新建的 `ICE` 实例以及未显式设置主题的实例。
+ * 需要多实例/多品牌各自独立时，请用 `ice.setTheme()`（实例级，互不影响）。
+ */
+export declare function setTheme(nameOrTheme: string | Partial<ICESemanticTheme>): ICETheme;
+export declare function getTheme(): ICETheme;
+export declare const STYLE_PRESETS: {
+    [name: string]: (theme: ICETheme) => any;
+};
+declare const _default: {
+    baseTokens: {
+        color: {
+            blue: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            emerald: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            amber: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            red: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            gray: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            violet: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            teal: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            pink: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+            indigo: {
+                50: string;
+                100: string;
+                200: string;
+                300: string;
+                400: string;
+                500: string;
+                600: string;
+                700: string;
+                800: string;
+                900: string;
+            };
+        };
+        spacing: {
+            1: number;
+            2: number;
+            3: number;
+            4: number;
+            6: number;
+            8: number;
+            12: number;
+            16: number;
+        };
+        radius: {
+            sm: number;
+            md: number;
+            lg: number;
+            xl: number;
+            full: number;
+        };
+        fontSize: {
+            sm: number;
+            md: number;
+            lg: number;
+            xl: number;
+            '2xl': number;
+            '3xl': number;
+            '4xl': number;
+        };
+        fontFamily: {
+            base: string;
+        };
+        fontWeight: {
+            normal: number;
+            bold: number;
+        };
+    };
+    DEFAULT_THEME: ICETheme;
+    DARK_THEME: ICETheme;
+    registerTheme: typeof registerTheme;
+    setTheme: typeof setTheme;
+    getTheme: typeof getTheme;
+    STYLE_PRESETS: {
+        [name: string]: (theme: ICETheme) => any;
+    };
+};
+export default _default;