@fangxinyan/lumina 0.6.17 → 0.7.0

package/dist/Image.d.ts

@@ -1,7 +1,19 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
 type ImageVariant = "framed" | "raw" | "icon";
-interface ImageProps extends React.HTMLAttributes<HTMLDivElement> {
+type ImagePreviewMode = "fit" | "actual";
+interface ImagePreviewToolbarRenderProps {
+    scale: number;
+    mode: ImagePreviewMode;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    fitToWindow: () => void;
+    actualSize: () => void;
+    reset: () => void;
+    close: () => void;
+}
+interface ImageProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     src?: string;
     alt?: string;
     width?: number | string;
@@ -22,6 +34,12 @@ interface ImageProps extends React.HTMLAttributes<HTMLDivElement> {
     previewClassName?: string;
     /** Inline style forwarded to the full-screen preview overlay. */
     previewStyle?: React.CSSProperties;
+    /** Max width of the image inside the preview overlay. Defaults to 80vw. */
+    previewMaxWidth?: number | string;
+    /** Max height of the image inside the preview overlay. Defaults to 80vh. */
+    previewMaxHeight?: number | string;
+    /** Render extra controls in the preview toolbar. */
+    renderPreviewToolbar?: (props: ImagePreviewToolbarRenderProps) => React.ReactNode;
     /** Hover scale-up. */
     hover?: boolean;
     /** Custom placeholder while loading or on error. */
@@ -30,19 +48,12 @@ interface ImageProps extends React.HTMLAttributes<HTMLDivElement> {
     imgProps?: Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src" | "alt" | "width" | "height">;
     className?: string;
 }
-/**
- * `Image` — image surface with framed, raw and icon-oriented variants.
- *
- * @example
- * <Image src={url} width={240} height={160} />
- * <Image variant="icon" src={iconUrl} width={48} height={48} preview={false} />
- */
 declare const Image: React.ForwardRefExoticComponent<ImageProps & React.RefAttributes<HTMLDivElement>>;
 interface ImageGridItem extends Omit<ImageProps, "children"> {
     src: string;
     alt?: string;
 }
-interface ImageGridProps extends React.HTMLAttributes<HTMLDivElement> {
+interface ImageGridProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     images: ImageGridItem[];
     columns?: number;
     itemHeight?: number;
@@ -51,7 +62,6 @@ interface ImageGridProps extends React.HTMLAttributes<HTMLDivElement> {
     imageProps?: Omit<ImageProps, "src" | "alt" | "width" | "height">;
     className?: string;
 }
-/** `ImageGrid` — auto-fit grid of `Image` items. */
 declare const ImageGrid: React.ForwardRefExoticComponent<ImageGridProps & React.RefAttributes<HTMLDivElement>>;
 interface SpriteRect {
     x: number;
@@ -59,7 +69,7 @@ interface SpriteRect {
     width: number;
     height: number;
 }
-interface SpriteImageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+interface SpriteImageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children">, ComponentThemeProps {
     src: string;
     sprite: SpriteRect;
     alt?: string;
@@ -72,12 +82,6 @@ interface SpriteImageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "c
     padding?: number | string;
     className?: string;
 }
-/**
- * `SpriteImage` — crops one rectangle from a sprite sheet.
- *
- * @example
- * <SpriteImage src={sheetUrl} sprite={{ x: 64, y: 32, width: 32, height: 32 }} />
- */
 declare const SpriteImage: React.ForwardRefExoticComponent<SpriteImageProps & React.RefAttributes<HTMLDivElement>>;
 type LayeredImageInset = number | string | Partial<Record<"top" | "right" | "bottom" | "left", number | string>>;
 interface LayeredImageLayer extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src" | "alt" | "width" | "height"> {
@@ -87,7 +91,7 @@ interface LayeredImageLayer extends Omit<React.ImgHTMLAttributes<HTMLImageElemen
     inset?: LayeredImageInset;
     zIndex?: number;
 }
-interface LayeredImageProps extends React.HTMLAttributes<HTMLDivElement> {
+interface LayeredImageProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     layers: LayeredImageLayer[];
     width?: number | string;
     height?: number | string;
@@ -96,12 +100,6 @@ interface LayeredImageProps extends React.HTMLAttributes<HTMLDivElement> {
     padding?: number | string;
     className?: string;
 }
-/**
- * `LayeredImage` — stacks several images in the same box, useful for avatar + frame assets.
- *
- * @example
- * <LayeredImage layers={[{ src: headUrl }, { src: frameUrl }]} width={48} height={48} />
- */
 declare const LayeredImage: React.ForwardRefExoticComponent<LayeredImageProps & React.RefAttributes<HTMLDivElement>>;
 
-export { Image, ImageGrid, type ImageGridItem, type ImageGridProps, type ImageProps, type ImageVariant, LayeredImage, type LayeredImageInset, type LayeredImageLayer, type LayeredImageProps, SpriteImage, type SpriteImageProps, type SpriteRect };
+export { Image, ImageGrid, type ImageGridItem, type ImageGridProps, type ImagePreviewMode, type ImagePreviewToolbarRenderProps, type ImageProps, type ImageVariant, LayeredImage, type LayeredImageInset, type LayeredImageLayer, type LayeredImageProps, SpriteImage, type SpriteImageProps, type SpriteRect };

package/dist/Image.js

@@ -1,2 +1,6 @@
-export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-EQ4FPOQQ.js';
-import './chunk-FDZG27IG.js';
+export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-Y22PTPA7.js';
+import './chunk-2A4GYSN4.js';
+import './chunk-JHM7MN3G.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Input-7GDPGP3E.css → Input-ZUASNDXM.css}

@@ -7,7 +7,7 @@
 }
 .input-count {
   font-size: var(--fs-xs);
-  color: var(--fg-subtle);
+  color: var(--lmn-input-fg-subtle, var(--fg-subtle));
   font-variant-numeric: tabular-nums;
   text-align: right;
 }
@@ -20,20 +20,20 @@
   height: var(--ctrl-h);
   padding: 0 var(--ctrl-pad-x);
   border-radius: var(--r-md);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-input-bg, var(--bg));
+  box-shadow: var(--lmn-input-neu-shadow-inset, var(--neu-shadow-inset));
   transition: box-shadow var(--dur) var(--ease);
   gap: 8px;
 }
 .input-wrap.sm { height: var(--field-h-sm); padding: 0 var(--ctrl-pad-x-sm); border-radius: var(--r-sm); gap: 6px; }
 .input-wrap.lg { height: var(--field-h-lg); padding: 0 var(--ctrl-pad-x); border-radius: var(--r-lg); gap: 10px; }
