@wil-works/evoke-ui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 willove
+
+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/README.md

@@ -0,0 +1,56 @@
+# @wil-works/evoke-ui
+
+Evoke UI — 纯 JS Vue3 **官网/纯前端站点**组件库，Clean Navy 设计语言（细字重展示排版 · 呼吸感 · 精致微交互），明暗双主题与运行时主题定制开箱即用。
+
+## 特性
+
+- **Clean Navy 设计语言**：藏青墨色 × 淡雾底 × Launch Blue，细字重展示标题与呼吸感排版，明暗双主题（`html.dark` 令牌重映射）
+- **运行时主题定制**：主色（淡色阶自动生成）/ 圆角 / 间距 / 容器宽四维配置，`EwConfigProvider` 或 `useThemeConfig` 即时生效
+- **签名组件**：`EwSearchBox` 大搜索栏 + `EwIconGrid` 可搜索图标网格（内置 900+ 图标，点击复制图标名）
+- **官网区块全家桶**：Hero / 导航页脚 / 定价对比 / FAQ / 文章与个人名片 / 音视频与留言表单，企业站与个人站要素齐备
+- **零运行时依赖**：仅 peer vue；图标为生成期静态快照，展示集独立 chunk 按需加载
+- **轻量动效**：spring 弹性微交互 + `v-reveal` 滚动浮现指令
+
+> 图标：核心集 39 个语义名内置；展示集 922 个原生名按需加载。组件 class 前缀 `ew-`、令牌前缀 `--ew-*` 为本库独立命名空间（构建期 `lint:tokens` 强制校验）。
+
+## 安装
+
+```bash
+pnpm add @wil-works/evoke-ui
+```
+
+```js
+import { createApp } from 'vue'
+import EvokeUI from '@wil-works/evoke-ui'
+import '@wil-works/evoke-ui/styles'
+
+const app = createApp(App)
+app.use(EvokeUI) // 全量注册 Ew* 组件 + v-reveal 指令 + 主题初始化
+```
+
+## 组件一览
+
+| 分类 | 组件 |
+| --- | --- |
+| 基础 | `EwIcon` `EwButton` `EwIconButton` `EwTag` `EwBadge` `EwKeycap` `EwTabs` `EwSwitch` `EwAvatar` `EwAvatarGroup` |
+| 表单 | `EwInput` `EwTextarea` `EwSelect` `EwField` |
+| 布局 | `EwSection` `EwCard` `EwHero` `EwNavbar` `EwFooter` `EwContainer` `EwConfigProvider` |
+| 区块 | `EwSearchBox` `EwIconGrid` `EwFeatureGrid` `EwPricingCard` `EwFaq` `EwQuote` `EwStatistic` `EwAlert` `EwTimeline` `EwComparisonTable` `EwCta` `EwNewsletter` `EwLogoCloud` `EwArticleCard` `EwProfileCard` |
+| 媒体与交互 | `EwVideo` `EwAudio` `EwCarousel` `EwContactForm` |
+| 反馈与主题 | `EwCodeBlock` `EwThemeToggle` |
+
+组合式 API：`useTheme`（明暗切换）/ `useCopy`（剪贴板）/ `useThemeConfig`（主题四维定制 + `applyPreset` 风格方案）；
+预设：`EW_STYLE_PRESETS`（企业官网/个人站/设计工作室等一键方案）与颜色/圆角/间距/容器四组单项预设；
+指令：`v-reveal`（滚动浮现，五种变体）；图标注册表：`registerIcons` / `getIconByName` / `loadShowcaseIcons`。
+
+## 脚本
+
+```bash
+pnpm build       # 令牌铁律检查 + vite lib 构建
+pnpm gen:icons   # 重新生成图标数据（核心集 + 展示集）
+pnpm lint:tokens # 单独跑 --ew-* 命名空间铁律检查
+```
+
+## License
+
+MIT（图标形状源自 Remix Icon，Remix Icon License v1.0，免费商用）