@defai.digital/ax-cli 4.4.7 → 4.4.10

package/dist/design/figma-client.js

@@ -1,369 +0,0 @@
-/**
- * Figma REST API Client
- *
- * Provides a type-safe interface to the Figma REST API.
- * Includes caching, rate limiting, and error handling.
- *
- * @module design/figma-client
- */
-import { FigmaFileResponseSchema, FigmaNodesResponseSchema, FigmaVariablesResponseSchema, FigmaImagesResponseSchema, } from '@defai.digital/ax-schemas';
-// =============================================================================
-// Rate Limiter
-// =============================================================================
-/**
- * Simple rate limiter for Figma API (60 req/min for Professional)
- *
- * BUG FIX: Converted from recursive to iterative approach to prevent stack overflow
- * when rate limit is hit repeatedly. Also handles edge cases like clock skew.
- */
-class RateLimiter {
-    requests = [];
-    maxRequests;
-    windowMs;
-    maxWaitIterations;
-    constructor(maxRequests = 60, windowMs = 60000) {
-        this.maxRequests = maxRequests;
-        this.windowMs = windowMs;
-        // BUG FIX: Limit iterations to prevent infinite loops
-        this.maxWaitIterations = 100;
-    }
-    async waitForSlot() {
-        let iterations = 0;
-        // BUG FIX: Use iterative approach instead of recursion to prevent stack overflow
-        while (iterations < this.maxWaitIterations) {
-            iterations++;
-            const now = Date.now();
-            // Remove old requests outside the window
-            this.requests = this.requests.filter((t) => now - t < this.windowMs);
-            if (this.requests.length < this.maxRequests) {
-                // Slot available
-                this.requests.push(now);
-                return;
-            }
-            // Wait until oldest request expires
-            const oldestRequest = this.requests[0];
-            // BUG FIX: Handle edge case where oldest request is in the future (clock skew)
-            // or wait time would be negative
-            const waitTime = Math.max(0, this.windowMs - (now - oldestRequest)) + 100;
-            // BUG FIX: Cap wait time to prevent extremely long waits
-            const cappedWaitTime = Math.min(waitTime, this.windowMs);
-            await new Promise((resolve) => setTimeout(resolve, cappedWaitTime));
-        }
-        // BUG FIX: If max iterations reached, proceed anyway to avoid deadlock
-        // This shouldn't happen in normal operation but prevents infinite loops
-        console.warn('RateLimiter: Max wait iterations reached, proceeding anyway');
-        this.requests.push(Date.now());
-    }
-}
-// =============================================================================
-// Response Cache
-// =============================================================================
-class ResponseCache {
-    cache = new Map();
-    defaultTtl;
-    constructor(defaultTtl = 60000) {
-        this.defaultTtl = defaultTtl;
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        const now = Date.now();
-        if (now - entry.timestamp > entry.ttl) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        return entry.data;
-    }
-    set(key, data, ttl) {
-        this.cache.set(key, {
-            data,
-            timestamp: Date.now(),
-            ttl: ttl ?? this.defaultTtl,
-        });
-    }
-    delete(key) {
-        this.cache.delete(key);
-    }
-    /**
-     * Delete all cache entries that start with the given prefix
-     *
-     * BUG FIX: This properly clears all parameterized cache entries for a file.
-     * Before, invalidateFile only deleted exact key matches, missing entries
-     * like `/v1/files/abc:{"depth":2}` when trying to clear `/v1/files/abc`.
-     */
-    deleteByPrefix(prefix) {
-        let deleted = 0;
-        for (const key of this.cache.keys()) {
-            if (key.startsWith(prefix)) {
-                this.cache.delete(key);
-                deleted++;
-            }
-        }
-        return deleted;
-    }
-    clear() {
-        this.cache.clear();
-    }
-    /** Get cache key for a request */
-    static makeKey(endpoint, params) {
-        const paramStr = params ? JSON.stringify(params) : '';
-        return `${endpoint}:${paramStr}`;
-    }
-}
-// =============================================================================
-// Figma Client
-// =============================================================================
-export class FigmaClient {
-    accessToken;
-    baseUrl;
-    timeout;
-    cache;
-    cacheEnabled;
-    rateLimiter;
-    constructor(config) {
-        this.accessToken = config.accessToken;
-        this.baseUrl = config.baseUrl ?? 'https://api.figma.com';
-        this.timeout = config.timeout ?? 30000;
-        this.cacheEnabled = config.cacheEnabled ?? true;
-        this.cache = new ResponseCache(config.cacheTtl ?? 60000);
-        this.rateLimiter = new RateLimiter();
-    }
-    // ===========================================================================
-    // Core Request Method
-    // ===========================================================================
-    async request(endpoint, options) {
-        const { params, skipCache, cacheTtl } = options ?? {};
-        // Build URL with query params
-        const url = new URL(`${this.baseUrl}${endpoint}`);
-        if (params) {
-            Object.entries(params).forEach(([key, value]) => {
-                if (value !== undefined) {
-                    url.searchParams.set(key, String(value));
-                }
-            });
-        }
-        // Check cache
-        const cacheKey = ResponseCache.makeKey(endpoint, params);
-        if (this.cacheEnabled && !skipCache) {
-            const cached = this.cache.get(cacheKey);
-            if (cached) {
-                return cached;
-            }
-        }
-        // Rate limit
-        await this.rateLimiter.waitForSlot();
-        // Make request
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-        try {
-            const response = await fetch(url.toString(), {
-                method: 'GET',
-                headers: {
-                    'X-Figma-Token': this.accessToken,
-                    'Content-Type': 'application/json',
-                },
-                signal: controller.signal,
-            });
-            clearTimeout(timeoutId);
-            if (!response.ok) {
-                const errorBody = await response.text().catch(() => '');
-                const error = new Error(`Figma API error: ${response.statusText}`);
-                error.status = response.status;
-                error.endpoint = endpoint;
-                error.figmaError = errorBody;
-                throw error;
-            }
-            const data = await response.json();
-            // Cache response
-            if (this.cacheEnabled) {
-                this.cache.set(cacheKey, data, cacheTtl);
-            }
-            return data;
-        }
-        catch (error) {
-            clearTimeout(timeoutId);
-            if (error instanceof Error && error.name === 'AbortError') {
-                const timeoutError = new Error(`Figma API request timed out after ${this.timeout}ms`);
-                timeoutError.status = 408;
-                timeoutError.endpoint = endpoint;
-                throw timeoutError;
-            }
-            throw error;
-        }
-    }
-    // ===========================================================================
-    // Public API Methods
-    // ===========================================================================
-    /**
-     * Get a Figma file
-     *
-     * @param fileKey - The file key from the Figma URL
-     * @param options - Optional parameters (depth, geometry, etc.)
-     * @returns Validated FigmaFileResponse
-     *
-     * @example
-     * ```typescript
-     * const file = await client.getFile('abc123xyz', { depth: 2 });
-     * console.log(file.name);
-     * ```
-     */
-    async getFile(fileKey, options) {
-        const params = {
-            depth: options?.depth,
-            geometry: options?.geometry,
-            plugin_data: options?.plugin_data,
-            branch_data: options?.branch_data,
-        };
-        if (options?.version) {
-            params.version = options.version;
-        }
-        const response = await this.request(`/v1/files/${fileKey}`, { params });
-        return FigmaFileResponseSchema.parse(response);
-    }
-    /**
-     * Get specific nodes from a Figma file
-     *
-     * @param fileKey - The file key from the Figma URL
-     * @param nodeIds - Array of node IDs to fetch
-     * @returns Validated FigmaNodesResponse
-     *
-     * @example
-     * ```typescript
-     * const nodes = await client.getFileNodes('abc123xyz', ['1:2', '3:4']);
-     * ```
-     */
-    async getFileNodes(fileKey, nodeIds) {
-        const params = {
-            ids: nodeIds.join(','),
-        };
-        const response = await this.request(`/v1/files/${fileKey}/nodes`, { params });
-        return FigmaNodesResponseSchema.parse(response);
-    }
-    /**
-     * Get local variables (design tokens) from a Figma file
-     *
-     * @param fileKey - The file key from the Figma URL
-     * @returns Validated FigmaVariablesResponse
-     *
-     * @example
-     * ```typescript
-     * const variables = await client.getLocalVariables('abc123xyz');
-     * ```
-     */
-    async getLocalVariables(fileKey) {
-        const response = await this.request(`/v1/files/${fileKey}/variables/local`);
-        return FigmaVariablesResponseSchema.parse(response);
-    }
-    /**
-     * Get images for specific nodes
-     *
-     * @param fileKey - The file key from the Figma URL
-     * @param nodeIds - Array of node IDs to export
-     * @param options - Export options (scale, format)
-     * @returns Validated FigmaImagesResponse with URLs
-     *
-     * @example
-     * ```typescript
-     * const images = await client.getImages('abc123xyz', ['1:2'], { format: 'png', scale: 2 });
-     * ```
-     */
-    async getImages(fileKey, nodeIds, options) {
-        const params = {
-            ids: nodeIds.join(','),
-            scale: options?.scale,
-            format: options?.format,
-            svg_include_id: options?.svg_include_id,
-            svg_simplify_stroke: options?.svg_simplify_stroke,
-            use_absolute_bounds: options?.use_absolute_bounds,
-        };
-        const response = await this.request(`/v1/images/${fileKey}`, {
-            params,
-            skipCache: true, // Image URLs are time-limited
-        });
-        return FigmaImagesResponseSchema.parse(response);
-    }
-    /**
-     * Get file metadata without the full document tree
-     *
-     * @param fileKey - The file key from the Figma URL
-     * @returns Basic file info (name, lastModified, etc.)
-     */
-    async getFileMetadata(fileKey) {
-        // Use depth=0 to get minimal data
-        const response = await this.getFile(fileKey, { depth: 1 });
-        return {
-            name: response.name,
-            lastModified: response.lastModified,
-            version: response.version,
-            thumbnailUrl: response.thumbnailUrl,
-        };
-    }
-    // ===========================================================================
-    // Cache Management
-    // ===========================================================================
-    /**
-     * Clear the response cache
-     */
-    clearCache() {
-        this.cache.clear();
-    }
-    /**
-     * Invalidate cache for a specific file
-     *
-     * BUG FIX: Now uses prefix-based deletion to clear all parameterized entries.
-     * Before, this only deleted exact key matches, missing entries with query params
-     * like `getFile(key, {depth: 2})` which produces keys like `/v1/files/abc:{"depth":2}`.
-     */
-    invalidateFile(fileKey) {
-        // Clear all cached entries for this file (including parameterized variants)
-        this.cache.deleteByPrefix(`/v1/files/${fileKey}`);
-        this.cache.deleteByPrefix(`/v1/images/${fileKey}`);
-    }
-}
-// =============================================================================
-// Factory Functions
-// =============================================================================
-let defaultClient = null;
-let lastTokenUsed = null;
-/**
- * Create a new Figma client instance
- */
-export function createFigmaClient(config) {
-    return new FigmaClient(config);
-}
-/**
- * Get the default Figma client (creates one if needed)
- *
- * Uses FIGMA_ACCESS_TOKEN environment variable if no token provided.
- *
- * BUG FIX: The singleton now re-initializes if the access token changes.
- * This fixes unreliable behavior in interactive mode where the token might
- * be set after the initial client creation, or changed during the session.
- */
-export function getFigmaClient(accessToken) {
-    const token = accessToken ?? process.env.FIGMA_ACCESS_TOKEN;
-    if (!token) {
-        throw new Error('Figma access token required. Set FIGMA_ACCESS_TOKEN environment variable or pass token to createFigmaClient().');
-    }
-    // BUG FIX: Re-create client if token has changed
-    // This handles cases where:
-    // 1. Client was created with no token (would have thrown, but checking for completeness)
-    // 2. Environment variable was updated during the session
-    // 3. A different token is explicitly passed
-    if (defaultClient && lastTokenUsed === token) {
-        return defaultClient;
-    }
-    // Create new client with current token
-    defaultClient = createFigmaClient({ accessToken: token });
-    lastTokenUsed = token;
-    return defaultClient;
-}
-/**
- * Reset the default client (useful for testing)
- */
-export function resetFigmaClient() {
-    defaultClient = null;
-    lastTokenUsed = null;
-}
-//# sourceMappingURL=figma-client.js.map

