@gyyxds/zy-ui 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -1,19 +1,23 @@
-# 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
+
+- `ZyMegaMenu` 面板里的二级菜单在没有 `desc`（描述行）时，图标与名称改为垂直居中，行高由 56.5 收到 36（图标 30 → 24、上内距 9 → 6）；有描述时排版不变。
+- `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,102 @@
-# 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`：组件。
+- 一段可复制的 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
+```
+
+`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 自定义属性的降级。