@robert-stackflow/oneui 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# @robert-stackflow/oneui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React 组件、应用外壳和两套可互换的主题。无 Electron、React Router、账户 API 或持久化存储依赖。
+
+## 使用
+
+```sh
+npm install @robert-stackflow/oneui
+```
+
+```tsx
+import { ThemeProvider, UIProvider, ToastProvider, Button } from '@robert-stackflow/oneui';
+import '@robert-stackflow/oneui/styles/themes.css';
+import '@robert-stackflow/oneui/styles/base.css';
+
+export function App() {
+  return (
+    <ThemeProvider theme="minimal" mode="system">
+      <UIProvider>
+        <ToastProvider>
+          <Button variant="primary">继续</Button>
+        </ToastProvider>
+      </UIProvider>
+    </ThemeProvider>
+  );
+}
+```
+
+`theme` 支持 `minimal`（极简）、`blue`（蓝白）；`mode` 支持 `light`、`dark`、`system`。也可以给 `ThemeProvider` 传入由 `appearanceDefaults()`、`normalizeAppearance()` 产生的完整 `appearance`，与 `AppearanceSettings` 共同使用。外观配置的保存与恢复由应用负责。
+
+`ThemeProvider` 管理当前文档的主题，应用根部放置一个即可。颜色模式、动效、字体、密度、圆角和自定义配色均由共享层应用。
+
+## 边界
+
+- `AppShell` 通过导航数据和 `onNavigate` 接入任何路由或状态机制。
+- `headerActions`、`sidebarFooter`、`windowControls` 为应用能力插槽；`draggable` 仅标记 header 的拖动区域。
+- `UIProvider` 配置 Toast 位置、Tooltip 位置和必填标记；组件不读取宿主设置。
+- 普通组件也支持子路径导入，例如 `@robert-stackflow/oneui/Input`。
+- CSS Modules 随组件分发，由消费项目的构建工具处理。图标/字符目录通过标准 `new URL(..., import.meta.url)` 加载随包资源。
+- React 和 React DOM 为 peer dependencies，不打入组件包。当前验证版本为 React 19.3.1，浏览器验证使用 Chromium。
+
+## 构建与打包
+
+在 General 根目录运行 `npm run pack:ui`。源码工作区供两端即时开发使用；发布内容单独生成到本目录 `dist`，含 ESM、TypeScript 声明、CSS 和资源。`dist/package.json` 只导出生成内容。
+
+发布内容已通过独立 Vite 消费项目验证。包的许可为 UNLICENSED；资源目录内保留图标许可文件。

package/assets/LUCIDE-LICENSE.txt

@@ -0,0 +1,43 @@
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+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, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/character-metadata.json

