@sangheepark/figma-ds-mcp 0.2.6 → 0.2.8

package/dist/tools/pipeline-tools.js

@@ -234,13 +234,23 @@ function enrichSpec(traversal, mapping) {
                 node.style['line-height'] = `${Math.round(lh * 100)}%`;
             }
         }
+        // _ds_type 제거 (downstream 미소비 — build 전에 정리)
+        if ('_ds_type' in node) {
+            delete node['_ds_type'];
+        }
         // Step 6: CSS → Figma 정규화
-        // 6-pre: overflow:hidden → layout.clip-content 변환 (6-A 필터링 전에 처리)
-        if (node.style && node.style['overflow'] === 'hidden') {
+        // 6-pre: overflow → clip-content 변환 (style 또는 layout 어디에 있든 처리)
+        const styleOverflow = node.style && node.style['overflow'];
+        if (styleOverflow === 'hidden' || styleOverflow === 'scroll' || styleOverflow === 'auto') {
             node.layout = node.layout || {};
             node.layout['clip-content'] = true;
             delete node.style['overflow'];
         }
+        const layoutOverflow = node.layout && node.layout['overflow'];
+        if (layoutOverflow === 'hidden' || layoutOverflow === 'scroll' || layoutOverflow === 'auto') {
+            node.layout['clip-content'] = true;
+            delete node.layout['overflow'];
+        }
         // 6-A: CSS-only 속성 필터링 (Figma가 지원하지 않는 CSS 속성 제거)
         if (node.style) {
             for (const key of Object.keys(node.style)) {
@@ -249,6 +259,25 @@ function enrichSpec(traversal, mapping) {
                 }
             }
         }
+        // 6-A2: layout에서 CSS position 키 → Figma x/y 변환 후 non-layout 키 제거
+        if (node.layout) {
+            const lay = node.layout;
+            // CSS top/left → Figma y/x (absolute positioning만)
+            if (lay['positioning'] === 'absolute') {
+                if (lay['top'] !== undefined && lay['y'] === undefined) {
+                    lay['y'] = String(lay['top']);
+                }
+                if (lay['left'] !== undefined && lay['x'] === undefined) {
+                    lay['x'] = String(lay['left']);
+                }
+            }
+            // non-layout 키 제거 (top, bottom, left, right, aspect-ratio, overflow 잔존 등)
+            for (const key of Object.keys(lay)) {
+                if (!LAYOUT_KEYS.has(key)) {
+                    delete lay[key];
+                }
+            }
+        }
         // 6-B: direction 기본값 column (children 있는 frame/component에 direction 없으면)
         if ((node.type === 'frame' || node.type === 'component') && node.children && node.children.length > 0) {
             if (!node.layout?.direction) {
@@ -541,6 +570,53 @@ function extractRepeatComponents(spec, defaultCount = 3) {
     walk(page);
     return { page, components: Array.from(extracted.values()) };
 }
+function countNodes(node) {
+    let count = 1;
+    if (node.children) {
+        for (const child of node.children)
+            count += countNodes(child);
+    }
+    return count;
+}
+function splitSections(pageSpec, components, outputDir) {
+    mkdirSync(join(outputDir, 'components'), { recursive: true });
+    mkdirSync(join(outputDir, 'sections'), { recursive: true });
+    // Save components
+    const compEntries = [];
+    for (const comp of components) {
+        const name = comp.name || `Component_${compEntries.length}`;
+        const relPath = `components/${name}.json`;
+        writeFileSync(join(outputDir, relPath), JSON.stringify(comp, null, 2));
+        compEntries.push({ name, specPath: relPath, nodeCount: countNodes(comp) });
+    }
+    // Split page into sections: use _section markers or top-level children
+    const sectionEntries = [];
+    const rootLayout = { ...(pageSpec.layout || {}) };
+    const rootStyle = pageSpec.style ? { ...pageSpec.style } : undefined;
+    const pageName = pageSpec.name || 'Page';
+    if (pageSpec.children && pageSpec.children.length > 0) {
+        for (let i = 0; i < pageSpec.children.length; i++) {
+            const child = pageSpec.children[i];
+            const name = child.name || `Section_${i}`;
+            const relPath = `sections/${name}.json`;
+            writeFileSync(join(outputDir, relPath), JSON.stringify(child, null, 2));
+            sectionEntries.push({ name, specPath: relPath, nodeCount: countNodes(child), order: i });
+        }
+    }
+    let totalNodes = 1; // root
+    for (const c of compEntries)
+        totalNodes += c.nodeCount;
+    for (const s of sectionEntries)
+        totalNodes += s.nodeCount;
+    const manifest = {
+        page: { name: pageName, rootLayout, rootStyle },
+        components: compEntries,
+        sections: sectionEntries,
+        stats: { totalNodes, components: compEntries.length, sections: sectionEntries.length },
+    };
+    writeFileSync(join(outputDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+    return manifest;
+}
 // fontWeight name → CSS number (reverse of display names in data files)
 const FONT_WEIGHT_NAME_TO_NUM = {
     thin: '100', hairline: '100',
@@ -912,16 +988,28 @@ Run after validate_traversal. If outputPath is provided, spec is saved to file a
                 }],
         };
     });
+    // Helper: resolve traversals from either JSON param or file paths
+    function resolveTraversals(traversals, traversalPaths) {
+        if (traversalPaths && traversalPaths.length > 0) {
+            return traversalPaths.map(p => JSON.parse(readFileSync(p, 'utf-8')));
+        }
+        if (traversals && traversals.length > 0) {
+            return traversals;
+        }
+        throw new Error('Either traversals or traversalPaths must be provided');
+    }
     // generate_mapping — D5
     server.tool('generate_mapping', `Generate mapping.json from traversal JSON + blueprint data files. Zero LLM involvement.
 Reads *-component-sets.json and *-style.json from dataDir. Matches components (3-stage: exact → case-insensitive → word-split), tokens (HEX → variable), text styles (fontSize/fontWeight → style name).
 Saves result to outputPath. Replaces ds-data-lookup sub-agent.`, {
-        traversals: z.array(z.record(z.unknown())).describe('Array of traversal JSON root nodes'),
+        traversals: z.array(z.record(z.unknown())).optional().describe('Array of traversal JSON root nodes'),
+        traversalPaths: z.array(z.string()).optional().describe('File paths to traversal JSON files (alternative to traversals — avoids large param)'),
         dataDir: z.string().describe('Path to blueprint data directory (e.g., .claude/blueprint/data/)'),
         outputPath: z.string().describe('File path to save mapping.json'),
-    }, async ({ traversals, dataDir, outputPath }) => {
+    }, async ({ traversals, traversalPaths, dataDir, outputPath }) => {
         try {
-            const result = generateMapping(traversals, dataDir);
+            const tNodes = resolveTraversals(traversals, traversalPaths);
+            const result = generateMapping(tNodes, dataDir);
             mkdirSync(dirname(outputPath), { recursive: true });
             writeFileSync(outputPath, JSON.stringify(result, null, 2));
             // Summary for context (not the full mapping)
@@ -933,7 +1021,7 @@ Saves result to outputPath. Replaces ds-data-lookup sub-agent.`, {
                     allDs.add(node._ds);
                 node.children?.forEach(collectDs);
             }
-            traversals.forEach(collectDs);
+            tNodes.forEach(collectDs);
             const unmatchedDs = [];
             for (const ds of allDs) {
                 if (!matchedDs.has(ds) && !reviewDs.has(ds))
@@ -974,13 +1062,14 @@ Saves result to outputPath. Replaces ds-data-lookup sub-agent.`, {
     server.tool('run_pipeline', `Run the full spec pipeline: generate_mapping → validate → enrich → gate → tree in one call.
 Supports 2-pass pattern: Pass 1 returns reviewNeeded (ambiguous matches). Agent decides, then Pass 2 with resolutions auto-applies decisions.
 If no reviewNeeded, completes in 1 pass.`, {
-        traversals: z.array(z.record(z.unknown())).describe('Array of traversal JSON root nodes'),
+        traversals: z.array(z.record(z.unknown())).optional().describe('Array of traversal JSON root nodes'),
+        traversalPaths: z.array(z.string()).optional().describe('File paths to traversal JSON files (alternative to traversals — avoids large param)'),
         dataDir: z.string().describe('Path to blueprint data directory (e.g., .claude/blueprint/data/)'),
         outputPath: z.string().describe('File path to save spec.json (mapping.json saved alongside)'),
         resolutions: z.record(z.string()).optional().describe('Agent-decided mappings: { dsName: resolvedName }. Pass 2 only.'),
-    }, async ({ traversals, dataDir, outputPath, resolutions }) => {
+    }, async ({ traversals, traversalPaths, dataDir, outputPath, resolutions }) => {
         try {
-            let tNodes = traversals;
+            let tNodes = resolveTraversals(traversals, traversalPaths);
             // Step 0: Apply resolutions — replace _ds in traversal nodes
             if (resolutions && Object.keys(resolutions).length > 0) {
                 // Deep clone to avoid mutating input
@@ -1070,8 +1159,12 @@ If no reviewNeeded, completes in 1 pass.`, {
             // Step 3.5: Extract _repeat components
             // Components are placed before pages so builder creates them first
             const finalSpecs = [];
+            const allComponents = [];
+            const allPages = [];
             for (const spec of specs) {
                 const { page, components } = extractRepeatComponents(spec);
+                allComponents.push(...components);
+                allPages.push(page);
                 finalSpecs.push(...components, page);
             }
             // Step 4: Gate check each spec
@@ -1084,13 +1177,30 @@ If no reviewNeeded, completes in 1 pass.`, {
             mkdirSync(dirname(outputPath), { recursive: true });
             const trees = [];
             const allStats = [];
+            // Also produce manifest + section files for incremental build
+            const outputDir = dirname(outputPath);
+            const manifests = [];
+            if (allPages.length === 1) {
+                const manifest = splitSections(allPages[0], allComponents, outputDir);
+                manifests.push(manifest);
+            }
+            else {
+                for (let i = 0; i < allPages.length; i++) {
+                    const pageDir = join(outputDir, `page_${i}`);
+                    mkdirSync(pageDir, { recursive: true });
+                    const manifest = splitSections(allPages[i], allComponents, pageDir);
+                    manifests.push(manifest);
+                }
+                // Save combined manifest at root level
+                writeFileSync(join(outputDir, 'manifest.json'), JSON.stringify(manifests, null, 2));
+            }
+            // Save full specs (legacy format) alongside manifest
             if (finalSpecs.length === 1) {
                 writeFileSync(outputPath, JSON.stringify(finalSpecs[0], null, 2));
                 trees.push(specToTree(finalSpecs[0]));
                 allStats.push(countSpecNodes(finalSpecs[0]));
             }
             else {
-                // Multiple specs → save each with index
                 for (let i = 0; i < finalSpecs.length; i++) {
                     const specPath = outputPath.replace(/\.json$/, `_${i}.json`);
                     writeFileSync(specPath, JSON.stringify(finalSpecs[i], null, 2));
@@ -1118,7 +1228,9 @@ If no reviewNeeded, completes in 1 pass.`, {
                         text: JSON.stringify({
                             success: allGatesPass,
                             savedTo: outputPath,
+                            manifestSavedTo: join(outputDir, 'manifest.json'),
                             mappingSavedTo: mappingPath,
+                            manifest: manifests.length === 1 ? manifests[0] : manifests,
                             tree: trees.length === 1 ? trees[0] : trees,
                             stats: allStats.length === 1 ? allStats[0] : allStats,
                             gateResult: gateResults.length === 1 ? gateResults[0] : gateResults,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sangheepark/figma-ds-mcp",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "MCP server for Code to Figma Bridge — bridges Claude Code to Figma plugin via WebSocket",
   "type": "module",
   "main": "dist/index.js",