@fangxinyan/lumina 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +1,110 @@
+# Lumina
+
+> A neumorphic React + TypeScript component library designed for Electron desktop apps.
+
+柔和、温润的拟态（Neumorphism）风格组件库，使用 **React 18** + **TypeScript**，开箱即用地适配 **Electron** 桌面应用场景 —— 包含窗口标题栏、侧边栏、抽屉、弹窗等桌面级组件。
+
+## ✨ 特性
+
+- **TypeScript 优先** — 全量类型定义，IDE 智能提示完善
+- **拟态设计语言** — 统一的凸起/凹陷/柔光阴影系统，通过 CSS 变量自定义
+- **25+ 基础组件** — Button、Input、Table、Modal、Toast、Calendar …
+- **Electron 原生感** — `TitleBar`、`Sidebar`、`AppShell` 直接拼出窗口布局
+- **主题化** — 明/暗模式、6 套强调色、3 档密度（紧凑/标准/宽松）
+- **零运行时依赖** — 只依赖 React；样式纯 CSS 变量驱动
+
+## 📦 安装
+
+```bash
+npm install lumina
+# 或
+pnpm add lumina
+# 或
+yarn add lumina
+```
+
+Peer deps: `react@>=18`, `react-dom@>=18`.
+
+## 🚀 快速上手
+
+```tsx
+import { Button, Card, toast, ToastContainer } from "lumina";
+import "lumina/styles"; // 全局样式 + 设计令牌
+
+export default function App() {
+  return (
+    <>
+      <Card padding="lg">
+        <h2>欢迎使用 Lumina</h2>
+        <Button variant="primary" onClick={() => toast.success("你好！")}>
+          点我
+        </Button>
+      </Card>
+      <ToastContainer />
+    </>
+  );
+}
+```
+
+## 🛠 本地开发（下载即用）
+
+```bash
+cd package
+npm install
+npm run dev          # 启动 Playground（http://localhost:5173）
+npm run typecheck    # 类型检查
+npm run build:lib    # 构建库 → dist/（ESM + CJS + .d.ts）
+```
+
+> Vite 已配置好 `lumina` 的别名，直接指向 `src/index.ts`。
+> 你修改 `src/components/*.tsx` 或 `src/styles/*.css`，Playground 会即时热更新。
+
+项目结构：
+
+```
+package/
+├── src/
+│   ├── components/       # 所有 .tsx 组件源码
+│   ├── styles/
+│   │   ├── tokens.css    # 设计令牌（主题 / 颜色 / 阴影 / 间距）
+│   │   ├── base.css      # 基础样式（body / scrollbar / focus）
+│   │   └── components/   # 每个组件对应一个 .css 文件
+│   └── index.ts          # 公共出口
+├── playground/           # 本地演示应用（Vite）
+├── docs/                 # 组件文档 & API 文档
+├── tsup.config.ts        # 库构建配置
+└── vite.config.ts        # Playground 开发服务器
+```
+
+## 🎨 主题定制
+
+所有设计令牌都在 `:root` 上定义，可以通过 `data-*` 属性切换主题：
+
+```html
+<html data-theme="dark" data-accent="sky" data-density="compact">
+```
+
+- `data-theme`: `light` | `dark`
+- `data-accent`: `rose` | `sky` | `coral` | `mint` | `violet` | `amber`
+- `data-density`: `compact` | `comfortable` | `spacious`
+
+覆写任意 CSS 变量即可局部定制：
+
+```css
+.my-scope {
+  --accent: oklch(72% 0.18 200);
+  --r-md: 12px;
+  --d: 0.8; /* 阴影强度乘数 */
+}
+```
+
+## 📚 文档
+
+- [组件清单](./docs/components.md)
+- [API 参考](./docs/api.md)
+- [设计令牌](./docs/tokens.md)
+- [Electron 集成](./docs/electron.md)
+
+## 📄 许可证
+
+MIT

package/dist/Accordion-GSBY5T5U.css

