/**
 * Map tokens tool for Figma-to-component workflow.
 *
 * Maps Figma design tokens to Storefront Next theme tokens in app.css with exact/fuzzy matching.
 *
 * @module tools/storefrontnext/figma/map-tokens
 */
import { z } from 'zod';
import type { McpTool } from '../../../../utils/index.js';
import type { Services } from '../../../../services.js';
export declare const mapTokensToThemeSchema: z.ZodObject<{
    figmaTokens: z.ZodArray<z.ZodObject<{
        name: z.ZodString;
        value: z.ZodString;
        type: z.ZodEnum<["color", "spacing", "radius", "opacity", "fontSize", "fontFamily", "other"]>;
        description: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        type: "color" | "fontFamily" | "fontSize" | "opacity" | "other" | "radius" | "spacing";
        name: string;
        value: string;
        description?: string | undefined;
    }, {
        type: "color" | "fontFamily" | "fontSize" | "opacity" | "other" | "radius" | "spacing";
        name: string;
        value: string;
        description?: string | undefined;
    }>, "many">;
    themeFilePath: z.ZodOptional<z.ZodString>;
}, "strict", z.ZodTypeAny, {
    figmaTokens: {
        type: "color" | "fontFamily" | "fontSize" | "opacity" | "other" | "radius" | "spacing";
        name: string;
        value: string;
        description?: string | undefined;
    }[];
    themeFilePath?: string | undefined;
}, {
    figmaTokens: {
        type: "color" | "fontFamily" | "fontSize" | "opacity" | "other" | "radius" | "spacing";
        name: string;
        value: string;
        description?: string | undefined;
    }[];
    themeFilePath?: string | undefined;
}>;
export type MapTokensToThemeInput = z.infer<typeof mapTokensToThemeSchema>;
/**
 * Maps Figma design tokens to existing theme tokens in app.css.
 *
 * @param args - Figma tokens array and optional theme file path
 * @param workspaceRoot - Optional workspace root for theme file discovery; used when themeFilePath is not provided
 * @returns Formatted mapping report with exact/fuzzy matches, confidence scores, and usage instructions, or error message on failure
 */
export declare function mapFigmaTokensToTheme(args: MapTokensToThemeInput, workspaceRoot?: string): string;
/**
 * Creates the sfnext_match_tokens_to_theme MCP tool.
 *
 * @param loadServices - Function that loads configuration and returns Services instance
 * @returns MCP tool for token mapping
 */
export declare function createMapTokensToThemeTool(loadServices: () => Promise<Services> | Services): McpTool;