@wneng/create-keel 0.2.1 → 0.3.0

package/src/standards/templates/tech-stack-web.md.eta

@@ -0,0 +1,36 @@
+---
+runtime: <%= it.standards.env %>
+language: <%= it.standards.language %>
+packageManager: <%= it.standards.packageManager %>
+manifestPath: <%= it.standards.manifestPath %>
+lastReviewed: <%= it.standards.lastReviewed %>
+dependencies:
+<% for (const dep of it.standards.dependencies) { %>  - name: "<%= dep.name %>"
+    version: "<%= dep.version %>"
+    policy: <%= dep.policy %>
+<% } %>---
+
+# 前端 / Web 技术栈钉版本表
+
+> frontmatter 是机器真值；governance-lint 会把上面 `dependencies` 与 `<%= it.standards.manifestPath %>` 的实际版本逐条比对。
+
+## 为什么钉版本
+
+- **审计可追溯**：升级历史进 git，PR review 看得到
+- **可重现构建**：CI cache 一致；六个月后能装出同一棵 lockfile
+
+## policy 三档
+
+policy 字段的语义、调整流程、不钉的例外，与 [tech-stack-server.md](tech-stack-server.md) 一致。本文件不重复。
+
+## Web 特有的考虑
+
+- React / Vue 的 minor 升级常带 hooks API 改动；新增 `policy: minor` 表示"先发 warning，看到再合"
+- `typescript` 单独列为 minor：tsc 主版本变化几乎一定要改代码
+- bundler（Vite / Webpack）和 polyfill 工具链版本若进 production bundle，必须钉；纯 dev 工具不进本表
+
+## 关联
+
+- 编码规范：[coding-style-typescript.md](coding-style-typescript.md)
+- UI 设计系统：[../05-前端客户端详细设计/ui-design-system.md](../05-前端客户端详细设计/ui-design-system.md)（启用 design 角色或 full 档时存在）
+- 依赖安全：[../governance/security.md](../governance/security.md)

package/src/standards/templates/ui-design-system.md.eta

@@ -0,0 +1,70 @@
+# UI 设计系统
+
+> 这是 UI / 视觉真值的入口。设计稿仍在 Figma；本文件 + `web/src/design-tokens.ts` 是工程侧能消费的版本。
+>
+> governance-lint 的 `GOV.UI.TOKEN_DRIFT` 检查会比对本文件 token 表与 `design-tokens.ts` 的 export 名集合，发现差异即阻断。
+
+## Token 表
+
+下面三类 token 是 design-tokens.ts 的真值；改一项，必须同 PR 改 ts 文件中对应 export。
+
+### 颜色
+
+| name | 值 | 用途 |
+|------|-----|------|
+| `colorPrimary` | `#2563EB` | 主操作按钮、链接 |
+| `colorSurface` | `#FFFFFF` | 卡片 / 模态背景 |
+| `colorTextDefault` | `#0F172A` | 默认文本 |
+| `colorTextMuted` | `#64748B` | 次要 / 辅助文本 |
+| `colorBorder` | `#E2E8F0` | 分隔线 / 输入框边框 |
+| `colorDanger` | `#DC2626` | 错误状态、危险操作 |
+
+### 间距（spacing scale）
+
+按 4px 基线倍数；**禁止**使用任意像素值。
+
+| name | 值 | 用途 |
+|------|-----|------|
+| `space1` | `4px` | 紧凑（图标到文字） |
+| `space2` | `8px` | 表单字段内 |
+| `space3` | `12px` | 默认内边距 |
+| `space4` | `16px` | 卡片内边距 |
+| `space6` | `24px` | 卡片间距 |
+| `space8` | `32px` | 区块间距 |
+
+### 字号（typography）
+
+| name | 值 | 用途 |
+|------|-----|------|
+| `fontHeading1` | `32px / 1.25 / 600` | 页面 H1 |
+| `fontHeading2` | `24px / 1.3 / 600` | 区块标题 |
+| `fontBody` | `14px / 1.5 / 400` | 正文 |
+| `fontCaption` | `12px / 1.4 / 400` | 辅助说明 |
+
+## 组件命名
+
+组件库统一前缀，避免与第三方库冲突：
+
+- `KButton` —— 主按钮 / 次按钮 / 危险按钮三态由 prop 切换
+- `KModal` —— 模态对话框；标题 / 内容 / footer 三槽位
+- `KFormItem` —— 表单单项；label + 控件 + 错误提示
+
+新增组件命名遵循同前缀；超过组件库范围（业务组件）走 PascalCase 不加前缀。
+
+## 调整流程
+
+1. 设计在 Figma 改 token；导出 SVG / PNG 到 `docs/design/figma-exports/`
+2. 同 PR 改本文件 token 表 + `web/src/design-tokens.ts` 中对应 export
+3. CI 跑 `governance-lint`：本表 token 名集合必须等于 design-tokens.ts 的 export 集合
+4. 若故意要让两边不同（极少见），删除本文件，改用其他 token 真值（需要新 ADR）
+
+## 何时**不**用本系统
+
+- 第三方组件库自带的 token：直接用；不要 wrap 一层把它们重命名成 K 前缀
+- 一次性的展示页（活动 banner、营销页）：可以脱离本系统，但不要把脱离的 token 散播到通用组件中
+
+## 关联
+
+- 配色无障碍要求：所有 `colorText*` 与对应 `colorSurface*` 的对比度必须 ≥ 4.5:1（WCAG AA）
+- 设计稿源：`docs/design/figma-exports/`
+- 二进制 Figma 源文件：走 LFS（见 [`docs/governance/assets.md`](../governance/assets.md)）

package/src/templates/docs-skeleton/files/usage-quickstart.md

@@ -35,9 +35,20 @@ npx @wneng/create-keel create my-full \
   --agent rust-desktop --deploy kubernetes --contract rest+events \
   --ai kiro --license apache-2.0 --gitLfs --integrations \
   --ci github --roles qa,field,data,legal-security,marketing,design \
+  --engineering-standards full \
   --yes
 ```
 
+### 0.1.1 工程规范是另一个正交维度
+
+档位决定 *目录与角色* 的启用范围；`--engineering-standards <tier>` 决定 *栈版本钉死、编码风格、模块边界、UI 设计系统* 的生成范围：
+
+| `--engineering-standards` | 启用 | 默认 |
+|---|---|---|
+| `lite` | 仅每语言 `coding-style-<lang>.md` + 对应 lint 配置 | —— |
+| `standard` | + `tech-stack-<env>.md` + `module-boundaries.md` + （multi-app + JS/TS）`dependency-cruiser.config.cjs` | ✓ `--yes` 默认 |
+| `full` | + `ui-design-system.md` + `web/src/design-tokens.ts`（启用 frontend 时） | —— |
+
 **已有项目升档**：
 
 | 升档动作 | 操作 |