@sun-asterisk/sungen 2.5.0 → 2.5.1

package/dist/orchestrator/figma/figma-scaffolder-helpers.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Internal helpers for figma-scaffolder.ts.
+ * Extracted to keep the main orchestration file under 200 LOC.
+ */
+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.sanitizeName = sanitizeName;
+exports.readGeneratorVersion = readGeneratorVersion;
+exports.minimalSpecMd = minimalSpecMd;
+exports.downloadImages = downloadImages;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const figma_image_downloader_1 = require("../../tools/figma/figma-image-downloader");
+const FigmaCache = __importStar(require("../../tools/figma/figma-cache"));
+// ---------------------------------------------------------------------------
+// Name utilities
+// ---------------------------------------------------------------------------
+/** Sanitize a Figma frame/variant name to a safe filename (lowercase, dashes). */
+function sanitizeName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+// ---------------------------------------------------------------------------
+// Version / stub helpers
+// ---------------------------------------------------------------------------
+/** Read generator version from root package.json. Falls back to "sungen". */
+function readGeneratorVersion(cwd) {
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+            if (pkg.version)
+                return `sungen v${pkg.version}`;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return 'sungen';
+}
+/** Minimal spec.md stub pointing users to spec_figma.md. */
+function minimalSpecMd(screenName) {
+    return `# ${screenName} Screen Specification
+
+<!-- This file is the human-authored source of truth. -->
+<!-- spec_figma.md contains auto-generated Figma data — copy useful sections here. -->
+
+## Overview
+- **URL Path:** /${screenName}
+- **Auth Required:** no
+- **Platform:** web
+
+## Sections
+
+<!-- Add sections, fields, validation rules, and business rules here. -->
+`;
+}
+/**
+ * Download (or copy from cache) images for each node ID.
+ * Returns relative paths (e.g. "ui/login-frame.png") for each successfully written file.
+ */
+async function downloadImages(opts) {
+    const imagePaths = [];
+    for (let i = 0; i < opts.imageNodeIds.length; i++) {
+        const nodeId = opts.imageNodeIds[i];
+        const isMain = nodeId === opts.mainNodeId;
+        const nameSuffix = isMain
+            ? opts.frameBaseName
+            : sanitizeName(opts.variantNames[i - 1] ?? `variant-${i}`);
+        const destPath = path.join(opts.uiDir, `${nameSuffix}.png`);
+        const relPath = `ui/${nameSuffix}.png`;
+        // Cache hit path
+        if (opts.cachedImages.has(nodeId)) {
+            opts.spinner.start(`Writing cached image: ${nameSuffix}.png`);
+            fs.writeFileSync(destPath, opts.cachedImages.get(nodeId));
+            imagePaths.push(relPath);
+            opts.spinner.succeed(`  ui/${nameSuffix}.png (cached)`);
+            continue;
+        }
+        const url = opts.imageUrls[nodeId];
+        if (!url) {
+            opts.spinner.warn(`  No image URL for node ${nodeId} — skipping`);
+            continue;
+        }
+        opts.spinner.start(`Downloading ui/${nameSuffix}.png…`);
+        try {
+            await (0, figma_image_downloader_1.downloadToPath)(url, destPath);
+            // Cache downloaded bytes for future runs
+            const bytes = fs.readFileSync(destPath);
+            FigmaCache.put(opts.cwd, opts.fileKey, opts.versionId, nodeId, opts.scaleKind, bytes);
+            imagePaths.push(relPath);
+            opts.spinner.succeed(`  ui/${nameSuffix}.png`);
+        }
+        catch {
+            opts.spinner.warn(`  Failed to download ui/${nameSuffix}.png — skipping`);
+        }
+    }
+    return imagePaths;
+}
+//# sourceMappingURL=figma-scaffolder-helpers.js.map

package/dist/orchestrator/figma/figma-scaffolder-helpers.js.map

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

