@defai.digital/ax-cli 3.14.9 → 3.14.11

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

@@ -0,0 +1,88 @@
+/**
+ * Figma Alias System
+ *
+ * Maps human-readable names to Figma file keys and node IDs.
+ * Stored in .ax-cli/design.json
+ *
+ * @module design/figma-alias
+ */
+import { type DesignConfig, type AliasTarget, type AliasOperationResult, type ResolvedAlias, type AliasListEntry, type AliasListResponse } from '@ax-cli/schemas';
+/**
+ * Get the path to the design config file
+ */
+export declare function getDesignConfigPath(basePath?: string): string;
+/**
+ * Load the design config from disk
+ */
+export declare function loadDesignConfig(basePath?: string): DesignConfig;
+/**
+ * Save the design config to disk
+ */
+export declare function saveDesignConfig(config: DesignConfig, basePath?: string): void;
+/**
+ * Add or update an alias
+ */
+export declare function addAlias(aliasName: string, fileKey: string, nodeId: string, options?: {
+    description?: string;
+    basePath?: string;
+}): AliasOperationResult;
+/**
+ * Remove an alias
+ */
+export declare function removeAlias(aliasName: string, options?: {
+    basePath?: string;
+}): AliasOperationResult;
+/**
+ * List all aliases
+ */
+export declare function listAliases(options?: {
+    basePath?: string;
+}): AliasListResponse;
+/**
+ * Resolve an alias to its target
+ */
+export declare function resolveAlias(aliasOrNodeId: string, options?: {
+    basePath?: string;
+}): ResolvedAlias | {
+    error: string;
+    suggestions?: string[];
+};
+/**
+ * Set the default file key
+ */
+export declare function setDefaultFile(fileKey: string, options?: {
+    basePath?: string;
+    fileName?: string;
+}): AliasOperationResult;
+/**
+ * Set the design system file key
+ */
+export declare function setDsFile(fileKey: string, options?: {
+    basePath?: string;
+    fileName?: string;
+}): AliasOperationResult;
+/**
+ * Get an alias by name
+ */
+export declare function getAlias(aliasName: string, options?: {
+    basePath?: string;
+}): AliasTarget | null;
+/**
+ * Check if an alias exists
+ */
+export declare function hasAlias(aliasName: string, options?: {
+    basePath?: string;
+}): boolean;
+/**
+ * Get all aliases for a specific file
+ */
+export declare function getAliasesForFile(fileKey: string, options?: {
+    basePath?: string;
+}): AliasListEntry[];
+/**
+ * Import aliases from another config file
+ */
+export declare function importAliases(sourcePath: string, options?: {
+    basePath?: string;
+    overwrite?: boolean;
+}): AliasOperationResult;

package/dist/design/figma-alias.js

