@fangxinyan/lumina 0.6.11 → 0.6.13

package/dist/index.d.cts

@@ -49,6 +49,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.11";
+declare const VERSION = "0.6.13";
 
 export { VERSION };

package/dist/index.d.ts

@@ -49,6 +49,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.11";
+declare const VERSION = "0.6.13";
 
 export { VERSION };

package/dist/index.js

@@ -1,54 +1,54 @@
-export { Tabs } from './chunk-GVPGJXZT.js';
-export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-ZTIECMCF.js';
-export { Timeline } from './chunk-7IWYBQAE.js';
-export { Tooltip } from './chunk-TWJAYAK2.js';
-export { Link, Paragraph, Text, Title, Typography } from './chunk-NUF3EA7T.js';
-export { Slider } from './chunk-Q5KHJ32P.js';
-export { Splitter } from './chunk-R53WIZY5.js';
-export { StatusBar, StatusBarItem } from './chunk-HR5QBBIS.js';
-export { SURFACE_THEME_PRESETS, Surface } from './chunk-WIZVOZNO.js';
+export { Tabs } from './chunk-5MCFW2HC.js';
+export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-BX45WJRT.js';
+export { Timeline } from './chunk-VGERRI4S.js';
+export { Tooltip } from './chunk-HYXA7S43.js';
+export { Link, Paragraph, Text, Title, Typography } from './chunk-O7OPFKAM.js';
+export { Slider } from './chunk-JST4HJ3I.js';
+export { Splitter } from './chunk-LM5XXSGE.js';
+export { StatusBar, StatusBarItem } from './chunk-E2OC4CUE.js';
+export { SURFACE_THEME_PRESETS, Surface } from './chunk-GGNBMIZ2.js';
 import './chunk-6SPMHY54.js';
-export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, FONT_STACKS, ThemeProvider, applyTheme, normalizeAccentInput, resolveThemeColorScheme, resolveThemeMode, useTheme, useThemeOptional } from './chunk-7ZCTEIOW.js';
-export { Switch } from './chunk-6VSNO7IH.js';
-export { TablePro } from './chunk-CBZJ4UL4.js';
-export { Table } from './chunk-5JNRCBTF.js';
-export { MessageContainer, ToastContainer, message, toast } from './chunk-62RPBEAW.js';
-export { Modal } from './chunk-SGNDIRZC.js';
-export { Pagination } from './chunk-5CWTC3I2.js';
-export { Popover } from './chunk-QKWRN2JL.js';
-export { Progress } from './chunk-44WHEN76.js';
-export { Radio, RadioGroup } from './chunk-P434GBHP.js';
-export { Select } from './chunk-MOLKLUSQ.js';
-export { Tag } from './chunk-I5XCHN67.js';
-export { Skeleton } from './chunk-JPAYPF6H.js';
-export { Drawer } from './chunk-EXN64ADJ.js';
-export { Empty } from './chunk-RYRBNMCC.js';
-export { Form, FormItem, useForm } from './chunk-ACZA7HHP.js';
-export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-GEANNF4T.js';
-export { InputNumber } from './chunk-3VXBSLPT.js';
-export { List } from './chunk-Q77BWQNG.js';
-export { Card } from './chunk-HEBBQZUT.js';
-export { Spin } from './chunk-3GJZRYTD.js';
-export { Cascader } from './chunk-FPII6I52.js';
-export { Checkbox } from './chunk-PHONNUK2.js';
-export { Collapse } from './chunk-OVTB7FQQ.js';
-export { ColorPicker } from './chunk-AHS2AFTD.js';
-export { CommandPalette } from './chunk-64ZQHLHL.js';
-export { ContextMenu } from './chunk-XN52S7PT.js';
-export { Divider } from './chunk-PWPL3DRN.js';
-export { Alert } from './chunk-762NV3E4.js';
-export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-WIBAYFBB.js';
-export { AutoComplete } from './chunk-ZCMFLRZS.js';
+export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, FONT_STACKS, ThemeProvider, applyTheme, normalizeAccentInput, resolveThemeColorScheme, resolveThemeMode, useTheme, useThemeOptional } from './chunk-DEXYWDHF.js';
+export { Switch } from './chunk-BK4XKZUO.js';
+export { TablePro } from './chunk-R3JCW3ES.js';
+export { Table } from './chunk-GVULVTWO.js';
+export { MessageContainer, ToastContainer, message, toast } from './chunk-HAA5C5YW.js';
+export { Modal } from './chunk-WY6AEPFW.js';
+export { Pagination } from './chunk-EVKLGNVR.js';
+export { Popover } from './chunk-BAWP2QVY.js';
+export { Progress } from './chunk-LFPFFSN2.js';
+export { Radio, RadioGroup } from './chunk-TAHZH6DJ.js';
+export { Select } from './chunk-UMLRSKBE.js';
+export { Tag } from './chunk-DCATZUT3.js';
+export { Skeleton } from './chunk-V5HMQGFD.js';
+export { Drawer } from './chunk-A7BI7YWZ.js';
+export { Empty } from './chunk-7RNT6KN4.js';
+export { Form, FormItem, useForm } from './chunk-XJTDCWKP.js';
+export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-JKFGLYMM.js';
+export { InputNumber } from './chunk-KRVWQKTZ.js';
+export { List } from './chunk-2M5WJENK.js';
+export { Card } from './chunk-Q4IAUKAW.js';
+export { Spin } from './chunk-LA62SD2F.js';
+export { Cascader } from './chunk-VJVXXCNL.js';
+export { Checkbox } from './chunk-5GKALAMP.js';
+export { Collapse } from './chunk-6Z4PZWND.js';
+export { ColorPicker } from './chunk-QVWCUKEY.js';
+export { CommandPalette } from './chunk-TTXYZDQ3.js';
+export { ContextMenu } from './chunk-ZNR6LWTQ.js';
+export { Divider } from './chunk-NZBOHEQA.js';
+export { Alert } from './chunk-RUE3QE6T.js';
+export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-UROQO2HR.js';
+export { AutoComplete } from './chunk-EKNDL2XB.js';
 import './chunk-DUFRASGO.js';
