@fangxinyan/lumina 0.6.7 → 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.7";
+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.7";
+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-I4M2RL2X.js';
-export { Tooltip } from './chunk-SFAGHPBT.js';
-export { Link, Paragraph, Text, Title, Typography } from './chunk-5JNDDWFZ.js';
-export { Slider } from './chunk-HU7T64Y3.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-N4USDBY2.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-J7EQJXSJ.js';
-export { Spin } from './chunk-Y5F7ZTBH.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.7";
+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,
@@ -3816,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/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/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 |
 
 
 ---

package/docs/llms/textarea.md

@@ -0,0 +1,83 @@
+# Textarea 多行输入
+
+> 多行文本输入域,支持清除、字数统计、错误态和原生 textarea 属性。
+
+## 导入
+
+```tsx
+import { Textarea, TextArea, Input } from "@fangxinyan/lumina";
+```
+
+## 示例
+
+### 基础用法
+
+Textarea 直接暴露原生 textarea ref 和常用原生属性。
+
+```tsx
+const [notes, setNotes] = useState("");
+
+<Textarea
+  value={notes}
+  onValueChange={setNotes}
+  rows={4}
+  placeholder="写点什么..."
+/>
+```
+
+### 可清除与字数统计
+
+allowClear、maxLength、showCount 可组合使用,适合受限文本输入。
+
+```tsx
+<Textarea
+  value={feedback}
+  onValueChange={setFeedback}
+  allowClear
+  maxLength={160}
+  showCount
+  placeholder="最多输入 160 个字"
+/>
+```
+
+### 错误与禁用
+
+invalid 只负责视觉状态;错误文案通常交给 Field 或 Form.Item 展示。
+
+```tsx
+<Textarea invalid defaultValue="太短" />
+<Textarea disabled defaultValue="只读说明..." />
+```
+
+### Input.TextArea 别名
+
+当表单统一从 Input 命名空间取控件时,Input.TextArea 与 Textarea 等价。
+
+```tsx
+<Input.TextArea
+  defaultValue="Input.TextArea 与 Textarea 使用同一套能力"
+  allowClear
+  showCount
+/>
+```
+
+## API
+
+**Textarea / TextArea / Input.TextArea**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| value / defaultValue | `string` | — | 受控值 / 初值 |
+| onChange | `(event) => void` | — | 变更回调,传入 React 原生事件 |
+| onValueChange | `(value: string, event) => void` | — | 值回调便捷写法 |
+| allowClear | `boolean` | `false` | 右上角显示清除按钮 |
+| maxLength | `number` | — | 最大字符数,透传至原生 textarea |
+| showCount | `boolean` | `false` | 显示字数统计;有 maxLength 时显示 N / max |
+| invalid | `boolean` | `false` | 错误态 |
+| disabled | `boolean` | `false` | 禁用 |
+| rows | `number` | — | 文本域可见行数,透传至原生 textarea |
+| className / style / id / data-* / aria-* | `native attrs` | — | 透传至原生 textarea |
+
+
+---
+[← 回到索引](../llms.md)

package/docs/llms/themepanel.md

@@ -12,7 +12,7 @@ import { ThemeProvider, ThemePanel, THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PA
 
 ### 完整面板
 
-默认包含浅色、深色、瓷白、助手、助手暗五个主题卡片,并提供简洁/深度两档新建主题入口;其余控制项直接驱动 useTheme。
+默认包含浅色、深色、瓷白、助手、助手暗五个主题卡片,并提供简洁/深度两档新建主题入口;高级调整区可编辑当前主题的 token、palette 和自定义字体,默认主题另存时可填写新主题名和副标题,非默认主题可直接改名、修改副标题后保存。
 
 ```tsx
 <ThemeProvider>
@@ -22,7 +22,7 @@ import { ThemeProvider, ThemePanel, THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PA
 
 ### 外部保存与回灌
 
-onCreateTheme / onDeleteTheme 会把新建和删除事件交给业务侧;业务侧保存后通过 ThemeProvider themes 回灌。
+onCreateTheme / onUpdateTheme / onDeleteTheme 会把新建、另存为、更新和删除事件交给业务侧;主题名和卡片第二行副标题会分别通过 payload.label / payload.description 传出,业务侧保存后通过 ThemeProvider themes 回灌。
 
 ```tsx
 import { ThemeProvider, ThemePanel, type ThemePresets } from "lumina";
@@ -45,6 +45,13 @@ const [themes, setThemes] = React.useState<ThemePresets>({});
       });
       deleteThemeFromServerOrStorage(payload);
     }}
