@fangxinyan/lumina 0.6.6 → 0.6.8

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 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, IconName, IconProps, IconSlot, LeftOutlined, LoadingOutlined, MinusCircleOutlined, MinusOutlined, NAMED_ICON_MAP, NamedIconComponentName, NamedIconProps, PictureOutlined, PlusOutlined, QqOutlined, ReloadOutlined, RenderIconSlotOptions, RightOutlined, RobotOutlined, SearchOutlined, SettingOutlined, StarFilled, StarOutlined, SwapOutlined, SwapRightOutlined, SyncOutlined, ThunderboltOutlined, TranslationOutlined, UnorderedListOutlined, UserOutlined, isIconName, renderIconSlot, resolveIconName } from './Icon.cjs';
-export { Button, ButtonProps, ButtonSize, ButtonVariant } from './Button.cjs';
+export { Button, ButtonProps, ButtonSize, ButtonVariant, IconButton, IconButtonProps } from './Button.cjs';
 export { Input, InputComponent, InputPassword, InputPasswordProps, InputProps, InputTextAreaProps } from './Input.cjs';
 export { TextArea, Textarea, TextareaProps } from './Textarea.cjs';
 export { Switch, SwitchProps } from './Switch.cjs';
@@ -43,12 +43,12 @@ export { BaseTypographyProps, CopyableConfig, EditableConfig, EllipsisConfig, Li
 export { ColorPicker, ColorPickerProps } from './ColorPicker.cjs';
 export { Drawer, DrawerProps } from './Drawer.cjs';
 export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, AccentKey, AccentPalette, BuiltInThemeMode, CustomAccentInput, DensityMode, FONT_STACKS, FontConfig, FontKey, ResolvedThemeMode, ThemeBaseMode, ThemeConfig, ThemeMode, ThemePreset, ThemePresets, ThemeProvider, ThemeProviderProps, ThemeTokens, ThemeValue, applyTheme, normalizeAccentInput, resolveThemeColorScheme, resolveThemeMode, useTheme, useThemeOptional } from './Theme.cjs';
-export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel, ThemePanelCreateThemePayload, ThemePanelCreatedThemeMeta, ThemePanelDeleteThemePayload, ThemePanelModeOption, ThemePanelPresetOption, ThemePanelProps, ThemePanelSection } from './ThemePanel.cjs';
+export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel, ThemePanelCreateThemePayload, ThemePanelCreatedThemeMeta, ThemePanelDeleteThemePayload, ThemePanelModeOption, ThemePanelPresetOption, ThemePanelProps, ThemePanelSection, ThemePanelUpdateThemePayload } from './ThemePanel.cjs';
 export { Timeline, TimelineItemConfig, TimelineProps } from './Timeline.cjs';
 import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.6";
+declare const VERSION = "0.6.8";
 
 export { VERSION };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 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, IconName, IconProps, IconSlot, LeftOutlined, LoadingOutlined, MinusCircleOutlined, MinusOutlined, NAMED_ICON_MAP, NamedIconComponentName, NamedIconProps, PictureOutlined, PlusOutlined, QqOutlined, ReloadOutlined, RenderIconSlotOptions, RightOutlined, RobotOutlined, SearchOutlined, SettingOutlined, StarFilled, StarOutlined, SwapOutlined, SwapRightOutlined, SyncOutlined, ThunderboltOutlined, TranslationOutlined, UnorderedListOutlined, UserOutlined, isIconName, renderIconSlot, resolveIconName } from './Icon.js';
-export { Button, ButtonProps, ButtonSize, ButtonVariant } from './Button.js';
+export { Button, ButtonProps, ButtonSize, ButtonVariant, IconButton, IconButtonProps } from './Button.js';
 export { Input, InputComponent, InputPassword, InputPasswordProps, InputProps, InputTextAreaProps } from './Input.js';
 export { TextArea, Textarea, TextareaProps } from './Textarea.js';
 export { Switch, SwitchProps } from './Switch.js';
@@ -43,12 +43,12 @@ export { BaseTypographyProps, CopyableConfig, EditableConfig, EllipsisConfig, Li
 export { ColorPicker, ColorPickerProps } from './ColorPicker.js';
 export { Drawer, DrawerProps } from './Drawer.js';
 export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, AccentKey, AccentPalette, BuiltInThemeMode, CustomAccentInput, DensityMode, FONT_STACKS, FontConfig, FontKey, ResolvedThemeMode, ThemeBaseMode, ThemeConfig, ThemeMode, ThemePreset, ThemePresets, ThemeProvider, ThemeProviderProps, ThemeTokens, ThemeValue, applyTheme, normalizeAccentInput, resolveThemeColorScheme, resolveThemeMode, useTheme, useThemeOptional } from './Theme.js';
