codesign-mcp-server 0.0.0-stage → 1.0.2

package/dist/types.d.ts

@@ -0,0 +1,173 @@
+export interface ScreenRef {
+    id: number;
+    name: string;
+}
+export interface DesignRef {
+    id: number;
+    name: string;
+    viewport: string;
+    screens: ScreenRef[];
+}
+export interface ShareInfo {
+    id: number;
+    title: string;
+    teamName: string;
+    permissions: {
+        commentable: boolean;
+        inspectable: boolean;
+        assetsDownloadable: boolean;
+    };
+    designs: DesignRef[];
+}
+export interface ScreenDetail {
+    id: number;
+    name: string;
+    width: number;
+    height: number;
+    designId: number;
+    source: string;
+    metaUrl?: string;
+    slicesUrl?: string;
+    previewUrl?: string;
+    slicesCount: number;
+}
+export interface LayerRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface TextStyle {
+    fontName: string;
+    fontStyleName: string;
+    /** 渲染后的实际字号（已按设计稿缩放换算），不是排版原始值 */
+    size: number;
+    /** Photoshop 千分之一单位，换算 CSS 时 /1000 * size */
+    tracking?: number;
+    leading?: number;
+    allCaps?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    color?: string;
+    textAlign?: string;
+    content?: string;
+}
+export interface LayerFill {
+    type: string;
+    color?: string;
+    css?: string;
+}
+export interface LayerBorder extends LayerFill {
+    /** 边框粗细 */
+    width?: number;
+    /** inside / outside / center */
+    position?: string;
+    style?: string;
+}
+/** 图层效果，`type` 为设计稿里的效果名（innerGlow / frameFX / dropShadow…） */
+export interface LayerEffect {
+    type: string;
+    [key: string]: unknown;
+}
+export interface Layer {
+    id: string;
+    /** CoDesign 的 object_id，切图清单里用它关联图层 */
+    objectId: string;
+    name: string;
+    type: string;
+    rect: LayerRect;
+    visible: boolean;
+    opacity?: number;
+    fillOpacity?: number;
+    /** 圆角，按 topLeft/topRight/bottomRight/bottomLeft 顺序 */
+    radius?: number[];
+    fills?: LayerFill[];
+    borders?: LayerBorder[];
+    /** 阴影/发光/描边等效果 */
+    effects?: LayerEffect[];
+    /** 设计稿自带的 CSS 片段，是最可靠的样式来源 */
+    css?: string[];
+    text?: TextStyle;
+    images?: string[];
+    clipped?: boolean;
+    blendMode?: string;
+    rotation?: number;
+    /** 图层带矢量路径 */
+    isVector?: boolean;
+    children?: Layer[];
+}
+export interface LayerTree {
+    name: string;
+    width: number;
+    height: number;
+    /** 已经按 parent_id 重建成真正的嵌套树 */
+    layers: Layer[];
+}
+export interface SliceExport {
+    name: string;
+    scale: number;
+    format: string;
+    width: number;
+    height: number;
+    downloadUrl: string;
+    objectId: string;
+}
+export interface SliceItem {
+    id: string;
+    name: string;
+    rect: LayerRect;
+    exports: SliceExport[];
+}
+export interface DownloadResult {
+    name: string;
+    /** 相对 outDir 的路径，便于调用方定位 */
+    path: string;
+    /** 实际使用的导出倍率（默认 2x；该图层没有时会就近取） */
+    scale?: number;
+    /** 该图层没有请求的倍率，实际用了另一个倍率 */
+    substituted?: boolean;
+    width: number;
+    height: number;
+    bytes: number;
+    ok: boolean;
+    error?: string;
+}
+export interface SpecNode {
+    name: string;
+    type: string;
+    objectId: string;
+    box: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    style: string[];
+    text?: string;
+}
+export interface SpecResult {
+    screen: string;
+    size: {
+        width: number;
+        height: number;
+    };
+    cssWidth: number;
+    /** 设计稿宽度 -> 目标 CSS 宽度的缩放比 */
+    scale: number;
+    nodes: SpecNode[];
+    slices: {
+        name: string;
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        scale: number;
+        file: string;
+    }[];
+    notes: string[];
+    /** 图层被截断时的说明 */
+    truncated?: {
+        total: number;
+        returned: number;
+    };
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,2 @@
+/** 按固定并发度执行，保持结果顺序与输入一致 */
+export declare function mapLimit<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/utils/concurrency.js

@@ -0,0 +1,15 @@
+/** 按固定并发度执行，保持结果顺序与输入一致 */
+export async function mapLimit(items, limit, fn) {
+    const size = Math.max(1, Math.min(Math.floor(limit) || 1, items.length || 1));
+    const results = new Array(items.length);
+    let next = 0;
+    async function worker() {
+        while (next < items.length) {
+            const i = next++;
+            results[i] = await fn(items[i], i);
+        }
+    }
+    await Promise.all(Array.from({ length: size }, worker));
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAmB,EACnB,KAAa,EACb,EAA0C;IAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,UAAU,MAAM;QACnB,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/filename.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 把图层名/画板名转成安全文件名。
+ * Windows 保留名（CON、NUL、COM1…）和非法的尾部点/空格也要处理，否则写文件会失败。
+ */
+export declare function sanitizeFilename(name: string, fallback?: string): string;
+/**
+ * 同名文件去重：第二次出现起追加 `_2`、`_3`…
+ * 返回一个可复用的命名器，同一目录内共享才能跨画板/跨批次去重。
+ */
+export declare function createNamer(): (base: string, ext: string) => string;

package/dist/utils/filename.js

@@ -0,0 +1,32 @@
+/**
+ * 把图层名/画板名转成安全文件名。
+ * Windows 保留名（CON、NUL、COM1…）和非法的尾部点/空格也要处理，否则写文件会失败。
+ */
+export function sanitizeFilename(name, fallback = "unnamed") {
+    let out = name
+        // 保留空格和连字符，只替换真正非法的字符与控制字符
+        .replace(/[\\/:*?"<>|\x00-\x1f]/g, "_")
+        // Windows 不允许文件名以 . 或空格结尾
+        .replace(/[. ]+$/, "")
+        .trim();
+    if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\.|$)/i.test(out) ||
+        out.length > 120) {
+        out = out.replace(/^(con|prn|aux|nul|com[1-9]|lpt[1-9])/i, "_$1").slice(0, 120);
+    }
+    return out || fallback;
+}
+/**
+ * 同名文件去重：第二次出现起追加 `_2`、`_3`…
+ * 返回一个可复用的命名器，同一目录内共享才能跨画板/跨批次去重。
+ */
+export function createNamer() {
+    const used = new Map();
+    // 不区分大小写，避免 a.png / A.png 在 macOS/Windows 上互相覆盖
+    return (base, ext) => {
+        const key = `${base}.${ext}`.toLowerCase();
+        const n = (used.get(key) ?? 0) + 1;
+        used.set(key, n);
+        return n === 1 ? `${base}.${ext}` : `${base}_${n}.${ext}`;
+    };
+}
+//# sourceMappingURL=filename.js.map

package/dist/utils/filename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.js","sourceRoot":"","sources":["../../src/utils/filename.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAQ,GAAG,SAAS;IACjE,IAAI,GAAG,GAAG,IAAI;QACZ,2BAA2B;SAC1B,OAAO,CAAC,wBAAwB,EAAE,GAAG,CAAC;QACvC,0BAA0B;SACzB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,IAAI,EAAE,CAAC;IAEV,IACE,6CAA6C,CAAC,IAAI,CAAC,GAAG,CAAC;QACvD,GAAG,CAAC,MAAM,GAAG,GAAG,EAChB,CAAC;QACD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,GAAG,IAAI,QAAQ,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,gDAAgD;IAChD,OAAO,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE;QAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 版本号唯一来源。
+ *
+ * 修改版本时只改这里，然后执行 `npm run version:sync` 同步到 package.json。
+ * `npm test` 与 `prepublishOnly` 都会校验两处是否一致，防止漏同步。
+ */
+export declare const VERSION = "1.0.2";

package/dist/version.js

@@ -0,0 +1,8 @@
+/**
+ * 版本号唯一来源。
+ *
+ * 修改版本时只改这里，然后执行 `npm run version:sync` 同步到 package.json。
+ * `npm test` 与 `prepublishOnly` 都会校验两处是否一致，防止漏同步。
+ */
+export const VERSION = "1.0.2";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "codesign-mcp-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.2",
+  "description": "MCP server for Tencent CoDesign — read design specs, layer annotations, and download slices",
+  "type": "module",
+  "bin": {
+    "codesign-mcp-server": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/geniyangge/codesign-mcp-server.git"
+  },
+  "homepage": "https://github.com/geniyangge/codesign-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/geniyangge/codesign-mcp-server/issues"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "version:check": "node scripts/version.mjs",
+    "version:sync": "node scripts/version.mjs --sync",
+    "test": "npm run version:check && tsc -p tsconfig.test.json && node --test dist-test/test/*.test.js",
+    "prepublishOnly": "npm run version:check && npm run build"
+  },
+  "engines": {
+    "node": ">=18.17"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "codesign",
+    "design",
+    "figma-alternative"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}