package/dist/orchestrator/figma/figma-scaffolder-types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared input/output types for FigmaScaffolder.
+ * Kept separate to avoid growing figma-client-types.ts beyond its scope.
+ */
+export interface FigmaScaffolderOptions {
+    /** Screen name (e.g. "login", "dashboard"). */
+    screenName: string;
+    /** Full Figma share URL. */
+    figmaUrl: string;
+    /** Absolute or cwd-relative working directory. Default: process.cwd(). */
+    cwd?: string;
+    /** When true, bypass cache and re-fetch from Figma API. Default: false. */
+    refresh?: boolean;
+    /** Render scale for PNG export. Default: 2. */
+    scale?: number;
+}
+export interface FigmaScaffolderResult {
+    /** Absolute path to the written spec_figma.md. */
+    specFigmaPath: string;
+    /** Absolute paths to downloaded PNG files. */
+    imagePaths: string[];
+    /** True when spec.md was newly created (was not already present). */
+    specMdCreated: boolean;
+}
+//# sourceMappingURL=figma-scaffolder-types.d.ts.map

package/dist/orchestrator/figma/figma-scaffolder-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-scaffolder-types.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/figma/figma-scaffolder-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAC;CACxB"}

package/dist/orchestrator/figma/figma-scaffolder-types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Shared input/output types for FigmaScaffolder.
+ * Kept separate to avoid growing figma-client-types.ts beyond its scope.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=figma-scaffolder-types.js.map

package/dist/orchestrator/figma/figma-scaffolder-types.js.map

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

package/dist/orchestrator/figma/figma-scaffolder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * FigmaScaffolder: orchestrates Figma URL → spec_figma.md + ui/*.png.
+ *
+ * Flow: parseFigmaUrl → assertSafeToUse → loadPat → cache check
+ *       → getFileNodes → filterFigmaNode → getImageUrls → downloadImages
+ *       → renderSpecFigma → write files
+ *
+ * Idempotent: re-running overwrites spec_figma.md and PNGs.
+ * spec.md: written only if absent (never overwritten).
+ * Cache: keyed by file+version+node; bypassed when refresh=true.
+ *
+ * Helpers (image download, name utils, stubs) live in figma-scaffolder-helpers.ts.
+ */
+import type { FigmaScaffolderOptions, FigmaScaffolderResult } from './figma-scaffolder-types';
+export declare class FigmaScaffolder {
+    /**
+     * Orchestrate the full Figma → screen files flow.
+     *
+     * @throws Error with remediation instructions on auth / parse / network failure.
+     */
+    static run(options: FigmaScaffolderOptions): Promise<FigmaScaffolderResult>;
+}
+//# sourceMappingURL=figma-scaffolder.d.ts.map

package/dist/orchestrator/figma/figma-scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-scaffolder.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/figma/figma-scaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAK9F,qBAAa,eAAe;IAC1B;;;;OAIG;WACU,GAAG,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAuKlF"}

