@bilalba/fig-mcp 1.0.0

package/dist/decode-vector-network.js

@@ -0,0 +1,160 @@
+/**
+ * Decode and inspect vectorNetworkBlob format
+ */
+import { readFigFile } from "./parser/index.js";
+import { parseCanvasFig } from "./parser/kiwi-parser.js";
+const FILE_PATH = "/Users/billy/Downloads/AutoDevice (Copy).fig";
+// Test with different vectors:
+// Simple horizontal line (2 vertices, 1 segment)
+const SIMPLE_LINE_NODE = "457:1695"; // Size: 10 x 0
+// Complex polygon (8+ vertices)
+const COMPLEX_SHAPE_NODE = "457:1697"; // Size: 18 x 12
+// Rotated filled shape
+const ROTATED_NODE = "457:1682";
+async function decodeVectorNetwork() {
+    console.log("Reading .fig file...");
+    const archive = await readFigFile(FILE_PATH);
+    const parsed = parseCanvasFig(archive.canvasFig);
+    const nodeChanges = parsed.message["nodeChanges"];
+    const blobs = parsed.message["blobs"];
+    if (!blobs) {
+        console.log("No blobs found!");
+        return;
+    }
+    // Build node map
+    const nodeMap = new Map();
+    for (const change of nodeChanges) {
+        if (!change || typeof change !== "object")
+            continue;
+        const obj = change;
+        const guid = obj["guid"];
+        if (guid) {
+            nodeMap.set(`${guid.sessionID}:${guid.localID}`, obj);
+        }
+    }
+    for (const nodeId of [SIMPLE_LINE_NODE, COMPLEX_SHAPE_NODE, ROTATED_NODE]) {
+        console.log("\n" + "=".repeat(80));
+        console.log(`Decoding vectorNetwork for: ${nodeId}`);
+        console.log("=".repeat(80));
+        const node = nodeMap.get(nodeId);
+        if (!node) {
+            console.log("Node not found!");
+            continue;
+        }
+        console.log(`Type: ${node["type"]}, Name: ${node["name"]}`);
+        const size = node["size"];
+        console.log(`Size: ${size?.x} x ${size?.y}`);
+        const vectorData = node["vectorData"];
+        if (!vectorData || vectorData.vectorNetworkBlob === undefined) {
+            console.log("No vectorData.vectorNetworkBlob!");
+            continue;
+        }
+        console.log(`NormalizedSize: ${JSON.stringify(vectorData.normalizedSize)}`);
+        const blobIndex = vectorData.vectorNetworkBlob;
+        const blob = blobs[blobIndex];
+        if (!blob?.bytes) {
+            console.log("Blob not found!");
+            continue;
+        }
+        const bytes = blob.bytes;
+        console.log(`\nBlob size: ${bytes.length} bytes`);
+        console.log(`Raw bytes: [${Array.from(bytes.slice(0, 60)).join(", ")}...]`);
+        // Try to decode the structure
+        const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.length);
+        let offset = 0;
+        // Read counts (appears to be 4-byte little-endian integers)
+        const count1 = view.getUint32(offset, true);
+        offset += 4;
+        const count2 = view.getUint32(offset, true);
+        offset += 4;
+        const count3 = view.getUint32(offset, true);
+        offset += 4;
+        console.log(`\nStructure (assuming uint32 counts):`);
+        console.log(`  Count1 (vertices?): ${count1}`);
+        console.log(`  Count2 (segments?): ${count2}`);
+        console.log(`  Count3 (regions?): ${count3}`);
+        // For simple lines (2 vertices, 1 segment), try to read vertex data
+        if (count1 === 2 && count2 === 1) {
+            console.log(`\nSimple line detected! Attempting to read vertex positions...`);
+            // After the 3 counts (12 bytes), we should have vertex data
+            // Each vertex likely has: x (float), y (float), and possibly handle data
+            console.log(`\nRemaining bytes after counts: ${bytes.length - 12}`);
+            // Try reading as floats
+            console.log(`\nAttempting to read as floats starting at offset 12:`);
+            for (let i = 0; i < Math.min(8, (bytes.length - 12) / 4); i++) {
+                const f = view.getFloat32(12 + i * 4, true);
+                console.log(`  float[${i}] @ offset ${12 + i * 4}: ${f}`);
+            }
+        }
+        // For more complex shapes, try different interpretations
+        if (count1 > 2) {
+            console.log(`\nComplex shape with ${count1} vertices and ${count2} segments`);
+            // Try to find vertex positions
+            console.log(`\nAttempting to read vertex positions as floats:`);
+            const vertexStart = 12; // After the 3 counts
+            // Each vertex might be: x (4), y (4) = 8 bytes minimum
+            // Or with handles: x (4), y (4), handleMode (4), handleIn (8), handleOut (8) = 28+ bytes
+            const bytesPerVertex = (bytes.length - 12) / count1;
+            console.log(`Estimated bytes per vertex: ${bytesPerVertex.toFixed(1)}`);
+            // Read first few vertices assuming just x,y floats
+            console.log(`\nFirst 4 vertices (assuming x,y floats):`);
+            for (let v = 0; v < Math.min(4, count1); v++) {
+                const vOffset = vertexStart + v * 8;
+                if (vOffset + 8 <= bytes.length) {
+                    const x = view.getFloat32(vOffset, true);
+                    const y = view.getFloat32(vOffset + 4, true);
+                    console.log(`  Vertex ${v}: (${x.toFixed(4)}, ${y.toFixed(4)})`);
+                }
+            }
+        }
+        // Also decode the strokeGeometry/fillGeometry path commands for comparison
+        const strokeGeometry = node["strokeGeometry"];
+        const fillGeometry = node["fillGeometry"];
+        const geom = strokeGeometry?.[0] || fillGeometry?.[0];
+        if (geom?.commandsBlob !== undefined) {
+            const pathBlob = blobs[geom.commandsBlob];
+            if (pathBlob?.bytes) {
+                console.log(`\nPath commands blob (${pathBlob.bytes.length} bytes):`);
+                decodePathCommands(pathBlob.bytes);
+            }
+        }
+    }
+}
+function decodePathCommands(bytes) {
+    const cmdNames = {
+        0: "CLOSE",
+        1: "MOVE",
+        2: "LINE",
+        3: "QUAD",
+        4: "CUBIC",
+    };
+    const cmdArgCounts = {
+        0: 0, 1: 2, 2: 2, 3: 4, 4: 6,
+    };
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.length);
+    let offset = 0;
+    let cmdIndex = 0;
+    while (offset < bytes.length && cmdIndex < 20) {
+        const cmd = bytes[offset++];
+        const cmdName = cmdNames[cmd] || `UNKNOWN(${cmd})`;
+        const argCount = cmdArgCounts[cmd] ?? 0;
+        const args = [];
+        for (let i = 0; i < argCount && offset + 4 <= bytes.length; i++) {
+            args.push(view.getFloat32(offset, true));
+            offset += 4;
+        }
+        if (args.length > 0) {
+            const argStr = args.map(a => a.toFixed(4)).join(", ");
+            console.log(`  [${cmdIndex}] ${cmdName}: ${argStr}`);
+        }
+        else {
+            console.log(`  [${cmdIndex}] ${cmdName}`);
+        }
+        cmdIndex++;
+    }
+    if (offset < bytes.length) {
+        console.log(`  ... (${bytes.length - offset} more bytes)`);
+    }
+}
+decodeVectorNetwork().catch(console.error);
+//# sourceMappingURL=decode-vector-network.js.map