-.input-wrap:focus-within { box-shadow: var(--neu-shadow-inset), 0 0 0 2px var(--accent-glow); }
-.input-wrap.invalid { box-shadow: var(--neu-shadow-inset), 0 0 0 2px color-mix(in oklch, var(--danger) 30%, transparent); }
+.input-wrap:focus-within { box-shadow: var(--lmn-input-neu-shadow-inset, var(--neu-shadow-inset)), 0 0 0 2px var(--lmn-input-accent-glow, var(--accent-glow)); }
+.input-wrap.invalid { box-shadow: var(--lmn-input-neu-shadow-inset, var(--neu-shadow-inset)), 0 0 0 2px color-mix(in oklch, var(--lmn-input-danger, var(--danger)) 30%, transparent); }
 .input-wrap.disabled { opacity: 0.6; cursor: not-allowed; }
 
 .input-wrap .lead,
 .input-wrap .trail {
-  color: var(--fg-subtle);
+  color: var(--lmn-input-fg-subtle, var(--fg-subtle));
   flex-shrink: 0;
   display: inline-flex;
   align-items: center;
@@ -49,14 +49,14 @@
 }
 .input-wrap .lead.interactive,
 .input-wrap .trail.interactive { cursor: pointer; pointer-events: auto; }
-.input-wrap .trail:hover { color: var(--fg); }
+.input-wrap .trail:hover { color: var(--lmn-input-fg, var(--fg)); }
 .input-wrap .lead:not(.interactive),
 .input-wrap .trail:not(.interactive) { pointer-events: none; }
 
 .input-wrap .input-affix {
   display: inline-flex;
   align-items: center;
-  color: var(--fg-muted);
+  color: var(--lmn-input-fg-muted, var(--fg-muted));
   font-size: var(--fs-md);
   white-space: nowrap;
   user-select: none;
@@ -72,21 +72,21 @@
   width: 18px;
   height: 18px;
   border-radius: 999px;
-  color: var(--fg-subtle);
+  color: var(--lmn-input-fg-subtle, var(--fg-subtle));
   background: transparent;
   cursor: pointer;
   flex-shrink: 0;
   transition: color var(--dur-fast) var(--ease), background var(--dur-fast) var(--ease);
 }
 .input-wrap .input-clear:hover {
-  color: var(--fg);
-  background: var(--bg-sunken);
+  color: var(--lmn-input-fg, var(--fg));
+  background: var(--lmn-input-bg-sunken, var(--bg-sunken));
 }
 
 .input-password-toggle {
   border: none;
   background: transparent;
-  color: var(--fg-subtle);
+  color: var(--lmn-input-fg-subtle, var(--fg-subtle));
   padding: 0;
   display: inline-flex;
   align-items: center;
@@ -95,7 +95,7 @@
   font-family: inherit;
   flex-shrink: 0;
 }