package/dist/orchestrator/figma/figma-scaffolder.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * FigmaScaffolder: orchestrates Figma URL → spec_figma.md + ui/*.png.
+ *
+ * Flow: parseFigmaUrl → assertSafeToUse → loadPat → cache check
+ *       → getFileNodes → filterFigmaNode → getImageUrls → downloadImages
+ *       → renderSpecFigma → write files
+ *
+ * Idempotent: re-running overwrites spec_figma.md and PNGs.
+ * spec.md: written only if absent (never overwritten).
+ * Cache: keyed by file+version+node; bypassed when refresh=true.
+ *
+ * Helpers (image download, name utils, stubs) live in figma-scaffolder-helpers.ts.
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaScaffolder = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ora_1 = __importDefault(require("ora"));
+const figma_url_parser_1 = require("../../tools/figma/figma-url-parser");
+const figma_auth_1 = require("../../tools/figma/figma-auth");
+const figma_rest_client_1 = require("../../tools/figma/figma-rest-client");
+const figma_node_filter_1 = require("../../tools/figma/figma-node-filter");
+const FigmaCache = __importStar(require("../../tools/figma/figma-cache"));
+const spec_figma_renderer_1 = require("./spec-figma-renderer");
+const figma_scaffolder_helpers_1 = require("./figma-scaffolder-helpers");
+// Max variant images to download in addition to the main frame.
+const MAX_VARIANT_IMAGES = 5;
+class FigmaScaffolder {
+    /**
+     * Orchestrate the full Figma → screen files flow.
+     *
+     * @throws Error with remediation instructions on auth / parse / network failure.
+     */
+    static async run(options) {
+        const cwd = options.cwd ?? process.cwd();
+        const refresh = options.refresh ?? false;
+        const scale = options.scale ?? 2;
+        const spinner = (0, ora_1.default)({ stream: process.stderr });
+        // 1. Parse and validate Figma URL
+        const ref = (0, figma_url_parser_1.parseFigmaUrl)(options.figmaUrl);
+        if (!ref) {
+            throw new Error(`Invalid Figma URL: "${options.figmaUrl}"\n` +
+                'Expected format: https://www.figma.com/design/<KEY>/<name>?node-id=1-23');
+        }
+        if (!ref.nodeId) {
+            throw new Error('Figma URL must include a node-id query parameter.\n' +
+                'Select a specific frame in Figma, right-click → "Copy link to selection".');
+        }
+        // 2. Security scan + PAT load
+        spinner.start('Checking Figma auth…');
+        await (0, figma_auth_1.assertSafeToUse)(cwd);
+        const pat = (0, figma_auth_1.loadPat)(cwd);
+        if (!pat) {
+            spinner.fail('Figma PAT not found.');
+            throw new Error('Figma PAT is not configured.\nRun: sungen figma auth set');
+        }
+        spinner.succeed('Figma auth OK');
+        // 3. Ensure screen directories exist
+        const screenDir = path.join(cwd, 'qa', 'screens', options.screenName);
+        const requirementsDir = path.join(screenDir, 'requirements');
+        const uiDir = path.join(requirementsDir, 'ui');
+        fs.mkdirSync(uiDir, { recursive: true });
+        // 4. Resolve node: prefer raw-JSON cache to spare Starter-tier REST quota.
+        // On Figma Starter, `/v1/files/:key/nodes` counts against a tiny daily
+        // bucket (observed Retry-After up to 4+ days). If we already have a
+        // cached raw response, reuse it and skip the call entirely.
+        let versionId;
+        let nodeDocument;
+        let fromCache = false;
+        if (!refresh) {
+            const cachedVersion = FigmaCache.findLatestCachedVersion(cwd, ref.fileKey, ref.nodeId);
+            if (cachedVersion) {
+                const cachedRaw = FigmaCache.get(cwd, ref.fileKey, cachedVersion, ref.nodeId, 'raw');
+                if (cachedRaw) {
+                    try {
+                        nodeDocument = JSON.parse(cachedRaw.toString('utf8'));
+                        versionId = cachedVersion;
+                        fromCache = true;
+                        spinner.info(`Reusing cached Figma node (version ${versionId}) — pass --refresh to re-fetch`);
+                    }
+                    catch {
+                        // Corrupt cache → fall through to API fetch
+                    }
+                }
+            }
+        }
+        if (!fromCache) {
+            spinner.start(`Fetching Figma node ${ref.nodeId}…`);
+            let nodesResponse;
+            try {
+                nodesResponse = await (0, figma_rest_client_1.getFileNodes)(pat, ref.fileKey, [ref.nodeId]);
+            }
+            catch (err) {
+                spinner.fail('Failed to fetch Figma node.');
+                throw err;
+            }
+            versionId = nodesResponse.version;
+            const nodeEntry = nodesResponse.nodes[ref.nodeId];
+            if (!nodeEntry) {
+                spinner.fail(`Node ${ref.nodeId} not found in Figma file.`);
+                throw new Error(`Node "${ref.nodeId}" was not found in file "${ref.fileKey}".\n` +
+                    'Check the Figma URL — the node-id may be incorrect.');
+            }
+            spinner.succeed(`Fetched node: ${nodeEntry.document.name}`);
+            nodeDocument = nodeEntry.document;
+            // Persist raw (unfiltered) node JSON for downstream LLM synthesis + future
+            // cache-first runs. Re-runs overwrite atomically.
+            FigmaCache.put(cwd, ref.fileKey, versionId, ref.nodeId, 'raw', JSON.stringify(nodeDocument));
+        }
+        // nodeEntry.document shape — trust the cached bytes we wrote earlier.
+        const nodeEntry = { document: nodeDocument };
+        // 5. Filter node tree + extract metadata
+        const filteredNode = (0, figma_node_filter_1.filterFigmaNode)(nodeEntry.document);
+        const textLabels = (0, figma_node_filter_1.extractTextLabels)(filteredNode);
+        const variants = (0, figma_node_filter_1.extractVariants)(filteredNode);
+        // 6. Resolve image node IDs (main + up to MAX_VARIANT_IMAGES variants)
+        const imageNodeIds = [ref.nodeId, ...variants.slice(0, MAX_VARIANT_IMAGES).map((v) => v.nodeId)];
+        const scaleKind = `${scale}x`;
+        // 7. Warm image cache (skipped when refresh=true)
+        const cachedImages = new Map();
+        if (!refresh) {
+            for (const nodeId of imageNodeIds) {
+                const cached = FigmaCache.get(cwd, ref.fileKey, versionId, nodeId, scaleKind);
+                if (cached)
+                    cachedImages.set(nodeId, cached);
+            }
+        }
+        // 8. Fetch image URLs for uncached nodes
+        const uncachedIds = imageNodeIds.filter((id) => !cachedImages.has(id));
+        let imageUrls = {};
+        if (uncachedIds.length > 0) {
+            spinner.start(`Fetching image URLs for ${uncachedIds.length} node(s)…`);
+            try {
+                const urlsResponse = await (0, figma_rest_client_1.getImageUrls)(pat, ref.fileKey, uncachedIds, { scale, format: 'png' });
+                imageUrls = urlsResponse.images;
+            }
+            catch (err) {
+                spinner.fail('Failed to fetch image URLs.');
+                throw err;
+            }
+            spinner.succeed('Image URLs fetched');
+        }
+        // 9. Download (or copy from cache) images
+        const frameBaseName = (0, figma_scaffolder_helpers_1.sanitizeName)(filteredNode.name);
+        const variantNames = variants.slice(0, MAX_VARIANT_IMAGES).map((v) => v.name);
+        const imagePaths = await (0, figma_scaffolder_helpers_1.downloadImages)({
+            cwd, fileKey: ref.fileKey, versionId, uiDir,
+            imageNodeIds, mainNodeId: ref.nodeId, variantNames,
+            cachedImages, imageUrls, frameBaseName, scaleKind, spinner,
+        });
+        // 10. Render and write spec_figma.md (always overwritten)
+        spinner.start('Rendering spec_figma.md…');
+        const markdown = (0, spec_figma_renderer_1.renderSpecFigma)({
+            filteredNode, variants, textLabels, imagePaths,
+            fileKey: ref.fileKey, nodeId: ref.nodeId, versionId,
+            fetchedAt: new Date().toISOString(),
+            generatorVersion: (0, figma_scaffolder_helpers_1.readGeneratorVersion)(cwd),
+        });
+        const specFigmaPath = path.join(requirementsDir, 'spec_figma.md');
+        fs.writeFileSync(specFigmaPath, markdown, 'utf8');
+        spinner.succeed('spec_figma.md written');
+        // 11. Write spec.md stub only if absent
+        const specMdPath = path.join(requirementsDir, 'spec.md');
+        const specMdCreated = !fs.existsSync(specMdPath);
+        if (specMdCreated) {
+            fs.writeFileSync(specMdPath, (0, figma_scaffolder_helpers_1.minimalSpecMd)(options.screenName), 'utf8');
+            spinner.info('spec.md created (stub — fill in your requirements)');
+        }
+        // 12. Evict old cache versions (keep last 3)
+        FigmaCache.bustOldVersions(cwd, ref.fileKey, versionId);
+        return { specFigmaPath, imagePaths, specMdCreated };
+    }
+}
+exports.FigmaScaffolder = FigmaScaffolder;
+//# sourceMappingURL=figma-scaffolder.js.map

