@fangxinyan/lumina 0.6.1 → 0.6.3

package/docs/llms/alert.md

@@ -22,12 +22,13 @@ import { Alert } from "@fangxinyan/lumina";
 <Alert tone="info" closable>仅一行的简短提示</Alert>
 ```
 
-### 隐藏图标
+### 图标控制
 
-showIcon={false} 可隐藏左侧语义图标,文本更紧凑。
+showIcon={false} 可隐藏左侧语义图标；icon 可传 IconName 或 ReactNode。
 
 ```tsx
 <Alert tone="info" showIcon={false}>纯文本提示</Alert>
+<Alert icon={<img src={iconUrl} alt="" />}>自定义图标</Alert>
 ```
 
 ### 自定义操作区
@@ -53,7 +54,7 @@ action 插槽可以放置按钮等操作元素,位于内容与关闭按钮之间
 | --- | --- | --- | --- |
 | tone | `"info" | "success" | "warning" | "danger"` | `"info"` | 语气 |
 | title | `ReactNode` | — | 标题 |
-| icon | `IconName` | — | 自定义图标 |
+| icon | `IconName | ReactNode` | — | 自定义图标,可传内置图标名或自定义节点 |
 | showIcon | `boolean` | `true` | 是否显示语义图标 |
 | action | `ReactNode` | — | 右侧操作区(如按钮) |
 | closable | `boolean` | `false` | 可关闭 |

package/docs/llms/badge.md

@@ -13,8 +13,8 @@ import { Badge } from "@fangxinyan/lumina";
 ### 数字徽标
 
 ```tsx
-<Badge count={3}><IconButton icon="bell" /></Badge>
-<Badge count={128} max={99}><IconButton icon="mail" /></Badge>
+<Badge count={3}><Button icon="bell" /></Badge>
+<Badge count={128} max={99}><Button icon="mail" /></Badge>
 ```
 
 ### 圆点
@@ -22,7 +22,7 @@ import { Badge } from "@fangxinyan/lumina";
 dot 模式不显示数字,只是状态指示。
 
 ```tsx
-<Badge dot><IconButton icon="user" /></Badge>
+<Badge dot><Button icon="user" /></Badge>
 ```
 
 ## API

package/docs/llms/button.md

@@ -5,7 +5,7 @@
 ## 导入
 
 ```tsx
-import { Button, IconButton, Segmented } from "@fangxinyan/lumina";
+import { Button } from "@fangxinyan/lumina";
 ```
 
 ## 示例
@@ -23,12 +23,13 @@ import { Button, IconButton, Segmented } from "@fangxinyan/lumina";
 
 ### 图标按钮
 
-icon 在前,trailingIcon 在后。
+icon 在前,trailingIcon 在后,既支持内置 IconName,也支持外部 ReactNode。
 
 ```tsx
 <Button variant="primary" icon="sparkle">新建</Button>
 <Button icon="download">下载</Button>
 <Button trailingIcon="arrowRight">下一步</Button>
+<Button icon={<img src={iconUrl} alt="" />}>外部图标</Button>
 ```
 
 ### 加载与禁用
@@ -61,27 +62,12 @@ block 让按钮撑满容器宽度,常用于底部主操作或表单提交。
 
 ### 纯图标按钮
 
-IconButton 是只含图标的方形按钮,常配合 tip 使用。
+Button 在只有 icon 时自动呈现为方形按钮,常配合 tip 使用。
 
 ```tsx
