@defai.digital/ax-cli 4.4.7 → 4.4.11

package/dist/design/figma-audit.js

@@ -1,383 +0,0 @@
-/**
- * Figma Design Audit
- *
- * Rule-based audit system for checking design consistency,
- * accessibility, and best practices.
- *
- * @module design/figma-audit
- */
-// =============================================================================
-// Generic Layer Naming Patterns
-// =============================================================================
-const GENERIC_NAMES = [
-    /^Frame \d+$/i,
-    /^Rectangle \d+$/i,
-    /^Ellipse \d+$/i,
-    /^Line \d+$/i,
-    /^Group \d+$/i,
-    /^Vector \d+$/i,
-    /^Text$/i,
-    /^Image \d*$/i,
-    /^Component \d+$/i,
-    /^Instance$/i,
-    /^Polygon \d+$/i,
-    /^Star \d+$/i,
-    /^Boolean \d+$/i,
-];
-// =============================================================================
-// Rule Implementations
-// =============================================================================
-/**
- * Check for generic layer names
- *
- * BUG FIX: Reset lastIndex before each regex test to handle global regexes safely.
- * Global regexes maintain lastIndex state between test() calls which can cause
- * flaky results when patterns are reused across multiple nodes.
- */
-function checkLayerNaming(node, _context, path) {
-    const issues = [];
-    // BUG FIX: Reset lastIndex to avoid stateful behavior with global regexes
-    const isGeneric = GENERIC_NAMES.some((pattern) => {
-        pattern.lastIndex = 0;
-        return pattern.test(node.name);
-    });
-    if (isGeneric) {
-        issues.push(createIssue('layer-naming', 'info', `Generic layer name "${node.name}" - consider using a descriptive name`, node, path, { suggestion: 'Rename to describe the layer\'s purpose (e.g., "Hero Section", "Primary Button")' }));
-    }
-    return issues;
-}
-/**
- * Check for missing auto-layout on frames with multiple children
- */
-function checkMissingAutoLayout(node, _context, path) {
-    const issues = [];
-    // Only check frames
-    if (node.type !== 'FRAME' && node.type !== 'COMPONENT') {
-        return issues;
-    }
-    // Check if it has children but no auto-layout
-    const childCount = node.children?.length ?? 0;
-    if (childCount >= 2 && !node.hasAutoLayout) {
-        issues.push(createIssue('missing-autolayout', 'info', `Frame "${node.name}" has ${childCount} children but no auto-layout`, node, path, { suggestion: 'Consider adding auto-layout for responsive design' }));
-    }
-    return issues;
-}
-/**
- * Check naming conventions
- */
-function checkNamingConvention(node, _context, path) {
-    const issues = [];
-    // Check components follow PascalCase
-    if (node.type === 'COMPONENT' || node.type === 'COMPONENT_SET') {
-        const isPascalCase = /^[A-Z][a-zA-Z0-9]*(\s[A-Z][a-zA-Z0-9]*)*$/.test(node.name);
-        if (!isPascalCase && !node.name.includes('/')) {
-            issues.push(createIssue('naming-convention', 'info', `Component "${node.name}" doesn't follow PascalCase naming`, node, path, { suggestion: 'Use PascalCase for components (e.g., "PrimaryButton", "Card Header")' }));
-        }
-    }
-    // Check for very short names (likely meaningless)
-    if (node.name.length === 1 && node.type !== 'TEXT') {
-        issues.push(createIssue('naming-convention', 'info', `Very short layer name "${node.name}" - likely needs more context`, node, path, { suggestion: 'Use descriptive names that explain the layer\'s purpose' }));
-    }
-    return issues;
-}
-/**
- * Check for potential text overflow issues
- */
-function checkTextOverflow(node, _context, path) {
-    const issues = [];
-    // Only check text nodes
-    if (node.type !== 'TEXT') {
-        return issues;
-    }
-    // Check for truncated text (indicated by ...)
-    if (node.characters && node.characters.endsWith('...')) {
-        issues.push(createIssue('text-overflow', 'warning', `Text "${node.name}" may be truncated`, node, path, {
-            suggestion: 'Check if text overflow is intentional or if container needs resizing',
-            actual: node.characters,
-        }));
-    }
-    return issues;
-}
-/**
- * Check component usage (prefer instances over detached)
- */
-function checkComponentUsage(node, _context, path) {
-    const issues = [];
-    // Check for frames that might be better as component instances
-    if (node.type === 'FRAME' && node.children) {
-        // Look for patterns that suggest this should be a component
-        const childNames = node.children.map((c) => c.name);
-        const hasButtonPattern = childNames.some((n) => /button|btn|cta/i.test(n));
-        const hasCardPattern = childNames.some((n) => /title|description|image|content/i.test(n));
-        if (hasButtonPattern || hasCardPattern) {
-            // Check if parent path suggests this is already a component
-            const isComponent = path.some((p) => /component|instance/i.test(p));
-            if (!isComponent && !node.componentKey) {
-                issues.push(createIssue('component-usage', 'info', `Frame "${node.name}" has common component patterns - consider making it a component`, node, path, { suggestion: 'Convert to component for reusability and consistency' }));
-            }
-        }
-    }
-    return issues;
-}
-/**
- * Check spacing consistency (basic check for common values)
- */
-function checkSpacingConsistency(_node, _context, _path) {
-    // This is a simplified check - full implementation would need
-    // actual spacing values from the Figma API
-    // For MVP, we just note frames without auto-layout padding
-    return [];
-}
-/**
- * Check font consistency
- */
-function checkFontConsistency(_node, _context, _path) {
-    // Font consistency requires style information from the API
-    // For MVP, this is a placeholder
-    return [];
-}
-/**
- * Check token usage
- */
-function checkTokenUsage(_node, _context, _path) {
-    // Token usage requires variable bindings from the API
-    // For MVP, this is a placeholder
-    return [];
-}
-/**
- * Check color contrast
- */
-function checkColorContrast(_node, _context, _path) {
-    // Color contrast requires color values from the API
-    // For MVP, this is a placeholder
-    return [];
-}
-/**
- * Check image resolution
- */
-function checkImageResolution(_node, _context, _path) {
-    // Image resolution requires image API calls
-    // Disabled by default
-    return [];
-}
-// =============================================================================
-// Rule Registry
-// =============================================================================
-const RULE_CHECKERS = {
-    'layer-naming': checkLayerNaming,
-    'missing-autolayout': checkMissingAutoLayout,
-    'naming-convention': checkNamingConvention,
-    'text-overflow': checkTextOverflow,
-    'component-usage': checkComponentUsage,
-    'spacing-consistency': checkSpacingConsistency,
-    'font-consistency': checkFontConsistency,
-    'token-usage': checkTokenUsage,
-    'color-contrast': checkColorContrast,
-    'image-resolution': checkImageResolution,
-};
-// =============================================================================
-// Helper Functions
-// =============================================================================
-function createIssue(ruleId, severity, message, node, path, extras = {}) {
-    return {
-        ruleId,
-        severity,
-        message,
-        location: {
-            nodeId: node.id,
-            nodeName: node.name,
-            nodePath: path.join(' > '),
-            nodeType: node.type,
-        },
-        ...extras,
-    };
-}
-function getEnabledRules(config) {
-    // Import DEFAULT_AUDIT_RULES at runtime to avoid circular deps
-    const defaultRules = [
-        { id: 'layer-naming', name: 'Layer Naming', description: 'Check for generic layer names', severity: 'info', category: 'naming', enabled: true },
-        { id: 'missing-autolayout', name: 'Missing Auto-Layout', description: 'Identify frames without auto-layout', severity: 'info', category: 'best-practices', enabled: true },
-        { id: 'naming-convention', name: 'Naming Convention', description: 'Check naming conventions', severity: 'info', category: 'naming', enabled: true },
-        { id: 'text-overflow', name: 'Text Overflow', description: 'Detect text overflow issues', severity: 'warning', category: 'best-practices', enabled: true },
-        { id: 'component-usage', name: 'Component Usage', description: 'Check component usage patterns', severity: 'info', category: 'best-practices', enabled: true },
-        { id: 'spacing-consistency', name: 'Spacing Consistency', description: 'Check spacing values', severity: 'warning', category: 'consistency', enabled: true },
-        { id: 'font-consistency', name: 'Font Consistency', description: 'Check font consistency', severity: 'warning', category: 'consistency', enabled: true },
-        { id: 'token-usage', name: 'Token Usage', description: 'Check token usage', severity: 'warning', category: 'consistency', enabled: true },
-        { id: 'color-contrast', name: 'Color Contrast', description: 'Check color contrast', severity: 'error', category: 'accessibility', enabled: true },
-        { id: 'image-resolution', name: 'Image Resolution', description: 'Check image resolution', severity: 'warning', category: 'performance', enabled: false },
-    ];
-    let rules = [...defaultRules];
-    // Filter to only requested rules
-    if (config.rules && config.rules.length > 0) {
-        rules = rules.filter((r) => config.rules.includes(r.id));
-    }
-    // Exclude specified rules
-    if (config.excludeRules && config.excludeRules.length > 0) {
-        rules = rules.filter((r) => !config.excludeRules.includes(r.id));
-    }
-    // Apply rule overrides
-    if (config.ruleConfig) {
-        rules = rules.map((rule) => {
-            const override = config.ruleConfig?.[rule.id];
-            if (override) {
-                return {
-                    ...rule,
-                    enabled: override.enabled ?? rule.enabled,
-                    severity: override.severity ?? rule.severity,
-                };
-            }
-            return rule;
-        });
-    }
-    // Return only enabled rules
-    return rules.filter((r) => r.enabled);
-}
-// =============================================================================
-// Main Audit Function
-// =============================================================================
-/**
- * Audit a Figma file/node for design issues
- */
-export function auditDesign(mapResult, config = {}) {
-    const startTime = Date.now();
-    const enabledRules = getEnabledRules(config);
-    const context = {
-        fileKey: mapResult.fileKey,
-        fileName: mapResult.fileName,
-        config,
-        rules: enabledRules,
-        issues: [],
-        nodesAudited: 0,
-        startTime,
-    };
-    // Traverse and audit
-    auditNode(mapResult.root, context, [], 0);
-    // Build summary
-    const issueCount = {
-        error: context.issues.filter((i) => i.severity === 'error').length,
-        warning: context.issues.filter((i) => i.severity === 'warning').length,
-        info: context.issues.filter((i) => i.severity === 'info').length,
-        total: context.issues.length,
-    };
-    const summary = {
-        totalNodes: mapResult.nodeCount,
-        nodesAudited: context.nodesAudited,
-        issueCount,
-        passRate: context.nodesAudited > 0
-            ? Math.round(((context.nodesAudited - issueCount.total) / context.nodesAudited) * 100 * 100) / 100
-            : 100,
-        rulesRun: enabledRules.map((r) => r.id),
-        duration: Date.now() - startTime,
-    };
-    return {
-        fileKey: mapResult.fileKey,
-        fileName: mapResult.fileName,
-        timestamp: new Date().toISOString(),
-        summary,
-        issues: context.issues,
-    };
-}
-/**
- * Recursively audit a node and its children
- */
-function auditNode(node, context, path, depth) {
-    // Check depth limit
-    if (context.config.maxDepth !== undefined && depth > context.config.maxDepth) {
-        return;
-    }
-    context.nodesAudited++;
-    const currentPath = [...path, node.name];
-    // Run each enabled rule
-    for (const rule of context.rules) {
-        const checker = RULE_CHECKERS[rule.id];
-        if (checker) {
-            const issues = checker(node, context, currentPath);
-            // Apply rule severity override
-            const processedIssues = issues.map((issue) => ({
-                ...issue,
-                severity: rule.severity, // Use rule's severity (may be overridden)
-            }));
-            context.issues.push(...processedIssues);
-        }
-    }
-    // Recurse into children
-    if (node.children) {
-        for (const child of node.children) {
-            auditNode(child, context, currentPath, depth + 1);
-        }
-    }
-}
-// =============================================================================
-// Output Formatting
-// =============================================================================
-/**
- * Format audit result for terminal display
- */
-export function formatAuditResult(result) {
-    const lines = [];
-    // Header
-    lines.push('Design Audit Report');
-    lines.push('===================');
-    lines.push(`File: ${result.fileName ?? result.fileKey}`);
-    lines.push(`Timestamp: ${result.timestamp}`);
-    lines.push('');
-    // Summary
-    lines.push('Summary');
-    lines.push('-------');
-    lines.push(`Nodes audited: ${result.summary.nodesAudited}/${result.summary.totalNodes}`);
-    lines.push(`Rules run: ${result.summary.rulesRun.length}`);
-    lines.push(`Duration: ${result.summary.duration}ms`);
-    lines.push('');
-    lines.push(`Issues: ${result.summary.issueCount.total}`);
-    lines.push(`  Errors: ${result.summary.issueCount.error}`);
-    lines.push(`  Warnings: ${result.summary.issueCount.warning}`);
-    lines.push(`  Info: ${result.summary.issueCount.info}`);
-    lines.push('');
-    lines.push(`Pass Rate: ${result.summary.passRate}%`);
-    lines.push('');
-    // Issues by severity
-    if (result.issues.length > 0) {
-        lines.push('Issues');
-        lines.push('------');
-        // Group by severity
-        const byRule = new Map();
-        for (const issue of result.issues) {
-            const existing = byRule.get(issue.ruleId) ?? [];
-            existing.push(issue);
-            byRule.set(issue.ruleId, existing);
-        }
-        for (const [ruleId, issues] of byRule) {
-            lines.push('');
-            lines.push(`[${ruleId}] (${issues.length} issue${issues.length === 1 ? '' : 's'})`);
-            for (const issue of issues.slice(0, 10)) {
-                const severityIcon = issue.severity === 'error' ? '✗' : issue.severity === 'warning' ? '!' : '•';
-                lines.push(`  ${severityIcon} ${issue.message}`);
-                lines.push(`    Path: ${issue.location.nodePath}`);
-                lines.push(`    Node ID: ${issue.location.nodeId}`);
-                if (issue.suggestion) {
-                    lines.push(`    Suggestion: ${issue.suggestion}`);
-                }
-            }
-            if (issues.length > 10) {
-                lines.push(`  ... and ${issues.length - 10} more`);
-            }
-        }
-    }
-    else {
-        lines.push('No issues found!');
-    }
-    return lines.join('\n');
-}
-/**
- * Format audit result as compact summary
- */
-export function formatAuditSummary(result) {
-    const { summary } = result;
-    const status = summary.issueCount.error > 0
-        ? 'FAILED'
-        : summary.issueCount.warning > 0
-            ? 'WARNINGS'
-            : 'PASSED';
-    return `[${status}] ${summary.nodesAudited} nodes, ${summary.issueCount.total} issues (${summary.issueCount.error} errors, ${summary.issueCount.warning} warnings, ${summary.issueCount.info} info) - ${summary.passRate}% pass rate`;
-}
-//# sourceMappingURL=figma-audit.js.map

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

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

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