package/dist/orchestrator/figma/figma-scaffolder.js.map

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

package/dist/orchestrator/figma/node-path-collapser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pure helper: collapse consecutive repeated segments in a Figma node path.
+ *
+ * Delimiter: " > " (space-angle-space).
+ * Collapsed runs use the multiplication sign × (U+00D7).
+ *
+ * Examples:
+ *   "A > B > C"                              → "A > B > C"          (unchanged)
+ *   "A > B > B > C"                          → "A > B×2 > C"
+ *   "Container > Container > Container > X"  → "Container×3 > X"
+ *   "A > A > A > A > A > B > C"             → "A×5 > B > C"
+ *   "A"                                       → "A"                  (single)
+ *   ""                                        → ""                   (empty)
+ */
+export declare function collapseNodePath(path: string): string;
+//# sourceMappingURL=node-path-collapser.d.ts.map

package/dist/orchestrator/figma/node-path-collapser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-path-collapser.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/figma/node-path-collapser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBrD"}

package/dist/orchestrator/figma/node-path-collapser.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collapseNodePath = collapseNodePath;
+/**
+ * Pure helper: collapse consecutive repeated segments in a Figma node path.
+ *
+ * Delimiter: " > " (space-angle-space).
+ * Collapsed runs use the multiplication sign × (U+00D7).
+ *
+ * Examples:
+ *   "A > B > C"                              → "A > B > C"          (unchanged)
+ *   "A > B > B > C"                          → "A > B×2 > C"
+ *   "Container > Container > Container > X"  → "Container×3 > X"
+ *   "A > A > A > A > A > B > C"             → "A×5 > B > C"
+ *   "A"                                       → "A"                  (single)
+ *   ""                                        → ""                   (empty)
+ */
+function collapseNodePath(path) {
+    if (!path)
+        return path;
+    const DELIMITER = ' > ';
+    const segments = path.split(DELIMITER);
+    const collapsed = [];
+    let i = 0;
+    while (i < segments.length) {
+        const current = segments[i];
+        let count = 1;
+        // Count consecutive identical segments
+        while (i + count < segments.length && segments[i + count] === current) {
+            count++;
+        }
+        collapsed.push(count > 1 ? `${current}×${count}` : current);
+        i += count;
+    }
+    return collapsed.join(DELIMITER);
+}
+//# sourceMappingURL=node-path-collapser.js.map

