@fangxinyan/lumina 0.6.8 → 0.6.9

package/README.md

@@ -19,11 +19,20 @@
 
 - **TypeScript 优先** — 全量类型定义，IDE 智能提示完善
 - **拟态设计语言** — 统一的凸起/凹陷/柔光阴影系统，通过 CSS 变量自定义
-- **25+ 基础组件** — Button、Input、Table、Modal、Toast、Calendar …
+- **45+ 公共组件** — Button、Input、Table、Modal、Message、Calendar …
 - **Electron 原生感** — `TitleBar`、`Sidebar`、`AppShell` 直接拼出窗口布局
 - **主题化** — 明/暗模式、6 套强调色、3 档密度（紧凑/标准/宽松）
 - **零运行时依赖** — 只依赖 React；样式纯 CSS 变量驱动
 
+## Why Lumina matters for AI-assisted development
+
+Lumina 不只是把组件打成 npm 包，也把“AI 能按需读懂组件”的上下文一起发布出去。
+
+- **内置 LLM 文档** — 每个组件都有独立 `docs/llms/<id>.md`，覆盖导入方式、可复制示例和完整 Props 表，AI 不必一次读取整份 API。
+- **按需组件文档** — `@fangxinyan/lumina/llms.md` 提供全局约定和组件索引，`@fangxinyan/lumina/llms/button.md` 这类子路径可直接定位到单组件。
+- **零运行时依赖** — 运行时只依赖 React / React DOM，组件逻辑、主题 token 和样式入口都更容易被 AI 审查、迁移和解释。
+- **Electron 场景优先** — `TitleBar`、`WindowControls`、`Sidebar`、`StatusBar`、`AppShell` 等桌面应用原语减少了业务侧临时拼装窗口 UI 的成本。
+
 ## 📦 安装
 
 ```bash
@@ -60,7 +69,7 @@ export default function App() {
 ## 🛠 本地开发（下载即用）
 
 ```bash
-cd package
+cd lumina
 npm install
 npm run dev          # 启动 Playground（http://localhost:5173）
 npm run typecheck    # 类型检查
@@ -73,16 +82,18 @@ npm run build:lib    # 构建库 → dist/（ESM + CJS + .d.ts）
 项目结构：
 
 ```
-package/
+lumina/
 ├── src/
-│   ├── components/       # 所有 .tsx 组件源码
+│   ├── components/       # 每个组件一个目录，包含 .tsx / .css / index.ts
 │   ├── styles/
 │   │   ├── tokens.css    # 设计令牌（主题 / 颜色 / 阴影 / 间距）
 │   │   ├── base.css      # 基础样式（body / scrollbar / focus）
-│   │   └── components/   # 每个组件对应一个 .css 文件
+│   │   ├── shared.css    # 共享动画 / 跨组件样式
+│   │   └── index.css     # 完整样式入口
 │   └── index.ts          # 公共出口
 ├── playground/           # 本地演示应用（Vite）
 ├── docs/                 # 组件文档 & API 文档
+├── scripts/              # 文档生成 / 公开 API 校验脚本
 ├── tsup.config.ts        # 库构建配置
 └── vite.config.ts        # Playground 开发服务器
 ```
@@ -112,7 +123,7 @@ package/
 
 ## 📚 文档
 
-- **[🤖 AI / LLM 组件参考(索引)](./docs/llms.md)** — 全局约定 + 39 个组件的链接
+- **[🤖 AI / LLM 组件参考(索引)](./docs/llms.md)** — 全局约定 + 完整组件索引
 - **[单组件文档](./docs/llms/)** — 每个组件一份 `.md`,AI 按需读取(例如 [`llms/button.md`](./docs/llms/button.md))
 - [设计令牌](./docs/tokens.md)
 - [Electron 集成](./docs/electron.md)

package/dist/{Card-M6UMBDD2.css → Card-4DKCXWFU.css}

@@ -66,8 +66,10 @@
   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);
+  background: color-mix(in srgb, var(--bg) 72%, var(--bg-sunken));
+  box-shadow:
+    inset calc(var(--shadow-inset-offset) * 0.45) calc(var(--shadow-inset-offset) * 0.45) calc(var(--shadow-inset-blur) * 0.45) color-mix(in oklch, var(--shadow-dark) 55%, transparent),
+    inset calc(var(--shadow-inset-offset) * -0.45) calc(var(--shadow-inset-offset) * -0.45) calc(var(--shadow-inset-blur) * 0.45) color-mix(in oklch, var(--shadow-light) 72%, transparent);
   color: var(--fg-muted);
   z-index: 1;
 }

package/dist/Card.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkTDYJ5ECR_cjs = require('./chunk-TDYJ5ECR.cjs');
+var chunkOUSJMIZX_cjs = require('./chunk-OUSJMIZX.cjs');
 require('./chunk-MZCKPLHQ.cjs');
 
 
 
 Object.defineProperty(exports, "Card", {
   enumerable: true,
-  get: function () { return chunkTDYJ5ECR_cjs.Card; }
+  get: function () { return chunkOUSJMIZX_cjs.Card; }
 });

