@sun-asterisk/sungen 2.4.6 → 2.5.1

package/dist/tools/figma/figma-auth.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Figma PAT lifecycle: load, save, clear, and safety checks.
+ *
+ * Storage: <cwd>/.env  key=FIGMA_PAT
+ * Override: process.env.FIGMA_PAT (CI path — skips file read)
+ *
+ * Safeguards enforced on every save AND every assertSafeToUse call:
+ *   1. .env must appear in .gitignore (abort if not).
+ *   2. No tracked file may contain "FIGMA_PAT=" (git grep scan).
+ */
+/**
+ * Load the Figma PAT.
+ * Priority: process.env.FIGMA_PAT > .env file.
+ * Returns undefined when no PAT is configured.
+ */
+export declare function loadPat(cwd: string): string | undefined;
+/**
+ * Persist PAT to <cwd>/.env, upserting only the FIGMA_PAT key.
+ * Aborts with an actionable error if safeguards are violated.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+export declare function savePat(cwd: string, token: string): Promise<void>;
+/**
+ * Remove FIGMA_PAT line from <cwd>/.env.
+ * No-op when key is not present.
+ */
+export declare function clearPat(cwd: string): void;
+/**
+ * Run tracked-file scan on every Figma CLI / skill invocation.
+ * Aborts with actionable message if FIGMA_PAT= is found in any tracked file.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+export declare function assertSafeToUse(cwd: string): Promise<void>;
+//# sourceMappingURL=figma-auth.d.ts.map

package/dist/tools/figma/figma-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-auth.d.ts","sourceRoot":"","sources":["../../../src/tools/figma/figma-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiEH;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWvD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCvE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAM1C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE"}

package/dist/tools/figma/figma-auth.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Figma PAT lifecycle: load, save, clear, and safety checks.
+ *
+ * Storage: <cwd>/.env  key=FIGMA_PAT
+ * Override: process.env.FIGMA_PAT (CI path — skips file read)
+ *
+ * Safeguards enforced on every save AND every assertSafeToUse call:
+ *   1. .env must appear in .gitignore (abort if not).
+ *   2. No tracked file may contain "FIGMA_PAT=" (git grep scan).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPat = loadPat;
+exports.savePat = savePat;
+exports.clearPat = clearPat;
+exports.assertSafeToUse = assertSafeToUse;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const exec_file_no_throw_1 = require("../../utils/exec-file-no-throw");
+const PAT_KEY = 'FIGMA_PAT';
+const ENV_FILE = '.env';
+const GITIGNORE_FILE = '.gitignore';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function envFilePath(cwd) {
+    return path.join(cwd, ENV_FILE);
+}
+function gitignorePath(cwd) {
+    return path.join(cwd, GITIGNORE_FILE);
+}
+/**
+ * Read .env file lines, return empty array when file does not exist.
+ */
+function readEnvLines(cwd) {
+    const fp = envFilePath(cwd);
+    if (!fs.existsSync(fp))
+        return [];
+    return fs.readFileSync(fp, 'utf8').split('\n');
+}
+/**
+ * Write lines back to .env, preserving a trailing newline.
+ */
+function writeEnvLines(cwd, lines) {
+    fs.writeFileSync(envFilePath(cwd), lines.join('\n'), 'utf8');
+}
+/**
+ * Check whether .env (or .env.*) is covered by .gitignore.
+ */
+function isEnvIgnored(cwd) {
+    const gp = gitignorePath(cwd);
+    if (!fs.existsSync(gp))
+        return false;
+    const content = fs.readFileSync(gp, 'utf8');
+    // Accept ".env", ".env.local", ".env.*", or "*.env" patterns
+    return /^\s*(\.env[\w.*]*|\*\.env)\s*$/m.test(content);
+}
+/**
+ * Run `git grep -l "FIGMA_PAT="` in cwd.
+ * Returns list of matching tracked file paths (empty = safe).
+ */
+async function findTrackedFilesWithPat(cwd) {
+    const result = await (0, exec_file_no_throw_1.execFileNoThrow)('git', ['grep', '-l', `${PAT_KEY}=`], cwd);
+    if (result.status === 0 && result.stdout.trim()) {
+        return result.stdout.trim().split('\n').filter(Boolean);
+    }
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load the Figma PAT.
+ * Priority: process.env.FIGMA_PAT > .env file.
+ * Returns undefined when no PAT is configured.
+ */
+function loadPat(cwd) {
+    if (process.env[PAT_KEY])
+        return process.env[PAT_KEY];
+    const lines = readEnvLines(cwd);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(`${PAT_KEY}=`)) {
+            return trimmed.slice(PAT_KEY.length + 1).trim();
+        }
+    }
+    return undefined;
+}
+/**
+ * Persist PAT to <cwd>/.env, upserting only the FIGMA_PAT key.
+ * Aborts with an actionable error if safeguards are violated.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+async function savePat(cwd, token) {
+    // Safeguard 1: .env must be gitignored
+    if (!isEnvIgnored(cwd)) {
+        throw new Error(`Refusing to save FIGMA_PAT: ".env" is not listed in ${GITIGNORE_FILE}.\n` +
+            `Add the following line to ${path.join(cwd, GITIGNORE_FILE)} and re-run:\n\n  .env\n`);
+    }
+    // Safeguard 2: no tracked file may contain FIGMA_PAT=
+    const leakedFiles = await findTrackedFilesWithPat(cwd);
+    if (leakedFiles.length > 0) {
+        throw new Error(`Refusing to save FIGMA_PAT: token key found in tracked file(s):\n` +
+            leakedFiles.map((f) => `  ${f}`).join('\n') +
+            `\n\nRemove FIGMA_PAT from those files, commit the removal, then re-run.\n`);
+    }
+    // Upsert: replace existing line or append
+    const lines = readEnvLines(cwd);
+    const idx = lines.findIndex((l) => l.trim().startsWith(`${PAT_KEY}=`));
+    const newLine = `${PAT_KEY}=${token}`;
+    if (idx >= 0) {
+        lines[idx] = newLine;
+    }
+    else {
+        // Ensure file ends with newline before appending
+        if (lines.length > 0 && lines[lines.length - 1] !== '') {
+            lines.push('');
+        }
+        lines.push(newLine);
+    }
+    writeEnvLines(cwd, lines);
+}
+/**
+ * Remove FIGMA_PAT line from <cwd>/.env.
+ * No-op when key is not present.
+ */
+function clearPat(cwd) {
+    const lines = readEnvLines(cwd);
+    const filtered = lines.filter((l) => !l.trim().startsWith(`${PAT_KEY}=`));
+    if (filtered.length !== lines.length) {
+        writeEnvLines(cwd, filtered);
+    }
+}
+/**
+ * Run tracked-file scan on every Figma CLI / skill invocation.
+ * Aborts with actionable message if FIGMA_PAT= is found in any tracked file.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+async function assertSafeToUse(cwd) {
+    const leakedFiles = await findTrackedFilesWithPat(cwd);
+    if (leakedFiles.length > 0) {
+        throw new Error(`Security check failed: FIGMA_PAT found in tracked file(s):\n` +
+            leakedFiles.map((f) => `  ${f}`).join('\n') +
+            `\n\nRemove FIGMA_PAT from those files and commit the removal before using Figma commands.\n`);
+    }
+}
+//# sourceMappingURL=figma-auth.js.map

package/dist/tools/figma/figma-auth.js.map

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

package/dist/tools/figma/figma-cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Version-keyed disk cache for Figma node JSON and rendered images.
+ *
+ * Layout:
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>.json       (filtered node)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-raw.json   (unfiltered API response)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-<scale>.png
+ *
+ * Cache directory is created on first write (permissions 0o700 on Unix).
+ * `bustOldVersions` retains the N most recently modified version dirs.
+ */
+import type { FigmaCacheKind } from './figma-client-types';
+/**
+ * Read a cached entry. Returns `undefined` on cache miss.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+export declare function get(cwd: string, fileKey: string, versionId: string, nodeId: string, kind: FigmaCacheKind): Buffer | undefined;
+/**
+ * Write data to the cache.
+ * Creates the version directory (mode 0o700) if it does not exist.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+export declare function put(cwd: string, fileKey: string, versionId: string, nodeId: string, kind: FigmaCacheKind, data: Buffer | string): void;
+/**
+ * Find the newest on-disk version that has a cached raw node JSON for `nodeId`.
+ * Returns `undefined` when no usable cache exists.
+ *
+ * Lets the scaffolder skip an expensive `/v1/files/:key/nodes` call on Starter
+ * plans where REST quota is severely restricted.
+ */
+export declare function findLatestCachedVersion(cwd: string, fileKey: string, nodeId: string): string | undefined;
+/**
+ * Remove all version directories for `fileKey` except the `keep` most recent.
+ *
+ * Directories are ordered by mtime descending; oldest are deleted first.
+ * No-op when fewer than `keep` versions exist.
+ *
+ * @param keep  Number of versions to retain (default 3).
+ */
+export declare function bustOldVersions(cwd: string, fileKey: string, currentVersion: string, options?: {
+    keep?: number;
+}): void;
+//# sourceMappingURL=figma-cache.d.ts.map