@@ -0,0 +1,324 @@
+/**
+ * Figma Alias System
+ *
+ * Maps human-readable names to Figma file keys and node IDs.
+ * Stored in .ax-cli/design.json
+ *
+ * @module design/figma-alias
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { DesignConfigSchema, AliasTargetSchema, createEmptyDesignConfig, createDesignAlias, } from '@ax-cli/schemas';
+// =============================================================================
+// Constants
+// =============================================================================
+const AX_CLI_DIR = '.ax-cli';
+const DESIGN_CONFIG_FILE = 'design.json';
+// =============================================================================
+// Config File Management
+// =============================================================================
+/**
+ * Get the path to the design config file
+ */
+export function getDesignConfigPath(basePath) {
+    const base = basePath ?? process.cwd();
+    return join(base, AX_CLI_DIR, DESIGN_CONFIG_FILE);
+}
+/**
+ * Load the design config from disk
+ */
+export function loadDesignConfig(basePath) {
+    const configPath = getDesignConfigPath(basePath);
+    if (!existsSync(configPath)) {
+        return createEmptyDesignConfig();
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        return DesignConfigSchema.parse(parsed);
+    }
+    catch {
+        // If parsing fails, return empty config
+        console.warn(`Warning: Could not parse ${configPath}, using empty config`);
+        return createEmptyDesignConfig();
+    }
+}
+/**
+ * Save the design config to disk
+ */
+export function saveDesignConfig(config, basePath) {
+    const configPath = getDesignConfigPath(basePath);
+    const configDir = dirname(configPath);
+    // Ensure directory exists
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    // Update last modified timestamp
+    const updatedConfig = {
+        ...config,
+        meta: {
+            ...config.meta,
+            lastModified: new Date().toISOString(),
+        },
+    };
+    writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2), 'utf-8');
+}
+// =============================================================================
+// Alias Operations
+// =============================================================================
+/**
+ * Add or update an alias
+ */
+export function addAlias(aliasName, fileKey, nodeId, options) {
+    try {
+        // Validate alias name (throws if invalid)
+        createDesignAlias(aliasName);
+        // Validate target
+        const target = AliasTargetSchema.parse({
+            fileKey,
+            nodeId,
+            description: options?.description,
+            updatedAt: new Date().toISOString(),
+        });
+        // Load existing config
+        const config = loadDesignConfig(options?.basePath);
+        // Check if alias already exists
+        const existed = aliasName in config.aliases;
+        // Add/update alias
+        config.aliases[aliasName] = target;
+        // Save config
+        saveDesignConfig(config, options?.basePath);
+        return {
+            success: true,
+            alias: aliasName,
+            message: existed
+                ? `Updated alias "${aliasName}" → ${fileKey}/${nodeId}`
+                : `Added alias "${aliasName}" → ${fileKey}/${nodeId}`,
+            target,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            alias: aliasName,
+            message: error instanceof Error ? error.message : 'Failed to add alias',
+        };
+    }
+}
+/**
+ * Remove an alias
+ */
+export function removeAlias(aliasName, options) {
+    try {
+        const config = loadDesignConfig(options?.basePath);
+        if (!(aliasName in config.aliases)) {
+            return {
+                success: false,
+                alias: aliasName,
+                message: `Alias "${aliasName}" not found`,
+            };
+        }
+        const target = config.aliases[aliasName];
+        delete config.aliases[aliasName];
+        saveDesignConfig(config, options?.basePath);
+        return {
+            success: true,
+            alias: aliasName,
+            message: `Removed alias "${aliasName}"`,
+            target,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            alias: aliasName,
+            message: error instanceof Error ? error.message : 'Failed to remove alias',
+        };
+    }
+}
+/**
+ * List all aliases
+ */
+export function listAliases(options) {
+    const config = loadDesignConfig(options?.basePath);
+    const aliases = Object.entries(config.aliases).map(([alias, target]) => ({
+        alias,
+        fileKey: target.fileKey,
+        nodeId: target.nodeId,
+        fileName: config.meta?.fileNames?.[target.fileKey],
+        description: target.description,
+        updatedAt: target.updatedAt,
+    }));
+    // Sort by alias name
+    aliases.sort((a, b) => a.alias.localeCompare(b.alias));
+    return {
+        defaultFile: config.defaultFile,
+        dsFile: config.dsFile,
+        aliases,
+        total: aliases.length,
+    };
+}
+/**
+ * Resolve an alias to its target
+ */
+export function resolveAlias(aliasOrNodeId, options) {
+    const config = loadDesignConfig(options?.basePath);
+    // Check if it's a direct alias match
+    if (aliasOrNodeId in config.aliases) {
+        const target = config.aliases[aliasOrNodeId];
+        return {
+            alias: aliasOrNodeId,
+            fileKey: target.fileKey,
+            nodeId: target.nodeId,
+            source: 'explicit',
+            description: target.description,
+        };
+    }
+    // Check if it's a node ID format (number:number)
+    if (/^\d+:\d+$/.test(aliasOrNodeId)) {
+        // Need a default file to resolve bare node IDs
+        if (!config.defaultFile) {
+            return {
+                error: 'No default file set. Use "ax-cli design alias set-default <file-key>" or provide full alias.',
+            };
+        }
+        return {
+            alias: aliasOrNodeId,
+            fileKey: config.defaultFile,
+            nodeId: aliasOrNodeId,
+            source: 'default-file',
+        };
+    }
+    // Check for partial matches (suggestions)
+    const suggestions = Object.keys(config.aliases).filter((alias) => alias.toLowerCase().includes(aliasOrNodeId.toLowerCase()));
+    return {
+        error: `Alias "${aliasOrNodeId}" not found`,
+        suggestions: suggestions.length > 0 ? suggestions.slice(0, 5) : undefined,
+    };
+}
+/**
+ * Set the default file key
+ */
+export function setDefaultFile(fileKey, options) {
+    try {
+        const config = loadDesignConfig(options?.basePath);
+        config.defaultFile = fileKey;
+        // Store file name if provided
+        if (options?.fileName) {
+            config.meta = {
+                ...config.meta,
+                fileNames: {
+                    ...config.meta?.fileNames,
+                    [fileKey]: options.fileName,
+                },
+            };
+        }
+        saveDesignConfig(config, options?.basePath);
+        return {
+            success: true,
+            alias: 'default',
+            message: `Set default file to "${fileKey}"${options?.fileName ? ` (${options.fileName})` : ''}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            alias: 'default',
+            message: error instanceof Error ? error.message : 'Failed to set default file',
+        };
+    }
+}
+/**
+ * Set the design system file key
+ */
+export function setDsFile(fileKey, options) {
+    try {
+        const config = loadDesignConfig(options?.basePath);
+        config.dsFile = fileKey;
+        // Store file name if provided
+        if (options?.fileName) {
+            config.meta = {
+                ...config.meta,
+                fileNames: {
+                    ...config.meta?.fileNames,
+                    [fileKey]: options.fileName,
+                },
+            };
+        }
+        saveDesignConfig(config, options?.basePath);
+        return {
+            success: true,
+            alias: 'ds',
+            message: `Set design system file to "${fileKey}"${options?.fileName ? ` (${options.fileName})` : ''}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            alias: 'ds',
+            message: error instanceof Error ? error.message : 'Failed to set DS file',
+        };
+    }
+}
+/**
+ * Get an alias by name
+ */
+export function getAlias(aliasName, options) {
+    const config = loadDesignConfig(options?.basePath);
+    return config.aliases[aliasName] ?? null;
+}
+/**
+ * Check if an alias exists
+ */
+export function hasAlias(aliasName, options) {
+    const config = loadDesignConfig(options?.basePath);
+    return aliasName in config.aliases;
+}
+/**
+ * Get all aliases for a specific file
+ */
+export function getAliasesForFile(fileKey, options) {
+    const config = loadDesignConfig(options?.basePath);
+    return Object.entries(config.aliases)
+        .filter(([_, target]) => target.fileKey === fileKey)
+        .map(([alias, target]) => ({
+        alias,
+        fileKey: target.fileKey,
+        nodeId: target.nodeId,
+        description: target.description,
+        updatedAt: target.updatedAt,
+    }));
+}
+/**
+ * Import aliases from another config file
+ */
+export function importAliases(sourcePath, options) {
+    try {
+        const sourceConfig = loadDesignConfig(sourcePath);
+        const targetConfig = loadDesignConfig(options?.basePath);
+        let added = 0;
+        let skipped = 0;
+        for (const [alias, target] of Object.entries(sourceConfig.aliases)) {
+            if (alias in targetConfig.aliases && !options?.overwrite) {
+                skipped++;
+                continue;
+            }
+            targetConfig.aliases[alias] = target;
+            added++;
+        }
+        saveDesignConfig(targetConfig, options?.basePath);
+        return {
+            success: true,
+            alias: 'import',
+            message: `Imported ${added} alias(es), skipped ${skipped} existing`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            alias: 'import',
+            message: error instanceof Error ? error.message : 'Failed to import aliases',
+        };
+    }
+}
+//# sourceMappingURL=figma-alias.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * Figma Design Audit
+ *
+ * Rule-based audit system for checking design consistency,
+ * accessibility, and best practices.
+ *
+ * @module design/figma-audit
+ */
+import type { AuditRuleId, AuditResult, AuditSeverity } from '@ax-cli/schemas';
+import type { MapResult } from './types.js';
+/**
+ * Audit configuration options (input type with optional fields)
+ */
+interface AuditConfigInput {
+    rules?: AuditRuleId[];
+    excludeRules?: AuditRuleId[];
+    ruleConfig?: Record<AuditRuleId, {
+        enabled?: boolean;
+        severity?: AuditSeverity;
+        options?: Record<string, unknown>;
+    }>;
+    maxDepth?: number;
+    failOnError?: boolean;
+    failOnWarning?: boolean;
+    includeHidden?: boolean;
+    tokensPath?: string;
+}
+/**
+ * Audit a Figma file/node for design issues
+ */
+export declare function auditDesign(mapResult: MapResult, config?: AuditConfigInput): AuditResult;
+/**
+ * Format audit result for terminal display
+ */
+export declare function formatAuditResult(result: AuditResult): string;
+/**
+ * Format audit result as compact summary
+ */
+export declare function formatAuditSummary(result: AuditResult): string;
+export {};