-export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel, ThemePanelCreateThemePayload, ThemePanelCreatedThemeMeta, ThemePanelDeleteThemePayload, ThemePanelModeOption, ThemePanelPresetOption, ThemePanelProps, ThemePanelSection } from './ThemePanel.js';
+export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel, ThemePanelCreateThemePayload, ThemePanelCreatedThemeMeta, ThemePanelDeleteThemePayload, ThemePanelModeOption, ThemePanelPresetOption, ThemePanelProps, ThemePanelSection, ThemePanelUpdateThemePayload } from './ThemePanel.js';
 export { Timeline, TimelineItemConfig, TimelineProps } from './Timeline.js';
 import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.6";
+declare const VERSION = "0.6.8";
 
 export { VERSION };

package/dist/index.js

@@ -1,54 +1,54 @@
-export { Tabs } from './chunk-TVUBGXWA.js';
-export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-NJCHFXGC.js';
-export { Timeline } from './chunk-OQU3TJCF.js';
-export { Tooltip } from './chunk-SFAGHPBT.js';
-export { Link, Paragraph, Text, Title, Typography } from './chunk-5JNDDWFZ.js';
-export { Slider } from './chunk-HU7T64Y3.js';
-export { Spin } from './chunk-Y5F7ZTBH.js';
-export { Splitter } from './chunk-7ZNGHWVS.js';
-export { StatusBar, StatusBarItem } from './chunk-2SCXQ7QS.js';
-export { SURFACE_THEME_PRESETS, Surface } from './chunk-O43DOE7V.js';
+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';
 import './chunk-6SPMHY54.js';
-export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, FONT_STACKS, ThemeProvider, applyTheme, normalizeAccentInput, resolveThemeColorScheme, resolveThemeMode, useTheme, useThemeOptional } from './chunk-7NZ2A4MA.js';
-export { Switch } from './chunk-YJEXAO2I.js';
-export { TablePro } from './chunk-GUZ2DNDC.js';
-export { Table } from './chunk-YSXD344H.js';
-export { MessageContainer, ToastContainer, message, toast } from './chunk-W5CJC7S7.js';
-export { Modal } from './chunk-OHIFKN4E.js';
-export { Pagination } from './chunk-2ZFJTMEF.js';
-export { Popover } from './chunk-PKHITACT.js';
-export { Progress } from './chunk-YVTLHTG6.js';
-export { Radio, RadioGroup } from './chunk-HFUHQUPQ.js';
-export { Select } from './chunk-7D76MI37.js';
-export { Tag } from './chunk-VNNQYJLT.js';
-export { Skeleton } from './chunk-PEJLXJQD.js';
-export { Drawer } from './chunk-PNZJFLMY.js';
-export { Empty } from './chunk-LQLOOUS3.js';
-export { Form, FormItem, useForm } from './chunk-SABWUELE.js';
-export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-2NT5QKEX.js';
-export { InputNumber } from './chunk-LI4XJTEA.js';
-export { List } from './chunk-OHFZ7L4T.js';
-export { Card } from './chunk-WEJKY3DF.js';
-export { Cascader } from './chunk-REMJWNAT.js';
-export { Checkbox } from './chunk-WXWFMWWF.js';
-export { Collapse } from './chunk-AJH2O4WC.js';
-export { ColorPicker } from './chunk-GZCU6HXD.js';
-export { CommandPalette } from './chunk-NE7IUGMK.js';
-export { ContextMenu } from './chunk-SQIWPU6V.js';
-export { Divider } from './chunk-MYRLCN6V.js';
-export { Alert } from './chunk-3YP7CBJT.js';
-export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-QP7RXZES.js';
-export { AutoComplete } from './chunk-ZPP7LTHP.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-N24KHD5B.js';
+export { Table } from './chunk-FZITSOKH.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-BKI7JY4Z.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';
 import './chunk-DUFRASGO.js';
-export { Input, InputPassword } from './chunk-XVP7IKLZ.js';
-export { TextArea, Textarea } from './chunk-56PHETWO.js';
-export { Avatar } from './chunk-KMG7OMOS.js';
-export { Badge } from './chunk-NFXHIO3G.js';
-export { Button } from './chunk-CNGKJYGZ.js';
-export { Calendar } from './chunk-CEZ2DR4R.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-YT5NLCRC.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';
 
 // src/index.ts
