@fangxinyan/lumina 0.6.12 → 0.6.14

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.12";
+declare const VERSION = "0.6.14";
 
 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.12";
+declare const VERSION = "0.6.14";
 
 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-ZTCRD2FL.js';
+export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-3VSHGM54.js';
+export { Timeline } from './chunk-OTSDPQPV.js';
+export { Tooltip } from './chunk-MOZ52KN6.js';
+export { Link, Paragraph, Text, Title, Typography } from './chunk-6HF6UF73.js';
+export { Slider } from './chunk-D7GK6H6V.js';
+export { Splitter } from './chunk-IZHH6CVY.js';
+export { StatusBar, StatusBarItem } from './chunk-TYLDISRK.js';
+export { SURFACE_THEME_PRESETS, Surface } from './chunk-JFL2WMJZ.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-RBDBEXUU.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-GNV6W4BN.js';
+export { Switch } from './chunk-PU7VXDAS.js';
+export { TablePro } from './chunk-QNN3YV2P.js';
+export { Table } from './chunk-4YSGGZDB.js';
+export { MessageContainer, ToastContainer, message, toast } from './chunk-P64NPZBG.js';
+export { Modal } from './chunk-BVQOJKRX.js';
+export { Pagination } from './chunk-6LC4QROE.js';
+export { Popover } from './chunk-I777JTTG.js';
+export { Progress } from './chunk-KMPFESEV.js';
+export { Radio, RadioGroup } from './chunk-KYV75JPQ.js';
+export { Select } from './chunk-6PHPRZTT.js';
+export { Tag } from './chunk-6K5YI4ZE.js';
+export { Skeleton } from './chunk-R3DTXVP2.js';
+export { Drawer } from './chunk-WMGMIE2D.js';
+export { Empty } from './chunk-6MEOLYNQ.js';
+export { Form, FormItem, useForm } from './chunk-ZR4IMROK.js';
+export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-EQ4FPOQQ.js';
+export { InputNumber } from './chunk-3VXGZ3SJ.js';
+export { List } from './chunk-YAFDVNXT.js';
+export { Card } from './chunk-ARUPS7JH.js';
+export { Spin } from './chunk-FYSXJXNW.js';
+export { Cascader } from './chunk-4HJBF4GY.js';
+export { Checkbox } from './chunk-ZD3L4V3H.js';
+export { Collapse } from './chunk-6LN4VVX7.js';
+export { ColorPicker } from './chunk-TJECLLN4.js';
+export { CommandPalette } from './chunk-5MOYKVB7.js';
+export { ContextMenu } from './chunk-AAPZLBHQ.js';
+export { Divider } from './chunk-HBO7ZDEQ.js';
+export { Alert } from './chunk-A6O25EP2.js';
+export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-XCXUGHDF.js';
+export { AutoComplete } from './chunk-CFZVWY5N.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-IOAOG5L7.js';
+export { TextArea, Textarea } from './chunk-S7IHWY24.js';
+export { Avatar } from './chunk-RR2BKV65.js';
+export { Badge } from './chunk-DSLYWX4O.js';
+export { Button, IconButton } from './chunk-IPSNC5VZ.js';
+export { Calendar } from './chunk-XG5D777V.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-FDZG27IG.js';
 
 // src/index.ts
-var VERSION = "0.6.12";
+var VERSION = "0.6.14";
 
 export { VERSION };

package/dist/styles.css

@@ -13,12 +13,13 @@
   --fg-subtle: #9ca7ba;
   --border: rgba(130, 148, 175, 0.14);
   --divider: rgba(130, 148, 175, 0.18);
+  --mask-bg: color-mix(in oklch, black 18%, transparent);
 
   /* ---- Shadows ---- */
   --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;
@@ -138,6 +139,7 @@
   --fg-subtle: #9ca7ba;
   --border: rgba(130, 148, 175, 0.14);
   --divider: rgba(130, 148, 175, 0.18);
+  --mask-bg: color-mix(in oklch, black 18%, transparent);
   --shadow-dark: rgba(163, 177, 198, 0.55);
   --shadow-light: rgba(255, 255, 255, 0.95);
   --shadow-offset: calc(6px * var(--d) * var(--shadow-scale));