package/dist/decode-vector-network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-vector-network.js","sourceRoot":"","sources":["../src/decode-vector-network.ts"],"names":[],"mappings":"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"}

package/dist/experimental/paint-utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Paint handling utilities for SVG rendering
+ */
+import type { FigNode, Paint } from "../parser/types.js";
+/**
+ * Get paints array from a node (handles both 'fills'/'strokes' and 'fillPaints'/'strokePaints').
+ */
+export declare function getPaints(node: FigNode, key: "fills" | "strokes"): Paint[] | undefined;
+/**
+ * Get the first visible paint from an array.
+ */
+export declare function getVisiblePaint(paints: Paint[] | undefined): Paint | undefined;
+/**
+ * Convert a paint to a CSS color string.
+ * Returns undefined if the paint is not visible or not a solid color.
+ */
+export declare function paintToColor(paint: Paint | undefined): string | undefined;
+/**
+ * Normalize an image hash from various formats to a hex string.
+ * Handles: string, array of bytes, object with hash property, or object with numeric keys.
+ */
+export declare function normalizeImageHash(value: unknown): string | null;
+/**
+ * Extract image hash from a paint object.
+ */
+export declare function paintToImageHash(paint: Paint | undefined): string | null;
+/**
+ * Detect image format from binary data.
+ */
+export declare function detectImageFormat(data: Uint8Array): string;
+/**
+ * Get MIME type for image format.
+ */
+export declare function getMimeType(format: string): string;
+//# sourceMappingURL=paint-utils.d.ts.map

package/dist/experimental/paint-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-utils.d.ts","sourceRoot":"","sources":["../../src/experimental/paint-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,EAAE,GAAG,SAAS,CAItF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAG9E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkChE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAM1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/experimental/paint-utils.js