@@ -0,0 +1,38 @@
+/* ============ Accordion ============ */
+.accordion { display: flex; flex-direction: column; gap: 10px; }
+.accordion-item {
+  background: var(--bg);
+  border-radius: var(--r-md);
+  box-shadow: var(--neu-out-sm);
+  overflow: hidden;
+}
+.accordion-head {
+  width: 100%;
+  border: none;
+  background: transparent;
+  padding: 14px 18px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  cursor: pointer;
+  font-size: 13px;
+  font-weight: 500;
+  font-family: inherit;
+  color: var(--fg);
+  text-align: left;
+}
+.accordion-body {
+  max-height: 0;
+  overflow: hidden;
+  transition: max-height var(--dur) var(--ease);
+  color: var(--fg-muted);
+  font-size: 13px;
+}
+.accordion-item.open .accordion-body { max-height: 320px; }
+.accordion-body-inner { padding: 0 18px 16px; }
+.accordion-chev {
+  transition: transform var(--dur) var(--ease);
+  color: var(--fg-subtle);
+  display: inline-flex;
+}
+.accordion-item.open .accordion-chev { transform: rotate(180deg); color: var(--accent); }

package/dist/Accordion.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunk77NP67ML_cjs = require('./chunk-77NP67ML.cjs');
+require('./chunk-YVO7XO4W.cjs');
+
+
+
+Object.defineProperty(exports, "Accordion", {
+  enumerable: true,
+  get: function () { return chunk77NP67ML_cjs.Accordion; }
+});
+//# sourceMappingURL=Accordion.cjs.map
+//# sourceMappingURL=Accordion.cjs.map

package/dist/Accordion.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Accordion.cjs"}

package/dist/Accordion.d.cts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+interface AccordionItem {
+    key: string;
+    title: React.ReactNode;
+    content: React.ReactNode;
+    disabled?: boolean;
+}
+interface AccordionProps {
+    items: AccordionItem[];
+    /** If true, multiple sections can be open at once. */
+    multiple?: boolean;
+    activeKeys?: string[];
+    defaultActiveKeys?: string[];
+    onChange?: (keys: string[]) => void;
+    className?: string;
+}
+/** `Accordion` — collapsible sections. */
+declare const Accordion: React.FC<AccordionProps>;
+
+export { Accordion, type AccordionItem, type AccordionProps };

package/dist/Accordion.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+interface AccordionItem {
+    key: string;
+    title: React.ReactNode;
+    content: React.ReactNode;
+    disabled?: boolean;
+}
+interface AccordionProps {
+    items: AccordionItem[];
+    /** If true, multiple sections can be open at once. */
+    multiple?: boolean;
+    activeKeys?: string[];
+    defaultActiveKeys?: string[];
+    onChange?: (keys: string[]) => void;
+    className?: string;
+}
+/** `Accordion` — collapsible sections. */
+declare const Accordion: React.FC<AccordionProps>;
+
+export { Accordion, type AccordionItem, type AccordionProps };

package/dist/Accordion.js

@@ -0,0 +1,4 @@
+export { Accordion } from './chunk-M6OTFXZA.js';
+import './chunk-GEYMWUW6.js';
+//# sourceMappingURL=Accordion.js.map
+//# sourceMappingURL=Accordion.js.map

package/dist/Accordion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Accordion.js"}

package/dist/Alert-LSKBYDRI.css

@@ -0,0 +1,35 @@
+/* ============ Alert ============ */
+.alert {
+  display: flex;
+  gap: 12px;
+  align-items: flex-start;
+  padding: 14px 16px;
+  border-radius: var(--r-md);
+  background: var(--bg);
+  box-shadow: var(--neu-in-sm);
+  position: relative;
+}
+.alert-ico {
+  width: 20px; height: 20px;
+  display: grid; place-items: center;
+  flex-shrink: 0;
+  margin-top: 1px;
+}
+.alert.info    .alert-ico { color: var(--info); }
+.alert.success .alert-ico { color: var(--success); }
+.alert.warning .alert-ico { color: var(--warning); }
+.alert.danger  .alert-ico { color: var(--danger); }
+.alert-body  { flex: 1; min-width: 0; }
+.alert-title { font-size: 13px; font-weight: 600; margin-bottom: 3px; line-height: 1.4; }
+.alert-desc  { font-size: 12px; color: var(--fg-muted); line-height: 1.55; }
+.alert.no-title { align-items: center; }
+.alert.no-title .alert-ico { margin-top: 0; }
+.alert-close {
+  position: absolute; top: 10px; right: 10px;
+  width: 22px; height: 22px; border-radius: 7px;
+  display: grid; place-items: center;
+  color: var(--fg-subtle);
+  cursor: pointer;
+  border: none; background: transparent;
+}
+.alert-close:hover { color: var(--fg); background: var(--bg); box-shadow: var(--neu-flat); }

