@fangxinyan/lumina 0.6.13 → 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.13";
+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.13";
+declare const VERSION = "0.6.14";
 
 export { VERSION };

package/dist/index.js

@@ -1,54 +1,54 @@
-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';
+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-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';
+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-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';
+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.13";
+var VERSION = "0.6.14";
 
 export { VERSION };

package/dist/styles.css

@@ -13,6 +13,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);
 
   /* ---- Shadows ---- */
   --shadow-dark: rgba(163, 177, 198, 0.55);
@@ -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-OJLK3XMZ.css → tokens-RYJ3DFTU.css}

@@ -13,6 +13,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);
 
   /* ---- Shadows ---- */
   --shadow-dark: rgba(163, 177, 198, 0.55);
@@ -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,6 +13,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);
 
   /* ---- Shadows ---- */
   --shadow-dark: rgba(163, 177, 198, 0.55);
@@ -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.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.6.13`
+- **版本**: `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.13",
+  "version": "0.6.14",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",