package/dist/tools/figma/figma-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-cache.d.ts","sourceRoot":"","sources":["../../../src/tools/figma/figma-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiC3D;;;;GAIG;AACH,wBAAgB,GAAG,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,IAAI,CAqCN"}

package/dist/tools/figma/figma-cache.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Version-keyed disk cache for Figma node JSON and rendered images.
+ *
+ * Layout:
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>.json       (filtered node)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-raw.json   (unfiltered API response)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-<scale>.png
+ *
+ * Cache directory is created on first write (permissions 0o700 on Unix).
+ * `bustOldVersions` retains the N most recently modified version dirs.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get = get;
+exports.put = put;
+exports.findLatestCachedVersion = findLatestCachedVersion;
+exports.bustOldVersions = bustOldVersions;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+const CACHE_ROOT = path.join('.sungen', 'figma-cache');
+/** Replace characters unsafe for filenames (colons, slashes, spaces). */
+function safeId(id) {
+    return id.replace(/[:/\\s]/g, '_');
+}
+function cacheDir(cwd, fileKey, versionId) {
+    return path.join(cwd, CACHE_ROOT, safeId(fileKey), safeId(versionId));
+}
+function cacheFilename(nodeId, kind) {
+    const safe = safeId(nodeId);
+    if (kind === 'json')
+        return `${safe}.json`;
+    if (kind === 'raw')
+        return `${safe}-raw.json`;
+    // kind is like "2x", "1x", etc.
+    return `${safe}-${kind}.png`;
+}
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Read a cached entry. Returns `undefined` on cache miss.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+function get(cwd, fileKey, versionId, nodeId, kind) {
+    const filePath = path.join(cacheDir(cwd, fileKey, versionId), cacheFilename(nodeId, kind));
+    if (!fs.existsSync(filePath))
+        return undefined;
+    try {
+        return fs.readFileSync(filePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Write data to the cache.
+ * Creates the version directory (mode 0o700) if it does not exist.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+function put(cwd, fileKey, versionId, nodeId, kind, data) {
+    const dir = cacheDir(cwd, fileKey, versionId);
+    ensureDir(dir);
+    const filePath = path.join(dir, cacheFilename(nodeId, kind));
+    const payload = typeof data === 'string' ? Buffer.from(data, 'utf8') : data;
+    // Atomic write: tmp → rename
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, payload, { mode: 0o600 });
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Find the newest on-disk version that has a cached raw node JSON for `nodeId`.
+ * Returns `undefined` when no usable cache exists.
+ *
+ * Lets the scaffolder skip an expensive `/v1/files/:key/nodes` call on Starter
+ * plans where REST quota is severely restricted.
+ */
+function findLatestCachedVersion(cwd, fileKey, nodeId) {
+    const keyDir = path.join(cwd, CACHE_ROOT, safeId(fileKey));
+    if (!fs.existsSync(keyDir))
+        return undefined;
+    let entries;
+    try {
+        entries = fs.readdirSync(keyDir, { withFileTypes: true });
+    }
+    catch {
+        return undefined;
+    }
+    const rawFilename = cacheFilename(nodeId, 'raw');
+    const candidates = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => {
+        const rawPath = path.join(keyDir, e.name, rawFilename);
+        if (!fs.existsSync(rawPath))
+            return undefined;
+        let mtime = 0;
+        try {
+            mtime = fs.statSync(rawPath).mtimeMs;
+        }
+        catch { /* ignore */ }
+        return { versionDir: e.name, mtime };
+    })
+        .filter((x) => x !== undefined)
+        .sort((a, b) => b.mtime - a.mtime);
+    return candidates[0]?.versionDir;
+}
+/**
+ * Remove all version directories for `fileKey` except the `keep` most recent.
+ *
+ * Directories are ordered by mtime descending; oldest are deleted first.
+ * No-op when fewer than `keep` versions exist.
+ *
+ * @param keep  Number of versions to retain (default 3).
+ */
+function bustOldVersions(cwd, fileKey, currentVersion, options = {}) {
+    const keep = options.keep ?? 3;
+    const keyDir = path.join(cwd, CACHE_ROOT, safeId(fileKey));
+    if (!fs.existsSync(keyDir))
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(keyDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const versionDirs = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => {
+        const fullPath = path.join(keyDir, e.name);
+        let mtime = 0;
+        try {
+            mtime = fs.statSync(fullPath).mtimeMs;
+        }
+        catch { /* ignore */ }
+        return { name: e.name, fullPath, mtime };
+    })
+        // Ensure current version is always kept (bump its mtime artificially)
+        .map((d) => d.name === safeId(currentVersion)
+        ? { ...d, mtime: Number.MAX_SAFE_INTEGER }
+        : d)
+        .sort((a, b) => b.mtime - a.mtime); // newest first
+    const toDelete = versionDirs.slice(keep);
+    for (const dir of toDelete) {
+        try {
+            fs.rmSync(dir.fullPath, { recursive: true, force: true });
+        }
+        catch { /* best-effort */ }
+    }
+}
+//# sourceMappingURL=figma-cache.js.map

package/dist/tools/figma/figma-cache.js.map

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

package/dist/tools/figma/figma-client-types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Shared types for Figma integration.
+ * Used by figma-auth.ts, figma-url-parser.ts, and REST client modules.
+ */
+/** Authentication configuration for Figma API. */
+export interface FigmaAuthConfig {
+    /** Personal Access Token — never log this value. */
+    pat: string;
+}
+/** Parsed reference to a specific Figma node. */
+export interface FigmaNodeRef {
+    /** Figma file key extracted from URL (alphanumeric, 20+ chars). */
+    fileKey: string;
+    /** Node ID in API form: "1:23" (colon-separated). Absent when URL has no node-id param. */
+    nodeId?: string;
+}
+/** Minimal /v1/me response shape used for PAT validation. */
+export interface FigmaMeResponse {
+    id: string;
+    email: string;
+    handle: string;
+}
+/** Result of a PAT validation call. */
+export interface FigmaAuthCheckResult {
+    valid: boolean;
+    handle?: string;
+    email?: string;
+    error?: string;
+}
+/** Raw Figma node as returned by the API (loose — unknown fields allowed). */
+export interface FigmaRawNode {
+    id: string;
+    name: string;
+    type: string;
+    /** Text content for TEXT nodes. */
+    characters?: string;
+    /** Component set variant properties. */
+    componentPropertyDefinitions?: Record<string, unknown>;
+    /** Variant property values for COMPONENT nodes. */
+    componentProperties?: Record<string, {
+        value: string;
+        type: string;
+    }>;
+    /** Bounding box from absoluteBoundingBox. */
+    absoluteBoundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Child nodes. */
+    children?: FigmaRawNode[];
+    /** Allow any additional Figma fields. */
+    [key: string]: unknown;
+}
+/** Response from GET /v1/files/:key/nodes */
+export interface FigmaFileNodesResponse {
+    nodes: Record<string, {
+        document: FigmaRawNode;
+    } | null>;
+    /** Current file version ID. */
+    version: string;
+}
+/** Response from GET /v1/images/:key */
+export interface FigmaImageUrlsResponse {
+    /** Map of nodeId → signed S3 URL (transient — do not persist). */
+    images: Record<string, string | null>;
+    err: string | null;
+}
+/** Role inferred from component name suffix. */
+export type FigmaNodeRole = 'button' | 'textbox' | 'link' | 'image' | null;
+/** Pruned, minimal Figma node for downstream LLM / test generation. */
+export interface FilteredFigmaNode {
+    id: string;
+    name: string;
+    type: string;
+    /** Text content (TEXT nodes only). */
+    text?: string;
+    /** Component set name (COMPONENT / COMPONENT_SET nodes). */
+    componentName?: string;
+    /** Variant property map from componentProperties. */
+    variantProps?: Record<string, string>;
+    /** Inferred accessibility / interaction role. */
+    role?: FigmaNodeRole;
+    /** Bounding rectangle in file coordinates. */
+    boundingBox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    children: FilteredFigmaNode[];
+}
+/** A single text label extracted from the node tree. */
+export interface FigmaTextLabel {
+    text: string;
+    nodePath: string;
+}
+/** A single variant definition extracted from a COMPONENT_SET. */
+export interface FigmaVariantDefinition {
+    nodeId: string;
+    name: string;
+    variantProps: Record<string, string>;
+}
+export interface FigmaImageOptions {
+    /** Render scale. Default 2. */
+    scale?: number;
+    /** Image format. Default 'png'. */
+    format?: 'png' | 'jpg' | 'svg' | 'pdf';
+}
+export type FigmaCacheKind = 'json' | 'raw' | `${number}x`;
+//# sourceMappingURL=figma-client-types.d.ts.map

package/dist/tools/figma/figma-client-types.d.ts.map

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

package/dist/tools/figma/figma-client-types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Shared types for Figma integration.
+ * Used by figma-auth.ts, figma-url-parser.ts, and REST client modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=figma-client-types.js.map

package/dist/tools/figma/figma-client-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-client-types.js","sourceRoot":"","sources":["../../../src/tools/figma/figma-client-types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/tools/figma/figma-errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Typed error classes for Figma API failures.
+ * Each error carries an actionable remediation message for CLI output.
+ *
+ * Never include PAT values in error messages or remediation text.
+ */
+/** Common base for all Figma errors. */
+declare abstract class FigmaBaseError extends Error {
+    /** Human-readable instruction shown to the user on failure. */
+    readonly remediation: string;
+    constructor(message: string, remediation: string);
+}
+/**
+ * HTTP 401 — PAT is missing, expired, or invalid.
+ */
+export declare class FigmaAuthError extends FigmaBaseError {
+    constructor(message?: string);
+}
+/**
+ * HTTP 403 / 404 — PAT valid but insufficient access, or resource not found.
+ */
+export declare class FigmaAccessError extends FigmaBaseError {
+    readonly statusCode: 403 | 404;
+    constructor(statusCode: 403 | 404, message?: string);
+}
+/**
+ * HTTP 429 — Rate limited by Figma API.
+ */
+export declare class FigmaRateLimitError extends FigmaBaseError {
+    /** Seconds to wait before retrying, parsed from Retry-After header. */
+    readonly retryAfter: number;
+    readonly planTier?: string;
+    readonly bucket?: string;
+    readonly upgradeLink?: string;
+    constructor(retryAfter: number, message?: string, opts?: {
+        planTier?: string;
+        bucket?: string;
+        upgradeLink?: string;
+    });
+}
+/**
+ * Network / transport failure (timeout, DNS, stream error, etc.).
+ */
+export declare class FigmaNetworkError extends FigmaBaseError {
+    readonly cause: unknown;
+    constructor(message: string, cause?: unknown);
+}
+export {};
+//# sourceMappingURL=figma-errors.d.ts.map

package/dist/tools/figma/figma-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-errors.d.ts","sourceRoot":"","sources":["../../../src/tools/figma/figma-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wCAAwC;AACxC,uBAAe,cAAe,SAAQ,KAAK;IACzC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAKjD;AAMD;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,SAAuC;CAM3D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC;gBAEnB,UAAU,EAAE,GAAG,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM;CAYpD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAG5B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;CAyB1E;AAgBD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAO7C"}