anima-common-errors

# Anima Common Errors ## Error Reference ### Authentication Errors | Error | Root Cause | Fix | |-------|-----------|-----| | `Invalid Anima token` | Token not provisioned or expired | Request new token from Anima team | | `Invalid Figma token` | PAT expired or revoked | Generate new PAT: Figma > Settings > Access Tokens | | `Unauthorized` | Token lacks file access | Ensure Figma PAT has file read permission | ### File & Node Errors | Error | Root Cause | Fix | |-------|-----------|-----| | `File not found` | Wrong file key | Extract from Figma URL: `figma.com/file/{KEY}/...` | | `Node not found` | Invalid node ID | Copy node link from Figma: right-click > Copy link | | `No renderable content` | Selected a page or group | Select a frame, component, or component set | | Empty `files` array | Node is empty or hidden | Unhide layers; ensure node has visible content | ### Code Generation Errors ```typescript // Common generation error handler async function safeGenerate(anima: Anima, params: any) { try { return await anima.generateCode(params); } catch (err: any) { if (err.message?.includes('rate limit')) { console.error('Rate limited — wait 60s before retrying'); } else if (err.message?.includes('timeout')) { console.error('Generation timed out — simplify the Figma node'); } else if (err.message?.includes('Invalid settings')) { console.error('Invalid settings combo — check framework/styling/uiLibrary compatibility'); } else { ...