package/dist/orchestrator/figma/node-path-collapser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-path-collapser.js","sourceRoot":"","sources":["../../../src/orchestrator/figma/node-path-collapser.ts"],"names":[],"mappings":";;AAcA,4CAuBC;AArCD;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,SAAS,GAAG,KAAK,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,uCAAuC;QACvC,OAAO,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC;YACtE,KAAK,EAAE,CAAC;QACV,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC5D,CAAC,IAAI,KAAK,CAAC;IACb,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/dist/orchestrator/figma/spec-figma-renderer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pure function: filtered Figma node → spec_figma.md envelope string.
+ *
+ * The envelope is deterministic and stable across runs: frontmatter,
+ * auto-gen banner, Frame metadata, Screenshots, and a SYNTHESIS marker.
+ * Narrative sections (Purpose, ASCII Layout, Regions, Actions, Form Fields,
+ * Data Columns, Navigation) are appended BELOW the marker by the
+ * sungen-figma-source skill, which reads the raw cached node JSON.
+ *
+ * Section renderers live in spec-figma-section-renderers.ts.
+ *
+ * This module never reads from disk or makes network calls.
+ */
+import type { FilteredFigmaNode, FigmaTextLabel, FigmaVariantDefinition } from '../../tools/figma/figma-client-types';
+export interface RenderSpecFigmaInput {
+    /** Root filtered node (the requested frame / component). */
+    filteredNode: FilteredFigmaNode;
+    /** Variant definitions from a COMPONENT_SET parent, or [] if none. Kept for compatibility. */
+    variants: FigmaVariantDefinition[];
+    /** Flat text labels extracted from the node tree. Kept for compatibility. */
+    textLabels: FigmaTextLabel[];
+    /** Relative paths of downloaded image files (e.g., ["ui/home.png", "ui/home-dark.png"]). */
+    imagePaths: string[];
+    /** Figma file key. */
+    fileKey: string;
+    /** Node ID in API form (e.g. "1:23"). */
+    nodeId: string;
+    /** Figma file version ID at fetch time. */
+    versionId: string;
+    /** ISO timestamp of when data was fetched. */
+    fetchedAt: string;
+    /** Generator version string (e.g., "sungen v2.4.5"). */
+    generatorVersion: string;
+}
+/**
+ * Render the deterministic envelope for spec_figma.md.
+ * The LLM synthesis step (sungen-figma-source skill) appends the narrative
+ * sections AFTER the SYNTHESIS_MARKER comment. Re-synthesis replaces
+ * everything from the marker to EOF.
+ *
+ * Pure function — no I/O side effects.
+ */
+export declare function renderSpecFigma(input: RenderSpecFigmaInput): string;
+//# sourceMappingURL=spec-figma-renderer.d.ts.map

package/dist/orchestrator/figma/spec-figma-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-figma-renderer.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/figma/spec-figma-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAY9C,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,YAAY,EAAE,iBAAiB,CAAC;IAChC,8FAA8F;IAC9F,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,6EAA6E;IAC7E,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,4FAA4F;IAC5F,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAgBnE"}

