@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
package/generated/rules.json
CHANGED
|
@@ -663,6 +663,8 @@
|
|
|
663
663
|
"chevron-left",
|
|
664
664
|
"chevron-right",
|
|
665
665
|
"chevron-up",
|
|
666
|
+
"chevrons-left",
|
|
667
|
+
"chevrons-right",
|
|
666
668
|
"circle-alert",
|
|
667
669
|
"circle-check",
|
|
668
670
|
"circle-check-big",
|
|
@@ -688,7 +690,7 @@
|
|
|
688
690
|
"upload",
|
|
689
691
|
"x"
|
|
690
692
|
],
|
|
691
|
-
"message": "<Icon> 的 name 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
693
|
+
"message": "<Icon> 的 name 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevrons-left' | 'chevrons-right' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
692
694
|
"rationale": "取值与顺序取自契约 contracts/foundation/icon/icon.ts,不得在别处另立一份。"
|
|
693
695
|
},
|
|
694
696
|
{
|
|
@@ -759,9 +761,10 @@
|
|
|
759
761
|
"outline",
|
|
760
762
|
"ghost",
|
|
761
763
|
"destructive",
|
|
764
|
+
"destructive-outline",
|
|
762
765
|
"link"
|
|
763
766
|
],
|
|
764
|
-
"message": "<Button> 的 variant 取值须为 'primary' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'link' 之一",
|
|
767
|
+
"message": "<Button> 的 variant 取值须为 'primary' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'destructive-outline' | 'link' 之一",
|
|
765
768
|
"rationale": "取值与顺序取自契约 contracts/foundation/actions/button.ts,不得在别处另立一份。"
|
|
766
769
|
},
|
|
767
770
|
{
|
|
@@ -1032,6 +1035,35 @@
|
|
|
1032
1035
|
"message": "<Combobox> 不接受该 prop。已声明的 props:options、value、defaultValue、onValueChange、placeholder、emptyText、disabled、invalid。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
1033
1036
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/foundation/input-selection/combobox.ts"
|
|
1034
1037
|
},
|
|
1038
|
+
{
|
|
1039
|
+
"id": "props-whitelist-date-input",
|
|
1040
|
+
"kind": "props-whitelist",
|
|
1041
|
+
"generated": true,
|
|
1042
|
+
"scope": "both",
|
|
1043
|
+
"severity": "warn",
|
|
1044
|
+
"targets": [
|
|
1045
|
+
"js"
|
|
1046
|
+
],
|
|
1047
|
+
"match": {
|
|
1048
|
+
"component": "DateInput"
|
|
1049
|
+
},
|
|
1050
|
+
"allowed": [
|
|
1051
|
+
"value",
|
|
1052
|
+
"defaultValue",
|
|
1053
|
+
"onValueChange",
|
|
1054
|
+
"placeholder",
|
|
1055
|
+
"disabled",
|
|
1056
|
+
"invalid",
|
|
1057
|
+
"today",
|
|
1058
|
+
"key",
|
|
1059
|
+
"ref",
|
|
1060
|
+
"className",
|
|
1061
|
+
"style",
|
|
1062
|
+
"children"
|
|
1063
|
+
],
|
|
1064
|
+
"message": "<DateInput> 不接受该 prop。已声明的 props:value、defaultValue、onValueChange、placeholder、disabled、invalid、today。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
1065
|
+
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/foundation/input-selection/date-input.ts"
|
|
1066
|
+
},
|
|
1035
1067
|
{
|
|
1036
1068
|
"id": "props-whitelist-field",
|
|
1037
1069
|
"kind": "props-whitelist",
|
|
@@ -2245,13 +2277,14 @@
|
|
|
2245
2277
|
"onSortChange",
|
|
2246
2278
|
"empty",
|
|
2247
2279
|
"density",
|
|
2280
|
+
"trailingRow",
|
|
2248
2281
|
"key",
|
|
2249
2282
|
"ref",
|
|
2250
2283
|
"className",
|
|
2251
2284
|
"style",
|
|
2252
2285
|
"children"
|
|
2253
2286
|
],
|
|
2254
|
-
"message": "<Table> 不接受该 prop。已声明的 props:columns、rows、rowKey、selectable、selected、onSelectedChange、onRowClick、sort、onSortChange、empty、density。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2287
|
+
"message": "<Table> 不接受该 prop。已声明的 props:columns、rows、rowKey、selectable、selected、onSelectedChange、onRowClick、sort、onSortChange、empty、density、trailingRow。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2255
2288
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/foundation/data-content-layout/table.ts"
|
|
2256
2289
|
},
|
|
2257
2290
|
{
|
|
@@ -2395,6 +2428,7 @@
|
|
|
2395
2428
|
"description",
|
|
2396
2429
|
"size",
|
|
2397
2430
|
"footer",
|
|
2431
|
+
"footerNote",
|
|
2398
2432
|
"onClose",
|
|
2399
2433
|
"initialFocus",
|
|
2400
2434
|
"children",
|
|
@@ -2403,7 +2437,7 @@
|
|
|
2403
2437
|
"className",
|
|
2404
2438
|
"style"
|
|
2405
2439
|
],
|
|
2406
|
-
"message": "<Dialog> 不接受该 prop。已声明的 props:open、title、description、size、footer、onClose、initialFocus、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2440
|
+
"message": "<Dialog> 不接受该 prop。已声明的 props:open、title、description、size、footer、footerNote、onClose、initialFocus、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2407
2441
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/foundation/feedback-overlay/dialog.ts"
|
|
2408
2442
|
},
|
|
2409
2443
|
{
|
|
@@ -2787,6 +2821,34 @@
|
|
|
2787
2821
|
"message": "<Tooltip> 的 side 取值须为 'top' | 'bottom' | 'left' | 'right' 之一",
|
|
2788
2822
|
"rationale": "取值与顺序取自契约 contracts/foundation/feedback-overlay/tooltip.ts,不得在别处另立一份。"
|
|
2789
2823
|
},
|
|
2824
|
+
{
|
|
2825
|
+
"id": "props-whitelist-application-date-range-filter",
|
|
2826
|
+
"kind": "props-whitelist",
|
|
2827
|
+
"generated": true,
|
|
2828
|
+
"scope": "both",
|
|
2829
|
+
"severity": "warn",
|
|
2830
|
+
"targets": [
|
|
2831
|
+
"js"
|
|
2832
|
+
],
|
|
2833
|
+
"match": {
|
|
2834
|
+
"component": "ApplicationDateRangeFilter"
|
|
2835
|
+
},
|
|
2836
|
+
"allowed": [
|
|
2837
|
+
"label",
|
|
2838
|
+
"labelText",
|
|
2839
|
+
"value",
|
|
2840
|
+
"onValueChange",
|
|
2841
|
+
"disabled",
|
|
2842
|
+
"today",
|
|
2843
|
+
"key",
|
|
2844
|
+
"ref",
|
|
2845
|
+
"className",
|
|
2846
|
+
"style",
|
|
2847
|
+
"children"
|
|
2848
|
+
],
|
|
2849
|
+
"message": "<ApplicationDateRangeFilter> 不接受该 prop。已声明的 props:label、labelText、value、onValueChange、disabled、today。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2850
|
+
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-atomic/application-date-range-filter.ts"
|
|
2851
|
+
},
|
|
2790
2852
|
{
|
|
2791
2853
|
"id": "props-whitelist-application-filter-menu",
|
|
2792
2854
|
"kind": "props-whitelist",
|
|
@@ -2880,6 +2942,7 @@
|
|
|
2880
2942
|
"pageSize",
|
|
2881
2943
|
"total",
|
|
2882
2944
|
"pageSizeOptions",
|
|
2945
|
+
"showJumper",
|
|
2883
2946
|
"onPageChange",
|
|
2884
2947
|
"onPageSizeChange",
|
|
2885
2948
|
"key",
|
|
@@ -2888,7 +2951,7 @@
|
|
|
2888
2951
|
"style",
|
|
2889
2952
|
"children"
|
|
2890
2953
|
],
|
|
2891
|
-
"message": "<ListTablePagination> 不接受该 prop。已声明的 props:page、pageSize、total、pageSizeOptions、onPageChange、onPageSizeChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2954
|
+
"message": "<ListTablePagination> 不接受该 prop。已声明的 props:page、pageSize、total、pageSizeOptions、showJumper、onPageChange、onPageSizeChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
2892
2955
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-atomic/list-table-pagination.ts"
|
|
2893
2956
|
},
|
|
2894
2957
|
{
|
|
@@ -3016,9 +3079,10 @@
|
|
|
3016
3079
|
"secondary",
|
|
3017
3080
|
"quiet",
|
|
3018
3081
|
"link",
|
|
3019
|
-
"destructive"
|
|
3082
|
+
"destructive",
|
|
3083
|
+
"destructive-outline"
|
|
3020
3084
|
],
|
|
3021
|
-
"message": "<SystemButton> 的 intent 取值须为 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive' 之一",
|
|
3085
|
+
"message": "<SystemButton> 的 intent 取值须为 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive' | 'destructive-outline' 之一",
|
|
3022
3086
|
"rationale": "取值与顺序取自契约 contracts/application-atomic/system-button.ts,不得在别处另立一份。"
|
|
3023
3087
|
},
|
|
3024
3088
|
{
|
|
@@ -3058,7 +3122,6 @@
|
|
|
3058
3122
|
"moduleName",
|
|
3059
3123
|
"modules",
|
|
3060
3124
|
"currentModule",
|
|
3061
|
-
"glyph",
|
|
3062
3125
|
"open",
|
|
3063
3126
|
"onOpenChange",
|
|
3064
3127
|
"onSelect",
|
|
@@ -3068,7 +3131,7 @@
|
|
|
3068
3131
|
"style",
|
|
3069
3132
|
"children"
|
|
3070
3133
|
],
|
|
3071
|
-
"message": "<ApplicationModuleSwitcher> 不接受该 prop。已声明的 props:moduleName、modules、currentModule、
|
|
3134
|
+
"message": "<ApplicationModuleSwitcher> 不接受该 prop。已声明的 props:moduleName、modules、currentModule、open、onOpenChange、onSelect。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3072
3135
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/navigation/application-module-switcher.ts"
|
|
3073
3136
|
},
|
|
3074
3137
|
{
|
|
@@ -3085,19 +3148,18 @@
|
|
|
3085
3148
|
},
|
|
3086
3149
|
"allowed": [
|
|
3087
3150
|
"appName",
|
|
3088
|
-
"appDescription",
|
|
3089
3151
|
"appGlyph",
|
|
3090
3152
|
"activeAction",
|
|
3091
3153
|
"actionBadges",
|
|
3092
3154
|
"onAction",
|
|
3093
|
-
"
|
|
3155
|
+
"account",
|
|
3094
3156
|
"key",
|
|
3095
3157
|
"ref",
|
|
3096
3158
|
"className",
|
|
3097
3159
|
"style",
|
|
3098
3160
|
"children"
|
|
3099
3161
|
],
|
|
3100
|
-
"message": "<ApplicationPrimaryNavigation> 不接受该 prop。已声明的 props:appName、
|
|
3162
|
+
"message": "<ApplicationPrimaryNavigation> 不接受该 prop。已声明的 props:appName、appGlyph、activeAction、actionBadges、onAction、account。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3101
3163
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/navigation/application-primary-navigation.ts"
|
|
3102
3164
|
},
|
|
3103
3165
|
{
|
|
@@ -3123,6 +3185,8 @@
|
|
|
3123
3185
|
"chevron-left",
|
|
3124
3186
|
"chevron-right",
|
|
3125
3187
|
"chevron-up",
|
|
3188
|
+
"chevrons-left",
|
|
3189
|
+
"chevrons-right",
|
|
3126
3190
|
"circle-alert",
|
|
3127
3191
|
"circle-check",
|
|
3128
3192
|
"circle-check-big",
|
|
@@ -3148,7 +3212,7 @@
|
|
|
3148
3212
|
"upload",
|
|
3149
3213
|
"x"
|
|
3150
3214
|
],
|
|
3151
|
-
"message": "<ApplicationPrimaryNavigation> 的 appGlyph 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
3215
|
+
"message": "<ApplicationPrimaryNavigation> 的 appGlyph 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevrons-left' | 'chevrons-right' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
3152
3216
|
"rationale": "取值与顺序取自契约 contracts/application-module/navigation/application-primary-navigation.ts,不得在别处另立一份。"
|
|
3153
3217
|
},
|
|
3154
3218
|
{
|
|
@@ -3191,13 +3255,16 @@
|
|
|
3191
3255
|
"tabs",
|
|
3192
3256
|
"value",
|
|
3193
3257
|
"onValueChange",
|
|
3258
|
+
"onNavigationSettings",
|
|
3259
|
+
"navigationSettingsOpen",
|
|
3260
|
+
"onCloseSettings",
|
|
3194
3261
|
"key",
|
|
3195
3262
|
"ref",
|
|
3196
3263
|
"className",
|
|
3197
3264
|
"style",
|
|
3198
3265
|
"children"
|
|
3199
3266
|
],
|
|
3200
|
-
"message": "<ApplicationSecondaryNavigation> 不接受该 prop。已声明的 props:moduleSwitcher、tabs、value、onValueChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3267
|
+
"message": "<ApplicationSecondaryNavigation> 不接受该 prop。已声明的 props:moduleSwitcher、tabs、value、onValueChange、onNavigationSettings、navigationSettingsOpen、onCloseSettings。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3201
3268
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/navigation/application-secondary-navigation.ts"
|
|
3202
3269
|
},
|
|
3203
3270
|
{
|
|
@@ -3582,6 +3649,9 @@
|
|
|
3582
3649
|
"dataStatus",
|
|
3583
3650
|
"updatedAt",
|
|
3584
3651
|
"onRefresh",
|
|
3652
|
+
"onBack",
|
|
3653
|
+
"backLabel",
|
|
3654
|
+
"taskStatus",
|
|
3585
3655
|
"actions",
|
|
3586
3656
|
"pageModes",
|
|
3587
3657
|
"pageMode",
|
|
@@ -3593,7 +3663,7 @@
|
|
|
3593
3663
|
"style",
|
|
3594
3664
|
"children"
|
|
3595
3665
|
],
|
|
3596
|
-
"message": "<ApplicationPageHeader> 不接受该 prop。已声明的 props:title、subtitle、dataStatus、updatedAt、onRefresh、actions、pageModes、pageMode、onPageModeChange、breadcrumb。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3666
|
+
"message": "<ApplicationPageHeader> 不接受该 prop。已声明的 props:title、subtitle、dataStatus、updatedAt、onRefresh、onBack、backLabel、taskStatus、actions、pageModes、pageMode、onPageModeChange、breadcrumb。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3597
3667
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/content/application-page-header.ts"
|
|
3598
3668
|
},
|
|
3599
3669
|
{
|
|
@@ -3772,13 +3842,14 @@
|
|
|
3772
3842
|
"allowed": [
|
|
3773
3843
|
"summary",
|
|
3774
3844
|
"sections",
|
|
3845
|
+
"aside",
|
|
3775
3846
|
"key",
|
|
3776
3847
|
"ref",
|
|
3777
3848
|
"className",
|
|
3778
3849
|
"style",
|
|
3779
3850
|
"children"
|
|
3780
3851
|
],
|
|
3781
|
-
"message": "<ApplicationRecordDetailBody> 不接受该 prop。已声明的 props:summary、sections。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3852
|
+
"message": "<ApplicationRecordDetailBody> 不接受该 prop。已声明的 props:summary、sections、aside。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3782
3853
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/content/application-record-detail-body.ts"
|
|
3783
3854
|
},
|
|
3784
3855
|
{
|
|
@@ -3941,13 +4012,15 @@
|
|
|
3941
4012
|
"error",
|
|
3942
4013
|
"onSubmit",
|
|
3943
4014
|
"onCancel",
|
|
4015
|
+
"secondaryActions",
|
|
4016
|
+
"footerNote",
|
|
3944
4017
|
"children",
|
|
3945
4018
|
"key",
|
|
3946
4019
|
"ref",
|
|
3947
4020
|
"className",
|
|
3948
4021
|
"style"
|
|
3949
4022
|
],
|
|
3950
|
-
"message": "<ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
4023
|
+
"message": "<ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、secondaryActions、footerNote、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3951
4024
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/overlays/application-form-dialog.ts"
|
|
3952
4025
|
},
|
|
3953
4026
|
{
|
|
@@ -3965,9 +4038,10 @@
|
|
|
3965
4038
|
},
|
|
3966
4039
|
"allowed": [
|
|
3967
4040
|
"small",
|
|
3968
|
-
"large"
|
|
4041
|
+
"large",
|
|
4042
|
+
"xlarge"
|
|
3969
4043
|
],
|
|
3970
|
-
"message": "<ApplicationFormDialog> 的 size 取值须为 'small' | 'large' 之一",
|
|
4044
|
+
"message": "<ApplicationFormDialog> 的 size 取值须为 'small' | 'large' | 'xlarge' 之一",
|
|
3971
4045
|
"rationale": "取值与顺序取自契约 contracts/application-module/overlays/application-form-dialog.ts,不得在别处另立一份。"
|
|
3972
4046
|
},
|
|
3973
4047
|
{
|
|
@@ -91,7 +91,7 @@ Next.js App Router 是本库实测过的环境:只有持有交互状态的组
|
|
|
91
91
|
7. **搭第一个页面。** 转 `moheng-ui-page`:先判定有没有结果集、定下五层 Canvas 模型里该写的字段,再选组件。
|
|
92
92
|
验证:页面通过第 5 步的 lint,且零报错。
|
|
93
93
|
|
|
94
|
-
当前
|
|
94
|
+
当前 165 条规则中,带 autofix 的有:`no-native-button`、`no-native-input`、`no-native-textarea`、`no-native-label`、`no-native-hr`、`no-native-progress`、`no-native-kbd`。
|
|
95
95
|
新项目不应依赖 autofix —— 一次写对是主技能 `moheng-ui` 的职责,autofix 是存量迁移的工具。
|
|
96
96
|
|
|
97
97
|
## 产出:写进项目的 agent 指导文件
|
|
@@ -35,10 +35,10 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
35
35
|
按字段取值从下面这批组件里选,每个组件的适用场景以其约定章节的「何时使用」为准:
|
|
36
36
|
|
|
37
37
|
- `ApplicationModuleSwitcher` —— 应用二级导航的左半部分 —— 你在哪个模块,以及如何切换。
|
|
38
|
-
- `ApplicationPrimaryNavigation` —— `APPLICATION.PRIMARY_NAV` ——
|
|
39
|
-
- `ApplicationSecondaryNavigation` —— `APPLICATION.SECONDARY_NAV` ——
|
|
38
|
+
- `ApplicationPrimaryNavigation` —— `APPLICATION.PRIMARY_NAV` —— GAP Design kit「通用导航 / 应用一级导航」。
|
|
39
|
+
- `ApplicationSecondaryNavigation` —— `APPLICATION.SECONDARY_NAV` —— GAP Design kit「应用二级导航」,外壳的最后一带
|
|
40
40
|
- `GlobalSidebar` —— 工作台左侧 72px 菜单栏,由 `SidebarRailButton` 构成。
|
|
41
|
-
- `TopNavigationPrimaryBar` —— `PLATFORM.TOP_USER_BAR` ——
|
|
41
|
+
- `TopNavigationPrimaryBar` —— `PLATFORM.TOP_USER_BAR` —— GAP Design kit「集团顶部导航」,只在集团版外壳出现
|
|
42
42
|
- `ApplicationMetricChart` —— `chart` 语义:数值 + 内嵌迷你走势线。仍然只读,卡片不导航。
|
|
43
43
|
- `ApplicationMetricPrimarySecondary` —— `primary-secondary` 语义:一个主数字 + 其拆解。
|
|
44
44
|
- `ApplicationMetricStatus` —— `status` 语义:功能状态 + 其计数 —— 逾期数、规则违反、系统健康度。
|
|
@@ -77,12 +77,15 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
77
77
|
`dataPresentation` → `ApplicationQueryToolbar` 与 `ApplicationDataDisplay` 的 `presentation`(prop 名与字段名不同)。
|
|
78
78
|
- 六种数据状态(Loading / Empty / Error / No Permission / Not Found / Partial Failure)
|
|
79
79
|
各给各的文案,不得共用一句。
|
|
80
|
-
-
|
|
80
|
+
- 页头的更新时间(`ApplicationPageHeader` 的 `updatedAt`)写完整日期时间 `YYYY-MM-DD HH:mm`(如 `2026-07-28 10:00`,
|
|
81
|
+
GAP Design kit「数据更新」,取代 07 · C-12 的 `HH:mm`),组件原样显示、不加前缀;
|
|
81
82
|
由服务端随数据返回的时间戳格式化而来,与数据同源;不得在客户端用 `useState(Date.now())` 一类写法自造一个时刻 —— 服务端渲染与客户端
|
|
82
83
|
水合各取一次当前时间,落在分钟边界两侧时文本不一致,且这个时刻与数据的实际更新时间无关。
|
|
83
84
|
- 查询参数(业务视图、搜索词、筛选、页码)与地址栏同步时,Next.js 下用 `useRouter()` 的
|
|
84
85
|
`router.replace`,不得直接调 `history.replaceState` —— 后者绕开 Next 的路由状态,浏览器后退
|
|
85
86
|
再回到本页时参数丢失。
|
|
87
|
+
- 有设计稿时,表格列宽照稿写进 `TableColumn.width`:稿上固定宽的列写数字(px),稿上均分剩余宽度的弹性列不写 `width`;
|
|
88
|
+
不得全部留空交给浏览器按内容分配 —— 那样每次数据不同列宽都不同,且与稿对不上。横向放不下时末列「操作」写 `fixed: 'right'`。
|
|
86
89
|
- Mock 数据只用登记过的占位符(`示例应用` / `模块 A` / `Tab 1`)。
|
|
87
90
|
- 骨架内不出现原生 `<button>` / `<input>` / `<table>`,替换表里有的一律用组件。
|
|
88
91
|
|
|
@@ -22,10 +22,12 @@ npx @moheng-design/ui-skill upgrade --from <旧版 contracts.json 的路径>
|
|
|
22
22
|
|
|
23
23
|
旧版 `contracts.json` 在升级前的 `node_modules/@moheng-design/ui-skill/generated/` 里,
|
|
24
24
|
升级前先拷一份出来。命令比对新旧两份,产出 `moheng-upgrade.md`:
|
|
25
|
-
组件的增删、prop
|
|
25
|
+
组件的增删、prop 的增删与必填变化、枚举值的增删、类型的收窄与变化、新标为弃用的 prop。
|
|
26
26
|
|
|
27
|
-
3.
|
|
28
|
-
|
|
27
|
+
3. 按报告改代码,从破坏性的几节改起(报告按此排序,「新增」两节排在最后)。删掉的 prop
|
|
28
|
+
与枚举值、收窄为固定取值的 prop 对应的是 `props-whitelist` / `prop-enum` 会报的那些
|
|
29
|
+
位置,先跑一遍 lint 再动手。「类型变化」一节 tsc 未必报(放宽的类型照样编译通过),
|
|
30
|
+
逐条核对引用处是否该改用新写法;「标为弃用」一节本次可不改,下一次升级前必须迁走。
|
|
29
31
|
4. 重跑安装命令,让项目里的 SKILL.md 跟上:
|
|
30
32
|
|
|
31
33
|
```bash
|
|
@@ -158,15 +158,17 @@ import '@moheng-design/ui/styles.css'
|
|
|
158
158
|
### 通用的「视图设置」按钮
|
|
159
159
|
|
|
160
160
|
```jsx
|
|
161
|
-
// 不要这样写
|
|
161
|
+
// 不要这样写 —— 自己拼一个设置按钮,名字还是通用的
|
|
162
162
|
<SystemButton>视图设置</SystemButton>
|
|
163
|
+
<SystemButton>自定义</SystemButton>
|
|
163
164
|
|
|
164
|
-
// 要这样写 ——
|
|
165
|
-
<
|
|
166
|
-
<
|
|
165
|
+
// 要这样写 —— 交给工具栏,它按当前呈现方式命名
|
|
166
|
+
<ApplicationQueryToolbar presentation="DataTable" onPresentationSettings={openColumns} /> {/* 列设置 */}
|
|
167
|
+
<ApplicationQueryToolbar presentation="KanbanBoard" onPresentationSettings={openBoard} /> {/* 看板设置 */}
|
|
167
168
|
```
|
|
168
169
|
|
|
169
|
-
|
|
170
|
+
呈现设置是一个*概念*,不是一个按钮名。工具栏的设置按钮按 GAP Design kit 是 32×32 纯图标,
|
|
171
|
+
名字落在可访问名与悬停提示上,必须按当前呈现方式命名:
|
|
170
172
|
`列设置` / `列表设置` / `卡片设置` / `看板设置` / `日历设置` / `图表设置` / `时间轴设置`。
|
|
171
173
|
|
|
172
174
|
### 六种数据状态共用一句话
|
|
@@ -13,25 +13,34 @@ Application
|
|
|
13
13
|
└─ Overlay Dialog / Drawer / Popover / Menu / Toast
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
### Shell
|
|
16
|
+
### Shell 导航带
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
固定骨架,**没有左侧全局栏**。导航带永不滚动。几何以 GAP Design kit「框架结构」为准,外壳有两种形态:
|
|
19
|
+
|
|
20
|
+
| 形态 | 带(自上而下) | Standard 总高 | Compact 总高 |
|
|
21
|
+
|---|---|---:|---:|
|
|
22
|
+
| 基础版 | 应用一级 + 应用二级 | 96px | 80px |
|
|
23
|
+
| 集团版 | 集团顶部 + 应用一级 + 应用二级 | 144px | 120px |
|
|
19
24
|
|
|
20
25
|
| 带 | 组件 | Standard | Compact |
|
|
21
26
|
|---|---|---:|---:|
|
|
22
|
-
|
|
|
23
|
-
| 应用一级导航 `APPLICATION.PRIMARY_NAV` | `ApplicationPrimaryNavigation` |
|
|
27
|
+
| 集团顶部导航 `PLATFORM.TOP_USER_BAR`(仅集团版) | `TopNavigationPrimaryBar` | 48px | 40px |
|
|
28
|
+
| 应用一级导航 `APPLICATION.PRIMARY_NAV` | `ApplicationPrimaryNavigation` | 48px | 40px |
|
|
24
29
|
| 应用二级导航 `APPLICATION.SECONDARY_NAV` | `ApplicationSecondaryNavigation` | 48px | 40px |
|
|
25
30
|
| Content Canvas | `ApplicationPageLayoutContainer` | 剩余视口 | 剩余视口 |
|
|
26
31
|
|
|
32
|
+
账户头像在基础版里是 `ApplicationPrimaryNavigation` 的 `account`,在集团版里在 `TopNavigationPrimaryBar`,
|
|
33
|
+
一个外壳只有一处。外壳总高读 `--ui-shell-application-total-height`:渲染了 `TopNavigationPrimaryBar` 时它自动计入
|
|
34
|
+
集团顶栏,宿主不必区分两种形态。
|
|
35
|
+
|
|
27
36
|
Compact 档在视口宽 ≤1180px 或高 ≤720px 时生效(`--ui-viewport-compact-max-width` / `-height`),
|
|
28
|
-
|
|
37
|
+
各带高度由同一组 `@media` 一并切换,宿主不得自行复刻断点。
|
|
29
38
|
|
|
30
39
|
宿主 padding 为零 —— padding 属于页面内容根。
|
|
31
40
|
|
|
32
41
|
### 宿主布局
|
|
33
42
|
|
|
34
|
-
本库不提供宿主组件(07 · C-5
|
|
43
|
+
本库不提供宿主组件(07 · C-5:组件留到第二个真实项目再抽),导航带 + Canvas 的宿主由应用
|
|
35
44
|
自己写,标准写法如下(类名由宿主自定,只读 `--application-*` 与 `--ui-*`):
|
|
36
45
|
|
|
37
46
|
```css
|
|
@@ -41,14 +50,14 @@ body {
|
|
|
41
50
|
margin: 0;
|
|
42
51
|
}
|
|
43
52
|
|
|
44
|
-
.app-shell { /*
|
|
53
|
+
.app-shell { /* 导航带 + Canvas,整体占满视口 */
|
|
45
54
|
display: flex;
|
|
46
55
|
flex-direction: column;
|
|
47
56
|
block-size: 100dvh;
|
|
48
57
|
background: var(--application-canvas);
|
|
49
58
|
}
|
|
50
59
|
|
|
51
|
-
.app-shell__bands { /*
|
|
60
|
+
.app-shell__bands { /* 包住全部导航带;不进滚动容器,即永不滚动 */
|
|
52
61
|
flex: none;
|
|
53
62
|
z-index: var(--ui-z-shell);
|
|
54
63
|
}
|
|
@@ -244,7 +253,7 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
244
253
|
### 关键尺寸
|
|
245
254
|
|
|
246
255
|
抽屉宽 680px(`--application-drawer-width: 1280px` 是宽/全屏变体);
|
|
247
|
-
表单对话框 720px / 960px;`SPLIT` 左栏 360px(Compact 300px);
|
|
256
|
+
表单对话框 720px / 960px / 1280px;`SPLIT` 左栏 360px(Compact 300px);
|
|
248
257
|
卡片网格默认 ≥1440 五列、Condensed 四列、Compact 三列,卡片最小宽 220px。
|
|
249
258
|
列数读 `--ui-card-columns-default`,三档由 `viewport.css` 的 `@media` 在 `:root` 上改写(5 / 4 / 3),
|
|
250
259
|
最小宽读 `--ui-card-min-width`,卡间距读 `--ui-card-gap`;系统内没有卡片网格组件,
|