-<IconButton icon="heart" tip="收藏" />
-<IconButton icon="bell" tip="通知" />
-<IconButton icon="settings" tip="设置" />
-```
-
-### 分段控制器
-
-互斥多选项切换。
-
-```tsx
-<Segmented
-  options={[
-    { value: "grid", label: "网格" },
-    { value: "list", label: "列表" },
-    { value: "card", label: "卡片" },
-  ]}
-  defaultValue="grid"
-/>
+<Button icon="heart" tip="收藏" />
+<Button icon="bell" tip="通知" />
+<Button icon="settings" tip="设置" />
 ```
 
 ## API
@@ -92,31 +78,15 @@ IconButton 是只含图标的方形按钮,常配合 tip 使用。
 | --- | --- | --- | --- |
 | variant | `"default" | "primary" | "ghost" | "danger"` | `"default"` | 按钮风格 |
 | size | `"sm" | "md" | "lg"` | `"md"` | 按钮尺寸 |
-| icon | `IconName` | — | 前置图标 |
-| trailingIcon | `IconName` | — | 后置图标 |
+| icon | `IconName | ReactNode` | — | 前置图标,可传内置图标名或自定义节点 |
+| trailingIcon | `IconName | ReactNode` | — | 后置图标,可传内置图标名或自定义节点 |
+| iconOnly | `boolean` | `自动` | 渲染为纯图标方形按钮 |
+| tip | `string` | — | 原生悬浮提示,常用于纯图标按钮 |
 | loading | `boolean` | `false` | 加载态 |
 | block | `boolean` | `false` | 撑满父容器宽度 |
 | disabled | `boolean` | `false` | 禁用 |
 | onClick | `(e: MouseEvent) => void` | — | 点击回调 |
 
 
-**IconButton**
-
-| Prop | 类型 | 默认 | 说明 |
-| --- | --- | --- | --- |
-| icon \* | `IconName` | — | 图标名 |
-| tip | `string` | — | 悬浮提示 |
-| size / variant | `—` | — | 继承自 Button |
-
-
-**Segmented**
-
-| Prop | 类型 | 默认 | 说明 |
-| --- | --- | --- | --- |
-| options \* | `{ value, label, disabled? }[]` | — | 选项数组 |
-| value / defaultValue | `T` | — | 受控/初始选中值 |
-| onChange | `(value: T) => void` | — | 切换回调 |
-
-
 ---
 [← 回到索引](../llms.md)

package/docs/llms/card.md

@@ -5,7 +5,7 @@
 ## 导入
 
 ```tsx
-import { Card, Panel } from "@fangxinyan/lumina";
+import { Card } from "@fangxinyan/lumina";
 ```
 
 ## 示例
@@ -28,20 +28,20 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 <Card hoverable>可点击卡片</Card>
 ```
 
-### Panel
+### 带标题
 
 带标题、描述、操作区。
 
 ```tsx
-<Panel title="月度营收" description="2026 年 4 月" actions={...}>
+<Card title="月度营收" description="2026 年 4 月" actions={...}>
   ¥ 12,480
-</Panel>
+</Card>
 ```
 
-### Panel 带操作
+### 标题区操作
 
 ```tsx
-<Panel title="..." actions={<Button size="sm" icon="plus">邀请</Button>}>...</Panel>
+<Card title="..." actions={<Button size="sm" icon="plus">邀请</Button>}>...</Card>
 ```
 
 ## API
@@ -53,12 +53,6 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 | variant | `"raised" | "flat" | "sunken"` | `"raised"` | 视觉变体 |
 | padding | `"none" | "sm" | "md" | "lg"` | `"md"` | 内边距 |
 | hoverable | `boolean` | `false` | 悬浮时抬起 |
-
-
-**Panel**
-
-| Prop | 类型 | 默认 | 说明 |
-| --- | --- | --- | --- |
 | title | `ReactNode` | — | 标题 |
 | description | `ReactNode` | — | 副标题 |
 | actions | `ReactNode` | — | 右上操作区 |

package/docs/llms/cascader.md

@@ -12,10 +12,27 @@ import { Cascader } from "@fangxinyan/lumina";
 
 ### 基础用法
 
+option.icon 支持 IconName 或 ReactNode。
+
 ```tsx
 <Cascader options={regions} value={addr} onChange={setAddr} />
 ```
 
+### 搜索与清除
+
+showSearch 开启路径搜索,allowClear 提供一键清空,popupClassName 可标记浮层。
+
+```tsx
+<Cascader
+  showSearch={{ limit: 8 }}
+  allowClear
+  popupClassName="my-cascader-popup"
+  options={regions}
+  value={addr}
+  onChange={setAddr}
+/>
+```
+
 ## API
 
 **Cascader**
@@ -23,10 +40,15 @@ import { Cascader } from "@fangxinyan/lumina";
 | Prop | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
 | options \* | `CascaderOption[]` | — | 层级选项树 |
+| options[].icon | `IconName | ReactNode` | — | 选项前置图标,可传内置图标名或自定义节点 |
 | value / defaultValue | `string[]` | — | 受控/初始路径 |
 | onChange | `(path: string[]) => void` | — | 选择叶子时触发 |
 | placeholder | `string` | — | 占位文案 |
 | disabled | `boolean` | `false` | 禁用 |
+| allowClear | `boolean` | `false` | 显示清除按钮 |
+| showSearch | `boolean | { filter?, render?, limit? }` | — | 搜索路径,支持 boolean / 对象配置 |
+| popupClassName / dropdownClassName | `string` | — | 浮层面板 className |
+| changeOnSelect | `boolean` | `false` | 允许选中非叶子节点 |
 
 
 ---