package/dist/Alert.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkJNFCTYJT_cjs = require('./chunk-JNFCTYJT.cjs');
+require('./chunk-YVO7XO4W.cjs');
+
+
+
+Object.defineProperty(exports, "Alert", {
+  enumerable: true,
+  get: function () { return chunkJNFCTYJT_cjs.Alert; }
+});
+//# sourceMappingURL=Alert.cjs.map
+//# sourceMappingURL=Alert.cjs.map

package/dist/Alert.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Alert.cjs"}

package/dist/Alert.d.cts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { IconName } from './Icon.cjs';
+
+type AlertTone = "info" | "success" | "warning" | "danger";
+interface AlertProps {
+    tone?: AlertTone;
+    title?: React.ReactNode;
+    children?: React.ReactNode;
+    icon?: IconName;
+    closable?: boolean;
+    onClose?: () => void;
+    className?: string;
+}
+/** `Alert` — inline contextual message. */
+declare const Alert: React.FC<AlertProps>;
+
+export { Alert, type AlertProps, type AlertTone };

package/dist/Alert.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { IconName } from './Icon.js';
+
+type AlertTone = "info" | "success" | "warning" | "danger";
+interface AlertProps {
+    tone?: AlertTone;
+    title?: React.ReactNode;
+    children?: React.ReactNode;
+    icon?: IconName;
+    closable?: boolean;
+    onClose?: () => void;
+    className?: string;
+}
+/** `Alert` — inline contextual message. */
+declare const Alert: React.FC<AlertProps>;
+
+export { Alert, type AlertProps, type AlertTone };

package/dist/Alert.js

@@ -0,0 +1,4 @@
+export { Alert } from './chunk-NWJW5KLN.js';
+import './chunk-GEYMWUW6.js';
+//# sourceMappingURL=Alert.js.map
+//# sourceMappingURL=Alert.js.map

package/dist/Alert.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Alert.js"}

package/dist/AppShell-RCALXUCZ.css