@@ -1,131 +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 { type FigmaFileResponse, type FigmaNodesResponse, type FigmaVariablesResponse, type FigmaImagesResponse, type GetFileOptions, type GetImagesOptions } from '@defai.digital/ax-schemas';
-export interface FigmaClientConfig {
-    /** Figma API access token */
-    accessToken: string;
-    /** Base URL for Figma API (default: https://api.figma.com) */
-    baseUrl?: string;
-    /** Request timeout in ms (default: 30000) */
-    timeout?: number;
-    /** Enable response caching (default: true) */
-    cacheEnabled?: boolean;
-    /** Cache TTL in ms (default: 60000) */
-    cacheTtl?: number;
-}
-export interface FigmaApiError extends Error {
-    status: number;
-    endpoint: string;
-    figmaError?: string;
-}
-export declare class FigmaClient {
-    private readonly accessToken;
-    private readonly baseUrl;
-    private readonly timeout;
-    private readonly cache;
-    private readonly cacheEnabled;
-    private readonly rateLimiter;
-    constructor(config: FigmaClientConfig);
-    private request;
-    /**
-     * 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);
-     * ```
-     */
-    getFile(fileKey: string, options?: GetFileOptions): Promise<FigmaFileResponse>;
-    /**
-     * 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']);
-     * ```
-     */
-    getFileNodes(fileKey: string, nodeIds: string[]): Promise<FigmaNodesResponse>;
-    /**
-     * 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');
-     * ```
-     */
-    getLocalVariables(fileKey: string): Promise<FigmaVariablesResponse>;
-    /**
-     * 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 });
-     * ```
-     */
-    getImages(fileKey: string, nodeIds: string[], options?: GetImagesOptions): Promise<FigmaImagesResponse>;
-    /**
-     * Get file metadata without the full document tree
-     *
-     * @param fileKey - The file key from the Figma URL
-     * @returns Basic file info (name, lastModified, etc.)
-     */
-    getFileMetadata(fileKey: string): Promise<{
-        name: string;
-        lastModified: string;
-        version: string;
-        thumbnailUrl?: string;
-    }>;
-    /**
-     * Clear the response cache
-     */
-    clearCache(): void;
-    /**
-     * 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: string): void;
-}
-/**
- * Create a new Figma client instance
- */
-export declare function createFigmaClient(config: FigmaClientConfig): FigmaClient;
-/**
- * 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 declare function getFigmaClient(accessToken?: string): FigmaClient;
-/**
- * Reset the default client (useful for testing)
- */
-export declare function resetFigmaClient(): void;