package/dist/Card.js

@@ -1,2 +1,2 @@
-export { Card } from './chunk-BKI7JY4Z.js';
+export { Card } from './chunk-HEBBQZUT.js';
 import './chunk-3GJZRYTD.js';

package/dist/{chunk-BKI7JY4Z.js → chunk-HEBBQZUT.js}

@@ -1,7 +1,7 @@
 import { Spin } from './chunk-3GJZRYTD.js';
 import './tokens-RGFJKRC7.css';
 import './shared-NJHRNLRH.css';
-import './Card-M6UMBDD2.css';
+import './Card-4DKCXWFU.css';
 import * as React from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 

package/dist/{chunk-TDYJ5ECR.cjs → chunk-OUSJMIZX.cjs}

@@ -3,7 +3,7 @@
 var chunkMZCKPLHQ_cjs = require('./chunk-MZCKPLHQ.cjs');
 require('./tokens-RGFJKRC7.css');
 require('./shared-NJHRNLRH.css');
-require('./Card-M6UMBDD2.css');
+require('./Card-4DKCXWFU.css');
 var React = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 

package/dist/index.cjs

@@ -29,7 +29,7 @@ var chunkN4JH6HHA_cjs = require('./chunk-N4JH6HHA.cjs');
 var chunk3NSBPQBT_cjs = require('./chunk-3NSBPQBT.cjs');
 var chunkPEFIXNAV_cjs = require('./chunk-PEFIXNAV.cjs');
 var chunk4N64ZL5M_cjs = require('./chunk-4N64ZL5M.cjs');
-var chunkTDYJ5ECR_cjs = require('./chunk-TDYJ5ECR.cjs');
+var chunkOUSJMIZX_cjs = require('./chunk-OUSJMIZX.cjs');
 var chunkMZCKPLHQ_cjs = require('./chunk-MZCKPLHQ.cjs');
 var chunkAA2FRQUQ_cjs = require('./chunk-AA2FRQUQ.cjs');
 var chunk5KGGB3EH_cjs = require('./chunk-5KGGB3EH.cjs');
@@ -51,7 +51,7 @@ var chunkHTW62OMX_cjs = require('./chunk-HTW62OMX.cjs');
 var chunkGJAEGIPM_cjs = require('./chunk-GJAEGIPM.cjs');
 
 // src/index.ts
-var VERSION = "0.6.8";
+var VERSION = "0.6.9";
 
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
@@ -271,7 +271,7 @@ Object.defineProperty(exports, "List", {
 });
 Object.defineProperty(exports, "Card", {
   enumerable: true,
-  get: function () { return chunkTDYJ5ECR_cjs.Card; }
+  get: function () { return chunkOUSJMIZX_cjs.Card; }
 });
 Object.defineProperty(exports, "Spin", {
   enumerable: true,

package/dist/index.d.cts

@@ -49,6 +49,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.8";
+declare const VERSION = "0.6.9";
 
 export { VERSION };

package/dist/index.d.ts

@@ -49,6 +49,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.8";
+declare const VERSION = "0.6.9";
 
 export { VERSION };

package/dist/index.js

@@ -27,7 +27,7 @@ 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 { Card } from './chunk-HEBBQZUT.js';
 export { Spin } from './chunk-3GJZRYTD.js';
 export { Cascader } from './chunk-FPII6I52.js';
 export { Checkbox } from './chunk-PHONNUK2.js';
@@ -49,6 +49,6 @@ 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.8";
+var VERSION = "0.6.9";
 
 export { VERSION };

package/dist/styles.css

@@ -1199,8 +1199,10 @@ input, textarea, select { font-family: inherit; color: inherit; }
   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);
+  background: color-mix(in srgb, var(--bg) 72%, var(--bg-sunken));
+  box-shadow:
+    inset calc(var(--shadow-inset-offset) * 0.45) calc(var(--shadow-inset-offset) * 0.45) calc(var(--shadow-inset-blur) * 0.45) color-mix(in oklch, var(--shadow-dark) 55%, transparent),
+    inset calc(var(--shadow-inset-offset) * -0.45) calc(var(--shadow-inset-offset) * -0.45) calc(var(--shadow-inset-blur) * 0.45) color-mix(in oklch, var(--shadow-light) 72%, transparent);
   color: var(--fg-muted);
   z-index: 1;
 }

package/docs/llms/card.md

@@ -61,10 +61,10 @@ bodyLayout 控制正文槽布局，bodyClassName / bodyStyle / bodyProps 直接
 
 ### 加载覆盖
 
-loading 会在正文区域显示内建 overlay；loadingOverlay 可替换默认 Spin。
+loading 会在正文区域显示中性 overlay；默认 Spin 跟随主题色，loadingOverlay 可替换内容。
 
 ```tsx
-<Card loading loadingOverlay="正在同步...">
+<Card loading>
   ...
 </Card>
 ```

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.6.8`
+- **版本**: `0.6.9`
 - **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.6.8",
+  "version": "0.6.9",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",