@gyyxds/zy-ui 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -1,19 +1,34 @@
-# Changelog
-
-## Unreleased
-
-- `ZyInput` / `ZySelect` 的 `raised`（键帽凸起形态）补上组件页舞台：实色主题下多一节「键帽凸起」，输入框与选择器各两颗（可输入 / 可清空、单选 / 可搜索），文案与代码片段齐全；图纸主题不出现（`raised` 在 A 里是空操作）。样式与展示板 `is-raised` 逐值一致（白键面 + `0 4px 0` 底座 + 落地影 + 两侧白弧），深色档同形不同光。
-- 修复键帽主题（`solid`）复选框**未勾选**时方框看不见：原先只把描边设为透明、再补一道白色顶光，白色键面落在白卡片上就整颗消失。现在未选态是**空槽**（`--zy-slot-face` 槽底 + `--zy-slot-shadow-sm` 内阴影 + `--zy-slot-line` 描边），与单选框、输入框同一个坑；深色档同样成立。`checkmark` / `tick` 两个变体不受影响。展示板复选框补了「未选」样本。
-- **新增 `ZyMegaMenu`（导航 + 大面板）**：`items` 数据驱动，面板支持 `grid` / `list` / `groups` 三种布局，也可用 `#panel-<key>` 整块接管；`v-model:open` 受控开合；键盘可达（↓ 进面板、Escape 关闭并把焦点还给触发器）；`#brand` / `#actions` 插槽。没有对应的 Element 组件，属自研件。组件数 27 → 28。
-- 深色色板换成方案稿那一套：`tokens/dark.css` 收成**两套材质共用的深色板**（品牌字 `#5aa6e4` / 键面 `#2876af`、储能、危险、警示、信息、焦点环、Element `--el-color-*` 桥接），`theme/basic.css` 增 §0.1「图纸 · 夜」（中性石墨纸 `#0f1014` / 纸片 `#1b1d23`、发丝线与控件线分档、表格栏头、实心按钮深档渐变），`theme/solid.css` 只留键帽的材质值。深色下 A 的实心按钮白字 2.78 → 4.88、角标 2.65 → 5.19、实心标签 2.0–2.7 → 4.86–5.19。
-- `ZyButton` 的 `effect="fill"`（实色键帽 / 悬停扩散）改为**只在键帽主题成立**：图纸主题下不渲染键帽层，`effect="fill"` 自动按 `press` 渲染；标题栏 / 舞台 / 参数表同步标注「仅键帽主题」，组件页在图纸主题下不再出现「实色按钮」舞台。
-- 移除 `ZyButton` 的 `effect="outline"`（描边展开）与 `hoverLabel` prop：悬停即把文案换成「已展开 / 已删除」，在点击发生前就宣告结果，对危险操作是错误的状态承诺；描边语义已由 `plain` / `dashed` 承担，按压与图标动效由 `press` / `sweep` 承担。`effect` 现为 `'press' | 'sweep' | 'fill'`。
-- 同步移除组件页「描边按钮」舞台、`button:outline` 片段、`solid` 主题里的 `.is-outline` 选择器与相关文档说明。
-
-## 0.1.0
-
-- 建立 Element Plus 二次封装组件库基础。
-- 新增 `basic` / `solid` 两套主题入口与 `data-zy-theme` 主题契约。
-- 新增 `ZyPagination`、`ZyPanel`、`ZyDatePicker`、`ZyTimePicker`。
-- 新增实验性 `ZySlideVerify`。
-- 增加发布产物、真实消费方、主题运行时和视觉回归检查。
+# Changelog
+
+## Unreleased
+
+- **站点瘦身：回归组件库与组件文档本身**。移除动效页（`/animations`）、效果详情页、收藏页与 `src/effects/**` 片段体系，连同 `mocks/families.ts` / `mocks/catalog.ts` / favorites store / `PreviewHost` / `GlassCard` / `GlassButton` / `FilterChip` 一并删除；旧地址与未知路由统一回落首页。组件库公共 API 不变。
+- **首页改为展示设计方案**：`/` 现在按「两根轴 → 四种组合 → 两套色板 → 设计原则 → 判据 → 落地清单」展示 `docs/theme` 的方案；四种组合可点击切换整站材质与光照。色板与文案的单一事实源迁到 `src/mocks/theme-design.ts`，四张展示板读同一份数据。
+- 校验脚本收敛：`check:registry` 只校验组件注册表 ↔ 实现文件、`COMPONENT_TOTAL` 与 `--zy-*` 令牌完整性；移除 `check:snippets` 与 `sync:scoped`（片段体系已下线），CI 同步。
+- **首页改用四张背景图**：`basic` / `solid` × 浅色 / 深色各一张 `1920 × 1200` PNG（`src/assets/backgrounds/`），按主题切换铺满视口，代替原来的页面渐变；左上阅读区保持近纯色，图纸的弧线 / 网格与键帽的挤出体只压在页边，生成脚本为 `scripts/gen_home_backgrounds.py`。
+- 修复 `ZyMegaMenu` 在实色主题下一级选中与悬停不一致的问题：悬停、选中、展开统一为同一枚凸起的品牌键（不使用内凹槽，也不再为展开单独按下），开合只由箭头方向表示；图纸主题原本就是浅底常亮，行为不变。
+- **顶栏导航改为胶囊滑行**：四个栏目不再铺轨道，选中胶囊直接浮在顶栏上，复用 `ZyRadioGroup` 分段按钮组的 400ms 回弹曲线与 320ms 品牌光晕；顶栏移到路由外，切栏目时不再重建，胶囊从上一格滑过去，同栏目内换组件页不闪。深色胶囊 / 字色另调，当前栏目补 `aria-current="page"`。
+- **站点品牌文案统一为「智云UI」**：顶栏、页面标题、页脚、关于页、MegaMenu 示例与主题展示板里的 MotionVault 字样全部替换。主题存储键（`motionvault-theme` / `motionvault-zy-theme`）与仓库路径保持不变，避免已有访客的主题选择丢失。
+- **主题页改为当前实现的真实演示**：`/theme` 用材质 / 光照两根轴的开关、9 颗真实 `ZyButton`（press / sweep / fill）、4 个材质验收样本（`raised`、`fill`、`hover-fill`）和品牌色 / 圆角令牌覆盖，替换原先手写按钮与站点变量样板；覆盖片段含深浅两档与悬停 / 按下派生令牌，可一键复制。
+- 修正 README / AGENTS 的深色换肤示例：`html.dark` 的权重低于 `dark.css` 的 `html.dark[data-zy-theme]`，示例改用 `html.dark[data-zy-theme]` 并注明加载顺序。
+- 文档更新：README / AGENTS / CONTRIBUTING / `docs/theme/README.md` / `dark-mode-design.md` 按新范围重写；删除已过时的 `docs/SPEC.md`。
+- `ZyMegaMenu` 面板里的二级菜单在没有 `desc`（描述行）时，图标与名称改为垂直居中，行高由 56.5 收到 36（图标 30 → 24、上内距 9 → 6）；有描述时排版不变。
+- `ZyMegaMenu` 新增选中态 `active`（一级项 key）/ `activeLink`（二级链接标题）：选中项沿用悬停那套底色常亮，一级和二级都不再随指针离开或面板收起消失；不传这两个 prop 时点击链接自动记下，并回传 `update:active` / `update:activeLink`。
+- `ZyTag` 的 `effect="fill"` 与 `ZyButton` 对齐：图纸主题里没有实色键帽这一档，切到图纸时自动退回 Element 的浅底标签；组件页的「实色标签」舞台同样只在键帽主题下出现。
+- 修复 `ZyTag` 在 `effect="fill"` + `closable` 时关闭图标与实色面同色、默认看不见的问题：关闭图标改跟标签字色（`--el-tag-text-color`），悬停不再被 Element 强制成「白图标 + type 色圆底」，改为压暗到挤出底座色，键盘焦点环也跟着字色走。
+- 发布流程补前置体检：`npm run release` 现在先跑 `scripts/check-release-env.mjs`，检查 registry、账号登录、该版本是否已发布、有无待发 changeset；不通过直接退出并给出补法（原来要先跑完 40 秒构建，再在 `changeset publish` 上撞 `ENEEDAUTH`）。同时把 `.changeset/config.json` 的 `access` 从 `restricted` 改回 `public`，与 `package.json` 的 `publishConfig` 对齐。
+- `ZyInput` / `ZySelect` 的 `raised`（键帽凸起形态）补上组件页舞台：实色主题下多一节「键帽凸起」，输入框与选择器各两颗（可输入 / 可清空、单选 / 可搜索），文案与代码片段齐全；图纸主题不出现（`raised` 在 A 里是空操作）。样式与展示板 `is-raised` 逐值一致（白键面 + `0 4px 0` 底座 + 落地影 + 两侧白弧），深色档同形不同光。
+- 修复键帽主题（`solid`）复选框**未勾选**时方框看不见：原先只把描边设为透明、再补一道白色顶光，白色键面落在白卡片上就整颗消失。现在未选态是**空槽**（`--zy-slot-face` 槽底 + `--zy-slot-shadow-sm` 内阴影 + `--zy-slot-line` 描边），与单选框、输入框同一个坑；深色档同样成立。`checkmark` / `tick` 两个变体不受影响。展示板复选框补了「未选」样本。
+- **新增 `ZyMegaMenu`（导航 + 大面板）**：`items` 数据驱动，面板支持 `grid` / `list` / `groups` 三种布局，也可用 `#panel-<key>` 整块接管；`v-model:open` 受控开合；键盘可达（↓ 进面板、Escape 关闭并把焦点还给触发器）；`#brand` / `#actions` 插槽。没有对应的 Element 组件，属自研件。组件数 27 → 28。
+- 深色色板换成方案稿那一套：`tokens/dark.css` 收成**两套材质共用的深色板**（品牌字 `#5aa6e4` / 键面 `#2876af`、储能、危险、警示、信息、焦点环、Element `--el-color-*` 桥接），`theme/basic.css` 增 §0.1「图纸 · 夜」（中性石墨纸 `#0f1014` / 纸片 `#1b1d23`、发丝线与控件线分档、表格栏头、实心按钮深档渐变），`theme/solid.css` 只留键帽的材质值。深色下 A 的实心按钮白字 2.78 → 4.88、角标 2.65 → 5.19、实心标签 2.0–2.7 → 4.86–5.19。
+- `ZyButton` 的 `effect="fill"`（实色键帽 / 悬停扩散）改为**只在键帽主题成立**：图纸主题下不渲染键帽层，`effect="fill"` 自动按 `press` 渲染；标题栏 / 舞台 / 参数表同步标注「仅键帽主题」，组件页在图纸主题下不再出现「实色按钮」舞台。
+- 移除 `ZyButton` 的 `effect="outline"`（描边展开）与 `hoverLabel` prop：悬停即把文案换成「已展开 / 已删除」，在点击发生前就宣告结果，对危险操作是错误的状态承诺；描边语义已由 `plain` / `dashed` 承担，按压与图标动效由 `press` / `sweep` 承担。`effect` 现为 `'press' | 'sweep' | 'fill'`。
+- 同步移除组件页「描边按钮」舞台、`button:outline` 片段、`solid` 主题里的 `.is-outline` 选择器与相关文档说明。
+
+## 0.1.0
+
+- 建立 Element Plus 二次封装组件库基础。
+- 新增 `basic` / `solid` 两套主题入口与 `data-zy-theme` 主题契约。
+- 新增 `ZyPagination`、`ZyPanel`、`ZyDatePicker`、`ZyTimePicker`。
+- 新增实验性 `ZySlideVerify`。
+- 增加发布产物、真实消费方、主题运行时和视觉回归检查。