package/docs/llms/{accordion.md → collapse.md}

@@ -1,11 +1,11 @@
-# Accordion 折叠面板
+# Collapse 折叠面板
 
 > 纵向折叠面板。
 
 ## 导入
 
 ```tsx
-import { Accordion } from "@fangxinyan/lumina";
+import { Collapse } from "@fangxinyan/lumina";
 ```
 
 ## 示例
@@ -13,7 +13,7 @@ import { Accordion } from "@fangxinyan/lumina";
 ### 基础
 
 ```tsx
-<Accordion items={[{ key, title, content }]} />
+<Collapse items={[{ key, label, children }]} />
 ```
 
 ### 多项展开
@@ -21,7 +21,7 @@ import { Accordion } from "@fangxinyan/lumina";
 multiple 允许同时展开多个面板。
 
 ```tsx
-<Accordion multiple defaultActiveKeys={["1", "2"]} ... />
+<Collapse defaultActiveKey={["1", "2"]} ... />
 ```
 
 ### 手风琴模式
@@ -29,7 +29,7 @@ multiple 允许同时展开多个面板。
 accordion={true} 同一时刻最多只展开一项;与 multiple 同时传入时 accordion 优先。
 
 ```tsx
-<Accordion accordion defaultActiveKeys={["1"]} ... />
+<Collapse accordion defaultActiveKey="1" ... />
 ```
 
 ### 仅图标可点
@@ -37,7 +37,7 @@ accordion={true} 同一时刻最多只展开一项;与 multiple 同时传入时
 collapsible="icon" 将展开触发限制在右侧箭头图标上,标题区域不再响应。
 
 ```tsx
-<Accordion collapsible="icon" ... />
+<Collapse collapsible="icon" ... />
 ```
 
 ### 禁用展开
@@ -45,20 +45,22 @@ collapsible="icon" 将展开触发限制在右侧箭头图标上,标题区域不
 collapsible="disabled" 会禁用所有项的展开交互。
 
 ```tsx
-<Accordion collapsible="disabled" defaultActiveKeys={["1"]} ... />
+<Collapse collapsible="disabled" defaultActiveKey="1" ... />
 ```
 
 ## API
 
-**Accordion**
+**Collapse**
 
 | Prop | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
-| items \* | `AccordionItem[]` | — | 面板数据 |
-| multiple | `boolean` | `false` | 可同时展开多个 |
+| items \* | `CollapseItem[]` | — | 面板数据 |
 | accordion | `boolean` | `false` | 手风琴模式(同一时刻最多一项) |
+| multiple | `boolean` | `true` | 可同时展开多个 |
 | collapsible | `"header" | "icon" | "disabled"` | `"header"` | 展开触发区域 |
-| activeKeys / defaultActiveKeys | `string[]` | — | 受控/初始展开 |
+| activeKey / defaultActiveKey | `string | string[]` | — | 受控/初始展开 |
+| ghost | `boolean` | `false` | 无外框/阴影的轻量样式 |
+| size | `"small" | "middle" | "large"` | `"middle"` | 尺寸 |
 | onChange | `(keys: string[]) => void` | — | 展开变更 |
 
 

package/docs/llms/drawer.md

@@ -23,7 +23,7 @@ extra 渲染到标题右边,常用来放刷新 / 更多 / 保存按钮。
 ```tsx
 <Drawer
   title="订单详情"
-  extra={<><IconButton icon="edit" tip="编辑" /><Button variant="primary">保存</Button></>}
+  extra={<><Button icon="edit" tip="编辑" /><Button variant="primary">保存</Button></>}
 />
 ```
 

package/docs/llms/form.md

@@ -1,6 +1,6 @@
 # Form 表单
 
-> 受控表单,字段绑定 + 校验,API 对齐 antd。
+> 受控表单,字段绑定 + 校验。
 
 ## 示例
 

package/docs/llms/image.md

@@ -5,7 +5,7 @@
 ## 导入
 
 ```tsx
-import { Image, ImageGrid } from "@fangxinyan/lumina";
+import { Image, ImageGrid, SpriteImage, LayeredImage } from "@fangxinyan/lumina";
 ```
 
 ## 示例
