@obra-studio/figma-console-mcp 1.32.0

package/dist/core/design-code-tools.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Design-Code Parity Checker & Documentation Generator
+ * MCP tools for comparing Figma design specs with code-side data
+ * and generating platform-agnostic component documentation.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FigmaAPI } from "./figma-api.js";
+import type { CompanyDocsContentEntry } from "./types/design-code.js";
+export { figmaRGBAToHex, normalizeColor, numericClose } from "./diff/property-compare.js";
+/** Calculate parity score from discrepancy counts */
+export declare function calculateParityScore(critical: number, major: number, minor: number, info: number): number;
+/** Split markdown by H2 headers for platforms that need chunking */
+export declare function chunkMarkdownByHeaders(markdown: string): Array<{
+    heading: string;
+    content: string;
+}>;
+/**
+ * Clean a raw Figma variant name like "Type=Image, Size=12" into "Image / 12".
+ * Extracts just the values from "Key=Value" pairs, joined by " / ".
+ */
+export declare function cleanVariantName(rawName: string): string;
+/** Structured content extracted from a Figma component description */
+interface ParsedDescription {
+    /** The main overview/summary text */
+    overview: string;
+    /** "When to Use" bullet points */
+    whenToUse: string[];
+    /** "When NOT to Use" bullet points */
+    whenNotToUse: string[];
+    /** Content guidelines sections (title text, description text, etc.) */
+    contentGuidelines: Array<{
+        heading: string;
+        items: string[];
+    }>;
+    /** Accessibility notes */
+    accessibilityNotes: string[];
+    /** Any remaining unclassified content */
+    additionalNotes: string[];
+}
+/**
+ * Parse a Figma component description into structured sections.
+ * Handles markdown-formatted descriptions with headers, bullet points, etc.
+ */
+export declare function parseComponentDescription(description: string): ParsedDescription;
+/** Color data collected from a specific variant */
+interface VariantColorData {
+    variantName: string;
+    fills: Array<{
+        hex: string;
+        nodeName: string;
+        variableId?: string;
+        variableName?: string;
+    }>;
+    strokes: Array<{
+        hex: string;
+        nodeName: string;
+        variableId?: string;
+        variableName?: string;
+    }>;
+    textColors: Array<{
+        hex: string;
+        nodeName: string;
+        variableId?: string;
+        variableName?: string;
+    }>;
+    icons: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+/** Typography data from a text node */
+interface TextStyleData {
+    nodeName: string;
+    fontFamily: string;
+    fontWeight: number;
+    fontWeightName: string;
+    fontSize: number;
+    lineHeight: number;
+    letterSpacing: number;
+    variableBindings?: Record<string, string>;
+}
+/**
+ * Collect color data from all variants in a COMPONENT_SET.
+ * For single COMPONENTs, returns data for just that component.
+ */
+export declare function collectAllVariantData(node: any, varNameMap: Map<string, string>): VariantColorData[];
+/**
+ * Collect typography data from all text nodes in a component tree.
+ */
+export declare function collectTypographyData(node: any, depth?: number, maxDepth?: number): TextStyleData[];
+/**
+ * Build an anatomy tree representation from a Figma node structure.
+ * Returns a formatted string showing the component's nested structure.
+ */
+export declare function buildAnatomyTree(node: any, depth?: number, maxDepth?: number): string;
+/**
+ * Resolve the node to use for visual/spacing/typography comparisons.
+ * COMPONENT_SET frames have container-level styling (Figma's purple dashed stroke,
+ * default cornerRadius: 5, organizational padding) that are NOT actual design specs.
+ * The real design properties live on the child COMPONENT variants.
+ * Returns the default variant (first child) for COMPONENT_SET, or the node itself otherwise.
+ */
+export declare function resolveVisualNode(node: any): any;
+/** Detect if a node name is a Figma variant pattern like "Variant=Default, State=Hover, Size=lg" */
+export declare function isVariantName(name: string): boolean;
+/** Sanitize a component name for use as a file path */
+export declare function sanitizeComponentName(name: string): string;
+/** Convert generated markdown into a CompanyDocsMCP-compatible content entry */
+export declare function toCompanyDocsEntry(markdown: string, componentName: string, figmaUrl: string, systemName?: string): CompanyDocsContentEntry;
+export declare function registerDesignCodeTools(server: McpServer, getFigmaAPI: () => Promise<FigmaAPI>, getCurrentUrl: () => string | null, variablesCache?: Map<string, {
+    data: any;
+    timestamp: number;
+}>, options?: {
+    isRemoteMode?: boolean;
+}, getDesktopConnector?: () => Promise<any>): void;
+//# sourceMappingURL=design-code-tools.d.ts.map

package/dist/core/design-code-tools.d.ts.map

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