package/dist/orchestrator/figma/spec-figma-renderer.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Pure function: filtered Figma node → spec_figma.md envelope string.
+ *
+ * The envelope is deterministic and stable across runs: frontmatter,
+ * auto-gen banner, Frame metadata, Screenshots, and a SYNTHESIS marker.
+ * Narrative sections (Purpose, ASCII Layout, Regions, Actions, Form Fields,
+ * Data Columns, Navigation) are appended BELOW the marker by the
+ * sungen-figma-source skill, which reads the raw cached node JSON.
+ *
+ * Section renderers live in spec-figma-section-renderers.ts.
+ *
+ * This module never reads from disk or makes network calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSpecFigma = renderSpecFigma;
+const spec_figma_section_renderers_1 = require("./spec-figma-section-renderers");
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Render the deterministic envelope for spec_figma.md.
+ * The LLM synthesis step (sungen-figma-source skill) appends the narrative
+ * sections AFTER the SYNTHESIS_MARKER comment. Re-synthesis replaces
+ * everything from the marker to EOF.
+ *
+ * Pure function — no I/O side effects.
+ */
+function renderSpecFigma(input) {
+    const sections = [
+        (0, spec_figma_section_renderers_1.renderFrontmatter)(input),
+        '',
+        '> Envelope is AUTO-GENERATED. Narrative sections below the marker are LLM-synthesized.',
+        '> To refine, copy useful parts into ../spec.md (authoritative).',
+        '',
+        (0, spec_figma_section_renderers_1.renderFrame)(input.filteredNode),
+        '',
+        (0, spec_figma_section_renderers_1.renderScreenshots)(input.imagePaths),
+        '',
+        spec_figma_section_renderers_1.SYNTHESIS_MARKER,
+        '',
+    ];
+    return sections.join('\n') + '\n';
+}
+//# sourceMappingURL=spec-figma-renderer.js.map

package/dist/orchestrator/figma/spec-figma-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-figma-renderer.js","sourceRoot":"","sources":["../../../src/orchestrator/figma/spec-figma-renderer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAmDH,0CAgBC;AA5DD,iFAKwC;AA2BxC,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,KAA2B;IACzD,MAAM,QAAQ,GAAG;QACf,IAAA,gDAAiB,EAAC,KAAK,CAAC;QACxB,EAAE;QACF,wFAAwF;QACxF,iEAAiE;QACjE,EAAE;QACF,IAAA,0CAAW,EAAC,KAAK,CAAC,YAAY,CAAC;QAC/B,EAAE;QACF,IAAA,gDAAiB,EAAC,KAAK,CAAC,UAAU,CAAC;QACnC,EAAE;QACF,+CAAgB;QAChB,EAAE;KACH,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACpC,CAAC"}

package/dist/orchestrator/figma/spec-figma-section-renderers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Section-render helpers for spec-figma-renderer.ts.
+ *
+ * After the shift to LLM-synthesized narrative sections, the envelope only
+ * needs: frontmatter, Frame metadata, Screenshots, and the SYNTHESIS marker.
+ * All prose sections (Purpose, ASCII Layout, Regions, Actions, Form Fields,
+ * Data Columns, Navigation) are appended below the marker by the
+ * sungen-figma-source skill.
+ *
+ * Pure — no I/O.
+ */
+import type { FilteredFigmaNode } from '../../tools/figma/figma-client-types';
+import type { RenderSpecFigmaInput } from './spec-figma-renderer';
+/**
+ * Sentinel comment that separates the deterministic envelope (above) from
+ * the LLM-synthesized narrative (below). Re-synthesis replaces everything
+ * from this marker to EOF.
+ */
+export declare const SYNTHESIS_MARKER = "<!-- SYNTHESIS-BELOW -->";
+export declare function renderFrontmatter(input: RenderSpecFigmaInput): string;
+export declare function renderFrame(node: FilteredFigmaNode): string;
+export declare function renderScreenshots(imagePaths: string[]): string;
+//# sourceMappingURL=spec-figma-section-renderers.d.ts.map

package/dist/orchestrator/figma/spec-figma-section-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-figma-section-renderers.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/figma/spec-figma-section-renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAWrE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAI3D;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAI9D"}