@@ -16,10 +16,43 @@ import { Image, ImageGrid } from "@fangxinyan/lumina";
 <Image src={url} width={240} height={160} />
 ```
 
+### 图标 / 原始资源
+
+variant="icon" 会默认去掉外层 padding,适合 1:1 装备、物品、头像缩略图；variant="raw" 保留原始图片比例。
+
+```tsx
+<Image variant="icon" src={iconUrl} width={56} height={56} preview={false} />
+<Image variant="raw" src={bannerUrl} width={220} height={84} objectFit="contain" />
+```
+
+### Sprite 裁剪
+
+SpriteImage 用 background-position 裁剪同一张雪碧图,适合 url + x/y/width/height 形式的图标资源。
+
+```tsx
+<SpriteImage src={sheetUrl} sprite={{ x: 32, y: 0, width: 32, height: 32 }} />
+```
+
+### 多图层图片
+
+LayeredImage 将多张图片叠在同一个盒子里,适合头像 + 头像框、底图 + 标记等资产。
+
+```tsx
+<LayeredImage
+  width={72}
+  height={72}
+  layers={[
+    { src: headUrl, fit: "cover" },
+    { src: frameUrl },
+  ]}
+/>
+```
+
 ### 图片组
 
 ```tsx
 <ImageGrid images={images} />
+<ImageGrid images={icons} imageProps={{ variant: "icon", preview: false }} />
 ```
 
 ## API
@@ -30,9 +63,47 @@ import { Image, ImageGrid } from "@fangxinyan/lumina";
 | --- | --- | --- | --- |
 | src | `string` | — | 图片 URL |
 | width / height | `number | string` | — | 尺寸 |
+| variant | `"framed" | "raw" | "icon"` | `"framed"` | 视觉形态 |
+| frame | `boolean` | `framed 时 true` | 是否保留内层凹陷 frame |
+| padding | `number | string` | — | 外层留白,raw/icon 默认 0 |
+| objectFit / objectPosition | `CSSProperties` | — | 底层 img 的 object-fit / object-position |
 | preview | `boolean` | `true` | 支持点击全屏预览 |
 | hover | `boolean` | `true` | 悬浮放大 |
 | placeholder | `ReactNode` | — | 占位/错误时内容 |
+| imgProps | `ImgHTMLAttributes` | — | 透传到底层 img 的属性 |
+
+
+**ImageGrid**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| images \* | `ImageGridItem[]` | — | 图片项数组,单项也可覆盖 Image props |
+| columns | `number` | — | 固定列数,不传则自动填充 |
+| itemHeight | `number` | `130` | 默认图片高度 |
+| minItemWidth | `number | string` | `160` | 自动填充时的最小列宽 |
+| gap | `number | string` | `14` | 网格间距 |
+| imageProps | `ImageProps` | — | 批量传给每个 Image 的属性 |
+
+
+**SpriteImage**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| src \* | `string` | — | sprite sheet 图片 URL |
+| sprite \* | `{ x; y; width; height }` | — | 裁剪区域 |
+| width / height | `number | string` | — | 渲染尺寸,默认使用 sprite 尺寸 |
+| scale | `number` | `1` | 未指定 width/height 时的缩放倍数 |
+| backgroundSize | `string` | — | 自定义 background-size |
+| variant / frame / padding | `ImageVariant / boolean / number` | — | 同 Image 的媒体外观控制 |
+
+
+**LayeredImage**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| layers \* | `LayeredImageLayer[]` | — | 按顺序叠放的图片层 |
+| width / height | `number | string` | — | 容器尺寸 |
+| variant / frame / padding | `ImageVariant / boolean / number` | — | 同 Image 的媒体外观控制 |
 
 
 ---

package/docs/llms/input.md

@@ -14,26 +14,32 @@ import { Input, Textarea } from "@fangxinyan/lumina";
 
 ```tsx
 const [v, setV] = useState("");
-<Input placeholder="输入用户名" value={v} onChange={setV} leadingIcon="user" />
+<Input
+  placeholder="输入用户名"
+  value={v}
+  onChange={(e) => setV(e.target.value)}
+  leadingIcon="user"
+/>
 ```
 
 ### 前后置图标
 
-leadingIcon / trailingIcon。
+leadingIcon / trailingIcon 支持内置 IconName 或外部 ReactNode。
 
 ```tsx
 <Input placeholder="搜索..." leadingIcon="search" />
+<Input placeholder="物品名" leadingIcon={<img src={iconUrl} alt="" />} />
 ```
 
-### 密码切换
+### Input.Password
 
-trailingIcon 可点击切换密码可见性。
+密码输入框,内置显隐切换。
 
 ```tsx