-export { Input, InputPassword } from './chunk-QDXBI3PV.js';
-export { TextArea, Textarea } from './chunk-7DNK5JB2.js';
-export { Avatar } from './chunk-TJB7U72Z.js';
-export { Badge } from './chunk-BY2YW5XN.js';
-export { Button, IconButton } from './chunk-VRA4CQCJ.js';
-export { Calendar } from './chunk-W72IIGOV.js';
-export { AimOutlined, AppstoreOutlined, BarChartOutlined, BlockOutlined, BorderOutlined, CameraOutlined, CaretDownOutlined, CaretUpOutlined, CheckCircleFilled, CheckCircleOutlined, CheckOutlined, ClockCircleFilled, CloseCircleOutlined, CloseOutlined, CopyOutlined, DashboardOutlined, DeleteOutlined, DownOutlined, EnvironmentOutlined, ExclamationCircleOutlined, FolderOpenOutlined, ICON_NAMES, Icon, LeftOutlined, LoadingOutlined, MinusCircleOutlined, MinusOutlined, NAMED_ICON_MAP, PictureOutlined, PlusOutlined, QqOutlined, ReloadOutlined, RightOutlined, RobotOutlined, SearchOutlined, SettingOutlined, StarFilled, StarOutlined, SwapOutlined, SwapRightOutlined, SyncOutlined, ThunderboltOutlined, TranslationOutlined, UnorderedListOutlined, UserOutlined, isIconName, renderIconSlot, resolveIconName } from './chunk-SNX4FZYB.js';
+export { Input, InputPassword } from './chunk-IZGHMMX7.js';
+export { TextArea, Textarea } from './chunk-M63HWVOS.js';
+export { Avatar } from './chunk-TCWGIRAW.js';
+export { Badge } from './chunk-T7RV2UMU.js';
+export { Button, IconButton } from './chunk-CQKQ7KS2.js';
+export { Calendar } from './chunk-J3LUTXVO.js';
+export { AimOutlined, AppstoreOutlined, BarChartOutlined, BlockOutlined, BorderOutlined, CameraOutlined, CaretDownOutlined, CaretUpOutlined, CheckCircleFilled, CheckCircleOutlined, CheckOutlined, ClockCircleFilled, CloseCircleOutlined, CloseOutlined, CopyOutlined, DashboardOutlined, DeleteOutlined, DownOutlined, EnvironmentOutlined, ExclamationCircleOutlined, FolderOpenOutlined, ICON_NAMES, Icon, LeftOutlined, LoadingOutlined, MinusCircleOutlined, MinusOutlined, NAMED_ICON_MAP, PictureOutlined, PlusOutlined, QqOutlined, ReloadOutlined, RightOutlined, RobotOutlined, SearchOutlined, SettingOutlined, StarFilled, StarOutlined, SwapOutlined, SwapRightOutlined, SyncOutlined, ThunderboltOutlined, TranslationOutlined, UnorderedListOutlined, UserOutlined, isIconName, renderIconSlot, resolveIconName } from './chunk-HHBXCBZP.js';
 
 // src/index.ts
