@mcp-consultant-tools/figma 1.0.0

package/build/FigmaService.d.ts

@@ -0,0 +1,47 @@
+import type { SimplifiedDesign } from "./figma/extractors/types.js";
+export interface FigmaConfig {
+    apiKey?: string;
+    oauthToken?: string;
+    useOAuth: boolean;
+}
+/**
+ * Service for interacting with the Figma API
+ * Follows the service pattern established by PowerPlatformService
+ */
+export declare class FigmaService {
+    private config;
+    private readonly baseUrl;
+    constructor(config: FigmaConfig);
+    /**
+     * Get authentication headers based on configuration
+     */
+    private getAuthHeaders;
+    /**
+     * Make an authenticated request to the Figma API
+     */
+    private request;
+    /**
+     * Get raw Figma API response for a file
+     * @param fileKey - The Figma file key from the URL
+     * @param depth - Optional depth limit for traversal
+     */
+    private getFigmaFile;
+    /**
+     * Get raw Figma API response for specific nodes
+     * @param fileKey - The Figma file key from the URL
+     * @param nodeIds - Array of node IDs to fetch
+     * @param depth - Optional depth limit for traversal
+     */
+    private getFigmaNodes;
+    /**
+     * Get comprehensive Figma design data in simplified, AI-friendly format
+     * This is the main method exposed to MCP tools
+     *
+     * @param fileKey - The Figma file key from the URL
+     * @param nodeId - Optional specific node ID(s) to fetch (format: "1:10" or "1:10;2:20")
+     * @param depth - Optional tree traversal depth limit
+     * @returns Simplified design data ready for AI consumption
+     */
+    getFigmaData(fileKey: string, nodeId?: string, depth?: number): Promise<SimplifiedDesign>;
+}
+//# sourceMappingURL=FigmaService.d.ts.map

package/build/FigmaService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FigmaService.d.ts","sourceRoot":"","sources":["../src/FigmaService.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,6BAA6B,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAE1C,MAAM,EAAE,WAAW;IAiB/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;YACW,OAAO;IAgBrB;;;;OAIG;YACW,YAAY;IAQ1B;;;;;OAKG;YACW,aAAa;IAc3B;;;;;;;;OAQG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;CA8B7B"}

package/build/FigmaService.js