@@ -0,0 +1,105 @@
+/**
+ * Paint handling utilities for SVG rendering
+ */
+import { colorToCSS } from "../parser/layout-inference.js";
+/**
+ * Get paints array from a node (handles both 'fills'/'strokes' and 'fillPaints'/'strokePaints').
+ */
+export function getPaints(node, key) {
+    const record = node;
+    const paints = record[key] ?? record[key === "fills" ? "fillPaints" : "strokePaints"];
+    return Array.isArray(paints) ? paints : undefined;
+}
+/**
+ * Get the first visible paint from an array.
+ */
+export function getVisiblePaint(paints) {
+    if (!paints)
+        return undefined;
+    return paints.find((p) => p.visible !== false);
+}
+/**
+ * Convert a paint to a CSS color string.
+ * Returns undefined if the paint is not visible or not a solid color.
+ */
+export function paintToColor(paint) {
+    if (!paint || paint.visible === false || paint.type !== "SOLID" || !paint.color) {
+        return undefined;
+    }
+    const opacity = paint.opacity ?? 1;
+    const color = { ...paint.color, a: paint.color.a * opacity };
+    return colorToCSS(color);
+}
+/**
+ * Normalize an image hash from various formats to a hex string.
+ * Handles: string, array of bytes, object with hash property, or object with numeric keys.
+ */
+export function normalizeImageHash(value) {
+    if (!value)
+        return null;
+    if (typeof value === "string")
+        return value.toLowerCase();
+    if (Array.isArray(value) && value.length === 20) {
+        const bytes = value.filter((b) => typeof b === "number");
+        if (bytes.length === 20) {
+            return bytes.map((b) => b.toString(16).padStart(2, "0")).join("");
+        }
+    }
+    if (typeof value === "object") {
+        const obj = value;
+        if (obj["hash"] && typeof obj["hash"] === "object") {
+            const bytes = obj["hash"];
+            return Object.keys(bytes)
+                .filter((key) => /^\d+$/.test(key))
+                .sort((a, b) => Number(a) - Number(b))
+                .map((key) => bytes[key].toString(16).padStart(2, "0"))
+                .join("");
+        }
+        const hasByteKeys = Object.keys(obj).some((key) => /^\d+$/.test(key));
+        if (hasByteKeys) {
+            const bytes = obj;
+            return Object.keys(bytes)
+                .filter((key) => /^\d+$/.test(key))
+                .sort((a, b) => Number(a) - Number(b))
+                .map((key) => bytes[key].toString(16).padStart(2, "0"))
+                .join("");
+        }
+    }
+    return null;
+}
+/**
+ * Extract image hash from a paint object.
+ */
+export function paintToImageHash(paint) {
+    if (!paint)
+        return null;
+    const record = paint;
+    return normalizeImageHash(record["image"]) ?? normalizeImageHash(record["imageHash"]);
+}
+/**
+ * Detect image format from binary data.
+ */
+export function detectImageFormat(data) {
+    if (data[0] === 0xff && data[1] === 0xd8)
+        return "jpeg";
+    if (data[0] === 0x89 && data[1] === 0x50 && data[2] === 0x4e && data[3] === 0x47)
+        return "png";
+    if (data[0] === 0x47 && data[1] === 0x49 && data[2] === 0x46)
+        return "gif";
+    if (data[0] === 0x52 && data[1] === 0x49 && data[2] === 0x46 && data[3] === 0x46)
+        return "webp";
+    return "unknown";
+}
+/**
+ * Get MIME type for image format.
+ */
+export function getMimeType(format) {
+    switch (format) {
+        case "jpeg": return "image/jpeg";
+        case "png": return "image/png";
+        case "gif": return "image/gif";
+        case "webp": return "image/webp";
+        default: return "application/octet-stream";
+    }
+}
+//# sourceMappingURL=paint-utils.js.map

package/dist/experimental/paint-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-utils.js","sourceRoot":"","sources":["../../src/experimental/paint-utils.ts"],"names":[],"mappings":"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"}

package/dist/experimental/render-screen-v2.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Render Screen V2 - Improved vector rendering
+ *
+ * Key improvements over v1:
+ * 1. For stroked vectors: Use vectorNetworkBlob or normalizedSize to get centerline, NOT strokeGeometry
+ * 2. strokeGeometry contains pre-outlined stroke - only use as fallback
+ * 3. Proper transform composition for rotated/positioned vectors
+ * 4. Better detection of stroked vs filled vectors
+ * 5. Mask rendering support (isMask flag handling)
+ * 6. Image embedding support
+ * 7. Full text styling (font-style, letter-spacing, etc.)
+ */
+import type { FigmaNode } from "../parser/types.js";
+import type { BlobEntry, RenderScreenOptions, RenderScreenResult } from "./render-types.js";
+export type { RenderScreenOptions, RenderScreenResult } from "./render-types.js";
+/**
+ * Render a Figma node subtree to SVG.
+ *
+ * @param node - The root node to render
+ * @param images - Optional map of image hash -> image data for embedding
+ * @param blobs - Optional array of blob data for vector paths
+ * @param options - Rendering options
+ * @returns The rendered SVG and metadata
+ */
+export declare function renderScreenV2(node: FigmaNode, images?: Map<string, Uint8Array>, blobs?: BlobEntry[], options?: RenderScreenOptions): RenderScreenResult;
+/**
+ * Alias for backwards compatibility with V1 interface.
+ * V1 used: renderScreen(node, images, blobs, options)
+ * V2 uses: renderScreenV2(node, images, blobs, options)
+ */
+export declare const renderScreen: typeof renderScreenV2;
+//# sourceMappingURL=render-screen-v2.d.ts.map

package/dist/experimental/render-screen-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-screen-v2.d.ts","sourceRoot":"","sources":["../../src/experimental/render-screen-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAEV,SAAS,EAET,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAuB3B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAmXjF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,KAAK,CAAC,EAAE,SAAS,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA4CpB;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,uBAAiB,CAAC"}