-var VERSION = "0.6.11";
+var VERSION = "0.6.13";
 
 export { VERSION };

package/dist/styles.css

@@ -18,7 +18,7 @@
   --shadow-dark: rgba(163, 177, 198, 0.55);
   --shadow-light: rgba(255, 255, 255, 0.95);
 
-  /* Distance multiplier — driven by ThemeProvider `intensity` (1..10 → 0.4..1.6). */
+  /* Distance multiplier — driven by ThemeProvider `intensity` (ThemePanel: 0..20 → 0.4..2.8). */
   --d: 1;
   --shadow-scale: 1;
   --shadow-float-scale: 1;
@@ -1136,7 +1136,9 @@ input, textarea, select { font-family: inherit; color: inherit; }
 /* center is default (both flex: 1) */
 /* ============ Card ============ */
 .card {
-  background: var(--bg);
+  --card-bg: var(--bg);
+  --card-loading-bg: color-mix(in srgb, var(--bg) 72%, var(--bg-sunken));
+  background: var(--card-bg);
   border-radius: var(--r-lg);
   box-shadow: var(--neu-shadow-panel);
   padding: var(--gap-5);
@@ -1199,7 +1201,7 @@ input, textarea, select { font-family: inherit; color: inherit; }
   border-radius: var(--r-md);
   display: grid;
   place-items: center;
-  background: color-mix(in srgb, var(--bg) 72%, var(--bg-sunken));
+  background: var(--card-loading-bg);
   box-shadow:
     inset calc(var(--shadow-inset-offset) * 0.45) calc(var(--shadow-inset-offset) * 0.45) calc(var(--shadow-inset-blur) * 0.45) color-mix(in oklch, var(--shadow-dark) 55%, transparent),
     inset calc(var(--shadow-inset-offset) * -0.45) calc(var(--shadow-inset-offset) * -0.45) calc(var(--shadow-inset-blur) * 0.45) color-mix(in oklch, var(--shadow-light) 72%, transparent);

package/dist/{tokens-RGFJKRC7.css → tokens-OJLK3XMZ.css}

@@ -18,7 +18,7 @@
   --shadow-dark: rgba(163, 177, 198, 0.55);
   --shadow-light: rgba(255, 255, 255, 0.95);
 
-  /* Distance multiplier — driven by ThemeProvider `intensity` (1..10 → 0.4..1.6). */
+  /* Distance multiplier — driven by ThemeProvider `intensity` (ThemePanel: 0..20 → 0.4..2.8). */
   --d: 1;
   --shadow-scale: 1;
   --shadow-float-scale: 1;

package/dist/tokens.css

@@ -18,7 +18,7 @@
   --shadow-dark: rgba(163, 177, 198, 0.55);
   --shadow-light: rgba(255, 255, 255, 0.95);
 
-  /* Distance multiplier — driven by ThemeProvider `intensity` (1..10 → 0.4..1.6). */
+  /* Distance multiplier — driven by ThemeProvider `intensity` (ThemePanel: 0..20 → 0.4..2.8). */
   --d: 1;
   --shadow-scale: 1;
   --shadow-float-scale: 1;

package/docs/llms/card.md

@@ -28,6 +28,26 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 <Card hoverable>可点击卡片</Card>
 ```
 
+### 自定义背景色
+
+background 可覆盖卡片根节点背景，纯色、主题 token、color-mix 与渐变都走同一个字段。
+
+```tsx
+<Card background="color-mix(in oklch, var(--accent-soft) 70%, var(--bg))">
+  主题强调底色
+</Card>
+```
+
+### 渐变背景
+
+background 支持完整 CSS 背景值，适合给看板、概览指标或状态卡片做轻量分层。
+
+```tsx
+<Card background="linear-gradient(135deg, var(--bg-raised), var(--accent-soft))">
+  渐变卡片
+</Card>
+```
+
 ### 带标题
 
 带标题、描述、操作区。
@@ -76,6 +96,7 @@ loading 会在正文区域显示中性 overlay；默认 Spin 跟随主题色，l
 | Prop | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
 | variant | `"raised" | "flat" | "sunken"` | `"raised"` | 视觉变体 |
+| background | `CSSProperties["background"]` | — | 自定义卡片根节点背景，支持主题 token / color-mix / linear-gradient / radial-gradient 等 CSS 背景值 |
 | padding | `"none" | "sm" | "md" | "lg"` | `"md"` | 内边距 |
 | hoverable | `boolean` | `false` | 悬浮时抬起 |
 | title | `ReactNode` | — | 标题 |

package/docs/llms/theme.md

@@ -24,7 +24,7 @@ function Root() {
       accent="violet"      // 预设 或 自定义颜色
       themes={{ graphite: { base: "dark", tokens: {} } }}
       density="comfortable"
-      intensity={5}        // 1..10 阴影强度
+      intensity={5}        // 0..20 阴影强度
       radius={20}          // 圆角基准 px
       font="sf"            // 字体预设
       storageKey="app:theme"   // 持久化到 localStorage
@@ -189,10 +189,10 @@ applyTheme(document.documentElement, {
 | colorScheme | `"light" | "dark"` | `"light"` | 自定义模式使用的 light/dark 基底 |
 | accent | `AccentKey | CustomAccentInput` | `"sky"` | 强调色,预设或自定义 |
 | density | `"compact" | "comfortable" | "spacious"` | `"comfortable"` | 密度 |
-| intensity | `number` | `5` | 阴影强度 1-10 |
+| intensity | `number` | `5` | 阴影强度;ThemePanel 默认调节范围 0-20 |
 | radius | `number` | `20` | 圆角基准 px |
 | font | `FontConfig` | `"sf"` | 字体预设或 CSS 栈 |
-| tokens | `Record<string, string>` | — | 任意 CSS 变量覆写;推荐用语义阴影 token 和 shadow-scale / shadow-float-scale 控制阴影系统 |
+| tokens | `Record<string, string>` | — | 任意 CSS 变量覆写;推荐用语义阴影 token 和 shadow-scale(0.2-3) / shadow-float-scale(0.2-4) 控制阴影系统 |
 | themes | `Record<string, ThemePreset>` | — | 命名自定义模式 preset |
 | ThemePreset.label / description | `string` | — | 可选展示元信息;ThemePanel 会读取它作为卡片标题和说明 |
 | target | `"root" | "scope"` | `"root"` | 应用到根还是局部 |

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.6.11`
+- **版本**: `0.6.13`
 - **React 最低版本**: 18
 - **环境**: 带打包器的 React 工程(Vite / Next.js / Webpack / Remix / Electron + Vite 等)
 - **零运行时依赖**: 只依赖 `react` / `react-dom` (peer deps)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fangxinyan/lumina",
-  "version": "0.6.11",
+  "version": "0.6.13",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",