@@ -0,0 +1,108 @@
+import { fetchWithRetry } from "./figma/utils/fetch-with-retry.js";
+import { simplifyRawFigmaObject } from "./figma/extractors/design-extractor.js";
+import { allExtractors } from "./figma/extractors/built-in.js";
+/**
+ * Service for interacting with the Figma API
+ * Follows the service pattern established by PowerPlatformService
+ */
+export class FigmaService {
+    config;
+    baseUrl = "https://api.figma.com/v1";
+    constructor(config) {
+        this.config = config;
+        // Validate configuration
+        if (!this.config.apiKey && !this.config.oauthToken) {
+            throw new Error("Figma configuration requires either apiKey or oauthToken");
+        }
+        if (this.config.useOAuth && !this.config.oauthToken) {
+            throw new Error("useOAuth is true but oauthToken is not provided");
+        }
+    }
+    /**
+     * Get authentication headers based on configuration
+     */
+    getAuthHeaders() {
+        if (this.config.useOAuth && this.config.oauthToken) {
+            console.error("Using OAuth Bearer token for authentication");
+            return { Authorization: `Bearer ${this.config.oauthToken}` };
+        }
+        else if (this.config.apiKey) {
+            console.error("Using Personal Access Token for authentication");
+            return { "X-Figma-Token": this.config.apiKey };
+        }
+        throw new Error("No valid authentication method configured");
+    }
+    /**
+     * Make an authenticated request to the Figma API
+     */
+    async request(endpoint) {
+        try {
+            console.error(`Calling ${this.baseUrl}${endpoint}`);
+            const headers = this.getAuthHeaders();
+            return await fetchWithRetry(`${this.baseUrl}${endpoint}`, {
+                headers,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to make request to Figma API endpoint '${endpoint}': ${errorMessage}`);
+        }
+    }
+    /**
+     * Get raw Figma API response for a file
+     * @param fileKey - The Figma file key from the URL
+     * @param depth - Optional depth limit for traversal
+     */
+    async getFigmaFile(fileKey, depth) {
+        const endpoint = `/files/${fileKey}${depth ? `?depth=${depth}` : ""}`;
+        console.error(`Retrieving Figma file: ${fileKey} (depth: ${depth ?? "default"})`);
+        const response = await this.request(endpoint);
+        return response;
+    }
+    /**
+     * Get raw Figma API response for specific nodes
+     * @param fileKey - The Figma file key from the URL
+     * @param nodeIds - Array of node IDs to fetch
+     * @param depth - Optional depth limit for traversal
+     */
+    async getFigmaNodes(fileKey, nodeIds, depth) {
+        const endpoint = `/files/${fileKey}/nodes?ids=${nodeIds.join(",")}${depth ? `&depth=${depth}` : ""}`;
+        console.error(`Retrieving Figma nodes: ${nodeIds.join(", ")} from ${fileKey} (depth: ${depth ?? "default"})`);
+        const response = await this.request(endpoint);
+        return response;
+    }
+    /**
+     * Get comprehensive Figma design data in simplified, AI-friendly format
+     * This is the main method exposed to MCP tools
+     *
+     * @param fileKey - The Figma file key from the URL
+     * @param nodeId - Optional specific node ID(s) to fetch (format: "1:10" or "1:10;2:20")
+     * @param depth - Optional tree traversal depth limit
+     * @returns Simplified design data ready for AI consumption
+     */
+    async getFigmaData(fileKey, nodeId, depth) {
+        try {
+            // Fetch raw data from Figma API
+            let rawData;
+            if (nodeId) {
+                // Parse node IDs (support both single and multiple, semicolon-separated)
+                const nodeIds = nodeId.split(";").map(id => id.trim()).filter(id => id.length > 0);
+                rawData = await this.getFigmaNodes(fileKey, nodeIds, depth);
+            }
+            else {
+                rawData = await this.getFigmaFile(fileKey, depth);
+            }
+            // Transform raw Figma data into simplified format using extractors
+            const options = {
+                maxDepth: depth,
+            };
+            const simplifiedData = simplifyRawFigmaObject(rawData, allExtractors, options);
+            return simplifiedData;
+        }
+        catch (error) {
+            console.error("Error fetching Figma data:", error);
+            throw new Error(`Failed to fetch Figma data: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=FigmaService.js.map

package/build/FigmaService.js.map

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

package/build/figma/extractors/built-in.d.ts

@@ -0,0 +1,57 @@
+import type { ExtractorFn, SimplifiedNode } from "./types.js";
+import type { Node as FigmaDocumentNode } from "@figma/rest-api-spec";
+/**
+ * Extracts layout-related properties from a node.
+ */
+export declare const layoutExtractor: ExtractorFn;
+/**
+ * Extracts text content and text styling from a node.
+ */
+export declare const textExtractor: ExtractorFn;
+/**
+ * Extracts visual appearance properties (fills, strokes, effects, opacity, border radius).
+ */
+export declare const visualsExtractor: ExtractorFn;
+/**
+ * Extracts component-related properties from INSTANCE nodes.
+ */
+export declare const componentExtractor: ExtractorFn;
+/**
+ * All extractors - replicates the current parseNode behavior.
+ */
+export declare const allExtractors: ExtractorFn[];
+/**
+ * Layout and text only - useful for content analysis and layout planning.
+ */
+export declare const layoutAndText: ExtractorFn[];
+/**
+ * Text content only - useful for content audits and copy extraction.
+ */
+export declare const contentOnly: ExtractorFn[];
+/**
+ * Visuals only - useful for design system analysis and style extraction.
+ */
+export declare const visualsOnly: ExtractorFn[];
+/**
+ * Layout only - useful for structure analysis.
+ */
+export declare const layoutOnly: ExtractorFn[];
+/**
+ * Node types that can be exported as SVG images.
+ * When a FRAME, GROUP, or INSTANCE contains only these types, we can collapse it to IMAGE-SVG.
+ * Note: FRAME/GROUP/INSTANCE are NOT included here—they're only eligible if collapsed to IMAGE-SVG.
+ */
+export declare const SVG_ELIGIBLE_TYPES: Set<string>;
+/**
+ * afterChildren callback that collapses SVG-heavy containers to IMAGE-SVG.
+ *
+ * If a FRAME, GROUP, or INSTANCE contains only SVG-eligible children, the parent
+ * is marked as IMAGE-SVG and children are omitted, reducing payload size.
+ *
+ * @param node - Original Figma node
+ * @param result - SimplifiedNode being built
+ * @param children - Processed children
+ * @returns Children to include (empty array if collapsed)
+ */
+export declare function collapseSvgContainers(node: FigmaDocumentNode, result: SimplifiedNode, children: SimplifiedNode[]): SimplifiedNode[];
+//# sourceMappingURL=built-in.d.ts.map

package/build/figma/extractors/built-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../../../src/figma/extractors/built-in.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAIX,cAAc,EACf,MAAM,YAAY,CAAC;AAYpB,OAAO,KAAK,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAsBtE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,WAK7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAoB3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WA0D9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAiBhC,CAAC;AAsBF;;GAEG;AACH,eAAO,MAAM,aAAa,eAAyE,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,aAAa,eAAmC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,WAAW,eAAkB,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,WAAW,eAAqB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,UAAU,eAAoB,CAAC;AAI5C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAO7B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EAAE,GACzB,cAAc,EAAE,CAgBlB"}

package/build/figma/extractors/built-in.js

@@ -0,0 +1,206 @@
+import { buildSimplifiedLayout } from "../transformers/layout.js";
+import { buildSimplifiedStrokes, parsePaint } from "../transformers/style.js";
+import { buildSimplifiedEffects } from "../transformers/effects.js";
+import { extractNodeText, extractTextStyle, hasTextStyle, isTextNode, } from "../transformers/text.js";
+import { hasValue, isRectangleCornerRadii } from "../utils/identity.js";
+import { generateVarId } from "../utils/common.js";
+/**
+ * Helper function to find or create a global variable.
+ */
+function findOrCreateVar(globalVars, value, prefix) {
+    // Check if the same value already exists
+    const [existingVarId] = Object.entries(globalVars.styles).find(([_, existingValue]) => JSON.stringify(existingValue) === JSON.stringify(value)) ?? [];
+    if (existingVarId) {
+        return existingVarId;
+    }
+    // Create a new variable if it doesn't exist
+    const varId = generateVarId(prefix);
+    globalVars.styles[varId] = value;
+    return varId;
+}
+/**
+ * Extracts layout-related properties from a node.
+ */
+export const layoutExtractor = (node, result, context) => {
+    const layout = buildSimplifiedLayout(node, context.parent);
+    if (Object.keys(layout).length > 1) {
+        result.layout = findOrCreateVar(context.globalVars, layout, "layout");
+    }
+};
+/**
+ * Extracts text content and text styling from a node.
+ */
+export const textExtractor = (node, result, context) => {
+    // Extract text content
+    if (isTextNode(node)) {
+        result.text = extractNodeText(node);
+    }
+    // Extract text style
+    if (hasTextStyle(node)) {
+        const textStyle = extractTextStyle(node);
+        if (textStyle) {
+            // Prefer Figma named style when available
+            const styleName = getStyleName(node, context, ["text", "typography"]);
+            if (styleName) {
+                context.globalVars.styles[styleName] = textStyle;
+                result.textStyle = styleName;
+            }
+            else {
+                result.textStyle = findOrCreateVar(context.globalVars, textStyle, "style");
+            }
+        }
+    }
+};
+/**
+ * Extracts visual appearance properties (fills, strokes, effects, opacity, border radius).
+ */
+export const visualsExtractor = (node, result, context) => {
+    // Check if node has children to determine CSS properties
+    const hasChildren = hasValue("children", node) && Array.isArray(node.children) && node.children.length > 0;
+    // fills
+    if (hasValue("fills", node) && Array.isArray(node.fills) && node.fills.length) {
+        const fills = node.fills.map((fill) => parsePaint(fill, hasChildren)).reverse();
+        const styleName = getStyleName(node, context, ["fill", "fills"]);
+        if (styleName) {
+            context.globalVars.styles[styleName] = fills;
+            result.fills = styleName;
+        }
+        else {
+            result.fills = findOrCreateVar(context.globalVars, fills, "fill");
+        }
+    }
+    // strokes
+    const strokes = buildSimplifiedStrokes(node, hasChildren);
+    if (strokes.colors.length) {
+        const styleName = getStyleName(node, context, ["stroke", "strokes"]);
+        if (styleName) {
+            // Only colors are stylable; keep other stroke props on the node
+            context.globalVars.styles[styleName] = strokes.colors;
+            result.strokes = styleName;
+            if (strokes.strokeWeight)
+                result.strokeWeight = strokes.strokeWeight;
+            if (strokes.strokeDashes)
+                result.strokeDashes = strokes.strokeDashes;
+            if (strokes.strokeWeights)
+                result.strokeWeights = strokes.strokeWeights;
+        }
+        else {
+            result.strokes = findOrCreateVar(context.globalVars, strokes, "stroke");
+        }
+    }
+    // effects
+    const effects = buildSimplifiedEffects(node);
+    if (Object.keys(effects).length) {
+        const styleName = getStyleName(node, context, ["effect", "effects"]);
+        if (styleName) {
+            // Effects styles store only the effect values
+            context.globalVars.styles[styleName] = effects;
+            result.effects = styleName;
+        }
+        else {
+            result.effects = findOrCreateVar(context.globalVars, effects, "effect");
+        }
+    }
+    // opacity
+    if (hasValue("opacity", node) && typeof node.opacity === "number" && node.opacity !== 1) {
+        result.opacity = node.opacity;
+    }
+    // border radius
+    if (hasValue("cornerRadius", node) && typeof node.cornerRadius === "number") {
+        result.borderRadius = `${node.cornerRadius}px`;
+    }
+    if (hasValue("rectangleCornerRadii", node, isRectangleCornerRadii)) {
+        result.borderRadius = `${node.rectangleCornerRadii[0]}px ${node.rectangleCornerRadii[1]}px ${node.rectangleCornerRadii[2]}px ${node.rectangleCornerRadii[3]}px`;
+    }
+};
+/**
+ * Extracts component-related properties from INSTANCE nodes.
+ */
+export const componentExtractor = (node, result, _context) => {
+    if (node.type === "INSTANCE") {
+        if (hasValue("componentId", node)) {
+            result.componentId = node.componentId;
+        }
+        // Add specific properties for instances of components
+        if (hasValue("componentProperties", node)) {
+            result.componentProperties = Object.entries(node.componentProperties ?? {}).map(([name, { value, type }]) => ({
+                name,
+                value: value.toString(),
+                type,
+            }));
+        }
+    }
+};
+// Helper to fetch a Figma style name for specific style keys on a node
+function getStyleName(node, context, keys) {
+    if (!hasValue("styles", node))
+        return undefined;
+    const styleMap = node.styles;
+    for (const key of keys) {
+        const styleId = styleMap[key];
+        if (styleId) {
+            const meta = context.globalVars.extraStyles?.[styleId];
+            if (meta?.name)
+                return meta.name;
+        }
+    }
+    return undefined;
+}
+// -------------------- CONVENIENCE COMBINATIONS --------------------
+/**
+ * All extractors - replicates the current parseNode behavior.
+ */
+export const allExtractors = [layoutExtractor, textExtractor, visualsExtractor, componentExtractor];
+/**
+ * Layout and text only - useful for content analysis and layout planning.
+ */
+export const layoutAndText = [layoutExtractor, textExtractor];
+/**
+ * Text content only - useful for content audits and copy extraction.
+ */
+export const contentOnly = [textExtractor];
+/**
+ * Visuals only - useful for design system analysis and style extraction.
+ */
+export const visualsOnly = [visualsExtractor];
+/**
+ * Layout only - useful for structure analysis.
+ */
+export const layoutOnly = [layoutExtractor];
+// -------------------- AFTER CHILDREN HELPERS --------------------
+/**
+ * Node types that can be exported as SVG images.
+ * When a FRAME, GROUP, or INSTANCE contains only these types, we can collapse it to IMAGE-SVG.
+ * Note: FRAME/GROUP/INSTANCE are NOT included here—they're only eligible if collapsed to IMAGE-SVG.
+ */
+export const SVG_ELIGIBLE_TYPES = new Set([
+    "IMAGE-SVG", // VECTOR nodes are converted to IMAGE-SVG, or containers that were collapsed
+    "STAR",
+    "LINE",
+    "ELLIPSE",
+    "REGULAR_POLYGON",
+    "RECTANGLE",
+]);
+/**
+ * afterChildren callback that collapses SVG-heavy containers to IMAGE-SVG.
+ *
+ * If a FRAME, GROUP, or INSTANCE contains only SVG-eligible children, the parent
+ * is marked as IMAGE-SVG and children are omitted, reducing payload size.
+ *
+ * @param node - Original Figma node
+ * @param result - SimplifiedNode being built
+ * @param children - Processed children
+ * @returns Children to include (empty array if collapsed)
+ */
+export function collapseSvgContainers(node, result, children) {
+    const allChildrenAreSvgEligible = children.every((child) => SVG_ELIGIBLE_TYPES.has(child.type));
+    if ((node.type === "FRAME" || node.type === "GROUP" || node.type === "INSTANCE") &&
+        allChildrenAreSvgEligible) {
+        // Collapse to IMAGE-SVG and omit children
+        result.type = "IMAGE-SVG";
+        return [];
+    }
+    // Include all children normally
+    return children;
+}
+//# sourceMappingURL=built-in.js.map

package/build/figma/extractors/built-in.js.map

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

package/build/figma/extractors/design-extractor.d.ts

@@ -0,0 +1,7 @@
+import type { GetFileResponse, GetFileNodesResponse } from "@figma/rest-api-spec";
+import type { ExtractorFn, TraversalOptions, SimplifiedDesign } from "./types.js";
+/**
+ * Extract a complete SimplifiedDesign from raw Figma API response using extractors.
+ */
+export declare function simplifyRawFigmaObject(apiResponse: GetFileResponse | GetFileNodesResponse, nodeExtractors: ExtractorFn[], options?: TraversalOptions): SimplifiedDesign;
+//# sourceMappingURL=design-extractor.d.ts.map

package/build/figma/extractors/design-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-extractor.d.ts","sourceRoot":"","sources":["../../../src/figma/extractors/design-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAKrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAGpG;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,eAAe,GAAG,oBAAoB,EACnD,cAAc,EAAE,WAAW,EAAE,EAC7B,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAsBlB"}

package/build/figma/extractors/design-extractor.js

@@ -0,0 +1,66 @@
+import { simplifyComponents, simplifyComponentSets } from "../transformers/component.js";
+import { isVisible } from "../utils/common.js";
+import { extractFromDesign } from "./node-walker.js";
+/**
+ * Extract a complete SimplifiedDesign from raw Figma API response using extractors.
+ */
+export function simplifyRawFigmaObject(apiResponse, nodeExtractors, options = {}) {
+    // Extract components, componentSets, and raw nodes from API response
+    const { metadata, rawNodes, components, componentSets, extraStyles } = parseAPIResponse(apiResponse);
+    // Process nodes using the flexible extractor system
+    const globalVars = { styles: {}, extraStyles };
+    const { nodes: extractedNodes, globalVars: finalGlobalVars } = extractFromDesign(rawNodes, nodeExtractors, options, globalVars);
+    // Return complete design
+    return {
+        ...metadata,
+        nodes: extractedNodes,
+        components: simplifyComponents(components),
+        componentSets: simplifyComponentSets(componentSets),
+        globalVars: { styles: finalGlobalVars.styles },
+    };
+}
+/**
+ * Parse the raw Figma API response to extract metadata, nodes, and components.
+ */
+function parseAPIResponse(data) {
+    const aggregatedComponents = {};
+    const aggregatedComponentSets = {};
+    let extraStyles = {};
+    let nodesToParse;
+    if ("nodes" in data) {
+        // GetFileNodesResponse
+        const nodeResponses = Object.values(data.nodes);
+        nodeResponses.forEach((nodeResponse) => {
+            if (nodeResponse.components) {
+                Object.assign(aggregatedComponents, nodeResponse.components);
+            }
+            if (nodeResponse.componentSets) {
+                Object.assign(aggregatedComponentSets, nodeResponse.componentSets);
+            }
+            if (nodeResponse.styles) {
+                Object.assign(extraStyles, nodeResponse.styles);
+            }
+        });
+        nodesToParse = nodeResponses.map((n) => n.document).filter(isVisible);
+    }
+    else {
+        // GetFileResponse
+        Object.assign(aggregatedComponents, data.components);
+        Object.assign(aggregatedComponentSets, data.componentSets);
+        if (data.styles) {
+            extraStyles = data.styles;
+        }
+        nodesToParse = data.document.children.filter(isVisible);
+    }
+    const { name } = data;
+    return {
+        metadata: {
+            name,
+        },
+        rawNodes: nodesToParse,
+        extraStyles,
+        components: aggregatedComponents,
+        componentSets: aggregatedComponentSets,
+    };
+}
+//# sourceMappingURL=design-extractor.js.map

package/build/figma/extractors/design-extractor.js.map

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

package/build/figma/extractors/index.d.ts

@@ -0,0 +1,5 @@
+export type { ExtractorFn, TraversalContext, TraversalOptions, GlobalVars, StyleTypes, } from "./types.js";
+export { extractFromDesign } from "./node-walker.js";
+export { simplifyRawFigmaObject } from "./design-extractor.js";
+export { layoutExtractor, textExtractor, visualsExtractor, componentExtractor, allExtractors, layoutAndText, contentOnly, visualsOnly, layoutOnly, collapseSvgContainers, SVG_ELIGIBLE_TYPES, } from "./built-in.js";
+//# sourceMappingURL=index.d.ts.map

package/build/figma/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/figma/extractors/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAElB,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EAEV,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/build/figma/extractors/index.js

@@ -0,0 +1,11 @@
+// Core traversal function
+export { extractFromDesign } from "./node-walker.js";
+// Design-level extraction (unified nodes + components)
+export { simplifyRawFigmaObject } from "./design-extractor.js";
+// Built-in extractors and afterChildren helpers
+export { layoutExtractor, textExtractor, visualsExtractor, componentExtractor, 
+// Convenience combinations
+allExtractors, layoutAndText, contentOnly, visualsOnly, layoutOnly, 
+// afterChildren helpers
+collapseSvgContainers, SVG_ELIGIBLE_TYPES, } from "./built-in.js";
+//# sourceMappingURL=index.js.map

package/build/figma/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/figma/extractors/index.ts"],"names":[],"mappings":"AASA,0BAA0B;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,uDAAuD;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,gDAAgD;AAChD,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB;AAClB,2BAA2B;AAC3B,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU;AACV,wBAAwB;AACxB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/build/figma/extractors/node-walker.d.ts

@@ -0,0 +1,16 @@
+import type { Node as FigmaDocumentNode } from "@figma/rest-api-spec";
+import type { ExtractorFn, TraversalOptions, GlobalVars, SimplifiedNode } from "./types.js";
+/**
+ * Extract data from Figma nodes using a flexible, single-pass approach.
+ *
+ * @param nodes - The Figma nodes to process
+ * @param extractors - Array of extractor functions to apply during traversal
+ * @param options - Traversal options (filtering, depth limits, etc.)
+ * @param globalVars - Global variables for style deduplication
+ * @returns Object containing processed nodes and updated global variables
+ */
+export declare function extractFromDesign(nodes: FigmaDocumentNode[], extractors: ExtractorFn[], options?: TraversalOptions, globalVars?: GlobalVars): {
+    nodes: SimplifiedNode[];
+    globalVars: GlobalVars;
+};
+//# sourceMappingURL=node-walker.d.ts.map

package/build/figma/extractors/node-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-walker.d.ts","sourceRoot":"","sources":["../../../src/figma/extractors/node-walker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAChB,UAAU,EACV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,UAAU,EAAE,WAAW,EAAE,EACzB,OAAO,GAAE,gBAAqB,EAC9B,UAAU,GAAE,UAA2B,GACtC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAerD"}