package/dist/design/figma-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"figma-client.js","sourceRoot":"","sources":["../../src/design/figma-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,GAO1B,MAAM,2BAA2B,CAAC;AA+BnC,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,WAAW;IACP,QAAQ,GAAa,EAAE,CAAC;IACf,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,iBAAiB,CAAS;IAE3C,YAAY,WAAW,GAAG,EAAE,EAAE,QAAQ,GAAG,KAAK;QAC5C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,sDAAsD;QACtD,IAAI,CAAC,iBAAiB,GAAG,GAAG,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,iFAAiF;QACjF,OAAO,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3C,UAAU,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEvB,yCAAyC;YACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAErE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC5C,iBAAiB;gBACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;YAED,oCAAoC;YACpC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACvC,+EAA+E;YAC/E,iCAAiC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,CAAC;YAE1E,yDAAyD;YACzD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEzD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,uEAAuE;QACvE,wEAAwE;QACxE,OAAO,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;CACF;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,MAAM,aAAa;IACT,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtC,UAAU,CAAS;IAEpC,YAAY,UAAU,GAAG,KAAK;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,IAAS,CAAC;IACzB,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,GAAY;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,MAAc;QAC3B,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,kCAAkC;IAClC,MAAM,CAAC,OAAO,CAAC,QAAgB,EAAE,MAAgC;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;IACnC,CAAC;CACF;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,MAAM,OAAO,WAAW;IACL,WAAW,CAAS;IACpB,OAAO,CAAS;IAChB,OAAO,CAAS;IAChB,KAAK,CAAgB;IACrB,YAAY,CAAU;IACtB,WAAW,CAAc;IAE1C,YAAY,MAAyB;QACnC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,uBAAuB,CAAC;QACzD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACvC,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAEtE,KAAK,CAAC,OAAO,CACnB,QAAgB,EAChB,OAIC;QAED,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAEtD,8BAA8B;QAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,cAAc;QACd,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAI,QAAQ,CAAC,CAAC;YAC3C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,aAAa;QACb,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAErC,eAAe;QACf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC3C,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,eAAe,EAAE,IAAI,CAAC,WAAW;oBACjC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,UAAU,EAAE,CAAkB,CAAC;gBACpF,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAC/B,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC1B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC7B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,iBAAiB;YACjB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,IAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,OAAO,IAAI,CAAkB,CAAC;gBACvG,YAAY,CAAC,MAAM,GAAG,GAAG,CAAC;gBAC1B,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBACjC,MAAM,YAAY,CAAC;YACrB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,qBAAqB;IACrB,8EAA8E;IAE9E;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAwB;QACrD,MAAM,MAAM,GAA0D;YACpE,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,WAAW,EAAE,OAAO,EAAE,WAAW;SAClC,CAAC;QAEF,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAU,aAAa,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,OAAO,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,OAAiB;QACnD,MAAM,MAAM,GAAG;YACb,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;SACvB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAU,aAAa,OAAO,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,OAAO,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAU,aAAa,OAAO,kBAAkB,CAAC,CAAC;QACrF,OAAO,4BAA4B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,SAAS,CACb,OAAe,EACf,OAAiB,EACjB,OAA0B;QAE1B,MAAM,MAAM,GAA0D;YACpE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YACtB,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,cAAc,EAAE,OAAO,EAAE,cAAc;YACvC,mBAAmB,EAAE,OAAO,EAAE,mBAAmB;YACjD,mBAAmB,EAAE,OAAO,EAAE,mBAAmB;SAClD,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAU,cAAc,OAAO,EAAE,EAAE;YACpE,MAAM;YACN,SAAS,EAAE,IAAI,EAAE,8BAA8B;SAChD,CAAC,CAAC;QACH,OAAO,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe;QAMnC,kCAAkC;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,YAAY,EAAE,QAAQ,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,OAAe;QAC5B,4EAA4E;QAC5E,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,IAAI,aAAa,GAAuB,IAAI,CAAC;AAC7C,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,WAAoB;IACjD,MAAM,KAAK,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAE5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,4BAA4B;IAC5B,yFAAyF;IACzF,yDAAyD;IACzD,4CAA4C;IAC5C,IAAI,aAAa,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QAC7C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,uCAAuC;IACvC,aAAa,GAAG,iBAAiB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,aAAa,GAAG,KAAK,CAAC;IACtB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,aAAa,GAAG,IAAI,CAAC;IACrB,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/design/figma-map.d.ts

@@ -1,29 +0,0 @@
-/**
- * Figma File Mapping
- *
- * Converts Figma file structure to a human-readable/machine-readable format.
- *
- * @module design/figma-map
- */
-import type { FigmaFileResponse } from '@defai.digital/ax-schemas';
-import type { SimplifiedNode, MapResult, TreeDisplayOptions, MapOutputFormat } from './types.js';
-/**
- * Map a Figma file to a simplified structure
- */
-export declare function mapFigmaFile(response: FigmaFileResponse, fileKey: string, options?: TreeDisplayOptions): MapResult;
-/**
- * Format map result as string
- */
-export declare function formatMapResult(result: MapResult, format: MapOutputFormat, options?: TreeDisplayOptions): string;
-/**
- * Find a node by ID in the simplified tree
- */
-export declare function findNodeById(root: SimplifiedNode, nodeId: string): SimplifiedNode | null;
-/**
- * Find nodes matching a predicate
- */
-export declare function findNodes(root: SimplifiedNode, predicate: (node: SimplifiedNode) => boolean, limit?: number): SimplifiedNode[];
-/**
- * Get path to a node
- */
-export declare function getNodePath(root: SimplifiedNode, nodeId: string): string[] | null;