@@ -0,0 +1,162 @@
+/* ============ TitleBar (Electron) ============ */
+.titlebar {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-3);
+  padding: 0 var(--gap-3);
+  height: 40px;
+  background: var(--bg);
+  -webkit-app-region: drag;
+  user-select: none;
+  border-bottom: 1px solid var(--divider);
+  position: relative;
+  z-index: 5;
+  overflow: visible;
+}
+.titlebar.windows { padding-right: 0; }
+.titlebar-title {
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  font-weight: 500;
+  font-size: 13px;
+  flex-shrink: 0;
+  min-width: 0;
+}
+.titlebar-center {
+  position: absolute; left: 50%; transform: translateX(-50%);
+  display: inline-flex; align-items: center; gap: 8px;
+  -webkit-app-region: no-drag;
+}
+.titlebar-actions {
+  margin-left: auto;
+  display: inline-flex; align-items: center; gap: 6px;
+  -webkit-app-region: no-drag;
+  flex-shrink: 0;
+}
+
+/* macOS traffic lights */
+.win-controls { flex-shrink: 0; }
+.win-controls.mac { display: inline-flex; gap: 8px; -webkit-app-region: no-drag; }
+.win-controls.mac .win-btn {
+  width: 13px; height: 13px;
+  border: none; padding: 0;
+  border-radius: 999px;
+  background: var(--bg);
+  box-shadow: var(--neu-flat);
+  position: relative;
+  cursor: pointer;
+  transition: transform var(--dur-fast) var(--ease);
+}
+.win-controls.mac .win-btn::after {
+  content: "";
+  position: absolute; inset: 2px;
+  border-radius: 999px;
+  background: var(--dot, var(--fg-subtle));
+  opacity: 0.85;
+}
+.win-controls.mac .win-btn.close    { --dot: #ff5f57; }
+.win-controls.mac .win-btn.minimize { --dot: #febc2e; }
+.win-controls.mac .win-btn.maximize { --dot: #28c840; }
+.win-controls.mac .win-btn:hover { transform: scale(1.08); }
+
+/* Windows controls */
+.win-controls.windows {
+  display: inline-flex;
+  -webkit-app-region: no-drag;
+  margin-left: 8px;
+  flex-shrink: 0;
+}
+.win-controls.windows .win-btn {
+  width: 38px;
+  height: 28px;
+  border: 0;
+  padding: 0;
+  border-radius: 8px;
+  background: transparent;
+  color: var(--fg-muted);
+  display: inline-grid;
+  place-items: center;
+  cursor: pointer;
+  transition: all var(--dur-fast) var(--ease);
+  margin: 0 1px;
+  flex-shrink: 0;
+  overflow: visible;
+}
+.win-controls.windows .win-btn svg { display: block; flex-shrink: 0; }
+.win-controls.windows .win-btn:hover { background: var(--bg); box-shadow: var(--neu-in-sm); color: var(--fg); }
+.win-controls.windows .win-btn.close:hover {
+  background: var(--danger);
+  color: white;
+  box-shadow: 2px 2px 4px color-mix(in oklch, var(--danger) 30%, var(--shadow-dark));
+}
+
+/* ============ Sidebar ============ */
+.sidebar {
+  display: flex;
+  flex-direction: column;
+  width: 220px;
+  padding: 12px;
+  background: var(--bg);
+  border-right: 1px solid var(--divider);
+  flex-shrink: 0;
+  overflow-y: auto;
+  gap: 4px;
+}
+.sidebar.collapsed { width: 64px; }
+.sidebar-header { padding: 4px 8px 12px; border-bottom: 1px solid var(--divider); margin-bottom: 8px; }
+.sidebar-footer { margin-top: auto; padding-top: 12px; border-top: 1px solid var(--divider); }
+.sidebar-nav { display: flex; flex-direction: column; gap: 2px; }
+.sidebar-item {
+  display: flex; align-items: center; gap: 10px;
+  padding: 10px 12px;
+  border: none;
+  border-radius: var(--r-sm);
+  background: transparent;
+  color: var(--fg-muted);
+  font-size: 13px;
+  font-family: inherit;
+  text-align: left;
+  cursor: pointer;
+  width: 100%;
+  transition: all var(--dur-fast) var(--ease);
+}
+.sidebar-item:hover { color: var(--fg); background: var(--bg); box-shadow: var(--neu-flat); }
+.sidebar-item.active {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-in-sm);
+  font-weight: 500;
+}
+.sidebar-icon { display: inline-flex; flex-shrink: 0; }
+.sidebar-label { flex: 1; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.sidebar-badge {
+  font-size: 11px;
+  padding: 1px 7px;
+  border-radius: 999px;
+  background: var(--accent);
+  color: white;
+  font-weight: 600;
+}
+
+/* ============ AppShell ============ */
+.app-shell {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  height: 100vh;
+  background: var(--bg);
+  color: var(--fg);
+  overflow: hidden;
+  position: relative;
+}
+.app-shell-body {
+  flex: 1;
+  display: flex;
+  min-height: 0;
+}
+.app-shell-main {
+  flex: 1;
+  min-width: 0;
+  overflow: auto;
+}

package/dist/AppShell.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var chunkFI7QO3I5_cjs = require('./chunk-FI7QO3I5.cjs');
+
+
+
+Object.defineProperty(exports, "AppShell", {
+  enumerable: true,
+  get: function () { return chunkFI7QO3I5_cjs.AppShell; }
+});
+Object.defineProperty(exports, "Sidebar", {
+  enumerable: true,
+  get: function () { return chunkFI7QO3I5_cjs.Sidebar; }
+});
+Object.defineProperty(exports, "TitleBar", {
+  enumerable: true,
+  get: function () { return chunkFI7QO3I5_cjs.TitleBar; }
+});
+Object.defineProperty(exports, "WindowControls", {
+  enumerable: true,
+  get: function () { return chunkFI7QO3I5_cjs.WindowControls; }
+});
+//# sourceMappingURL=AppShell.cjs.map
+//# sourceMappingURL=AppShell.cjs.map

package/dist/AppShell.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AppShell.cjs"}

package/dist/AppShell.d.cts

@@ -0,0 +1,68 @@
+import * as React from 'react';
+
+interface WindowControlsProps {
+    /** macOS traffic lights or Windows-style buttons. */
+    platform?: "mac" | "windows";
+    onMinimize?: () => void;
+    onMaximize?: () => void;
+    onClose?: () => void;
+    className?: string;
+}
+/**
+ * `WindowControls` — standalone window control buttons.
+ * Mac: traffic lights (close/min/max). Windows: rectangular controls.
+ */
+declare const WindowControls: React.FC<WindowControlsProps>;
+interface TitleBarProps {
+    title?: React.ReactNode;
+    /** Platform appearance — affects button placement. Default "mac". */
+    platform?: "mac" | "windows";
+    onMinimize?: () => void;
+    onMaximize?: () => void;
+    onClose?: () => void;
+    /** Extra content in the center. */
+    center?: React.ReactNode;
+    /** Extra content on the trailing side. */
+    actions?: React.ReactNode;
+    /** Make the whole bar draggable (Electron `-webkit-app-region: drag`). */
+    draggable?: boolean;
+    className?: string;
+}
+/**
+ * `TitleBar` — Electron-style window chrome. Attach at the top of your app.
+ * Buttons are non-draggable regions so clicks register correctly.
+ */
+declare const TitleBar: React.FC<TitleBarProps>;
+interface SidebarItem {
+    key: string;
+    label: React.ReactNode;
+    icon?: React.ReactNode;
+    badge?: React.ReactNode;
+    children?: SidebarItem[];
+}
+interface SidebarProps {
+    items: SidebarItem[];
+    activeKey?: string;
+    onSelect?: (key: string) => void;
+    /** Collapsed: icons only. */
+    collapsed?: boolean;
+    /** Header slot (e.g. workspace switcher). */
+    header?: React.ReactNode;
+    /** Footer slot (e.g. user card). */
+    footer?: React.ReactNode;
+    className?: string;
+}
+/** `Sidebar` — navigation rail. Pair with `AppShell`. */
+declare const Sidebar: React.FC<SidebarProps>;
+interface AppShellProps {
+    sidebar?: React.ReactNode;
+    titleBar?: React.ReactNode;
+    children?: React.ReactNode;
+    className?: string;
+}
+/**
+ * `AppShell` — 3-zone Electron layout: title bar across top, sidebar on left, content fills rest.
+ */
+declare const AppShell: React.FC<AppShellProps>;
+
+export { AppShell, type AppShellProps, Sidebar, type SidebarItem, type SidebarProps, TitleBar, type TitleBarProps, WindowControls, type WindowControlsProps };

package/dist/AppShell.d.ts

@@ -0,0 +1,68 @@
+import * as React from 'react';
+
+interface WindowControlsProps {
+    /** macOS traffic lights or Windows-style buttons. */
+    platform?: "mac" | "windows";
+    onMinimize?: () => void;
+    onMaximize?: () => void;
+    onClose?: () => void;
+    className?: string;
+}
+/**
+ * `WindowControls` — standalone window control buttons.
+ * Mac: traffic lights (close/min/max). Windows: rectangular controls.
+ */
+declare const WindowControls: React.FC<WindowControlsProps>;
+interface TitleBarProps {
+    title?: React.ReactNode;
+    /** Platform appearance — affects button placement. Default "mac". */
+    platform?: "mac" | "windows";
+    onMinimize?: () => void;
+    onMaximize?: () => void;
+    onClose?: () => void;
+    /** Extra content in the center. */
+    center?: React.ReactNode;
+    /** Extra content on the trailing side. */
+    actions?: React.ReactNode;
+    /** Make the whole bar draggable (Electron `-webkit-app-region: drag`). */
+    draggable?: boolean;
+    className?: string;
+}
+/**
+ * `TitleBar` — Electron-style window chrome. Attach at the top of your app.
+ * Buttons are non-draggable regions so clicks register correctly.
+ */
+declare const TitleBar: React.FC<TitleBarProps>;
+interface SidebarItem {
+    key: string;
+    label: React.ReactNode;
+    icon?: React.ReactNode;
+    badge?: React.ReactNode;
+    children?: SidebarItem[];
+}
+interface SidebarProps {
+    items: SidebarItem[];
+    activeKey?: string;
+    onSelect?: (key: string) => void;
+    /** Collapsed: icons only. */
+    collapsed?: boolean;
+    /** Header slot (e.g. workspace switcher). */
+    header?: React.ReactNode;
+    /** Footer slot (e.g. user card). */
+    footer?: React.ReactNode;
+    className?: string;
+}
+/** `Sidebar` — navigation rail. Pair with `AppShell`. */
+declare const Sidebar: React.FC<SidebarProps>;
+interface AppShellProps {
+    sidebar?: React.ReactNode;
+    titleBar?: React.ReactNode;
+    children?: React.ReactNode;
+    className?: string;
+}
+/**
+ * `AppShell` — 3-zone Electron layout: title bar across top, sidebar on left, content fills rest.
+ */
+declare const AppShell: React.FC<AppShellProps>;
+
+export { AppShell, type AppShellProps, Sidebar, type SidebarItem, type SidebarProps, TitleBar, type TitleBarProps, WindowControls, type WindowControlsProps };

package/dist/AppShell.js

@@ -0,0 +1,3 @@
+export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-3WAFIUDQ.js';
+//# sourceMappingURL=AppShell.js.map
+//# sourceMappingURL=AppShell.js.map

package/dist/AppShell.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AppShell.js"}