@moheng-design/ui-skill 2.0.0 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/bin/cli.js +0 -0
- package/bin/lib/upgrade.mjs +27 -6
- package/generated/SKILL.md +49 -36
- package/generated/contracts.json +1504 -620
- package/generated/plugin-data.js +113 -19
- package/generated/reference.md +570 -258
- package/generated/rules.json +93 -19
- package/generated/skills/moheng-ui-bootstrap/SKILL.md +1 -1
- package/generated/skills/moheng-ui-page/SKILL.md +7 -4
- package/generated/skills/moheng-ui-review/SKILL.md +1 -1
- package/generated/skills/moheng-ui-upgrade/SKILL.md +5 -3
- package/handwritten/anti-patterns.md +7 -5
- package/handwritten/canvas-model.md +18 -9
- package/handwritten/conventions.md +156 -82
- package/handwritten/skills/page.md +4 -1
- package/handwritten/skills/upgrade.md +5 -3
- package/package.json +11 -11
|
@@ -46,12 +46,15 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
46
46
|
`dataPresentation` → `ApplicationQueryToolbar` 与 `ApplicationDataDisplay` 的 `presentation`(prop 名与字段名不同)。
|
|
47
47
|
- 六种数据状态(Loading / Empty / Error / No Permission / Not Found / Partial Failure)
|
|
48
48
|
各给各的文案,不得共用一句。
|
|
49
|
-
-
|
|
49
|
+
- 页头的更新时间(`ApplicationPageHeader` 的 `updatedAt`)写完整日期时间 `YYYY-MM-DD HH:mm`(如 `2026-07-28 10:00`,
|
|
50
|
+
GAP Design kit「数据更新」,取代 07 · C-12 的 `HH:mm`),组件原样显示、不加前缀;
|
|
50
51
|
由服务端随数据返回的时间戳格式化而来,与数据同源;不得在客户端用 `useState(Date.now())` 一类写法自造一个时刻 —— 服务端渲染与客户端
|
|
51
52
|
水合各取一次当前时间,落在分钟边界两侧时文本不一致,且这个时刻与数据的实际更新时间无关。
|
|
52
53
|
- 查询参数(业务视图、搜索词、筛选、页码)与地址栏同步时,Next.js 下用 `useRouter()` 的
|
|
53
54
|
`router.replace`,不得直接调 `history.replaceState` —— 后者绕开 Next 的路由状态,浏览器后退
|
|
54
55
|
再回到本页时参数丢失。
|
|
56
|
+
- 有设计稿时,表格列宽照稿写进 `TableColumn.width`:稿上固定宽的列写数字(px),稿上均分剩余宽度的弹性列不写 `width`;
|
|
57
|
+
不得全部留空交给浏览器按内容分配 —— 那样每次数据不同列宽都不同,且与稿对不上。横向放不下时末列「操作」写 `fixed: 'right'`。
|
|
55
58
|
- Mock 数据只用登记过的占位符(`示例应用` / `模块 A` / `Tab 1`)。
|
|
56
59
|
- 骨架内不出现原生 `<button>` / `<input>` / `<table>`,替换表里有的一律用组件。
|
|
57
60
|
|
|
@@ -20,10 +20,12 @@ npx @moheng-design/ui-skill upgrade --from <旧版 contracts.json 的路径>
|
|
|
20
20
|
|
|
21
21
|
旧版 `contracts.json` 在升级前的 `node_modules/@moheng-design/ui-skill/generated/` 里,
|
|
22
22
|
升级前先拷一份出来。命令比对新旧两份,产出 `moheng-upgrade.md`:
|
|
23
|
-
组件的增删、prop
|
|
23
|
+
组件的增删、prop 的增删与必填变化、枚举值的增删、类型的收窄与变化、新标为弃用的 prop。
|
|
24
24
|
|
|
25
|
-
3.
|
|
26
|
-
|
|
25
|
+
3. 按报告改代码,从破坏性的几节改起(报告按此排序,「新增」两节排在最后)。删掉的 prop
|
|
26
|
+
与枚举值、收窄为固定取值的 prop 对应的是 `props-whitelist` / `prop-enum` 会报的那些
|
|
27
|
+
位置,先跑一遍 lint 再动手。「类型变化」一节 tsc 未必报(放宽的类型照样编译通过),
|
|
28
|
+
逐条核对引用处是否该改用新写法;「标为弃用」一节本次可不改,下一次升级前必须迁走。
|
|
27
29
|
4. 重跑安装命令,让项目里的 SKILL.md 跟上:
|
|
28
30
|
|
|
29
31
|
```bash
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@moheng-design/ui-skill",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
4
|
"description": "@moheng-design/ui 的 AI agent 支持包 —— SKILL.md 引导 + ESLint / stylelint 强制规则",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent",
|
|
@@ -37,13 +37,6 @@
|
|
|
37
37
|
"handwritten",
|
|
38
38
|
"README.md"
|
|
39
39
|
],
|
|
40
|
-
"scripts": {
|
|
41
|
-
"generate": "node scripts/generate.mjs",
|
|
42
|
-
"check:generate": "node scripts/generate.mjs --check",
|
|
43
|
-
"extract": "node scripts/extract-contracts.mjs",
|
|
44
|
-
"build": "node scripts/generate.mjs",
|
|
45
|
-
"test": "node test/generate.negative.mjs && node test/eslint-rules.test.mjs && node test/stylelint-rules.test.mjs && node test/commands.test.mjs"
|
|
46
|
-
},
|
|
47
40
|
"peerDependencies": {
|
|
48
41
|
"eslint": "^9.0.0",
|
|
49
42
|
"stylelint": "^16.0.0"
|
|
@@ -57,10 +50,17 @@
|
|
|
57
50
|
}
|
|
58
51
|
},
|
|
59
52
|
"devDependencies": {
|
|
60
|
-
"@moheng-design/ui": "workspace:*",
|
|
61
53
|
"@types/react": "^19.2.2",
|
|
62
54
|
"eslint": "^9.39.0",
|
|
63
55
|
"stylelint": "^16.26.0",
|
|
64
|
-
"typescript": "^5.9.3"
|
|
56
|
+
"typescript": "^5.9.3",
|
|
57
|
+
"@moheng-design/ui": "3.0.0"
|
|
58
|
+
},
|
|
59
|
+
"scripts": {
|
|
60
|
+
"generate": "node scripts/generate.mjs",
|
|
61
|
+
"check:generate": "node scripts/generate.mjs --check",
|
|
62
|
+
"extract": "node scripts/extract-contracts.mjs",
|
|
63
|
+
"build": "node scripts/generate.mjs",
|
|
64
|
+
"test": "node test/generate.negative.mjs && node test/eslint-rules.test.mjs && node test/stylelint-rules.test.mjs && node test/commands.test.mjs"
|
|
65
65
|
}
|
|
66
|
-
}
|
|
66
|
+
}
|