package/CONTRIBUTING.md

@@ -1,99 +1,109 @@
-# Zy UI 贡献规范
-
-## 先判断产物类型
-
-- 有 props / events / slots，供业务项目 `import`：组件。
-- 一段可复制的 HTML / CSS（可选原生 JS）：动效片段。
-- 两者不能互相冒充。新增内容前先确认归属。
-
-组件库改造规范见 [docs/ui-library-refactor-spec.md](docs/ui-library-refactor-spec.md)。
-
-## 本地开发
-
-```bash
-npm ci
-npm run dev
-```
-
-文档站默认运行在 Vite 输出地址。组件实现放在 `src/zy/<name>/`，每个组件目录必须有：
-
-- `Zy<Name>.vue`
-- `index.ts`
-- 需要样式资产时放在同目录
-
-## 新增或修改组件
-
-提交前至少完成：
-
-1. 组件实现与入口。
-2. `src/zy/index.ts` 导出与全局注册。
-3. `src/mocks/element-demos.ts` 演示。
-4. `src/mocks/element-components.ts` API 文档。
-5. 两套主题下的状态检查。
-6. 键盘、禁用、加载、错误、弹层等适用状态。
-7. 视觉基线更新并经过人工审核。
-8. README / 规范中的组件数量和说明同步。
-
-## 主题约束
-
-- 主题属性：`html[data-zy-theme="basic|solid"]`。
-- 明暗属性：`html[data-zy-color-scheme="light|dark"]`。
-- 组件优先消费 `--zy-*` 语义令牌。
-- 主题层不得引用展示板专用类名或站点专属变量。
-- 不得依赖组件内部 `.el-*` 子结构作为公共 API。
-- 深色当前统一回退 `basic`，不要在深色中单独叠加 `solid` 材质。
-
-## 提交前验证
-
-```bash
-npm run check:registry
-npm run check:snippets
-npm run lint
-npm run test
-npm run build
-npm run build:lib
-npm run check:consumer
-```
-
-主题运行时与视觉回归需要先启动站点：
-
-```bash
-npm run preview -- --port 4173
-npm run check:theme-runtime
-npm run check:visual
-```
-
-只有确认视觉变化符合设计后，才允许执行：
-
-```bash
-npm run check:visual:update
-```
-
-## 版本与发布
-
-- 使用 Changesets 描述变更。
-- patch：样式或类型修复。
-- minor：向后兼容的新组件 / 新能力。
-- major：删除或改变公共 API、主题默认值、组件 DOM 契约。
-- `prepublishOnly` 会重新构建并校验发布产物。
-
-```bash
-npm run changeset
-npm run version
-npm run release
-```
-
-发布前必须确认：
-
-- 包 scope 与私有 registry 已配置。
-- 当前账号不是唯一发布人。
-- CHANGELOG 和迁移说明完整。
-- `npm pack` 产物可由非作者安装。
-
-## 组件 RFC
-
-大型组件或破坏性改动先提交 RFC。模板位于 `.gitlab/issue_templates/component-rfc.md`。
-
-## 浏览器支持
-
-见 [docs/browser-support.md](docs/browser-support.md)。如业务需要旧 WebView，必须先评估 `color-mix()`、`:has()` 与 CSS 自定义属性的降级。
+# Zy UI 贡献规范
+
+## 先判断产物类型
+
+- 有 props / events / slots，供业务项目 `import`：组件（`src/zy/`）。
+- 组件的用法与设计依据：文档页（`src/views/`、`src/mocks/`）与设计规范（`docs/theme/`）。
+- 动效片段体系已于 2026-10 下线；组件内的 `effect` 微动效属于组件 API，不单独建产物。
+
+组件库改造规范见 [docs/ui-library-refactor-spec.md](docs/ui-library-refactor-spec.md)，主题设计见 [docs/theme/README.md](docs/theme/README.md)。
+
+## 本地开发
+
+```bash
+npm ci
+npm run dev
+```
+
+文档站默认运行在 Vite 输出地址。组件实现放在 `src/zy/<name>/`，每个组件目录必须有：
+
+- `Zy<Name>.vue`
+- `index.ts`
+- 需要样式资产时放在同目录
+
+## 新增或修改组件
+
+提交前至少完成：
+
+1. 组件实现与入口。
+2. `src/zy/index.ts` 导出与全局注册。
+3. `src/mocks/element-demos.ts` 演示。
+4. `src/mocks/element-components.ts` API 文档。
+5. 两套主题下的状态检查。
+6. 键盘、禁用、加载、错误、弹层等适用状态。
+7. 视觉基线更新并经过人工审核。
+8. README / 规范中的组件数量和说明同步。
+
+## 新增或修改设计 / 首页
+
+1. 主题名、立场、两档色板、材质解剖、原则与判据改 `src/mocks/theme-design.ts` —— 首页 `/` 与四张展示板共用这一份，不要在两处各写一份。
+2. 令牌改 `src/zy/styles/tokens/`，材质改 `src/zy/styles/themes/`；主题层只消费 `--zy-*`。
+3. 同步 `docs/theme/README.md`（推导与数值）并跑 `node docs/theme/tools/contrast.mjs`。
+4. 首页结构改 `src/views/HomeView.vue`，保持「两根轴 → 四种组合 → 两套色板 → 原则 → 判据／落地」的信息顺序。
+5. 视觉有变化时先人工确认，再 `npm run check:visual:update`。
+
+## 主题约束
+
+- 主题属性：`html[data-zy-theme="basic|solid"]`。
+- 明暗属性：`html[data-zy-color-scheme="light|dark"]`。
+- 组件优先消费 `--zy-*` 语义令牌。
+- 主题层不得引用展示板专用类名或站点专属变量。
+- 不得依赖组件内部 `.el-*` 子结构作为公共 API。
+- 深浅色在当前材质内切换（`solid` 深色 = 「键帽 · 夜」），不要回退到另一套材质，也不要在深色中叠加 `solid` 材质。
+
+## 提交前验证
+
+```bash
+npm run check:registry
+npm run lint
+npm run test
+npm run build
+npm run build:lib
+npm run check:consumer
+```
+
+主题运行时与视觉回归需要先启动站点：
+
+```bash
+npm run preview -- --port 4173
+npm run check:theme-runtime
+npm run check:visual
+```
+
+只有确认视觉变化符合设计后，才允许执行：
+
+```bash
+npm run check:visual:update
+```
+
+## 版本与发布
+
+- 使用 Changesets 描述变更。
+- patch：样式或类型修复。
+- minor：向后兼容的新组件 / 新能力。
+- major：删除或改变公共 API、主题默认值、组件 DOM 契约。
+- `prepublishOnly` 会重新构建并校验发布产物。
+
+```bash
+npm run changeset
+npm run version
+npm run release
+```
+
+`npm run release` 先跑 `node scripts/check-release-env.mjs`（registry / 登录 / 版本是否已发 / 有无待发 changeset），体检不过直接退，不会再白跑一遍构建。
+
+
+发布前必须确认：
+
+- 包 scope 与私有 registry 已配置。
+- 当前账号不是唯一发布人。
+- CHANGELOG 和迁移说明完整。
+- `npm pack` 产物可由非作者安装。
+
+## 组件 RFC
+
+大型组件或破坏性改动先提交 RFC。模板位于 `.gitlab/issue_templates/component-rfc.md`。
+
+## 浏览器支持
+
+见 [docs/browser-support.md](docs/browser-support.md)。如业务需要旧 WebView，必须先评估 `color-mix()`、`:has()` 与 CSS 自定义属性的降级。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 @gyyxds/zy-ui contributors
+
+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.