-<Input
-  type={showPw ? "text" : "password"}
-  trailingIcon={showPw ? "eyeOff" : "eye"}
-  onTrailingIconClick={() => setShowPw(s => !s)}
+<Input.Password
+  value={pw}
+  onChange={(e) => setPw(e.target.value)}
+  allowClear
 />
 ```
 
@@ -50,7 +56,7 @@ invalid 触发红色凹槽。
 allowClear 在值非空时显示 × 按钮,点击即清空。
 
 ```tsx
-<Input value={v} onChange={setV} allowClear placeholder="输入后右侧会出现 ×" />
+<Input value={v} onValueChange={setV} allowClear placeholder="输入后右侧会出现 ×" />
 ```
 
 ### 前缀 / 后缀
@@ -69,22 +75,22 @@ showCount 显示当前字数,配合 maxLength 显示 N / max。
 ```tsx
 <Input
   value={v}
-  onChange={setV}
+  onValueChange={setV}
   maxLength={20}
   showCount
   placeholder="最多输入 20 个字"
 />
 ```
 
-### 多行文本
+### Input.TextArea 多行文本
 
-Textarea 与 Input 共享同款凹槽,也支持 allowClear / maxLength / showCount。
+Input.TextArea 与 Textarea 使用同一套多行输入能力,也支持 allowClear / maxLength / showCount。
 
 ```tsx
-<Textarea
+<Input.TextArea
   placeholder="..."
   value={msg}
-  onChange={setMsg}
+  onChange={(e) => setMsg(e.target.value)}
   allowClear
   maxLength={300}
   showCount
@@ -98,25 +104,29 @@ Textarea 与 Input 共享同款凹槽,也支持 allowClear / maxLength / showCou
 | Prop | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
 | value / defaultValue | `string` | — | 受控值 / 初值 |
-| onChange | `(value: string, e) => void` | — | 变更回调 |
+| onChange | `(event) => void` | — | 变更回调,传入 React 原生事件 |
+| onValueChange | `(value: string, event) => void` | — | 值回调便捷写法 |
 | placeholder | `string` | — | 占位文案 |
-| leadingIcon / trailingIcon | `IconName` | — | 前/后置图标 |
+| leadingIcon / trailingIcon | `IconName | ReactNode` | — | 前/后置图标,可传内置图标名或自定义节点 |
 | prefix | `ReactNode` | — | 左侧内嵌内容(在 leadingIcon 之后) |
 | suffix | `ReactNode` | — | 右侧内嵌内容(在 trailingIcon 之前) |
 | allowClear | `boolean` | `false` | 显示内置的清除按钮 |
 | maxLength | `number` | — | 最大字符数,透传至原生 input |
 | showCount | `boolean` | `false` | 在输入框下方显示字数统计 |
+| Input.Password | `Component` | — | 密码输入框,内置显隐切换 |
+| Input.TextArea | `typeof Textarea` | — | 多行文本别名 |
 | size | `"sm" | "md" | "lg"` | `"md"` | 尺寸 |
 | invalid | `boolean` | `false` | 错误态 |
 | disabled | `boolean` | `false` | 禁用 |
 
 
-**Textarea**
+**Input.TextArea / Textarea**
 
 | Prop | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
 | value / defaultValue | `string` | — | 受控值 / 初值 |
-| onChange | `(value: string, e) => void` | — | 变更回调 |
+| onChange | `(event) => void` | — | 变更回调,传入 React 原生事件 |
+| onValueChange | `(value: string, event) => void` | — | 值回调便捷写法 |
 | allowClear | `boolean` | `false` | 右上角显示清除按钮 |
 | maxLength | `number` | — | 最大字符数 |
 | showCount | `boolean` | `false` | 显示字数统计 |

package/docs/llms/message.md