@@ -159,6 +161,7 @@
   --fg-subtle: #5f6a82;
   --border: rgba(0, 0, 0, 0.35);
   --divider: rgba(255, 255, 255, 0.06);
+  --mask-bg: color-mix(in oklch, black 55%, transparent);
   /* 强 dark shadow 提供深度;light 高光几乎不可见,去掉白圈效果 */
   --shadow-dark: rgba(0, 0, 0, 0.55);
   --shadow-light: rgba(130, 145, 180, 0.06);
@@ -1628,7 +1631,7 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .modal-overlay {
   position: fixed;
   inset: 0;
-  background: color-mix(in oklch, var(--bg-sunken) 60%, transparent);
+  background: var(--modal-mask-bg, var(--mask-bg));
   backdrop-filter: blur(8px);
   display: grid;
   place-items: center;
@@ -1723,7 +1726,7 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .drawer-overlay {
   position: fixed;
   inset: 0;
-  background: color-mix(in oklch, var(--bg-sunken) 50%, transparent);
+  background: var(--drawer-mask-bg, var(--mask-bg));
   backdrop-filter: blur(4px);
   z-index: 150;
   animation: fadeIn var(--dur) var(--ease);
@@ -2746,7 +2749,7 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .n-image:hover .image-hint { opacity: 1; transform: translateY(0); }
 .image-preview-overlay {
   position: fixed; inset: 0;
-  background: color-mix(in oklch, var(--bg-sunken) 82%, transparent);
+  background: var(--image-preview-mask-bg, var(--mask-bg));
   backdrop-filter: blur(16px);
   display: grid; place-items: center;
   z-index: 500;

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

@@ -13,12 +13,13 @@
   --fg-subtle: #9ca7ba;
   --border: rgba(130, 148, 175, 0.14);
   --divider: rgba(130, 148, 175, 0.18);
+  --mask-bg: color-mix(in oklch, black 18%, transparent);
 
   /* ---- Shadows ---- */
   --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;
@@ -139,6 +140,7 @@
   --fg-subtle: #9ca7ba;
   --border: rgba(130, 148, 175, 0.14);
   --divider: rgba(130, 148, 175, 0.18);
+  --mask-bg: color-mix(in oklch, black 18%, transparent);
   --shadow-dark: rgba(163, 177, 198, 0.55);
   --shadow-light: rgba(255, 255, 255, 0.95);
   --shadow-offset: calc(6px * var(--d) * var(--shadow-scale));
@@ -161,6 +163,7 @@
   --fg-subtle: #5f6a82;
   --border: rgba(0, 0, 0, 0.35);
   --divider: rgba(255, 255, 255, 0.06);
+  --mask-bg: color-mix(in oklch, black 55%, transparent);
   /* 强 dark shadow 提供深度;light 高光几乎不可见,去掉白圈效果 */
   --shadow-dark: rgba(0, 0, 0, 0.55);
   --shadow-light: rgba(130, 145, 180, 0.06);

package/dist/tokens.css

@@ -13,12 +13,13 @@
   --fg-subtle: #9ca7ba;
   --border: rgba(130, 148, 175, 0.14);
   --divider: rgba(130, 148, 175, 0.18);
+  --mask-bg: color-mix(in oklch, black 18%, transparent);
 
   /* ---- Shadows ---- */
   --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;
@@ -139,6 +140,7 @@
   --fg-subtle: #9ca7ba;
   --border: rgba(130, 148, 175, 0.14);
   --divider: rgba(130, 148, 175, 0.18);
+  --mask-bg: color-mix(in oklch, black 18%, transparent);
   --shadow-dark: rgba(163, 177, 198, 0.55);
   --shadow-light: rgba(255, 255, 255, 0.95);
   --shadow-offset: calc(6px * var(--d) * var(--shadow-scale));
@@ -161,6 +163,7 @@
   --fg-subtle: #5f6a82;
   --border: rgba(0, 0, 0, 0.35);
   --divider: rgba(255, 255, 255, 0.06);
+  --mask-bg: color-mix(in oklch, black 55%, transparent);
   /* 强 dark shadow 提供深度;light 高光几乎不可见,去掉白圈效果 */
   --shadow-dark: rgba(0, 0, 0, 0.55);
   --shadow-light: rgba(130, 145, 180, 0.06);

package/docs/llms/drawer.md

@@ -44,6 +44,17 @@ placement 控制滑出方向;top / bottom 用 size 控高度。
 <Drawer mask={false} />
 ```
 
+### 遮罩定制
+
+默认遮罩使用中性 --mask-bg,不跟随 --bg-sunken 的色相;maskClassName / maskStyle 可定制遮罩层。
+
+```tsx
+<Drawer
+  maskClassName="settings-drawer-mask"
+  maskStyle={{ background: "var(--mask-bg)", backdropFilter: "none" }}
+/>
+```
+
 ## API
 
 **Drawer**
@@ -58,6 +69,8 @@ placement 控制滑出方向;top / bottom 用 size 控高度。
 | extra | `ReactNode` | — | 标题右侧的附加操作区 |
 | mask | `boolean` | `true` | 是否渲染遮罩 |
 | maskClosable | `boolean` | `true` | 点击遮罩关闭 |
+| maskClassName | `string` | — | 遮罩层 className |
+| maskStyle | `CSSProperties` | — | 遮罩层内联样式 |
 | keyboard | `boolean` | `true` | Esc 关闭 |
 | closable | `boolean` | `true` | 右上角 × |
 | closeIcon | `ReactNode` | — | 自定义关闭图标 |

package/docs/llms/image.md

@@ -16,6 +16,18 @@ import { Image, ImageGrid, SpriteImage, LayeredImage } from "@fangxinyan/lumina"
 <Image src={url} width={240} height={160} />
 ```
 
+### 预览遮罩
+
+全屏预览默认使用中性 --mask-bg,previewClassName / previewStyle 可单独控制预览蒙层。
+
+```tsx
+<Image
+  src={url}
+  previewClassName="asset-preview-mask"
+  previewStyle={{ background: "var(--mask-bg)", backdropFilter: "none" }}
+/>
+```
+
 ### 图标 / 原始资源
 
 variant="icon" 会默认去掉外层 padding,适合 1:1 装备、物品、头像缩略图；variant="raw" 保留原始图片比例。
@@ -68,6 +80,8 @@ LayeredImage 将多张图片叠在同一个盒子里,适合头像 + 头像框、
 | padding | `number | string` | — | 外层留白,raw/icon 默认 0 |
 | objectFit / objectPosition | `CSSProperties` | — | 底层 img 的 object-fit / object-position |
 | preview | `boolean` | `true` | 支持点击全屏预览 |
+| previewClassName | `string` | — | 预览蒙层 className |
+| previewStyle | `CSSProperties` | — | 预览蒙层内联样式 |
 | hover | `boolean` | `true` | 悬浮放大 |
 | placeholder | `ReactNode` | — | 占位/错误时内容 |
 | imgProps | `ImgHTMLAttributes` | — | 透传到底层 img 的属性 |

package/docs/llms/modal.md

@@ -34,6 +34,17 @@ Modal.confirm({
 Modal.warning({ title: "容量不足", content: "请先清理缓存。" });
 ```
 
+### 遮罩定制
+
+默认遮罩使用中性 --mask-bg,不跟随 --bg-sunken 的色相;maskClassName / maskStyle 可定制遮罩层。
+
+```tsx
+<Modal
+  maskClassName="settings-mask"
+  maskStyle={{ background: "var(--mask-bg)", backdropFilter: "none" }}
+/>
+```
+
 ### 确认操作 (footer 自定义)
 
 用 footer 自定义底部按钮。传 null 可以去掉 footer。
@@ -115,6 +126,8 @@ bodyClassName / bodyStyle / bodyProps 可直接作用到正文容器；bodyOverf
 | closable | `boolean` | `true` | 显示右上角 × |
 | closeIcon | `ReactNode` | — | 自定义关闭图标 |
 | maskClosable | `boolean` | `true` | 点击遮罩关闭 |
+| maskClassName | `string` | — | 遮罩层 className |
+| maskStyle | `CSSProperties` | — | 遮罩层内联样式 |
 | escClosable | `boolean` | `true` | Esc 关闭 |
 | width | `number | string` | `440` | 宽度 |
 | destroyOnClose | `boolean` | `false` | 关闭时卸载子树 |

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.12`
+- **版本**: `0.6.14`
 - **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.12",
+  "version": "0.6.14",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",