+    onUpdateTheme={(payload) => {
+      setThemes((current) => ({
+        ...current,
+        [String(payload.key)]: payload.preset,
+      }));
+      saveThemeToServerOrStorage(payload);
+    }}
   />
 </ThemeProvider>
 ```
@@ -71,16 +78,18 @@ const [themes, setThemes] = React.useState<ThemePresets>({});
 | --- | --- | --- | --- |
 | title | `ReactNode` | `"主题"` | 面板标题;传 null 可隐藏标题文本 |
 | description | `ReactNode` | `"快速调整当前 Lumina 主题"` | 面板副标题 |
-| sections | `ThemePanelSection[]` | — | 展示的控制区及顺序;shadow 区同时控制 intensity / shadow-scale / shadow-float-scale |
+| sections | `ThemePanelSection[]` | — | 展示的控制区及顺序;advanced 区提供完整 token / palette 编辑,shadow 区同时控制 intensity / shadow-scale / shadow-float-scale |
 | modeOptions | `ThemePanelModeOption[]` | — | 模式切换项 |
 | presetOptions | `ThemePanelPresetOption[]` | — | 命名主题预设卡片;不传时使用浅色/深色/瓷白/助手/助手暗 + theme.themes,也可完全由业务侧控制 |
 | defaultCustomAccent | `string` | `"#845ef7"` | 自定义强调色初始值 |
 | allowCreateTheme | `boolean` | `true` | 在预设区显示新建主题流程 |
 | defaultCreateThemeName | `string` | `"我的主题"` | 新建主题的默认名称 |
 | createThemeKeyPrefix | `string` | `"user"` | 生成自建主题 mode key 时使用的前缀 |
-| onCreateTheme | `(payload: ThemePanelCreateThemePayload) => void` | — | 保存自建主题后的回调,业务侧可把 payload.preset 存起来并通过 ThemeProvider themes 回灌 |
+| onCreateTheme | `(payload: ThemePanelCreateThemePayload) => void` | — | 保存自建主题或高级区命名另存为后的回调;主题名和副标题通过 payload.label / payload.description 传出,业务侧可把 payload.preset 存起来并通过 ThemeProvider themes 回灌 |
 | allowDeleteTheme | `boolean` | `true` | 为非默认主题显示删除按钮;默认主题不会显示删除入口 |
 | onDeleteTheme | `(payload: ThemePanelDeleteThemePayload) => void` | — | 删除非默认主题后的回调,业务侧可同步删除外部存储 |
+| allowUpdateTheme | `boolean` | `true` | 在高级调整区为非默认主题显示保存修改能力;默认主题保存时会另存为新主题 |
+| onUpdateTheme | `(payload: ThemePanelUpdateThemePayload) => void` | — | 覆盖保存非默认主题修改后的回调;名称和副标题修改通过 payload.label / payload.description 传出,另存为仍走 onCreateTheme |
 | showReset | `boolean` | `true` | 显示重置按钮 |
 | compact | `boolean` | `false` | 紧凑布局 |
 
@@ -109,11 +118,23 @@ const [themes, setThemes] = React.useState<ThemePresets>({});
 | --- | --- | --- | --- |
 | key | `ThemeMode` | — | 保存后注册到 ThemeProvider 的 mode key |
 | label | `string` | — | 用户输入的主题名称 |
-| description | `string` | — | ThemePanel 生成的说明文案,如自建亮/自建暗 |
+| description | `string` | — | 用户输入的主题副标题,会显示在主题卡片第二行 |
 | preset | `ThemePreset` | — | 最终保存到 theme.themes 的主题配置 |
 | presetOption | `ThemePanelPresetOption` | — | 可直接追加到受控 presetOptions 的卡片配置 |
 
 
+**ThemePanelUpdateThemePayload**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| key | `ThemeMode` | — | 被更新的主题 mode key |
+| label | `string` | — | 被更新主题的展示名称 |
+| description | `string` | — | 被更新主题的副标题,会显示在主题卡片第二行 |
+| preset | `ThemePreset` | — | 从当前面板状态生成的新主题配置 |
+| previousPreset | `ThemePreset` | — | 更新前的主题配置 |
+| presetOption | `ThemePanelPresetOption` | — | 可直接回灌到受控 presetOptions 的卡片配置 |
+
+
 **ThemePanelDeleteThemePayload**
 
 | Prop | 类型 | 默认 | 说明 |

package/docs/llms/timeline.md

@@ -2,6 +2,12 @@
 
 > 垂直时间线，支持等待状态、自定义圆点、交替布局
 
+## 导入
+
+```tsx
+import { Timeline } from "@fangxinyan/lumina";
+```
+
 ## 示例
 
 ### 基础用法

package/docs/llms/typography.md

@@ -5,7 +5,7 @@
 ## 导入
 
 ```tsx
-import { Typography } from "@fangxinyan/lumina";
+import { Typography, Title, Text, Paragraph, Link } from "@fangxinyan/lumina";
 ```
 
 ## 示例

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.6.7`
+- **版本**: `0.6.8`
 - **React 最低版本**: 18
 - **环境**: 带打包器的 React 工程(Vite / Next.js / Webpack / Remix / Electron + Vite 等)
 - **零运行时依赖**: 只依赖 `react` / `react-dom` (peer deps)
@@ -55,6 +55,7 @@
 ### 表单
 
 - [Input 输入框](./llms/input.md) — 凹陷凹槽式输入域,支持前后置图标、错误态、禁用态。
+- [Textarea 多行输入](./llms/textarea.md) — 多行文本输入域,支持清除、字数统计、错误态和原生 textarea 属性。
 - [InputNumber 数字输入](./llms/inputnumber.md) — 带步进按钮的数字输入框。
 - [Switch 开关](./llms/switch.md) — 二元状态切换器。
 - [Checkbox 复选框](./llms/checkbox.md) — 在一组选项中进行多项选择,或独立切换某个开关项。