@kupola/kupola 1.9.13 → 1.9.15

package/README.md

@@ -18,6 +18,73 @@
 - [English](#english)
 - [中文](#中文)
 
+---
+
+## 📦 构建工具插件
+
+### Vite 插件
+
+```js
+// vite.config.js
+import { kupola } from '@kupola/kupola/vite';
+
+export default {
+  plugins: [kupola()]
+};
+```
+
+**配置选项：**
+
+| 选项 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `autoCSS` | boolean | `true` | 自动注入 Kupola CSS |
+| `autoImport` | boolean | `true` | 自动导入 `useDeps`/`useQuery` |
+| `devTools` | boolean | `true` | 开发模式下启用调试工具 |
+| `cssPath` | string | `null` | 自定义 CSS 路径 |
+| `themePreload` | boolean | `false` | 自动注入主题预加载脚本 |
+
+### Webpack 插件
+
+```js
+// webpack.config.js
+const KupolaWebpackPlugin = require('@kupola/kupola/webpack');
+
+module.exports = {
+  plugins: [new KupolaWebpackPlugin()]
+};
+```
+
+**配置选项：**
+
+| 选项 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `autoCSS` | boolean | `true` | 自动注入 Kupola CSS |
+| `themePreload` | boolean | `false` | 自动注入主题预加载脚本 |
+| `cssPath` | string | `null` | 自定义 CSS 路径 |
+
+### themePreload 配置说明
+
+**默认值：`false`**（v1.9.13 变更）
+
+`themePreload` 用于在 CSS 加载前设置主题属性，防止主题切换时的闪屏问题。请根据你的使用方式决定是否开启：
+
+| 使用方式 | themePreload | 说明 |
+|---------|-------------|------|
+| **ESM + initTheme()** | `false`（默认） | JS 模块加载时自动初始化，无需预加载 |
+| **UMD / 纯 CSS** | `true` | 需要在 CSS 加载前设置主题，防止闪屏 |
+
+**开启示例：**
+
+```js
+// Vite
+kupola({ themePreload: true })
+
+// Webpack
+new KupolaWebpackPlugin({ themePreload: true })
+```
+
+---
+
 ## 📖 Documentation
 
 - [**用户文档**](https://kupola-cn.github.io/kupola/docs/index.html) — 安装、组件速查、核心 API、主题、后端集成
@@ -26,6 +93,71 @@
 ---
 
 <a id="english"></a>
+## 📦 Build Tool Plugins
+
+### Vite Plugin
+
+```js
+// vite.config.js
+import { kupola } from '@kupola/kupola/vite';
+
+export default {
+  plugins: [kupola()]
+};
+```
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|--------|-------------|
+| `autoCSS` | boolean | `true` | Auto inject Kupola CSS |
+| `autoImport` | boolean | `true` | Auto import `useDeps`/`useQuery` |
+| `devTools` | boolean | `true` | Enable dev tools in dev mode |
+| `cssPath` | string | `null` | Custom CSS path |
+| `themePreload` | boolean | `false` | Auto inject theme preload script |
+
+### Webpack Plugin
+
+```js
+// webpack.config.js
+const KupolaWebpackPlugin = require('@kupola/kupola/webpack');
+
+module.exports = {
+  plugins: [new KupolaWebpackPlugin()]
+};
+```
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|--------|-------------|
+| `autoCSS` | boolean | `true` | Auto inject Kupola CSS |
+| `themePreload` | boolean | `false` | Auto inject theme preload script |
+| `cssPath` | string | `null` | Custom CSS path |
+
+### themePreload Configuration
+
+**Default: `false`** (Changed in v1.9.13)
+
+`themePreload` sets theme attributes before CSS loads to prevent flash of unstyled content during theme switching. Enable it based on your usage pattern:
+
+| Usage Pattern | themePreload | Reason |
+|--------------|-------------|--------|
+| **ESM + initTheme()** | `false` (default) | JS module initializes automatically on load |
+| **UMD / CSS-only** | `true` | Needs theme set before CSS loads to prevent flash |
+
+**Example with themePreload enabled:**
+
+```js
+// Vite
+kupola({ themePreload: true })
+
+// Webpack
+new KupolaWebpackPlugin({ themePreload: true })
+```
+
+---
+
 ## ✨ Features
 
 - **50+ UI Components** — Buttons, inputs, cards, modals, datepickers, timepickers, heatmap, virtual list, stat cards, and more

package/css/dashboard.css

@@ -264,26 +264,77 @@ body.ds-dashboard-page {
 
 /* Responsive adjustments for tablet */
 @media (max-width: 1024px) and (min-width: 769px) {
+  .ds-dashboard__header-center {
+    display: none;
+  }
+  
+  .ds-dashboard__content {
+    padding: var(--spacer-12);
+    padding-bottom: calc(var(--spacer-12) + 56px);
+  }
+  
   .ds-dashboard__sidebar {
-    width: 44px;
+    position: fixed;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    width: 100%;
+    height: 56px;
+    flex-direction: row;
+    justify-content: space-around;
+    align-items: center;
+    padding: 0;
+    border-right: none;
+    border-top: 1px solid var(--border-neutral-l1);
+    z-index: 100;
+    background: var(--bg-base-secondary);
+    backdrop-filter: blur(10px);
+  }
+  
+  .ds-dashboard__sidebar-nav {
+    flex-direction: row;
+    width: 100%;
+    justify-content: space-around;
+    padding: 0;
   }
   
   .ds-dashboard__sidebar-item {
-    width: 34px;
-    height: 34px;
+    width: 48px;
+    height: 48px;
+    margin: 0;
+    flex-direction: column;
+    gap: 2px;
   }
   
   .ds-dashboard__sidebar-item img {
-    width: 16px;
-    height: 16px;
+    width: 18px;
+    height: 18px;
   }
   
-  .ds-dashboard__header-center {
+  .ds-dashboard__sidebar-item::before {
     display: none;
   }
   
-  .ds-dashboard__content {
-    padding: var(--spacer-12);
+  .ds-dashboard__sidebar-item::after {
+    display: none;
+  }
+  
+  .ds-dashboard__sidebar-item span {
+    display: block;
+    font-size: 10px;
+    color: inherit;
+  }
+  
+  .ds-dashboard__sidebar-divider {
+    display: none;
+  }
+  
+  .ds-dashboard__sidebar-bottom {
+    display: none;
+  }
+  
+  .ds-dashboard__footer {
+    display: none;
   }
 }
 
@@ -299,12 +350,12 @@ body.ds-dashboard-page {
   
   .ds-dashboard__content {
     padding: var(--spacer-8);
-    padding-bottom: calc(var(--spacer-8) + 56px + var(--dashboard-footer-height, 24px));
+    padding-bottom: calc(var(--spacer-8) + 56px);
   }
   
   .ds-dashboard__sidebar {
     position: fixed;
-    bottom: var(--dashboard-footer-height, 24px);
+    bottom: 0;
     left: 0;
     right: 0;
     width: 100%;
@@ -363,6 +414,6 @@ body.ds-dashboard-page {
   }
   
   .ds-dashboard__footer {
-    padding-bottom: calc(env(safe-area-inset-bottom) + 4px);
+    display: none;
   }
 }

package/css/kupola.css

@@ -1,6 +1,5 @@
 @import url('colors-and-type.css');
-@import url('theme-dark.css');
-@import url('theme-light.css');
+@import url('theme.css');
 @import url('brand-themes.css');
 @import url('scaffold.css');
 @import url('dashboard.css');