figma-spec-mcp 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zafer Dace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# figma-spec-mcp
+
+![Version: 1.0.0-beta.1](https://img.shields.io/badge/version-1.0.0--beta.1-orange)
+![License: MIT](https://img.shields.io/badge/license-MIT-blue)
+![MCP Compatible](https://img.shields.io/badge/MCP-compatible-brightgreen)
+
+<p align="center">
+  <img src="assets/banner.png" alt="figma-spec-mcp — Bridge Figma to Game Engines" width="720" />
+</p>
+
+**Engineering-grade Figma specs for AI agents.** Layout audit, design tokens, accessibility checks, prototype flows, version diffs, and platform-ready mapping for Unity, React, SwiftUI, and more — all through MCP.
+
+Works with **any MCP-compatible client**: Claude Code, Claude Desktop, Cursor, VS Code + Copilot, Windsurf, Cline, Continue.dev, Zed.
+
+> **Security note:** Your Figma access token is passed as a tool argument. Never commit it to version control. Use environment variables or your AI client's secret management to supply it at runtime.
+
+---
+
+## Quick Start
+
+**1. Get a Figma access token**
+→ [figma.com/developers/api#access-tokens](https://www.figma.com/developers/api#access-tokens)
+
+**2. Add to your MCP config** (Claude Desktop, Cursor, VS Code, or any MCP client):
+```json
+{
+  "mcpServers": {
+    "figma-spec-mcp": {
+      "command": "npx",
+      "args": ["-y", "figma-spec-mcp@beta"]
+    }
+  }
+}
+```
+
+**3. Restart your AI client and use the tools.**
+
+Your file key is in the Figma URL: `figma.com/file/<FILE_KEY>/...`
+
+---
+
+## Why figma-spec-mcp?
+
+Most Figma MCP tools forward raw API responses. `figma-spec-mcp` adds stable envelopes, focused derivations, and reusable engineering outputs:
+
+- Deterministic JSON responses with a shared response envelope
+- Built-in disk cache with freshness metadata on every result
+- Source traceability for tokens, mappings, and extracted relationships
+- Platform-ready outputs for Unity, codebase mapping, and image export workflows
+
+---
+
+## Tools
+
+- `inspect_layout` — Inspects a Figma frame and returns hierarchy, layout structure, spacing, constraints, annotations, and basic accessibility warnings.
+- `extract_design_tokens` — Extracts color, typography, and spacing tokens from a Figma file and exports them as CSS variables, Style Dictionary JSON, or Tailwind config.
+- `map_to_unity` — Produces a Unity UGUI-oriented mapping with RectTransform data, layout groups, suggested components, notes, and warnings.
+- `resolve_components` — Resolves instance nodes to their backing component definitions and returns source file and source node references.
+- `extract_flows` — Extracts prototype transitions from a page or frame and returns directed flow connections plus a deterministic frame order.
+- `bridge_to_codebase` — Scans a local project and maps Figma component names to likely implementation files using filename heuristics.
+- `diff_versions` — Compares two Figma file versions and reports added, removed, and modified nodes.
+- `extract_variants` — Reads a component set and returns structured variant metadata, parsed properties, dimensions, layout details, fills, and typography.
+- `export_images` — Exports one or more Figma nodes as PNG, JPG, SVG, or PDF and returns the image URLs.
+- `audit_accessibility` — Audits a frame for accessibility issues such as contrast, touch targets, font size, missing alt text, and color-only distinctions.
+- `simplify_context` — Produces a token-efficient, LLM-oriented summary tree by collapsing wrappers, grouping repeated nodes, and truncating deep hierarchies.
+
+---
+
+## Features
+
+### v0.1 — Core
+- `inspect_layout`, `extract_design_tokens`, `map_to_unity`
+- Disk cache with SHA-256 keying and 1h TTL
+
+### v0.2 — Intelligence
+- Token name preservation from Figma styles
+- Depth-limited chunking for large files
+- Mixed/rich text runs extraction
+- Annotation extraction, framework-aware hints (Unity, React, SwiftUI, Web)
+
+### v0.3 — Workflows
+- `resolve_components` — multi-file component traversal
+- `extract_flows` — prototype flow graph
+- `bridge_to_codebase` — Figma → repo file matching
+- `diff_versions` — structured version diff
+- `extract_variants` — component set batch extraction
+
+### v0.4 — Quality & DX
+- `export_images` — PNG/JPG/SVG/PDF export
+- `audit_accessibility` — WCAG 2.1 contrast, touch targets, font size
+- `simplify_context` — AI-optimized, token-efficient output
+- Tool registry pattern for easy contribution
+- Rate limit handling (429 + Retry-After)
+
+---
+
+## Response Shape
+
+All 11 tools return a consistent top-level envelope:
+
+```json
+{
+  "schema_version": "0.1.0",
+  "source": { "file_key": "abc123", "node_id": "1:23" },
+  "freshness": {
+    "fresh": true,
+    "timestamp": "2026-03-26T10:00:00.000Z",
+    "ttl_ms": 3600000
+  },
+  "warnings": [],
+  "data": {}
+}
+```
+
+Tool-specific results live in `data`, and most tools also include low-level cache metadata there.
+
+---
+
+## Caching
+
+Responses are cached to disk (default: `$TMPDIR/figma-spec-mcp-cache/`) by file key and request shape with a 1-hour TTL. Cache metadata is included in responses:
+
+```json
+"cache": {
+  "cachedAt": "2026-03-26T10:00:00.000Z",
+  "expiresAt": "2026-03-26T11:00:00.000Z",
+  "fileVersion": "123456789",
+  "fresh": true
+}
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/zaferdace/figma-spec-mcp
+cd figma-spec-mcp
+npm install
+npm run build
+node dist/index.js
+```
+
+---
+
+## Roadmap
+
+- [ ] Export to React Native StyleSheet
+- [ ] Export to Flutter ThemeData
+- [ ] Semantic component detection (button/card/nav inference)
+- [ ] Webhook-triggered spec generation
+- [ ] Plugin API companion for live document access
+
+---
+
+## License
+
+MIT © Zafer Dace

package/dist/figma/client.d.ts

@@ -0,0 +1,53 @@
+import type { FigmaComponentResponse, FigmaFileResponse, FigmaNode } from "../types/figma.js";
+export interface CacheMetadata {
+    cachedAt: string;
+    expiresAt: string;
+    fileVersion: string;
+    fresh: boolean;
+}
+export interface CachedResult<T> {
+    data: T;
+    cache: CacheMetadata;
+}
+export interface FigmaClientOptions {
+    ttlMs?: number;
+    cacheDir?: string;
+    disableCache?: boolean;
+}
+export declare class FigmaRateLimitError extends Error {
+    readonly retryAfterMs: number;
+    constructor(retryAfterMs: number);
+}
+export declare class FigmaClient {
+    private readonly accessToken;
+    private readonly ttlMs;
+    private readonly cacheDir;
+    private readonly disableCache;
+    constructor(accessToken: string, options?: FigmaClientOptions);
+    private cacheKey;
+    private cachePath;
+    private getFileCacheKey;
+    private getFileNodesCacheKey;
+    private getImagesCacheKey;
+    private readCache;
+    private writeCache;
+    invalidateCache(fileKey: string, nodeId?: string): void;
+    private buildCacheMetadata;
+    private buildFreshMetadata;
+    private request;
+    private parseRetryAfterMs;
+    getFile(fileKey: string, version?: string): Promise<CachedResult<FigmaFileResponse>>;
+    getFileNodes(fileKey: string, nodeIds: string[], fileVersion?: string): Promise<CachedResult<{
+        nodes: Record<string, {
+            document: FigmaNode;
+        } | null>;
+    }>>;
+    getStyles(fileKey: string): Promise<CachedResult<{
+        styles: Record<string, unknown>;
+    }>>;
+    getComponent(componentKey: string): Promise<CachedResult<FigmaComponentResponse>>;
+    getImages(fileKey: string, nodeIds: string[], format: "png" | "jpg" | "svg" | "pdf", scale: number): Promise<CachedResult<{
+        images: Record<string, string | null>;
+    }>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/figma/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/figma/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAY9F,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,YAAY,EAAE,MAAM;CAKjC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAE3B,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAWjE,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,UAAU;IAYlB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAWvD,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;YAUZ,OAAO;IAoBrB,OAAO,CAAC,iBAAiB;IAkBnB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAgBpF,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,SAAS,CAAA;SAAE,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;IAqB7E,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAetF,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAejF,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EACrC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CAkBpE"}

package/dist/figma/client.js

@@ -0,0 +1,193 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+const FIGMA_API_BASE = "https://api.figma.com/v1";
+const DEFAULT_TTL_MS = 60 * 60 * 1000; // 1 hour
+export class FigmaRateLimitError extends Error {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        super(`Figma API rate limited. Retry after ${retryAfterMs}ms`);
+        this.name = "FigmaRateLimitError";
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class FigmaClient {
+    accessToken;
+    ttlMs;
+    cacheDir;
+    disableCache;
+    constructor(accessToken, options = {}) {
+        this.accessToken = accessToken;
+        this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+        this.cacheDir = options.cacheDir ?? join(tmpdir(), "figma-spec-cache");
+        this.disableCache = options.disableCache ?? false;
+        if (!this.disableCache) {
+            mkdirSync(this.cacheDir, { recursive: true });
+        }
+    }
+    cacheKey(parts) {
+        return createHash("sha256").update(parts.join("|")).digest("hex").slice(0, 16);
+    }
+    cachePath(key) {
+        return join(this.cacheDir, `${key}.json`);
+    }
+    getFileCacheKey(fileKey, version) {
+        return this.cacheKey([fileKey, "file", version ?? "latest"]);
+    }
+    getFileNodesCacheKey(fileKey, nodeIds, fileVersion) {
+        const sortedIds = [...nodeIds].sort();
+        return this.cacheKey([fileKey, ...sortedIds, fileVersion ?? "latest"]);
+    }
+    getImagesCacheKey(fileKey, nodeIds, format, scale) {
+        const sortedIds = [...nodeIds].sort();
+        return this.cacheKey([fileKey, "images", format, String(scale), ...sortedIds]);
+    }
+    readCache(key) {
+        if (this.disableCache)
+            return null;
+        const path = this.cachePath(key);
+        if (!existsSync(path))
+            return null;
+        try {
+            return JSON.parse(readFileSync(path, "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    writeCache(key, data, fileVersion) {
+        if (this.disableCache)
+            return;
+        const now = Date.now();
+        const entry = {
+            data,
+            cachedAt: now,
+            expiresAt: now + this.ttlMs,
+            fileVersion,
+        };
+        writeFileSync(this.cachePath(key), JSON.stringify(entry));
+    }
+    invalidateCache(fileKey, nodeId) {
+        if (this.disableCache)
+            return;
+        const key = nodeId ? this.getFileNodesCacheKey(fileKey, [nodeId]) : this.getFileCacheKey(fileKey);
+        const path = this.cachePath(key);
+        if (existsSync(path)) {
+            unlinkSync(path);
+        }
+    }
+    buildCacheMetadata(entry) {
+        return {
+            cachedAt: new Date(entry.cachedAt).toISOString(),
+            expiresAt: new Date(entry.expiresAt).toISOString(),
+            fileVersion: entry.fileVersion,
+            fresh: Date.now() < entry.expiresAt,
+        };
+    }
+    buildFreshMetadata(fileVersion) {
+        const now = Date.now();
+        return {
+            cachedAt: new Date(now).toISOString(),
+            expiresAt: new Date(now + this.ttlMs).toISOString(),
+            fileVersion,
+            fresh: true,
+        };
+    }
+    async request(path) {
+        const response = await fetch(`${FIGMA_API_BASE}${path}`, {
+            headers: { "X-Figma-Token": this.accessToken },
+        });
+        if (!response.ok) {
+            if (response.status === 429) {
+                const retryAfterHeader = response.headers.get("Retry-After");
+                const retryAfterMs = this.parseRetryAfterMs(retryAfterHeader);
+                throw new FigmaRateLimitError(retryAfterMs);
+            }
+            const body = await response.text();
+            const sanitized = body.replace(/figd_[A-Za-z0-9_-]+/g, "[REDACTED]");
+            throw new Error(`Figma API error ${response.status}: ${sanitized}`);
+        }
+        return response.json();
+    }
+    parseRetryAfterMs(retryAfterHeader) {
+        if (!retryAfterHeader) {
+            return 1000;
+        }
+        const seconds = Number(retryAfterHeader);
+        if (Number.isFinite(seconds) && seconds >= 0) {
+            return seconds * 1000;
+        }
+        const retryAt = Date.parse(retryAfterHeader);
+        if (!Number.isNaN(retryAt)) {
+            return Math.max(retryAt - Date.now(), 0);
+        }
+        return 1000;
+    }
+    async getFile(fileKey, version) {
+        const key = this.getFileCacheKey(fileKey, version);
+        const cached = this.readCache(key);
+        if (cached && Date.now() < cached.expiresAt) {
+            return { data: cached.data, cache: this.buildCacheMetadata(cached) };
+        }
+        const params = version ? `?version=${encodeURIComponent(version)}` : "";
+        const data = await this.request(`/files/${fileKey}${params}`);
+        this.writeCache(key, data, data.version);
+        const entry = this.readCache(key);
+        const cache = entry ? this.buildCacheMetadata(entry) : this.buildFreshMetadata(data.version);
+        return { data, cache };
+    }
+    async getFileNodes(fileKey, nodeIds, fileVersion) {
+        const key = this.getFileNodesCacheKey(fileKey, nodeIds, fileVersion);
+        const cached = this.readCache(key);
+        if (cached && Date.now() < cached.expiresAt) {
+            return { data: cached.data, cache: this.buildCacheMetadata(cached) };
+        }
+        const ids = nodeIds.join(",");
+        const versionParam = fileVersion ? `&version=${encodeURIComponent(fileVersion)}` : "";
+        const data = await this.request(`/files/${fileKey}/nodes?ids=${encodeURIComponent(ids)}${versionParam}`);
+        const version = fileVersion ?? "unknown";
+        this.writeCache(key, data, version);
+        const entry = this.readCache(key);
+        const cache = entry ? this.buildCacheMetadata(entry) : this.buildFreshMetadata(version);
+        return { data, cache };
+    }
+    async getStyles(fileKey) {
+        const key = this.cacheKey([fileKey, "styles"]);
+        const cached = this.readCache(key);
+        if (cached && Date.now() < cached.expiresAt) {
+            return { data: cached.data, cache: this.buildCacheMetadata(cached) };
+        }
+        const data = await this.request(`/files/${fileKey}/styles`);
+        this.writeCache(key, data, "unknown");
+        const entry = this.readCache(key);
+        const cache = entry ? this.buildCacheMetadata(entry) : this.buildFreshMetadata("unknown");
+        return { data, cache };
+    }
+    async getComponent(componentKey) {
+        const key = this.cacheKey(["component", componentKey]);
+        const cached = this.readCache(key);
+        if (cached && Date.now() < cached.expiresAt) {
+            return { data: cached.data, cache: this.buildCacheMetadata(cached) };
+        }
+        const data = await this.request(`/components/${componentKey}`);
+        this.writeCache(key, data, "unknown");
+        const entry = this.readCache(key);
+        const cache = entry ? this.buildCacheMetadata(entry) : this.buildFreshMetadata("unknown");
+        return { data, cache };
+    }
+    async getImages(fileKey, nodeIds, format, scale) {
+        const key = this.getImagesCacheKey(fileKey, nodeIds, format, scale);
+        const cached = this.readCache(key);
+        if (cached && Date.now() < cached.expiresAt) {
+            return { data: cached.data, cache: this.buildCacheMetadata(cached) };
+        }
+        const ids = nodeIds.join(",");
+        const data = await this.request(`/images/${fileKey}?ids=${encodeURIComponent(ids)}&format=${encodeURIComponent(format)}&scale=${encodeURIComponent(String(scale))}`);
+        this.writeCache(key, data, "unknown");
+        const entry = this.readCache(key);
+        const cache = entry ? this.buildCacheMetadata(entry) : this.buildFreshMetadata("unknown");
+        return { data, cache };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/figma/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "./tools/register-all.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { SERVER_VERSION } from "./shared.js";
+import "./tools/register-all.js";
+import { executeTool, getToolDefinitions } from "./tools/registry.js";
+const server = new Server({ name: "figma-spec-mcp", version: SERVER_VERSION }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+const tools = getToolDefinitions();
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        const result = await executeTool(name, args);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "ZodError") {
+            throw new Error(`Invalid input: ${error.message}`, { cause: error });
+        }
+        throw error;
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAEhH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1E,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;AAEnC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/shared.d.ts

@@ -0,0 +1,9 @@
+import type { CacheMetadata } from "./figma/client.js";
+export declare const SCHEMA_VERSION: "0.1.0";
+export declare const SERVER_VERSION = "1.0.0-beta.1";
+export declare function buildFreshness(cache: CacheMetadata): {
+    fresh: boolean;
+    timestamp: string;
+    ttl_ms: number;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAC;AAC/C,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAM1G"}

package/dist/shared.js

@@ -0,0 +1,10 @@
+export const SCHEMA_VERSION = "0.1.0";
+export const SERVER_VERSION = "1.0.0-beta.1";
+export function buildFreshness(cache) {
+    return {
+        fresh: cache.fresh,
+        timestamp: cache.cachedAt,
+        ttl_ms: new Date(cache.expiresAt).getTime() - new Date(cache.cachedAt).getTime(),
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAgB,CAAC;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;KACjF,CAAC;AACJ,CAAC"}

package/dist/tools/analyze-frame.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AnalyzeFrameInput, AnalyzeFrameResult } from "../types/tools.js";
+export declare const analyzeFrameSchema: z.ZodObject<{
+    file_key: z.ZodString;
+    node_id: z.ZodString;
+    access_token: z.ZodString;
+}, z.core.$strip>;
+export declare function analyzeFrame(input: AnalyzeFrameInput): Promise<AnalyzeFrameResult>;
+//# sourceMappingURL=analyze-frame.d.ts.map

package/dist/tools/analyze-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-frame.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAKnB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAmFH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0CxF"}

package/dist/tools/analyze-frame.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { FigmaClient } from "../figma/client.js";
+export const analyzeFrameSchema = z.object({
+    file_key: z.string().describe("The Figma file key (from the file URL)"),
+    node_id: z.string().describe("The node ID of the frame to analyze"),
+    access_token: z.string().describe("Your Figma personal access token"),
+});
+function collectComponents(node, results) {
+    const isComponent = node.type === "COMPONENT" || node.type === "COMPONENT_SET";
+    const isInstance = node.type === "INSTANCE";
+    if (isComponent || isInstance) {
+        results.push({
+            id: node.id,
+            name: node.name,
+            type: node.type,
+            isComponent,
+            isInstance,
+        });
+    }
+    node.children?.forEach((child) => collectComponents(child, results));
+}
+function collectLayouts(node, results) {
+    if (node.layoutMode && node.layoutMode !== "NONE") {
+        results[node.id] = {
+            mode: node.layoutMode === "HORIZONTAL" ? "horizontal" : "vertical",
+            primaryAxisAlign: node.primaryAxisAlignItems ?? "MIN",
+            counterAxisAlign: node.counterAxisAlignItems ?? "MIN",
+            padding: {
+                top: node.paddingTop ?? 0,
+                right: node.paddingRight ?? 0,
+                bottom: node.paddingBottom ?? 0,
+                left: node.paddingLeft ?? 0,
+            },
+            gap: node.itemSpacing ?? 0,
+            sizing: {
+                width: node.primaryAxisSizingMode === "AUTO" ? "hug" : "fixed",
+                height: node.counterAxisSizingMode === "AUTO" ? "hug" : "fixed",
+            },
+        };
+    }
+    node.children?.forEach((child) => collectLayouts(child, results));
+}
+function collectConstraints(node, results) {
+    if (node.constraints && node.absoluteBoundingBox) {
+        results[node.id] = {
+            horizontal: node.constraints.horizontal,
+            vertical: node.constraints.vertical,
+            bounds: node.absoluteBoundingBox,
+        };
+    }
+    node.children?.forEach((child) => collectConstraints(child, results));
+}
+function collectAccessibilityWarnings(node, warnings) {
+    if (node.type === "TEXT" && node.style) {
+        if (node.style.fontSize < 12) {
+            warnings.push({
+                nodeId: node.id,
+                nodeName: node.name,
+                severity: "warning",
+                message: `Text node "${node.name}" has a font size of ${node.style.fontSize}px, which may be too small for accessibility.`,
+            });
+        }
+    }
+    if (node.fills && node.fills.length === 0 && node.type === "FRAME") {
+        warnings.push({
+            nodeId: node.id,
+            nodeName: node.name,
+            severity: "info",
+            message: `Frame "${node.name}" has no background fill — ensure this is intentional.`,
+        });
+    }
+    node.children?.forEach((child) => collectAccessibilityWarnings(child, warnings));
+}
+function countNodesByType(node, counts) {
+    counts[node.type] = (counts[node.type] ?? 0) + 1;
+    node.children?.forEach((child) => countNodesByType(child, counts));
+}
+export async function analyzeFrame(input) {
+    const client = new FigmaClient(input.access_token);
+    const normalizedId = input.node_id.replace("-", ":");
+    const response = await client.getFileNodes(input.file_key, [normalizedId]);
+    const nodeData = response.nodes[normalizedId];
+    if (!nodeData) {
+        throw new Error(`Node "${input.node_id}" not found in file "${input.file_key}"`);
+    }
+    const frame = nodeData.document;
+    const components = [];
+    const layouts = {};
+    const constraints = {};
+    const accessibilityWarnings = [];
+    const typeCounts = {};
+    collectComponents(frame, components);
+    collectLayouts(frame, layouts);
+    collectConstraints(frame, constraints);
+    collectAccessibilityWarnings(frame, accessibilityWarnings);
+    countNodesByType(frame, typeCounts);
+    return {
+        frameId: frame.id,
+        frameName: frame.name,
+        dimensions: {
+            width: frame.absoluteBoundingBox?.width ?? 0,
+            height: frame.absoluteBoundingBox?.height ?? 0,
+        },
+        components,
+        layouts,
+        constraints,
+        accessibilityWarnings,
+        stats: {
+            totalNodes: Object.values(typeCounts).reduce((a, b) => a + b, 0),
+            componentCount: components.filter((c) => c.isComponent).length,
+            instanceCount: components.filter((c) => c.isInstance).length,
+            textNodeCount: typeCounts["TEXT"] ?? 0,
+            imageNodeCount: typeCounts["RECTANGLE"] ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=analyze-frame.js.map