-.input-password-toggle:hover { color: var(--fg); }
+.input-password-toggle:hover { color: var(--lmn-input-fg, var(--fg)); }
 
 .input-wrap > .input {
   flex: 1;
@@ -106,12 +106,12 @@
   border: none;
   background: transparent;
   box-shadow: none;
-  color: var(--fg);
+  color: var(--lmn-input-fg, var(--fg));
   font-size: var(--fs-md);
   font-family: inherit;
   outline: none;
 }
 .input-wrap.sm > .input { font-size: var(--fs-sm); }
 .input-wrap.lg > .input { font-size: var(--fs-lg); }
-.input-wrap > .input::placeholder { color: var(--fg-subtle); }
+.input-wrap > .input::placeholder { color: var(--lmn-input-fg-subtle, var(--fg-subtle)); }
 .input-wrap.disabled > .input { cursor: not-allowed; }

package/dist/Input.cjs

@@ -1,16 +1,18 @@
 'use strict';
 
-var chunkVS3I5OKA_cjs = require('./chunk-VS3I5OKA.cjs');
-require('./chunk-RZEFKXL3.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkSTQDKMS5_cjs = require('./chunk-STQDKMS5.cjs');
+require('./chunk-HYHBCHFM.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Input", {
   enumerable: true,
-  get: function () { return chunkVS3I5OKA_cjs.Input; }
+  get: function () { return chunkSTQDKMS5_cjs.Input; }
 });
 Object.defineProperty(exports, "InputPassword", {
   enumerable: true,
-  get: function () { return chunkVS3I5OKA_cjs.InputPassword; }
+  get: function () { return chunkSTQDKMS5_cjs.InputPassword; }
 });

package/dist/Input.d.cts

@@ -1,9 +1,10 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.cjs';
 import { Textarea, TextareaProps } from './Textarea.cjs';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 import 'react/jsx-runtime';
 
-interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "prefix" | "value" | "defaultValue"> {
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "prefix" | "value" | "defaultValue">, ComponentThemeProps {
     value?: string;
     defaultValue?: string;
     /** Native input change event. */

package/dist/Input.d.ts

@@ -1,9 +1,10 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.js';
 import { Textarea, TextareaProps } from './Textarea.js';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 import 'react/jsx-runtime';
 
-interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "prefix" | "value" | "defaultValue"> {
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "prefix" | "value" | "defaultValue">, ComponentThemeProps {
     value?: string;
     defaultValue?: string;
     /** Native input change event. */

package/dist/Input.js

@@ -1,3 +1,5 @@
-export { Input, InputPassword } from './chunk-IOAOG5L7.js';
-import './chunk-S7IHWY24.js';
-import './chunk-FDZG27IG.js';
+export { Input, InputPassword } from './chunk-UE4HFGJ6.js';
+import './chunk-3F424R5P.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{InputNumber-VXQIWLQC.css → InputNumber-6NHBMRT4.css}

@@ -5,7 +5,7 @@
   align-self: stretch;
   margin: 4px -6px 4px 6px;
   width: 16px;
-  border-left: 1px solid var(--divider);
+  border-left: 1px solid var(--lmn-input-divider, var(--divider));
   overflow: hidden;
   border-top-right-radius: calc(var(--r-md) - 4px);
   border-bottom-right-radius: calc(var(--r-md) - 4px);
@@ -21,18 +21,18 @@
   padding: 0;
   border: none;
   background: transparent;
-  color: var(--fg-subtle);
+  color: var(--lmn-input-fg-subtle, var(--fg-subtle));
   cursor: pointer;
   transition: color var(--dur-fast) var(--ease), background var(--dur-fast) var(--ease);
 }
-.ipn-step.up:not(.down) { border-bottom: 1px solid var(--divider); }
-.ipn-step.up            { border-bottom: 1px solid var(--divider); }
+.ipn-step.up:not(.down) { border-bottom: 1px solid var(--lmn-input-divider, var(--divider)); }
+.ipn-step.up            { border-bottom: 1px solid var(--lmn-input-divider, var(--divider)); }
 .ipn-step:hover:not(:disabled) {
-  color: var(--accent-ink);
-  background: var(--bg-sunken);
+  color: var(--lmn-input-accent-ink, var(--accent-ink));
+  background: var(--lmn-input-bg-sunken, var(--bg-sunken));
 }
 .ipn-step:active:not(:disabled) {
-  color: var(--accent);
+  color: var(--lmn-input-accent, var(--accent));
 }
 .ipn-step:disabled {
   cursor: not-allowed;

package/dist/InputNumber.cjs

@@ -1,13 +1,15 @@
 'use strict';
 
-var chunk5QEI7GGA_cjs = require('./chunk-5QEI7GGA.cjs');
-require('./chunk-VS3I5OKA.cjs');
-require('./chunk-RZEFKXL3.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunk434Y2JVW_cjs = require('./chunk-434Y2JVW.cjs');
+require('./chunk-STQDKMS5.cjs');
+require('./chunk-HYHBCHFM.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "InputNumber", {
   enumerable: true,
-  get: function () { return chunk5QEI7GGA_cjs.InputNumber; }
+  get: function () { return chunk434Y2JVW_cjs.InputNumber; }
 });

package/dist/InputNumber.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface InputNumberProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "size" | "prefix" | "suffix" | "type"> {
+interface InputNumberProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "size" | "prefix" | "suffix" | "type">, ComponentThemeProps {
     /** Controlled value. `null` = empty field. */
     value?: number | null;
     /** Uncontrolled initial value. */

package/dist/InputNumber.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface InputNumberProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "size" | "prefix" | "suffix" | "type"> {
+interface InputNumberProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "size" | "prefix" | "suffix" | "type">, ComponentThemeProps {
     /** Controlled value. `null` = empty field. */
     value?: number | null;
     /** Uncontrolled initial value. */

package/dist/InputNumber.js

@@ -1,4 +1,6 @@
-export { InputNumber } from './chunk-3VXGZ3SJ.js';
-import './chunk-IOAOG5L7.js';
-import './chunk-S7IHWY24.js';
-import './chunk-FDZG27IG.js';
+export { InputNumber } from './chunk-YPMQC5HX.js';
+import './chunk-UE4HFGJ6.js';
+import './chunk-3F424R5P.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/List-6BQIFAIT.css

@@ -0,0 +1,42 @@
+/* ============ List ============ */
+.list {
+  display: flex;
+  flex-direction: column;
+  background: var(--lmn-list-bg, var(--bg));
+  border-radius: var(--r-lg);
+  box-shadow: var(--lmn-list-neu-shadow-inset, var(--neu-shadow-inset));
+  padding: 8px;
+}
+.list-item {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 12px;
+  border-radius: var(--r-sm);
+  transition: all var(--dur-fast) var(--ease);
+}
+.list-item-trigger {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex: 1;
+  min-width: 0;
+}
+button.list-item-trigger {
+  border: 0;
+  padding: 0;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+.list-item.clickable { cursor: pointer; }
+.list-item.clickable:hover { background: var(--lmn-list-bg, var(--bg)); box-shadow: var(--lmn-list-neu-shadow-subtle, var(--neu-shadow-subtle)); }
+.list-item.selected { box-shadow: var(--lmn-list-neu-shadow-control, var(--neu-shadow-control)); background: var(--lmn-list-bg, var(--bg)); }
+.list.with-dividers .list-item + .list-item { border-top: 1px solid var(--lmn-list-divider, var(--divider)); border-radius: 0; }
+.list-item-meta { flex: 1; display: flex; flex-direction: column; gap: 2px; min-width: 0; }
+.list-item-title { font-size: 13px; font-weight: 500; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.list-item-desc  { font-size: 12px; color: var(--lmn-list-fg-muted, var(--fg-muted)); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.list-item-actions { display: flex; gap: 6px; align-items: center; flex-shrink: 0; }
+.list-item-avatar { display: inline-flex; align-items: center; justify-content: center; color: var(--lmn-list-fg-muted, var(--fg-muted)); flex-shrink: 0; }

package/dist/List.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunkSOQ56ZI2_cjs = require('./chunk-SOQ56ZI2.cjs');
+var chunkQYPA77OI_cjs = require('./chunk-QYPA77OI.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "List", {
   enumerable: true,
-  get: function () { return chunkSOQ56ZI2_cjs.List; }
+  get: function () { return chunkQYPA77OI_cjs.List; }
 });

package/dist/List.d.cts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
 interface ListItem {
     key: string;
@@ -8,13 +9,12 @@ interface ListItem {
     actions?: React.ReactNode;
     onClick?: () => void;
 }
-interface ListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, "children"> {
+interface ListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, "children">, ComponentThemeProps {
     items: ListItem[];
     /** Show dividers between items. */
     dividers?: boolean;
     className?: string;
 }
-/** `List` — vertical list of rows. */
 declare const List: React.ForwardRefExoticComponent<ListProps & React.RefAttributes<HTMLUListElement>>;
 
 export { List, type ListItem, type ListProps };

package/dist/List.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
 interface ListItem {
     key: string;
@@ -8,13 +9,12 @@ interface ListItem {
     actions?: React.ReactNode;
     onClick?: () => void;
 }
-interface ListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, "children"> {
+interface ListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, "children">, ComponentThemeProps {
     items: ListItem[];
     /** Show dividers between items. */
     dividers?: boolean;
     className?: string;
 }
-/** `List` — vertical list of rows. */
 declare const List: React.ForwardRefExoticComponent<ListProps & React.RefAttributes<HTMLUListElement>>;
 
 export { List, type ListItem, type ListProps };

package/dist/List.js

@@ -1 +1,3 @@
-export { List } from './chunk-YAFDVNXT.js';
+export { List } from './chunk-VQEMMJHC.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Message-H222YGR6.css → Message-OTZWQTQ5.css}

@@ -13,33 +13,33 @@
 .message-container.bottom-left  { bottom: 20px; left: 20px; }
 .message-container.top-center   { top: 56px; left: 50%; transform: translateX(-50%); align-items: center; }
 .message {
-  background: var(--bg);
+  background: var(--lmn-message-bg, var(--bg));
   border-radius: var(--r-md);
-  box-shadow: var(--neu-shadow-float);
+  box-shadow: var(--lmn-message-neu-shadow-float, var(--neu-shadow-float));
   padding: 12px 16px;
   min-width: 240px;
   display: flex; align-items: center; gap: 10px;
   font-size: 13px;
   pointer-events: auto;
   animation: messageIn var(--dur-slow) var(--ease);
-  border-left: 3px solid var(--accent);
+  border-left: 3px solid var(--lmn-message-accent, var(--accent));
 }
-.message.success { border-color: var(--success); }
-.message.warning { border-color: var(--warning); }
-.message.error   { border-color: var(--danger); }
-.message .message-icon { color: var(--accent); flex-shrink: 0; }
-.message.success .message-icon { color: var(--success); }
-.message.warning .message-icon { color: var(--warning); }
-.message.error   .message-icon { color: var(--danger); }
+.message.success { border-color: var(--lmn-message-success, var(--success)); }
+.message.warning { border-color: var(--lmn-message-warning, var(--warning)); }
+.message.error   { border-color: var(--lmn-message-danger, var(--danger)); }
+.message .message-icon { color: var(--lmn-message-accent, var(--accent)); flex-shrink: 0; }
+.message.success .message-icon { color: var(--lmn-message-success, var(--success)); }
+.message.warning .message-icon { color: var(--lmn-message-warning, var(--warning)); }
+.message.error   .message-icon { color: var(--lmn-message-danger, var(--danger)); }
 .message-body { flex: 1; min-width: 0; }
 .message-title { font-weight: 600; margin-bottom: 2px; }
-.message-content { color: var(--fg-muted); font-size: 12px; }
+.message-content { color: var(--lmn-message-fg-muted, var(--fg-muted)); font-size: 12px; }
 .message-close {
   background: transparent; border: none;
-  color: var(--fg-subtle); cursor: pointer;
+  color: var(--lmn-message-fg-subtle, var(--fg-subtle)); cursor: pointer;
   padding: 0 2px; font-family: inherit;
 }
-.message-close:hover { color: var(--fg); }
+.message-close:hover { color: var(--lmn-message-fg, var(--fg)); }
 .message.leaving { animation: messageOut var(--dur) var(--ease) forwards; }
 @keyframes messageIn  { from { opacity: 0; transform: translateX(20px); } }
 @keyframes messageOut { to   { opacity: 0; transform: translateX(20px); } }

package/dist/Message.cjs

@@ -1,23 +1,26 @@
 'use strict';
 
-var chunkRFI5R42I_cjs = require('./chunk-RFI5R42I.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkQ565GDVK_cjs = require('./chunk-Q565GDVK.cjs');
+require('./chunk-HSDMJUB6.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "MessageContainer", {
   enumerable: true,
-  get: function () { return chunkRFI5R42I_cjs.MessageContainer; }
+  get: function () { return chunkQ565GDVK_cjs.MessageContainer; }
 });
 Object.defineProperty(exports, "ToastContainer", {
   enumerable: true,
-  get: function () { return chunkRFI5R42I_cjs.ToastContainer; }
+  get: function () { return chunkQ565GDVK_cjs.ToastContainer; }
 });
 Object.defineProperty(exports, "message", {
   enumerable: true,
-  get: function () { return chunkRFI5R42I_cjs.message; }
+  get: function () { return chunkQ565GDVK_cjs.message; }
 });
 Object.defineProperty(exports, "toast", {
   enumerable: true,
-  get: function () { return chunkRFI5R42I_cjs.toast; }
+  get: function () { return chunkQ565GDVK_cjs.toast; }
 });

package/dist/Message.d.cts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
 type MessageType = "info" | "success" | "warning" | "error";
 interface MessageConfig {
@@ -24,24 +25,39 @@ interface MessageItem {
     duration?: number;
     onClose?: () => void;
 }
+/**
+ * 语义消息方法：支持配置对象，也支持“内容 + 时长/标题 + 关闭回调”调用方式。
+ * 第二个参数为数字时表示毫秒时长，否则作为标题渲染。
+ */
 type MessageMethod = (configOrContent: MessageConfig | React.ReactNode, durationOrTitle?: number | React.ReactNode, onClose?: () => void) => number;
 interface MessageApi {
+    /** 通过完整配置创建或按 key 更新消息。 */
     open(config: MessageConfig): number;
+    /** `open` 的等价别名。 */
     show(config: MessageConfig): number;
     info: MessageMethod;
     success: MessageMethod;
     warning: MessageMethod;
     warn: MessageMethod;
     error: MessageMethod;
+    /** 按消息内部 id 精确关闭，避免与数字 key 混淆。 */
+    dismissById(id: number): void;
+    /** 按调用方提供的 key 精确关闭。 */
+    dismissByKey(key: React.Key): void;
+    /**
+     * 兼容关闭方法：优先把参数识别为现有 key；没有同值 key 时，数字参数才按内部 id 处理。
+     * 新代码建议使用 `dismissById` 或 `dismissByKey` 明确语义。
+     */
     dismiss(idOrKey: number | React.Key): void;
+    /** `dismiss` 的兼容别名；不传参数时清空全部消息。 */
     destroy(idOrKey?: number | React.Key): void;
+    /** 清空全部消息，并为每条消息执行一次 `onClose`。 */
     clear(): void;
 }
 declare const message: MessageApi;
-interface MessageContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+interface MessageContainerProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     placement?: "top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center";
 }
-/** `MessageContainer` — optional app-root mount point for `message.*` calls. */
 declare const MessageContainer: React.ForwardRefExoticComponent<MessageContainerProps & React.RefAttributes<HTMLDivElement>>;
 type ToastType = MessageType;
 type ToastItem = MessageItem;

package/dist/Message.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
 type MessageType = "info" | "success" | "warning" | "error";
 interface MessageConfig {
@@ -24,24 +25,39 @@ interface MessageItem {
     duration?: number;
     onClose?: () => void;
 }
+/**
+ * 语义消息方法：支持配置对象，也支持“内容 + 时长/标题 + 关闭回调”调用方式。
+ * 第二个参数为数字时表示毫秒时长，否则作为标题渲染。
+ */
 type MessageMethod = (configOrContent: MessageConfig | React.ReactNode, durationOrTitle?: number | React.ReactNode, onClose?: () => void) => number;
 interface MessageApi {
+    /** 通过完整配置创建或按 key 更新消息。 */
     open(config: MessageConfig): number;
+    /** `open` 的等价别名。 */
     show(config: MessageConfig): number;
     info: MessageMethod;
     success: MessageMethod;
     warning: MessageMethod;
     warn: MessageMethod;
     error: MessageMethod;
+    /** 按消息内部 id 精确关闭，避免与数字 key 混淆。 */
+    dismissById(id: number): void;
+    /** 按调用方提供的 key 精确关闭。 */
+    dismissByKey(key: React.Key): void;
+    /**
+     * 兼容关闭方法：优先把参数识别为现有 key；没有同值 key 时，数字参数才按内部 id 处理。
+     * 新代码建议使用 `dismissById` 或 `dismissByKey` 明确语义。
+     */
     dismiss(idOrKey: number | React.Key): void;
+    /** `dismiss` 的兼容别名；不传参数时清空全部消息。 */
     destroy(idOrKey?: number | React.Key): void;
+    /** 清空全部消息，并为每条消息执行一次 `onClose`。 */
     clear(): void;
 }
 declare const message: MessageApi;
-interface MessageContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+interface MessageContainerProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     placement?: "top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center";
 }
-/** `MessageContainer` — optional app-root mount point for `message.*` calls. */
 declare const MessageContainer: React.ForwardRefExoticComponent<MessageContainerProps & React.RefAttributes<HTMLDivElement>>;
 type ToastType = MessageType;
 type ToastItem = MessageItem;