@fangxinyan/lumina 0.9.0 → 0.9.1

package/dist/styles.css

@@ -1997,6 +1997,8 @@ button.collapse-chev {
 }
 .modal-head {
   display: flex;
+  flex: 0 0 auto;
+  min-width: 0;
   align-items: flex-start;
   justify-content: space-between;
   gap: var(--gap-3);
@@ -2011,26 +2013,41 @@ button.collapse-chev {
 .modal-body {
   min-width: 0;
   min-height: 0;
-  margin-inline: calc(var(--gap-6) * -1);
+  margin-inline: calc(var(--overlay-shadow-safe-area) * -1);
   padding: var(--overlay-shadow-safe-area);
   color: var(--lmn-modal-fg-muted, var(--fg-muted));
   font-size: 13px;
   line-height: 1.6;
-  flex: 1;
+  flex: 1 1 auto;
+  overflow-x: hidden;
   overflow-y: auto;
 }
 .modal-body:first-child {
-  margin-top: calc(var(--gap-6) * -1);
+  margin-top: calc(var(--overlay-shadow-safe-area) * -1);
 }
-.modal-body:last-child {
-  margin-bottom: calc(var(--gap-6) * -1);
+.modal-body.default-overflow > * {
+  min-width: 0;
+  max-width: 100%;
+  flex-shrink: 0;
 }
 .modal-body.inset-none {
+  margin-inline: calc(var(--gap-6) * -1);
   padding: 0;
 }
+.modal-body.inset-none:first-child {
+  margin-top: calc(var(--gap-6) * -1);
+}
+.modal-body.inset-none:last-child {
+  margin-bottom: calc(var(--gap-6) * -1);
+}
 .modal-foot {
   display: flex;
-  gap: 10px;
+  flex: 0 0 auto;
+  min-width: 0;
+  min-height: var(--lmn-modal-footer-min-height, var(--ctrl-h));
+  margin-top: var(--lmn-modal-footer-gap, var(--gap-4));
+  align-items: center;
+  gap: var(--lmn-modal-footer-action-gap, var(--gap-3));
   justify-content: flex-end;
 }
 .modal-close {

package/docs/llms/modal.md

@@ -104,6 +104,28 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 </Modal>
 ```
 
+### 长内容与独立 footer
+
+默认正文只纵向滚动并保留底部安全区；直接子控件不会被纵向压缩。footer 独立于滚动区，bodyOverflow="hidden" 仍可交给内层容器滚动。
+
+```tsx
+<Modal
+  footer={null}
+  bodyStyle={{ maxHeight: 360, display: "flex", flexDirection: "column" }}
+>
+  <Input placeholder="固定高度的搜索框" />
+  <LongList />
+</Modal>
+
+<Modal bodyStyle={{ maxHeight: 360 }}>
+  <LongForm />
+</Modal>
+
+<Modal bodyOverflow="hidden">
+  <InnerScrollableLayout />
+</Modal>
+```
+
 ### 嵌套浮层与 Esc 顺序
 
 子 Select 即使 Portal 到对话框之外，也会保持在 Modal 上方并参与同一焦点范围；连续按 Esc 会先关 Select，再关 Modal。
@@ -125,14 +147,14 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 | onOk | `() => void` | — | 默认 OK 按钮点击 |
 | onCancel | `() => void` | — | 默认 Cancel 按钮 / Esc / 关闭 / 遮罩触发,缺省则用 onClose |
 | title / description | `ReactNode` | — | 标题/说明 |
-| footer | `ReactNode` | — | 自定义底部(null 去除) |
+| footer | `ReactNode` | — | 独立于正文滚动区的底部区域；自定义内容，null 去除 |
 | 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 快捷控制 |
+| bodyOverflow | `CSSProperties['overflow']` | — | 正文容器 overflow 快捷控制；hidden 可让复杂内层布局接管滚动 |
 | bodyInset | `"safe" | "none"` | `"safe"` | 正文边缘留白；safe 自动保护拟态阴影，none 用于贴边内容 |
 | closable | `boolean` | `true` | 显示右上角 × |
 | closeIcon | `ReactNode` | — | 自定义关闭图标 |

package/docs/llms/theme.md

@@ -272,7 +272,7 @@ applyTheme(document.documentElement, {
 | tokens | `ThemeTokens` | — | 短键会写入组件前缀变量；以 -- 开头的键作为高级原始变量逃生口 |
 | components | `ComponentThemeOverrides` | — | 继续定向配置当前组件内部或 subtree 后代的组件类型 |
 | styles.root | `CSSProperties` | — | 所有组件都支持真实视觉根节点；调用方 style 仍保持最高优先级 |
-| styles.popup / overlay / body | `CSSProperties` | — | 浮层、遮罩和正文等组件专用静态插槽；定位与用户 popupStyle 不会被覆盖 |
+| styles.popup / overlay / header / body / footer | `CSSProperties` | — | 浮层、遮罩和 Modal 头部/正文/footer 等稳定静态插槽；定位与用户实例样式不会被覆盖 |
 
 
 ---

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.9.0`
+- **版本**: `0.9.1`
 - **React 最低版本**: 18
 - **环境**: 带打包器的 React 工程(Vite / Next.js / Webpack / Remix / Electron + Vite 等)
 - **零运行时依赖**: 只依赖 `react` / `react-dom` (peer deps)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fangxinyan/lumina",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",