@@ -0,0 +1 @@
+{"groups": {"Smileys & Emotion": ["笑脸与情感", "Smileys & Emotion"], "People & Body": ["人物与身体", "People & Body"], "Animals & Nature": ["动物与自然", "Animals & Nature"], "Food & Drink": ["食物与饮品", "Food & Drink"], "Travel & Places": ["旅行与地点", "Travel & Places"], "Activities": ["活动", "Activities"], "Objects": ["物品", "Objects"], "Symbols": ["标志", "Symbols"], "Flags": ["旗帜", "Flags"], "Currency": ["货币", "Currency"], "Superscripts": ["上下标", "Superscripts"], "Punctuation": ["标点", "Punctuation"], "CJK punctuation": ["中日韩标点", "CJK punctuation"], "Enclosed numbers": ["带圈字符", "Enclosed numbers"], "Miscellaneous": ["杂项", "Miscellaneous"], "Arrows": ["箭头", "Arrows"], "Math": ["数学", "Math"], "Extra arrows": ["扩展箭头", "Extra arrows"], "Supplemental arrows": ["补充箭头", "Supplemental arrows"], "Supplemental math": ["补充数学", "Supplemental math"], "Technical": ["技术符号", "Technical"], "Box drawing": ["制表与方块", "Box drawing"], "Geometric": ["几何形状", "Geometric"], "Dingbats": ["装饰符号", "Dingbats"], "Braille": ["盲文", "Braille"], "Greek": ["希腊字母", "Greek"], "Roman numerals": ["罗马数字", "Roman numerals"], "Control": ["控制字符", "Control"], "Digits": ["数字", "Digits"], "Uppercase": ["大写字母", "Uppercase"], "Lowercase": ["小写字母", "Lowercase"], "Letters": ["字母", "Letters"], "Other": ["其他", "Other"], "Red": ["红色", "Red"], "Orange": ["橙色", "Orange"], "Yellow": ["黄色", "Yellow"], "Green": ["绿色", "Green"], "Cyan": ["青色", "Cyan"], "Blue": ["蓝色", "Blue"], "Purple": ["紫色", "Purple"], "Pink": ["粉色", "Pink"], "Neutral": ["黑白灰", "Neutral"], "开心": ["开心", "Happy"], "喜欢": ["喜欢", "Love"], "惊讶": ["惊讶", "Surprised"], "难过": ["难过", "Sad"], "生气": ["生气", "Angry"], "动作": ["动作", "Actions"], "动物": ["动物", "Animals"], "application": ["应用与文件", "Application"], "audio": ["音频", "Audio"], "image": ["图像", "Image"], "video": ["视频", "Video"], "text": ["文本", "Text"], "font": ["字体", "Fonts"], "message": ["消息", "Message"], "model": ["模型", "Models"], "multipart": ["多部分内容", "Multipart"], "chemical": ["化学", "Chemical"], "example": ["示例", "Example"], "haptics": ["触觉", "Haptics"]}, "aliases": {"😀": "开心 smile", "😃": "笑脸 happy", "😊": "微笑 blush", "😂": "笑哭 joy", "🥹": "感动 touched", "😍": "喜欢 love", "🥰": "爱慕 hearts", "😎": "酷 cool", "🤔": "思考 thinking", "😴": "睡觉 sleep", "😭": "哭泣 cry", "😡": "生气 angry", "🥳": "庆祝 party", "🤩": "惊喜 star", "🫡": "敬礼 salute", "🙃": "倒脸 upside down", "👍": "赞 thumbs up", "👎": "踩 thumbs down", "👏": "鼓掌 clap", "🙌": "欢呼 raised hands", "👋": "挥手 wave", "🤝": "握手 handshake", "🙏": "感谢 pray", "✌️": "胜利 victory", "👌": "好的 ok", "💪": "加油 strong", "🐱": "猫 cat", "🐶": "狗 dog", "🦊": "狐狸 fox", "🐼": "熊猫 panda", "🐸": "青蛙 frog", "🦋": "蝴蝶 butterfly", "🌸": "花 blossom", "🌲": "树 tree", "🌱": "幼苗 seedling", "☀️": "太阳 sun", "🌙": "月亮 moon", "🌈": "彩虹 rainbow", "💡": "灵感 bulb", "📁": "文件夹 folder", "📌": "图钉 pin", "🎨": "绘画 art", "📷": "相机 camera", "💻": "电脑 computer", "📚": "书 books", "📝": "笔记 memo", "🔑": "钥匙 key", "🎁": "礼物 gift", "⚙️": "设置 gear", "🛠️": "工具 tools", "❤️": "爱心 heart", "💛": "黄心 yellow heart", "💚": "绿心 green heart", "💙": "蓝心 blue heart", "✨": "闪光 sparkles", "⭐": "星星 star", "🔥": "火 fire", "✅": "完成 check", "❌": "错误 cross", "⚠️": "警告 warning", "💯": "满分 hundred", "🎉": "庆祝 confetti", "★": "实心星 star", "☆": "空心星 star outline", "●": "圆 circle", "○": "空心圆", "■": "方块 square", "□": "空心方块", "◆": "菱形 diamond", "◇": "空心菱形", "✓": "勾 check", "✕": "叉 cross", "•": "圆点 bullet", "…": "省略号 ellipsis", "§": "章节 section", "¶": "段落 paragraph", "←": "左 left", "→": "右 right", "↑": "上 up", "↓": "下 down", "↔": "左右 horizontal", "↕": "上下 vertical", "↗": "右上", "↘": "右下", "↖": "左上", "↙": "左下", "⇒": "推出 implies", "⇔": "等价 equivalent", "⤴": "向上转弯", "↩": "返回 return", "±": "正负 plus minus", "×": "乘 multiply", "÷": "除 divide", "≠": "不等 not equal", "≈": "约等 approximate", "≤": "小于等于", "≥": "大于等于", "∞": "无穷 infinity", "√": "平方根 root", "∑": "求和 sum", "∫": "积分 integral", "π": "圆周率 pi", "∈": "属于", "∅": "空集", "∩": "交集", "∪": "并集", "¥": "人民币 yen yuan", "$": "美元 dollar", "€": "欧元 euro", "£": "英镑 pound", "₩": "韩元 won", "₹": "卢比 rupee", "₽": "卢布 ruble", "₿": "比特币 bitcoin", "©": "版权 copyright", "®": "注册 registered", "™": "商标 trademark", "°": "度 degree", "℃": "摄氏", "℉": "华氏", "α": "阿尔法 alpha", "β": "贝塔 beta", "γ": "伽马 gamma", "δ": "德尔塔 delta", "λ": "拉姆达 lambda", "Ω": "欧米伽 omega"}}