@@ -0,0 +1,63 @@
+# Message 全局消息
+
+> 全局轻量提示,支持函数调用与对象配置。
+
+## 导入
+
+```tsx
+import { message, MessageContainer } from "@fangxinyan/lumina";
+```
+
+## 示例
+
+### 四种语义
+
+```tsx
+message.info("已保存到草稿");
+message.success("操作完成");
+message.warning("请注意");
+message.error("发生错误");
+```
+
+### 带标题
+
+```tsx
+message.success("已上传 5 个文件", "上传完成");
+```
+
+### 对象调用
+
+支持 content / duration / key / destroy,适合需要更新或手动关闭的提示。
+
+```tsx
+message.open({ key: "sync", type: "info", content: "同步中...", duration: 0 });
+setTimeout(() => {
+  message.success({ key: "sync", content: "同步完成", duration: 1800 });
+}, 900);
+message.destroy("sync");
+```
+
+## API
+
+**message.***
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| info(message, title?) | `(msg, title?) => id` | — | 信息提示 |
+| success(message, title?) | `(msg, title?) => id` | — | 成功 |
+| warning(message, title?) / warn(message, title?) | `(msg, title?) => id` | — | 警告 |
+| error(message, title?) | `(msg, title?) => id` | — | 错误 |
+| open({ type, content, title?, duration?, key? }) | `(config) => id` | — | 对象配置 API |
+| dismiss(id) | `(id: number) => void` | — | 关闭一条 |
+| destroy(key?) / clear() | `(key?) => void` | — | 关闭指定 key 或清空全部 |
+
+
+**MessageContainer**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| placement | `"top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center"` | `"top-right"` | 位置 |
+
+
+---
+[← 回到索引](../llms.md)

package/docs/llms/modal.md

@@ -16,6 +16,24 @@ import { Modal } from "@fangxinyan/lumina";
 <Modal open={m} onClose={...} title="标题">...</Modal>
 ```
 
+### 静态确认框
+
+通过 Modal.confirm / warning / error / success / info 直接创建一次性对话框。
+
+```tsx
+Modal.confirm({
+  title: "覆盖当前配置?",
+  content: "保存后会立即生效。",
+  okText: "覆盖",
+  onOk: async () => {
+    await save();
+    message.success("已覆盖");
+  },
+});
+
+Modal.warning({ title: "容量不足", content: "请先清理缓存。" });
+```
+
 ### 确认操作 (footer 自定义)
 
 用 footer 自定义底部按钮。传 null 可以去掉 footer。
@@ -85,5 +103,17 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 | zIndex | `number` | — | 覆盖遮罩 z-index |
 
 
+**Modal 静态 API**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| Modal.confirm(config) | `(config) => { destroy, update }` | — | 确认框,默认显示取消/确定 |
+| Modal.info / success / warning / error(config) | `(config) => { destroy, update }` | — | 单按钮提示框 |
+| Modal.destroyAll() | `() => void` | — | 关闭全部静态弹窗 |
+| config.content | `ReactNode` | — | 正文内容 |
+| config.okCancel | `boolean` | — | 是否显示取消按钮 |
+| config.onOk | `() => void | Promise<void>` | — | 确定回调,返回 Promise 时自动显示 loading |
+
+
 ---
 [← 回到索引](../llms.md)

package/docs/llms/popover.md

@@ -71,6 +71,21 @@ import { Popover } from "@fangxinyan/lumina";
 </div>
 ```
 
+### 细分位置与浮层 class
+
+placement 支持 bottomLeft 等细分方向,overlayClassName 可标记浮层节点。
+
+```tsx
+<Popover
+  placement="bottomLeft"
+  overlayClassName="settings-popover"
+  title="快捷设置"
+  content={<div>显示在触发器左下方。</div>}
+>
+  <Button icon="settings">设置</Button>
+</Popover>
+```
+
 ### 箭头
 
 arrow 属性添加指向触发元素的小箭头
@@ -152,7 +167,7 @@ trigger="hover" 鼠标悬停触发
 | --- | --- | --- | --- |
 | content \* | `ReactNode` | — | 浮层内容 |
 | title | `ReactNode` | — | 标题 |
-| placement | `"top" | "bottom" | "left" | "right"` | `"bottom"` | 弹出位置 |
+| placement | `"top" | "bottom" | "left" | "right" | ...` | `"bottom"` | 弹出位置,支持 bottomLeft 等细分方向 |
 | trigger | `"click" | "hover"` | `"click"` | 触发方式 |
 | arrow | `boolean` | `false` | 显示箭头 |
 | closable | `boolean` | `false` | 显示关闭按钮 |
@@ -160,6 +175,8 @@ trigger="hover" 鼠标悬停触发
 | open | `boolean` | — | 受控显示状态 |
 | defaultOpen | `boolean` | `false` | 非受控初始状态 |
 | onOpenChange | `(open: boolean) => void` | — | 显示状态变化回调 |
+| visible / onVisibleChange | `boolean / (visible) => void` | — | 受控显示状态别名 |
+| overlayClassName / popupClassName | `string` | — | 浮层 className |
 
 
 ---