-var VERSION = "0.6.6";
+var VERSION = "0.6.8";
 
 export { VERSION };

package/dist/styles.css

@@ -125,6 +125,26 @@
   --dur: 220ms;
   --dur-slow: 360ms;
 }
+/* Explicit light reset for scoped ThemeProvider instances.
+   :root already has these defaults, but nested [data-theme="light"] must not
+   inherit a dark or custom parent surface. */
+:root[data-theme="light"],
+[data-theme="light"] {
+  --bg: #e8eef5;
+  --bg-raised: #edf2f8;
+  --bg-sunken: #dde4ed;
+  --fg: #3a4558;
+  --fg-muted: #7b8599;
+  --fg-subtle: #9ca7ba;
+  --border: rgba(130, 148, 175, 0.14);
+  --divider: rgba(130, 148, 175, 0.18);
+  --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));
+  --shadow-blur: calc(16px * var(--d) * var(--shadow-scale));
+  --shadow-inset-offset: calc(4px * var(--d) * var(--shadow-scale));
+  --shadow-inset-blur: calc(10px * var(--d) * var(--shadow-scale));
+}
 /* ---- Dark theme ----
    深色模式的拟态不能照搬浅色思路:白色高光会变成刺眼的白圈。
    这里做法:保留深色阴影给"下沉"深度,把"上凸高光"压到很低 alpha,
@@ -1121,6 +1141,12 @@ input, textarea, select { font-family: inherit; color: inherit; }
   box-shadow: var(--neu-shadow-panel);
   padding: var(--gap-5);
 }
+.card.fill {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  height: 100%;
+}
 .card.flat   { box-shadow: var(--neu-shadow-subtle); }
 .card.sunken { box-shadow: var(--neu-shadow-inset-strong); }
 .card.pad-none { padding: 0; }
@@ -1144,7 +1170,40 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .card-title { font-size: 15px; font-weight: 600; }
 .card-desc  { font-size: 12px; color: var(--fg-muted); }
 .card-actions { display: flex; gap: 6px; }
-.card-body { font-size: 13px; }
+.card-body {
+  font-size: 13px;
+  min-width: 0;
+  position: relative;
+}
+.card-body.body-stack {
+  display: flex;
+  flex-direction: column;
+  gap: var(--gap-3);
+}
+.card-body.body-fill {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-height: 0;
+}
+.card-body.body-center {
+  display: grid;
+  place-items: center;
+}
+.card-body.loading {
+  pointer-events: none;
+}
+.card-loading-overlay {
+  position: absolute;
+  inset: calc(var(--gap-2) * -1);
+  border-radius: var(--r-md);
+  display: grid;
+  place-items: center;
+  background: color-mix(in oklch, var(--bg) 82%, transparent);
+  box-shadow: var(--neu-shadow-inset);
+  color: var(--fg-muted);
+  z-index: 1;
+}
 /* ============ Surface ============ */
 .surface {
   position: relative;
@@ -3777,6 +3836,64 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .theme-panel-shadow {
   gap: 7px;
 }
+.theme-panel-advanced-row {
+  gap: 10px;
+}
+.theme-panel .theme-panel-advanced-toggle.btn {
+  justify-content: center;
+}
+.theme-panel-live-advanced {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 10px;
+  border-radius: var(--r-md);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-inset);
+}
+.theme-panel-advanced-actions {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding-top: 10px;
+  border-top: 1px solid var(--divider);
+}
+.theme-panel-save-as-field {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  gap: 8px;
+  align-items: center;
+}
+.theme-panel-save-as-field > span {
+  color: var(--fg-muted);
+  font-size: 11px;
+  font-weight: 800;
+  white-space: nowrap;
+}
+.theme-panel-advanced-footer {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 8px;
+  align-items: center;
+}
+.theme-panel-advanced-footer > span {
+  min-width: 0;
+  color: var(--fg-subtle);
+  font-family: var(--font-mono);
+  font-size: 10px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.theme-panel-advanced-buttons {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: 6px;
+}
+.theme-panel-advanced-buttons .btn {
+  white-space: nowrap;
+}
 .theme-panel-create-preview {
   min-height: 36px;
   display: flex;

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

@@ -126,6 +126,27 @@
   --dur-slow: 360ms;
 }
 
+/* Explicit light reset for scoped ThemeProvider instances.
+   :root already has these defaults, but nested [data-theme="light"] must not
+   inherit a dark or custom parent surface. */
+:root[data-theme="light"],
+[data-theme="light"] {
+  --bg: #e8eef5;
+  --bg-raised: #edf2f8;
+  --bg-sunken: #dde4ed;
+  --fg: #3a4558;
+  --fg-muted: #7b8599;
+  --fg-subtle: #9ca7ba;
+  --border: rgba(130, 148, 175, 0.14);
+  --divider: rgba(130, 148, 175, 0.18);
+  --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));
+  --shadow-blur: calc(16px * var(--d) * var(--shadow-scale));
+  --shadow-inset-offset: calc(4px * var(--d) * var(--shadow-scale));
+  --shadow-inset-blur: calc(10px * var(--d) * var(--shadow-scale));
+}
+
 /* ---- Dark theme ----
    深色模式的拟态不能照搬浅色思路:白色高光会变成刺眼的白圈。
    这里做法:保留深色阴影给"下沉"深度,把"上凸高光"压到很低 alpha,

package/dist/tokens.css

@@ -126,6 +126,27 @@
   --dur-slow: 360ms;
 }
 
+/* Explicit light reset for scoped ThemeProvider instances.
+   :root already has these defaults, but nested [data-theme="light"] must not
+   inherit a dark or custom parent surface. */
+:root[data-theme="light"],
+[data-theme="light"] {
+  --bg: #e8eef5;
+  --bg-raised: #edf2f8;
+  --bg-sunken: #dde4ed;
+  --fg: #3a4558;
+  --fg-muted: #7b8599;
+  --fg-subtle: #9ca7ba;
+  --border: rgba(130, 148, 175, 0.14);
+  --divider: rgba(130, 148, 175, 0.18);
+  --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));
+  --shadow-blur: calc(16px * var(--d) * var(--shadow-scale));
+  --shadow-inset-offset: calc(4px * var(--d) * var(--shadow-scale));
+  --shadow-inset-blur: calc(10px * var(--d) * var(--shadow-scale));
+}
+
 /* ---- Dark theme ----
    深色模式的拟态不能照搬浅色思路:白色高光会变成刺眼的白圈。
    这里做法:保留深色阴影给"下沉"深度,把"上凸高光"压到很低 alpha,

package/docs/llms/autocomplete.md

@@ -2,6 +2,12 @@
 
 > 输入时展示建议下拉,不限定必须从候选中选。
 
+## 导入
+
+```tsx
+import { AutoComplete } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础

package/docs/llms/button.md

@@ -5,7 +5,7 @@
 ## 导入
 
 ```tsx
-import { Button } from "@fangxinyan/lumina";
+import { Button, IconButton } from "@fangxinyan/lumina";
 ```
 
 ## 示例
@@ -62,12 +62,12 @@ block 让按钮撑满容器宽度,常用于底部主操作或表单提交。
 
 ### 纯图标按钮
 
-Button 在只有 icon 时自动呈现为方形按钮,常配合 tip 使用。
+IconButton 是 Button 的方形图标专用封装;Button 在只有 icon 时也会自动呈现为同样形态。
 
 ```tsx
 <Button icon="heart" tip="收藏" />
-<Button icon="bell" tip="通知" />
-<Button icon="settings" tip="设置" />
+<IconButton icon="bell" tip="通知" />
+<IconButton icon="settings" tip="设置" />
 ```
 
 ## API
@@ -88,5 +88,17 @@ Button 在只有 icon 时自动呈现为方形按钮,常配合 tip 使用。
 | onClick | `(e: MouseEvent) => void` | — | 点击回调 |
 
 
+**IconButton**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| icon \* | `IconName | ReactNode` | — | 按钮图标,可传内置图标名或自定义节点 |
+| tip | `string` | — | 原生悬浮提示,也会作为缺省 aria-label |
+| variant | `"default" | "primary" | "ghost" | "danger"` | `"default"` | 按钮风格 |
+| size | `"sm" | "md" | "lg"` | `"md"` | 按钮尺寸 |
+| loading | `boolean` | `false` | 加载态 |
+| disabled | `boolean` | `false` | 禁用 |
+
+
 ---
 [← 回到索引](../llms.md)

package/docs/llms/card.md

@@ -44,6 +44,31 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 <Card title="..." actions={<Button size="sm" icon="plus">邀请</Button>}>...</Card>
 ```
 
+### 正文布局
+
+bodyLayout 控制正文槽布局，bodyClassName / bodyStyle / bodyProps 直接作用到 .card-body。
+
+```tsx
+<Card
+  fill
+  bodyLayout="stack"
+  bodyClassName="settings-card-body"
+  bodyStyle={{ minHeight: 160 }}
+>
+  ...
+</Card>
+```
+
+### 加载覆盖
+
+loading 会在正文区域显示内建 overlay；loadingOverlay 可替换默认 Spin。
+
+```tsx
+<Card loading loadingOverlay="正在同步...">
+  ...
+</Card>
+```
+
 ## API
 
 **Card**
@@ -56,6 +81,13 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 | title | `ReactNode` | — | 标题 |
 | description | `ReactNode` | — | 副标题 |
 | actions | `ReactNode` | — | 右上操作区 |
+| fill | `boolean` | `false` | 卡片和正文填满可用高度 |
+| bodyLayout | `"block" | "stack" | "fill" | "center"` | `"block"` | 正文布局策略 |
+| bodyClassName | `string` | — | 正文容器 className |
+| bodyStyle | `CSSProperties` | — | 正文容器内联样式 |
+| bodyProps | `HTMLAttributes<HTMLDivElement>` | — | 透传给正文容器的 DOM props |
+| loading | `boolean` | `false` | 显示正文加载覆盖层 |
+| loadingOverlay | `ReactNode` | — | 自定义加载覆盖层内容 |
 
 
 ---

package/docs/llms/commandpalette.md

@@ -2,6 +2,12 @@
 
 > 全局命令搜索与执行入口。
 
+## 导入
+
+```tsx
+import { CommandPalette } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础 + 快捷键

package/docs/llms/contextmenu.md

@@ -2,6 +2,12 @@
 
 > 桌面应用风格的右键上下文菜单。
 
+## 导入
+
+```tsx
+import { ContextMenu } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础

package/docs/llms/form.md

@@ -2,6 +2,12 @@
 
 > 受控表单,字段绑定 + 校验。
 
+## 导入
+
+```tsx
+import { Form, FormItem } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础

package/docs/llms/inputnumber.md

@@ -2,6 +2,12 @@
 
 > 带步进按钮的数字输入框。
 
+## 导入
+
+```tsx
+import { InputNumber } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础

package/docs/llms/modal.md

@@ -78,6 +78,21 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 <Modal closeIcon={<Icon name="chevDown" />} />
 ```
 
+### 正文容器控制
+
+bodyClassName / bodyStyle / bodyProps 可直接作用到正文容器；bodyOverflow 用于切换滚动或允许拟态阴影外溢。
+
+```tsx
+<Modal
+  bodyClassName="settings-modal-body"
+  bodyStyle={{ maxHeight: 260, padding: 12 }}
+  bodyOverflow="visible"
+  bodyProps={{ "data-panel": "settings" }}
+>
+  ...
+</Modal>
+```
+
 ## API
 
 **Modal**
@@ -93,6 +108,10 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 | okText / cancelText | `ReactNode` | `"确定" / "取消"` | 默认按钮文案 |
 | okButtonProps / cancelButtonProps | `Partial<ButtonProps>` | — | 透传给默认按钮 |
 | confirmLoading | `boolean` | `false` | OK 按钮显示 spinner 并禁用 |
+| bodyClassName | `string` | — | 正文容器 className |
+| bodyStyle | `CSSProperties` | — | 正文容器内联样式 |
+| bodyProps | `HTMLAttributes<HTMLDivElement>` | — | 透传给正文容器的 DOM props |
+| bodyOverflow | `CSSProperties['overflow']` | — | 正文容器 overflow 快捷控制 |
 | closable | `boolean` | `true` | 显示右上角 × |
 | closeIcon | `ReactNode` | — | 自定义关闭图标 |
 | maskClosable | `boolean` | `true` | 点击遮罩关闭 |

package/docs/llms/splitter.md

@@ -2,6 +2,12 @@
 
 > 两栏之间可拖拽的分隔条,支持横向、纵向与嵌套。
 
+## 导入
+
+```tsx
+import { Splitter } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 水平分栏

package/docs/llms/statusbar.md

@@ -2,6 +2,12 @@
 
 > 窗口底部状态栏,展示分支、编码、行列等应用元信息。
 
+## 导入
+
+```tsx
+import { StatusBar, StatusBarItem } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础

package/docs/llms/tablepro.md

@@ -50,6 +50,8 @@ TablePro 直接透传 expandable 到 Table。
 | actions | `ReactNode` | — | 工具栏右侧操作 |
 | footer | `ReactNode` | — | 底部 (可选,传了会渲染在分页下方) |
 | title | `ReactNode` | — | 工具栏标题 |
+| className / style / id / data-* / aria-* | `native attrs` | — | 透传到外层 table-card 根节点 |
+| tableClassName / tableStyle | `string / CSSProperties` | — | 透传到内部 Table |
 
 
 ---