text-to-design-mcp 0.4.0 → 0.5.1
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/dist/index.js +336 -42
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -102,7 +102,7 @@ pkill -f text-to-design-mcp
|
|
|
102
102
|
| --- | --- |
|
|
103
103
|
| `jsd_ping` | 检查插件是否在线 |
|
|
104
104
|
| `jsd_get_selection` | 读取画布当前选中的节点 |
|
|
105
|
-
| `
|
|
105
|
+
| `jsd_create_nodes` | 按描述创建节点(frame/rect/text 等,支持阴影/描边/渐变/文本样式) |
|
|
106
106
|
| `jsd_create_svg` | 直接导入 SVG 字符串(保留 path/矢量数据,不经降级) |
|
|
107
107
|
| `jsd_html_to_design` | 把 HTML 转成设计节点 |
|
|
108
108
|
| `jsd_update_selection` | 修改选中节点的属性(位置/颜色/文字/圆角等) |
|
package/dist/index.js
CHANGED
|
@@ -13,7 +13,7 @@ import { isTag } from "domhandler";
|
|
|
13
13
|
import { parseDocument } from "htmlparser2";
|
|
14
14
|
import Fuse from "fuse.js";
|
|
15
15
|
//#region package.json
|
|
16
|
-
var version = "0.
|
|
16
|
+
var version = "0.5.1";
|
|
17
17
|
//#endregion
|
|
18
18
|
//#region src/config.ts
|
|
19
19
|
var PORT = Number(process.env.TEXT_TO_DESIGN_MCP_PORT ?? 47812);
|
|
@@ -427,9 +427,9 @@ async function serveProxy(client) {
|
|
|
427
427
|
//#endregion
|
|
428
428
|
//#region ../shared/src/schemas.ts
|
|
429
429
|
var rgbSchema = z.object({
|
|
430
|
-
r: z.number().min(0).max(1),
|
|
431
|
-
g: z.number().min(0).max(1),
|
|
432
|
-
b: z.number().min(0).max(1)
|
|
430
|
+
r: z.number().min(0).max(1).describe("红色通道,范围 0-1(0=无,1=满),如纯红为 1"),
|
|
431
|
+
g: z.number().min(0).max(1).describe("绿色通道,范围 0-1"),
|
|
432
|
+
b: z.number().min(0).max(1).describe("蓝色通道,范围 0-1")
|
|
433
433
|
});
|
|
434
434
|
var rgbaSchema = z.object({
|
|
435
435
|
r: z.number().min(0).max(1),
|
|
@@ -440,7 +440,7 @@ var rgbaSchema = z.object({
|
|
|
440
440
|
var gradientStopSchema = z.object({
|
|
441
441
|
color: rgbaSchema,
|
|
442
442
|
position: z.number().min(0).max(1)
|
|
443
|
-
});
|
|
443
|
+
}).describe("渐变停止点,如 {color:{r:1,g:0,b:0,a:1}, position:0}(起点红色)和 {color:{r:0,g:0,b:1,a:1}, position:1}(终点蓝色)");
|
|
444
444
|
var transformSchema = z.tuple([z.tuple([
|
|
445
445
|
z.number(),
|
|
446
446
|
z.number(),
|
|
@@ -449,7 +449,7 @@ var transformSchema = z.tuple([z.tuple([
|
|
|
449
449
|
z.number(),
|
|
450
450
|
z.number(),
|
|
451
451
|
z.number()
|
|
452
|
-
])]);
|
|
452
|
+
])]).describe("变换矩阵,如 [[1,0,0],[0,1,0]] 表示无变换(Identity)");
|
|
453
453
|
var paintSchema = z.discriminatedUnion("type", [
|
|
454
454
|
z.object({
|
|
455
455
|
type: z.literal("SOLID"),
|
|
@@ -489,11 +489,9 @@ var blendModeSchema = z.enum([
|
|
|
489
489
|
"NORMAL",
|
|
490
490
|
"DARKEN",
|
|
491
491
|
"MULTIPLY",
|
|
492
|
-
"LINEAR_BURN",
|
|
493
492
|
"COLOR_BURN",
|
|
494
493
|
"LIGHTEN",
|
|
495
494
|
"SCREEN",
|
|
496
|
-
"LINEAR_DODGE",
|
|
497
495
|
"COLOR_DODGE",
|
|
498
496
|
"OVERLAY",
|
|
499
497
|
"SOFT_LIGHT",
|
|
@@ -567,10 +565,20 @@ var layoutGridSchema = z.object({
|
|
|
567
565
|
offset: z.number().optional().describe("偏移(px)"),
|
|
568
566
|
visible: z.boolean().optional().describe("是否可见"),
|
|
569
567
|
color: rgbaSchema.optional().describe("网格颜色")
|
|
568
|
+
}).superRefine((val, ctx) => {
|
|
569
|
+
if (val.pattern === "GRID" && val.sectionSize == null) ctx.addIssue({
|
|
570
|
+
code: z.ZodIssueCode.custom,
|
|
571
|
+
message: "pattern 为 GRID 时,sectionSize 为必填项",
|
|
572
|
+
path: ["sectionSize"]
|
|
573
|
+
});
|
|
570
574
|
});
|
|
571
575
|
var vectorPathSchema = z.object({
|
|
572
|
-
data: z.string().describe("SVG path data"),
|
|
573
|
-
windingRule: z.enum([
|
|
576
|
+
data: z.string().describe("SVG path data,如 \"M0 0 L100 0 L100 100 Z\"(M=移动到,L=画线到,Z=闭合)"),
|
|
577
|
+
windingRule: z.enum([
|
|
578
|
+
"NONZERO",
|
|
579
|
+
"EVENODD",
|
|
580
|
+
"NONE"
|
|
581
|
+
]).default("NONZERO").describe("环绕规则:NONZERO|EVENODD|NONE,默认 NONZERO")
|
|
574
582
|
});
|
|
575
583
|
var fontNameSchema = z.object({
|
|
576
584
|
family: z.string(),
|
|
@@ -580,16 +588,16 @@ var lineHeightSchema = z.union([
|
|
|
580
588
|
z.object({
|
|
581
589
|
value: z.number(),
|
|
582
590
|
unit: z.literal("PIXELS")
|
|
583
|
-
}),
|
|
591
|
+
}).describe("固定行高:{value: 数值, unit: \"PIXELS\"},如 {value: 24, unit: \"PIXELS\"}"),
|
|
584
592
|
z.object({
|
|
585
593
|
value: z.number(),
|
|
586
594
|
unit: z.literal("PERCENT")
|
|
587
|
-
}),
|
|
588
|
-
z.object({ unit: z.literal("AUTO") })
|
|
595
|
+
}).describe("百分比行高:{value: 数值, unit: \"PERCENT\"},如 {value: 150, unit: \"PERCENT\"}"),
|
|
596
|
+
z.object({ unit: z.literal("AUTO") }).describe("自动行高:{unit: \"AUTO\"},无需传 value")
|
|
589
597
|
]);
|
|
590
598
|
var letterSpacingSchema = z.object({
|
|
591
599
|
value: z.number(),
|
|
592
|
-
unit: z.
|
|
600
|
+
unit: z.enum(["PIXELS", "PERCENT"])
|
|
593
601
|
});
|
|
594
602
|
var nodeTypeSchema = z.enum([
|
|
595
603
|
"SLICE",
|
|
@@ -918,34 +926,267 @@ var listFontsResultSchema = z.object({
|
|
|
918
926
|
count: z.number()
|
|
919
927
|
});
|
|
920
928
|
z.object({});
|
|
921
|
-
z.object({ depth: z.number().optional().describe("
|
|
922
|
-
var
|
|
923
|
-
type: nodeTypeSchema.describe("节点类型:FRAME|RECTANGLE|ELLIPSE|LINE|POLYGON|STAR|VECTOR|BOOLEAN_OPERATION|TEXT"),
|
|
929
|
+
z.object({ depth: z.number().optional().describe("序列化深度:0=仅自身,1=含直接子节点,2=含孙节点;缺省 2") });
|
|
930
|
+
var baseNodeFields = {
|
|
924
931
|
name: z.string().optional().describe("图层名"),
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
932
|
+
x: z.number().optional().describe("X 坐标(px)"),
|
|
933
|
+
y: z.number().optional().describe("Y 坐标(px)"),
|
|
934
|
+
width: z.number().optional().describe("宽度(px)"),
|
|
935
|
+
height: z.number().optional().describe("高度(px)"),
|
|
936
|
+
rotation: z.number().optional().describe("旋转角度(deg)"),
|
|
937
|
+
opacity: z.number().optional().describe("不透明度 0-1"),
|
|
938
|
+
visible: z.boolean().optional().describe("是否可见"),
|
|
939
|
+
locked: z.boolean().optional().describe("锁定图层"),
|
|
940
|
+
isMask: z.boolean().optional().describe("是否为蒙版"),
|
|
941
|
+
children: z.array(z.any()).max(10).optional().describe("子节点数组(GROUP/BOOLEAN_OPERATION 使用,递归嵌套,最多 10 个直接子节点)")
|
|
942
|
+
};
|
|
943
|
+
var visualFields = {
|
|
944
|
+
fills: z.array(paintSchema).optional().describe("填充列表(Paint 数组)"),
|
|
945
|
+
strokes: z.array(paintSchema).optional().describe("描边列表(Paint 数组)"),
|
|
946
|
+
strokeWeight: z.number().optional().describe("描边宽度(px)"),
|
|
947
|
+
strokeTopWeight: z.number().optional().describe("描边顶部宽(px)"),
|
|
948
|
+
strokeBottomWeight: z.number().optional().describe("描边底部宽(px)"),
|
|
949
|
+
strokeLeftWeight: z.number().optional().describe("描边左侧宽(px)"),
|
|
950
|
+
strokeRightWeight: z.number().optional().describe("描边右侧宽(px)"),
|
|
951
|
+
strokeAlign: z.enum([
|
|
952
|
+
"CENTER",
|
|
953
|
+
"INSIDE",
|
|
954
|
+
"OUTSIDE"
|
|
955
|
+
]).optional().describe("描边对齐:CENTER|INSIDE|OUTSIDE"),
|
|
956
|
+
strokeCap: z.enum([
|
|
957
|
+
"NONE",
|
|
958
|
+
"ROUND",
|
|
959
|
+
"SQUARE",
|
|
960
|
+
"ARROW_LINES",
|
|
961
|
+
"ARROW_EQUILATERAL"
|
|
962
|
+
]).optional().describe("描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL"),
|
|
963
|
+
strokeJoin: z.enum([
|
|
964
|
+
"MITER",
|
|
965
|
+
"BEVEL",
|
|
966
|
+
"ROUND"
|
|
967
|
+
]).optional().describe("描边连接:MITER|BEVEL|ROUND"),
|
|
968
|
+
dashPattern: z.array(z.number()).optional().describe("虚线段数组,如 [4,4]"),
|
|
969
|
+
blendMode: blendModeSchema.optional().describe("混合模式"),
|
|
970
|
+
effects: z.array(effectSchema).optional().describe("效果列表(阴影/模糊,可多层叠加)"),
|
|
971
|
+
constraints: z.object({
|
|
972
|
+
horizontal: constraintTypeSchema.describe("水平约束:MIN|MAX|STRETCH|CENTER|SCALE"),
|
|
973
|
+
vertical: constraintTypeSchema.describe("垂直约束:MIN|MAX|STRETCH|CENTER|SCALE")
|
|
974
|
+
}).optional().describe("自动布局中的约束"),
|
|
975
|
+
clipsContent: z.boolean().optional().describe("是否裁剪溢出内容"),
|
|
976
|
+
cornerSmoothing: z.number().optional().describe("圆角平滑度 0-1"),
|
|
977
|
+
layoutGrids: z.array(layoutGridSchema).optional().describe("布局网格(参考线)")
|
|
978
|
+
};
|
|
979
|
+
var frameNodeSchema = z.object({
|
|
980
|
+
type: z.literal("FRAME"),
|
|
981
|
+
...baseNodeFields,
|
|
982
|
+
layoutMode: z.enum([
|
|
983
|
+
"NONE",
|
|
984
|
+
"HORIZONTAL",
|
|
985
|
+
"VERTICAL"
|
|
986
|
+
]).optional().describe("自动布局方向:NONE=无布局,HORIZONTAL=水平排列,VERTICAL=垂直排列。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL"),
|
|
987
|
+
itemSpacing: z.number().optional().describe("自动布局项间距(px),需先设 layoutMode"),
|
|
988
|
+
paddingTop: z.number().optional().describe("上内边距(px)"),
|
|
989
|
+
paddingRight: z.number().optional().describe("右内边距(px)"),
|
|
990
|
+
paddingBottom: z.number().optional().describe("下内边距(px)"),
|
|
991
|
+
paddingLeft: z.number().optional().describe("左内边距(px)"),
|
|
992
|
+
primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
|
|
993
|
+
counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
|
|
994
|
+
primaryAxisAlignItems: z.enum([
|
|
995
|
+
"MIN",
|
|
996
|
+
"MAX",
|
|
997
|
+
"CENTER",
|
|
998
|
+
"SPACE_BETWEEN"
|
|
999
|
+
]).optional().describe("主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN"),
|
|
1000
|
+
counterAxisAlignItems: z.enum([
|
|
1001
|
+
"MIN",
|
|
1002
|
+
"MAX",
|
|
1003
|
+
"CENTER"
|
|
1004
|
+
]).optional().describe("交叉轴对齐:MIN|MAX|CENTER"),
|
|
1005
|
+
layoutGrow: z.number().optional().describe("自动布局内伸缩系数"),
|
|
1006
|
+
layoutAlign: z.enum([
|
|
1007
|
+
"MIN",
|
|
1008
|
+
"CENTER",
|
|
1009
|
+
"MAX",
|
|
1010
|
+
"STRETCH",
|
|
1011
|
+
"INHERIT"
|
|
1012
|
+
]).optional().describe("自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT"),
|
|
1013
|
+
...visualFields
|
|
1014
|
+
}).superRefine((val, ctx) => {
|
|
1015
|
+
if ((val.itemSpacing != null || val.paddingTop != null || val.paddingRight != null || val.paddingBottom != null || val.paddingLeft != null || val.primaryAxisSizingMode != null || val.counterAxisSizingMode != null || val.primaryAxisAlignItems != null || val.counterAxisAlignItems != null) && (val.layoutMode == null || val.layoutMode === "NONE")) ctx.addIssue({
|
|
1016
|
+
code: z.ZodIssueCode.custom,
|
|
1017
|
+
message: "传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL",
|
|
1018
|
+
path: ["layoutMode"]
|
|
1019
|
+
});
|
|
1020
|
+
}).describe("FRAME=容器(可 auto-layout)");
|
|
1021
|
+
var rectangleNodeSchema = z.object({
|
|
1022
|
+
type: z.literal("RECTANGLE"),
|
|
1023
|
+
...baseNodeFields,
|
|
1024
|
+
cornerRadius: z.number().optional().describe("圆角半径(px),四角统一"),
|
|
1025
|
+
topLeftRadius: z.number().optional().describe("左上圆角(px)"),
|
|
1026
|
+
topRightRadius: z.number().optional().describe("右上圆角(px)"),
|
|
1027
|
+
bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
|
|
1028
|
+
bottomRightRadius: z.number().optional().describe("右下圆角(px)"),
|
|
1029
|
+
...visualFields
|
|
1030
|
+
}).describe("RECTANGLE=矩形");
|
|
1031
|
+
var ellipseNodeSchema = z.object({
|
|
1032
|
+
type: z.literal("ELLIPSE"),
|
|
1033
|
+
...baseNodeFields,
|
|
1034
|
+
cornerRadius: z.number().optional().describe("圆角半径(px)"),
|
|
1035
|
+
arcData: z.object({
|
|
1036
|
+
startingAngle: z.number().describe("起始角度(radians)"),
|
|
1037
|
+
endingAngle: z.number().describe("结束角度(radians)"),
|
|
1038
|
+
innerRadius: z.number().describe("内半径(0-1 ratio)")
|
|
1039
|
+
}).optional().describe("环形路径参数(弧线),可画圆环"),
|
|
1040
|
+
...visualFields
|
|
1041
|
+
}).describe("ELLIPSE=椭圆(配合 arcData 可画环)");
|
|
1042
|
+
var lineNodeSchema = z.object({
|
|
1043
|
+
type: z.literal("LINE"),
|
|
1044
|
+
...baseNodeFields,
|
|
1045
|
+
...visualFields
|
|
1046
|
+
}).describe("LINE=线段");
|
|
1047
|
+
var polygonNodeSchema = z.object({
|
|
1048
|
+
type: z.literal("POLYGON"),
|
|
1049
|
+
...baseNodeFields,
|
|
1050
|
+
pointCount: z.number().describe("多边形角点数,如 6=六边形"),
|
|
1051
|
+
cornerRadius: z.number().optional().describe("圆角半径(px)"),
|
|
1052
|
+
topLeftRadius: z.number().optional().describe("左上圆角(px)"),
|
|
1053
|
+
topRightRadius: z.number().optional().describe("右上圆角(px)"),
|
|
1054
|
+
bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
|
|
1055
|
+
bottomRightRadius: z.number().optional().describe("右下圆角(px)"),
|
|
1056
|
+
...visualFields
|
|
1057
|
+
}).describe("POLYGON=多边形(配合 pointCount)");
|
|
1058
|
+
var starNodeSchema = z.object({
|
|
1059
|
+
type: z.literal("STAR"),
|
|
1060
|
+
...baseNodeFields,
|
|
1061
|
+
pointCount: z.number().describe("星形角点数,如 5=五角星"),
|
|
1062
|
+
innerRadius: z.number().describe("星形内半径(px),值越小角越尖锐"),
|
|
1063
|
+
cornerRadius: z.number().optional().describe("圆角半径(px)"),
|
|
1064
|
+
topLeftRadius: z.number().optional().describe("左上圆角(px)"),
|
|
1065
|
+
topRightRadius: z.number().optional().describe("右上圆角(px)"),
|
|
1066
|
+
bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
|
|
1067
|
+
bottomRightRadius: z.number().optional().describe("右下圆角(px)"),
|
|
1068
|
+
...visualFields
|
|
1069
|
+
}).describe("STAR=星形(配合 pointCount + innerRadius)");
|
|
1070
|
+
var vectorNodeSchema = z.object({
|
|
1071
|
+
type: z.literal("VECTOR"),
|
|
1072
|
+
...baseNodeFields,
|
|
1073
|
+
vectorPaths: z.array(vectorPathSchema).describe("矢量路径数组,每项含 SVG path data(如 \"M0 0 L100 100\")"),
|
|
1074
|
+
...visualFields
|
|
1075
|
+
}).describe("VECTOR=矢量(配合 vectorPaths 传 SVG path data)");
|
|
1076
|
+
var textNodeSchema = z.object({
|
|
1077
|
+
type: z.literal("TEXT"),
|
|
1078
|
+
...baseNodeFields,
|
|
1079
|
+
characters: z.string().describe("文本内容,如 \"Hello World\""),
|
|
1080
|
+
fontSize: z.number().optional().describe("字号(px),默认 16"),
|
|
1081
|
+
fontName: fontNameSchema.optional().describe("字体:{family,style},如 {family:\"PingFang SC\",style:\"Regular\"}"),
|
|
1082
|
+
textAlignHorizontal: z.enum([
|
|
1083
|
+
"LEFT",
|
|
1084
|
+
"CENTER",
|
|
1085
|
+
"RIGHT",
|
|
1086
|
+
"JUSTIFIED"
|
|
1087
|
+
]).optional().describe("水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED"),
|
|
1088
|
+
textAlignVertical: z.enum([
|
|
1089
|
+
"TOP",
|
|
1090
|
+
"CENTER",
|
|
1091
|
+
"BOTTOM"
|
|
1092
|
+
]).optional().describe("垂直对齐:TOP|CENTER|BOTTOM"),
|
|
1093
|
+
textAutoResize: z.enum([
|
|
1094
|
+
"NONE",
|
|
1095
|
+
"WIDTH_AND_HEIGHT",
|
|
1096
|
+
"HEIGHT",
|
|
1097
|
+
"TRUNCATE"
|
|
1098
|
+
]).optional().describe("文本自适应:NONE|WIDTH_AND_HEIGHT|HEIGHT|TRUNCATE"),
|
|
1099
|
+
textCase: z.enum([
|
|
1100
|
+
"ORIGINAL",
|
|
1101
|
+
"UPPER",
|
|
1102
|
+
"LOWER",
|
|
1103
|
+
"TITLE"
|
|
1104
|
+
]).optional().describe("文本大小写:ORIGINAL|UPPER|LOWER|TITLE"),
|
|
1105
|
+
textDecoration: z.enum([
|
|
1106
|
+
"NONE",
|
|
1107
|
+
"UNDERLINE",
|
|
1108
|
+
"STRIKETHROUGH"
|
|
1109
|
+
]).optional().describe("文本装饰:NONE|UNDERLINE|STRIKETHROUGH"),
|
|
1110
|
+
lineHeight: lineHeightSchema.optional().describe("行高:{value,unit},unit 为 PIXELS|PERCENT;或 {unit:\"AUTO\"}"),
|
|
1111
|
+
letterSpacing: letterSpacingSchema.optional().describe("字距:{value,unit},unit 为 PIXELS|PERCENT"),
|
|
1112
|
+
...visualFields
|
|
1113
|
+
}).describe("TEXT=文本(配合 characters/fontSize/fontName 等)");
|
|
1114
|
+
var groupNodeSchema = z.object({
|
|
1115
|
+
type: z.literal("GROUP"),
|
|
1116
|
+
...baseNodeFields,
|
|
1117
|
+
layoutMode: z.enum([
|
|
1118
|
+
"NONE",
|
|
1119
|
+
"HORIZONTAL",
|
|
1120
|
+
"VERTICAL"
|
|
1121
|
+
]).optional().describe("自动布局方向:NONE=纯归组,HORIZONTAL=水平,VERTICAL=垂直。传 itemSpacing/padding* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL"),
|
|
1122
|
+
itemSpacing: z.number().optional().describe("项间距(px),需先设 layoutMode"),
|
|
1123
|
+
paddingTop: z.number().optional().describe("上内边距(px)"),
|
|
1124
|
+
paddingRight: z.number().optional().describe("右内边距(px)"),
|
|
1125
|
+
paddingBottom: z.number().optional().describe("下内边距(px)"),
|
|
1126
|
+
paddingLeft: z.number().optional().describe("左内边距(px)"),
|
|
1127
|
+
primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
|
|
1128
|
+
counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
|
|
1129
|
+
primaryAxisAlignItems: z.enum([
|
|
1130
|
+
"MIN",
|
|
1131
|
+
"MAX",
|
|
1132
|
+
"CENTER",
|
|
1133
|
+
"SPACE_BETWEEN"
|
|
1134
|
+
]).optional().describe("主轴对齐"),
|
|
1135
|
+
counterAxisAlignItems: z.enum([
|
|
1136
|
+
"MIN",
|
|
1137
|
+
"MAX",
|
|
1138
|
+
"CENTER"
|
|
1139
|
+
]).optional().describe("交叉轴对齐"),
|
|
1140
|
+
...visualFields
|
|
1141
|
+
}).superRefine((val, ctx) => {
|
|
1142
|
+
if ((val.itemSpacing != null || val.paddingTop != null || val.paddingRight != null || val.paddingBottom != null || val.paddingLeft != null || val.primaryAxisSizingMode != null || val.counterAxisSizingMode != null || val.primaryAxisAlignItems != null || val.counterAxisAlignItems != null) && (val.layoutMode == null || val.layoutMode === "NONE")) ctx.addIssue({
|
|
1143
|
+
code: z.ZodIssueCode.custom,
|
|
1144
|
+
message: "传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL",
|
|
1145
|
+
path: ["layoutMode"]
|
|
1146
|
+
});
|
|
1147
|
+
}).describe("GROUP=分组(内部用 Frame 实现)");
|
|
1148
|
+
var booleanOperationNodeSchema = z.object({
|
|
1149
|
+
type: z.literal("BOOLEAN_OPERATION"),
|
|
1150
|
+
...baseNodeFields,
|
|
929
1151
|
booleanOperation: z.enum([
|
|
930
1152
|
"UNION",
|
|
931
1153
|
"SUBTRACT",
|
|
932
1154
|
"INTERSECT",
|
|
933
1155
|
"EXCLUDE"
|
|
934
|
-
]).
|
|
935
|
-
|
|
936
|
-
|
|
1156
|
+
]).describe("布尔运算:UNION=合并,SUBTRACT=减去,INTERSECT=相交,EXCLUDE=排除"),
|
|
1157
|
+
children: z.array(z.any()).min(2).describe("要合并的子节点数组(至少 2 个)"),
|
|
1158
|
+
...visualFields
|
|
1159
|
+
}).describe("BOOLEAN_OPERATION=布尔运算(合并子节点)");
|
|
1160
|
+
var executeNodeSchema = z.discriminatedUnion("type", [
|
|
1161
|
+
frameNodeSchema,
|
|
1162
|
+
rectangleNodeSchema,
|
|
1163
|
+
ellipseNodeSchema,
|
|
1164
|
+
lineNodeSchema,
|
|
1165
|
+
polygonNodeSchema,
|
|
1166
|
+
starNodeSchema,
|
|
1167
|
+
vectorNodeSchema,
|
|
1168
|
+
textNodeSchema,
|
|
1169
|
+
groupNodeSchema,
|
|
1170
|
+
booleanOperationNodeSchema
|
|
1171
|
+
]);
|
|
937
1172
|
var placementSchema = z.object({
|
|
938
1173
|
mode: z.enum([
|
|
939
1174
|
"center",
|
|
940
1175
|
"manual",
|
|
941
1176
|
"absolute"
|
|
942
|
-
]).optional().describe("
|
|
943
|
-
x: z.number().optional().describe("absolute 模式下的绝对 X
|
|
944
|
-
y: z.number().optional().describe("absolute 模式下的绝对 Y
|
|
1177
|
+
]).optional().describe("放置模式:center=居中画布/manual=保持节点原始坐标/absolute=使用 x/y 指定坐标(选 absolute 必须传 x 和 y)"),
|
|
1178
|
+
x: z.number().optional().describe("absolute 模式下的绝对 X 坐标,与 mode=\"absolute\" 配合使用"),
|
|
1179
|
+
y: z.number().optional().describe("absolute 模式下的绝对 Y 坐标,与 mode=\"absolute\" 配合使用")
|
|
1180
|
+
}).superRefine((val, ctx) => {
|
|
1181
|
+
if (val.mode === "absolute" && (val.x == null || val.y == null)) ctx.addIssue({
|
|
1182
|
+
code: z.ZodIssueCode.custom,
|
|
1183
|
+
message: "placement.mode 为 absolute 时,x 和 y 均为必填项",
|
|
1184
|
+
path: val.x == null ? ["x"] : ["y"]
|
|
1185
|
+
});
|
|
945
1186
|
});
|
|
946
1187
|
var executeSchema = z.object({
|
|
947
1188
|
ops: z.array(executeNodeSchema).describe("设计指令节点树"),
|
|
948
|
-
placement: placementSchema.optional().describe("放置方式,缺省 center
|
|
1189
|
+
placement: placementSchema.optional().describe("放置方式,缺省 center 居中。选 absolute 模式必须传 x 和 y 坐标")
|
|
949
1190
|
});
|
|
950
1191
|
var createSvgSchema = z.object({
|
|
951
1192
|
svg: z.string().describe("完整 SVG 字符串,如 <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"100\" height=\"100\"><path d=\"M0 0 L100 0 L100 100 Z\" fill=\"#ff0000\"/></svg>"),
|
|
@@ -976,9 +1217,9 @@ var updateNodeSchema = z.object({
|
|
|
976
1217
|
var findSchema = z.object({
|
|
977
1218
|
ids: z.array(z.string()).optional().describe("按节点 id 精确查找,优先级最高"),
|
|
978
1219
|
name: z.string().optional().describe("按名称模糊匹配(包含)"),
|
|
979
|
-
type: z.string().optional().describe("
|
|
1220
|
+
type: z.string().optional().describe("节点类型过滤,支持:SLICE/FRAME/GROUP/COMPONENT_SET/COMPONENT/INSTANCE/BOOLEAN_OPERATION/VECTOR/STAR/LINE/ELLIPSE/POLYGON/RECTANGLE/TEXT"),
|
|
980
1221
|
recursive: z.boolean().optional().describe("是否递归查找(默认 true)"),
|
|
981
|
-
depth: z.number().optional().describe("
|
|
1222
|
+
depth: z.number().optional().describe("序列化深度:0=仅自身,1=含直接子节点;缺省 1")
|
|
982
1223
|
});
|
|
983
1224
|
var manageNodesSchema = z.discriminatedUnion("op", [
|
|
984
1225
|
z.object({
|
|
@@ -988,7 +1229,7 @@ var manageNodesSchema = z.discriminatedUnion("op", [
|
|
|
988
1229
|
z.object({
|
|
989
1230
|
op: z.literal("remove"),
|
|
990
1231
|
ids: z.array(z.string()).optional().describe("要删除的节点 id 列表,缺省用当前选中"),
|
|
991
|
-
matchName: z.string().optional().describe("
|
|
1232
|
+
matchName: z.string().optional().describe("在 ids(或当前选中)范围内,仅删除 name 精确匹配的节点")
|
|
992
1233
|
}),
|
|
993
1234
|
z.object({
|
|
994
1235
|
op: z.literal("clone"),
|
|
@@ -1002,7 +1243,7 @@ var manageNodesSchema = z.discriminatedUnion("op", [
|
|
|
1002
1243
|
"NONE",
|
|
1003
1244
|
"HORIZONTAL",
|
|
1004
1245
|
"VERTICAL"
|
|
1005
|
-
]).optional().describe("自动布局方向:NONE
|
|
1246
|
+
]).optional().describe("自动布局方向:NONE=纯归组,子节点仅叠加,HORIZONTAL=水平排列,VERTICAL=垂直排列"),
|
|
1006
1247
|
itemSpacing: z.number().optional().describe("自动布局项间距(px)"),
|
|
1007
1248
|
paddingTop: z.number().optional().describe("上内边距(px)"),
|
|
1008
1249
|
paddingRight: z.number().optional().describe("右内边距(px)"),
|
|
@@ -1040,7 +1281,7 @@ var manageNodesSchema = z.discriminatedUnion("op", [
|
|
|
1040
1281
|
parentId: z.string().optional().describe("目标父节点 id,缺省用当前选中第一个节点"),
|
|
1041
1282
|
index: z.number().optional().describe("插入位置,缺省追加到末尾")
|
|
1042
1283
|
}),
|
|
1043
|
-
z.object({ op: z.literal("repair").describe("
|
|
1284
|
+
z.object({ op: z.literal("repair").describe("清理画布中已损坏/失效的节点(读取失败的节点直接删除)") })
|
|
1044
1285
|
]);
|
|
1045
1286
|
var manageComponentsSchema = z.discriminatedUnion("op", [
|
|
1046
1287
|
z.object({
|
|
@@ -1058,7 +1299,7 @@ var manageComponentsSchema = z.discriminatedUnion("op", [
|
|
|
1058
1299
|
}),
|
|
1059
1300
|
z.object({
|
|
1060
1301
|
op: z.literal("import_component"),
|
|
1061
|
-
key: z.string().describe("
|
|
1302
|
+
key: z.string().describe("团队库组件的唯一标识 Key(从设计稿/团队库获取)"),
|
|
1062
1303
|
name: z.string().optional().describe("导入后的组件名")
|
|
1063
1304
|
}),
|
|
1064
1305
|
z.object({
|
|
@@ -1069,7 +1310,7 @@ var manageComponentsSchema = z.discriminatedUnion("op", [
|
|
|
1069
1310
|
z.object({
|
|
1070
1311
|
op: z.literal("set_instance_properties"),
|
|
1071
1312
|
ids: z.array(z.string()).describe("实例(INSTANCE)节点 id 列表"),
|
|
1072
|
-
properties: z.record(z.string(), z.string()).describe("变体属性名→值,如 {\"状态\":\"禁用\"}")
|
|
1313
|
+
properties: z.record(z.string(), z.string()).describe("变体属性名→值,如 {\"状态\":\"禁用\"}。可调属性列表需从 jsd_find/jsd_get_selection 返回的 variantGroupProperties 获取,属性名必须完全匹配")
|
|
1073
1314
|
}),
|
|
1074
1315
|
z.object({
|
|
1075
1316
|
op: z.literal("combine_as_variants"),
|
|
@@ -1932,8 +2173,23 @@ function iconToSvg(def, size = 24, color = "#000000", strokeWidth = 2) {
|
|
|
1932
2173
|
//#region src/tools/create.ts
|
|
1933
2174
|
/** 创建类:声明式节点 / SVG 导入 / HTML 转设计 */
|
|
1934
2175
|
function registerCreateTools(server, bridge) {
|
|
1935
|
-
server.registerTool("
|
|
1936
|
-
description:
|
|
2176
|
+
server.registerTool("jsd_create_nodes", {
|
|
2177
|
+
description: `在画布创建节点(可递归嵌套子节点)。
|
|
2178
|
+
|
|
2179
|
+
节点类型 type:
|
|
2180
|
+
- FRAME=容器(可 auto-layout)
|
|
2181
|
+
- RECTANGLE=矩形
|
|
2182
|
+
- ELLIPSE=椭圆(配合 arcData 可画环)
|
|
2183
|
+
- LINE=线段
|
|
2184
|
+
- POLYGON=多边形(配合 pointCount)
|
|
2185
|
+
- STAR=星形(配合 pointCount + innerRadius)
|
|
2186
|
+
- VECTOR=矢量(配合 vectorPaths 传 SVG path data)
|
|
2187
|
+
- TEXT=文本(配合 characters/fontSize/fontName 等)
|
|
2188
|
+
- GROUP=分组(内部用 Frame 实现)
|
|
2189
|
+
- BOOLEAN_OPERATION=布尔运算(配合 booleanOperation:UNION|SUBTRACT|INTERSECT|EXCLUDE)
|
|
2190
|
+
|
|
2191
|
+
填充 fills/描边 strokes:每项为 {type:"SOLID", color:{r,g,b}} 或 {type:"GRADIENT_LINEAR",...},color 的 r/g/b 范围 0-1。
|
|
2192
|
+
放置 placement:mode=center 居中画布,manual=保持原始坐标,absolute=使用 x/y 坐标。`,
|
|
1937
2193
|
inputSchema: executeSchema,
|
|
1938
2194
|
outputSchema: createdResultSchema
|
|
1939
2195
|
}, async ({ ops, placement }) => {
|
|
@@ -2002,7 +2258,19 @@ function registerCreateTools(server, bridge) {
|
|
|
2002
2258
|
/** 管理类:节点结构操作 + 组件/实例操作 */
|
|
2003
2259
|
function registerManageTools(server, bridge) {
|
|
2004
2260
|
server.registerTool("jsd_manage_nodes", {
|
|
2005
|
-
description:
|
|
2261
|
+
description: `对节点执行结构操作(按 op 分发):
|
|
2262
|
+
|
|
2263
|
+
- select:设置当前选中
|
|
2264
|
+
- remove:删除(matchName 可在 ids/选中范围内进一步过滤)
|
|
2265
|
+
- clone:复制(右下偏移 24px)
|
|
2266
|
+
- group:编组(支持 auto-layout 参数 layoutMode/itemSpacing/padding*)
|
|
2267
|
+
- ungroup:取消编组
|
|
2268
|
+
- flatten:合并为单个矢量(至少 2 个节点)
|
|
2269
|
+
- outline_stroke:描边转矢量轮廓
|
|
2270
|
+
- reparent:移动到目标父节点下(parentId 缺省用当前选中第一个)
|
|
2271
|
+
- repair:清理画布中已损坏的节点
|
|
2272
|
+
|
|
2273
|
+
注意:修改属性(位置/尺寸/填充/文本等)请用 jsd_update_node。`,
|
|
2006
2274
|
inputSchema: manageNodesSchema,
|
|
2007
2275
|
outputSchema: manageNodesResultSchema
|
|
2008
2276
|
}, async (params) => {
|
|
@@ -2013,7 +2281,15 @@ function registerManageTools(server, bridge) {
|
|
|
2013
2281
|
}
|
|
2014
2282
|
});
|
|
2015
2283
|
server.registerTool("jsd_manage_components", {
|
|
2016
|
-
description:
|
|
2284
|
+
description: `组件/实例操作(按 op 分发):
|
|
2285
|
+
|
|
2286
|
+
- create_component:创建空壳组件(子节点需另用 reparent 归组)
|
|
2287
|
+
- create_instance:从组件生成实例
|
|
2288
|
+
- detach_instance:解绑实例(转为 Frame)
|
|
2289
|
+
- import_component:从团队库按 key 导入组件
|
|
2290
|
+
- swap_component:交换实例引用的组件
|
|
2291
|
+
- set_instance_properties:设置实例变体属性(可调属性从 find/selection 的 variantGroupProperties 获取)
|
|
2292
|
+
- combine_as_variants:合并为组件集(基于副本,原组件保留)`,
|
|
2017
2293
|
inputSchema: manageComponentsSchema,
|
|
2018
2294
|
outputSchema: manageComponentsResultSchema
|
|
2019
2295
|
}, async (params) => {
|
|
@@ -2029,7 +2305,15 @@ function registerManageTools(server, bridge) {
|
|
|
2029
2305
|
/** 修改类:选中属性修改 + 节点查找 */
|
|
2030
2306
|
function registerModifyTools(server, bridge) {
|
|
2031
2307
|
server.registerTool("jsd_update_node", {
|
|
2032
|
-
description:
|
|
2308
|
+
description: `按 id 修改节点属性(位置/尺寸/填充/文本/效果等)。
|
|
2309
|
+
|
|
2310
|
+
参数说明:
|
|
2311
|
+
- ids:指定要修改的节点 id 列表(优先级高于当前选中)
|
|
2312
|
+
- matchName:在 ids 范围内进一步过滤,仅修改 name 精确匹配的节点
|
|
2313
|
+
- recursive:是否递归应用到子节点
|
|
2314
|
+
- props:要修改的属性对象,字段与枚举以 inputSchema 为准
|
|
2315
|
+
|
|
2316
|
+
注意:结构操作(分组/删除/移动)请用 jsd_manage_nodes。`,
|
|
2033
2317
|
inputSchema: updateNodeSchema,
|
|
2034
2318
|
outputSchema: updatedResultSchema
|
|
2035
2319
|
}, async ({ ids, matchName, recursive, props }) => {
|
|
@@ -2065,7 +2349,15 @@ var fillImageSchema = z.object({
|
|
|
2065
2349
|
/** 原始数据类:导出/填充图片/字体列表 */
|
|
2066
2350
|
function registerRawTools(server, bridge) {
|
|
2067
2351
|
server.registerTool("jsd_export", {
|
|
2068
|
-
description:
|
|
2352
|
+
description: `导出节点为图片/文件。
|
|
2353
|
+
|
|
2354
|
+
参数说明:
|
|
2355
|
+
- format:导出格式 PNG/JPG/SVG/PDF,默认 PNG
|
|
2356
|
+
- scale:缩放倍率(PNG/JPG),默认 1
|
|
2357
|
+
- savePath:落盘到本地文件路径(如 /tmp/icon.png),推荐在不支持图像的模型时使用
|
|
2358
|
+
- includeDataUrl:是否同时返回 base64 dataURL(供支持图像的模型直接查看)
|
|
2359
|
+
|
|
2360
|
+
两种输出方式可并存:传 savePath 落盘 + 不传 includeDataUrl 则仅落盘;传 includeDataUrl 则返回 base64。`,
|
|
2069
2361
|
inputSchema: exportSchema,
|
|
2070
2362
|
outputSchema: exportResultSchema
|
|
2071
2363
|
}, async ({ ids, format, scale, savePath, includeDataUrl }) => {
|
|
@@ -2148,7 +2440,9 @@ function registerSessionTools(server, bridge) {
|
|
|
2148
2440
|
}
|
|
2149
2441
|
});
|
|
2150
2442
|
server.registerTool("jsd_get_selection", {
|
|
2151
|
-
description:
|
|
2443
|
+
description: `获取画布当前选中的节点信息(名称/类型/尺寸/位置/填充/文本/子树结构)。
|
|
2444
|
+
|
|
2445
|
+
可选 depth 参数控制序列化深度:0=仅自身,1=含直接子节点,2=含孙节点,默认 2。`,
|
|
2152
2446
|
outputSchema: getSelectionResultSchema
|
|
2153
2447
|
}, async () => {
|
|
2154
2448
|
try {
|