devlens-mcp 0.4.2 → 0.5.2

package/dist/src/prototype/browser-engine.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserEngine = void 0;
+const DEFAULT_VIEWPORT = { width: 390, height: 844 };
+const NAVIGATION_TIMEOUT_MS = 30_000;
+const NETWORK_IDLE_TIMEOUT_MS = 5_000;
+/**
+ * Thin wrapper around Puppeteer for headless Chrome lifecycle management.
+ * Lazily imports puppeteer so the rest of DevLens does not fail if the
+ * optional dependency is missing.
+ */
+class BrowserEngine {
+    browser = null;
+    page = null;
+    options;
+    constructor(options) {
+        this.options = {
+            viewportWidth: options?.viewportWidth ?? DEFAULT_VIEWPORT.width,
+            viewportHeight: options?.viewportHeight ?? DEFAULT_VIEWPORT.height,
+            headless: options?.headless ?? true,
+        };
+    }
+    async launch() {
+        const puppeteer = await import("puppeteer");
+        this.browser = await puppeteer.default.launch({
+            headless: this.options.headless,
+            args: [
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+                "--disable-gpu",
+                "--disable-dev-shm-usage",
+            ],
+        });
+        this.page = await this.browser.newPage();
+        await this.page.setViewport({
+            width: this.options.viewportWidth,
+            height: this.options.viewportHeight,
+            deviceScaleFactor: 2,
+        });
+        await this.page.setUserAgent("Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) " +
+            "AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 " +
+            "Mobile/15E148 Safari/604.1");
+    }
+    async navigate(url) {
+        const page = this.ensurePage();
+        await page.goto(url, {
+            waitUntil: "networkidle2",
+            timeout: NAVIGATION_TIMEOUT_MS,
+        });
+    }
+    async screenshot() {
+        const page = this.ensurePage();
+        const data = await page.screenshot({
+            type: "png",
+            fullPage: true,
+            encoding: "binary",
+        });
+        return Buffer.from(data);
+    }
+    async viewportScreenshot() {
+        const page = this.ensurePage();
+        const data = await page.screenshot({
+            type: "png",
+            fullPage: false,
+            encoding: "binary",
+        });
+        return Buffer.from(data);
+    }
+    async scrollPage(direction, distance = 500) {
+        const page = this.ensurePage();
+        const d = direction === "down" ? distance : -distance;
+        await page.evaluate((scrollY) => {
+            window.scrollBy({ top: scrollY, behavior: "smooth" });
+        }, d);
+        await this.waitMs(400);
+    }
+    async getScrollHeight() {
+        const page = this.ensurePage();
+        return page.evaluate(() => document.body.scrollHeight);
+    }
+    async getScrollPosition() {
+        const page = this.ensurePage();
+        return page.evaluate(() => window.scrollY);
+    }
+    async click(x, y) {
+        const page = this.ensurePage();
+        await page.mouse.click(x, y);
+    }
+    async clickElement(selector) {
+        const page = this.ensurePage();
+        try {
+            await page.click(selector);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async extractLinks() {
+        const page = this.ensurePage();
+        return page.evaluate(() => {
+            const origin = window.location.origin;
+            const anchors = Array.from(document.querySelectorAll("a[href]"));
+            const seen = new Set();
+            const results = [];
+            for (const a of anchors) {
+                const href = a.href;
+                if (!href.startsWith(origin))
+                    continue;
+                const normalized = href.split("#")[0].split("?")[0];
+                if (seen.has(normalized))
+                    continue;
+                seen.add(normalized);
+                results.push({
+                    text: (a.textContent || "").trim().slice(0, 80),
+                    href,
+                });
+            }
+            return results;
+        });
+    }
+    async extractDomMetadata() {
+        const page = this.ensurePage();
+        return page.evaluate(() => {
+            const title = document.title || "";
+            const headings = Array.from(document.querySelectorAll("h1, h2, h3, h4")).map((el) => (el.textContent || "").trim().slice(0, 120));
+            const origin = window.location.origin;
+            const links = Array.from(document.querySelectorAll("a[href]"))
+                .filter((a) => a.href.startsWith(origin))
+                .map((a) => ({
+                text: (a.textContent || "").trim().slice(0, 80),
+                href: a.href,
+            }));
+            const images = Array.from(document.querySelectorAll("img"))
+                .slice(0, 30)
+                .map((img) => ({
+                src: img.src?.slice(0, 200) || "",
+                alt: img.alt || "",
+            }));
+            const interactiveSelectors = "button, [role=button], input, select, textarea, [onclick], a";
+            const interactiveElements = Array.from(document.querySelectorAll(interactiveSelectors))
+                .slice(0, 50)
+                .map((el) => {
+                const rect = el.getBoundingClientRect();
+                return {
+                    tag: el.tagName.toLowerCase(),
+                    text: (el.textContent || "").trim().slice(0, 80),
+                    href: el.href || undefined,
+                    role: el.getAttribute("role") || undefined,
+                    bounds: {
+                        x: Math.round(rect.x),
+                        y: Math.round(rect.y),
+                        width: Math.round(rect.width),
+                        height: Math.round(rect.height),
+                    },
+                };
+            });
+            const textContent = (document.body.innerText || "")
+                .replace(/\s+/g, " ")
+                .trim()
+                .slice(0, 2000);
+            return { title, headings, links, images, interactiveElements, textContent };
+        });
+    }
+    async waitForNavigation() {
+        const page = this.ensurePage();
+        try {
+            await page.waitForNavigation({
+                waitUntil: "networkidle2",
+                timeout: NETWORK_IDLE_TIMEOUT_MS,
+            });
+        }
+        catch {
+            /* timeout is acceptable – the page may not navigate */
+        }
+    }
+    async waitMs(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async currentUrl() {
+        const page = this.ensurePage();
+        return page.url();
+    }
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+            this.page = null;
+        }
+    }
+    ensurePage() {
+        if (!this.page) {
+            throw new Error("Browser not launched. Call launch() before using the engine.");
+        }
+        return this.page;
+    }
+}
+exports.BrowserEngine = BrowserEngine;
+//# sourceMappingURL=browser-engine.js.map

package/dist/src/prototype/browser-engine.js.map

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

package/dist/src/prototype/figma-navigator.d.ts

@@ -0,0 +1,40 @@
+import { BrowserEngine } from "./browser-engine.js";
+import type { PrototypeFlowSummary } from "../figma/figma-api.js";
+export interface NavigationStep {
+    screenId: string;
+    screenName: string;
+    screenshot: Buffer;
+    fromScreenId?: string;
+    trigger?: string;
+    transitionType?: string;
+    transitionDuration?: number;
+}
+export interface FigmaNavigatorOptions {
+    maxScreens: number;
+    captureDelay: number;
+}
+/**
+ * Navigate a Figma prototype by opening the prototype URL in Puppeteer
+ * and using the flow graph from the Figma REST API to determine where
+ * to click.
+ *
+ * Because the Figma prototype viewer renders inside a `<canvas>`,
+ * DOM-based hotspot detection is not possible. We rely on the prototype
+ * starting state and advance by clicking in the centre of the viewport
+ * (the most common hotspot zone) or at the approximate coordinate
+ * derived from the connection metadata.
+ */
+export declare class FigmaNavigator {
+    private readonly engine;
+    private readonly options;
+    constructor(engine: BrowserEngine, options: FigmaNavigatorOptions);
+    navigatePrototype(protoUrl: string, flow: PrototypeFlowSummary): Promise<NavigationStep[]>;
+    /**
+     * Advance the Figma prototype by clicking the centre of the viewport.
+     * Figma prototype hotspots are typically full-frame overlays or large
+     * CTA areas.  A centre-click covers the majority of single-hotspot
+     * frames.
+     */
+    private advancePrototype;
+}
+//# sourceMappingURL=figma-navigator.d.ts.map

package/dist/src/prototype/figma-navigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-navigator.d.ts","sourceRoot":"","sources":["../../../src/prototype/figma-navigator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAkBD;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB;IAK3D,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC;IA0D5B;;;;;OAKG;YACW,gBAAgB;CAM/B"}

package/dist/src/prototype/figma-navigator.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaNavigator = void 0;
+/**
+ * Build an adjacency list from prototype connections so we can
+ * BFS through the flow graph.
+ */
+function buildAdjacency(connections) {
+    const adj = new Map();
+    for (const conn of connections) {
+        const list = adj.get(conn.sourceNodeId) || [];
+        list.push(conn);
+        adj.set(conn.sourceNodeId, list);
+    }
+    return adj;
+}
+/**
+ * Navigate a Figma prototype by opening the prototype URL in Puppeteer
+ * and using the flow graph from the Figma REST API to determine where
+ * to click.
+ *
+ * Because the Figma prototype viewer renders inside a `<canvas>`,
+ * DOM-based hotspot detection is not possible. We rely on the prototype
+ * starting state and advance by clicking in the centre of the viewport
+ * (the most common hotspot zone) or at the approximate coordinate
+ * derived from the connection metadata.
+ */
+class FigmaNavigator {
+    engine;
+    options;
+    constructor(engine, options) {
+        this.engine = engine;
+        this.options = options;
+    }
+    async navigatePrototype(protoUrl, flow) {
+        const steps = [];
+        const adjacency = buildAdjacency(flow.connections);
+        const visited = new Set();
+        await this.engine.navigate(protoUrl);
+        await this.engine.waitMs(this.options.captureDelay + 1000);
+        const startId = flow.startingNodeId || flow.allScreenIds[0];
+        if (!startId)
+            return steps;
+        const startName = flow.startingNodeName ||
+            flow.allScreenNames.get(startId) ||
+            "Start Screen";
+        steps.push({
+            screenId: startId,
+            screenName: startName,
+            screenshot: await this.engine.viewportScreenshot(),
+        });
+        visited.add(startId);
+        const queue = [startId];
+        while (queue.length > 0 && steps.length < this.options.maxScreens) {
+            const currentId = queue.shift();
+            const edges = adjacency.get(currentId) || [];
+            for (const edge of edges) {
+                if (visited.has(edge.destinationNodeId))
+                    continue;
+                if (steps.length >= this.options.maxScreens)
+                    break;
+                await this.advancePrototype();
+                await this.engine.waitMs(this.options.captureDelay);
+                const destName = flow.allScreenNames.get(edge.destinationNodeId) ||
+                    `Screen ${steps.length + 1}`;
+                steps.push({
+                    screenId: edge.destinationNodeId,
+                    screenName: destName,
+                    screenshot: await this.engine.viewportScreenshot(),
+                    fromScreenId: currentId,
+                    trigger: edge.trigger,
+                    transitionType: edge.transitionType,
+                    transitionDuration: edge.transitionDuration,
+                });
+                visited.add(edge.destinationNodeId);
+                queue.push(edge.destinationNodeId);
+            }
+        }
+        return steps;
+    }
+    /**
+     * Advance the Figma prototype by clicking the centre of the viewport.
+     * Figma prototype hotspots are typically full-frame overlays or large
+     * CTA areas.  A centre-click covers the majority of single-hotspot
+     * frames.
+     */
+    async advancePrototype() {
+        const vw = 390;
+        const vh = 844;
+        await this.engine.click(Math.round(vw / 2), Math.round(vh / 2));
+        await this.engine.waitMs(800);
+    }
+}
+exports.FigmaNavigator = FigmaNavigator;
+//# sourceMappingURL=figma-navigator.js.map

package/dist/src/prototype/figma-navigator.js.map

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

package/dist/src/prototype/flow-reporter.d.ts

@@ -0,0 +1,47 @@
+import type { CrawlResult } from "./web-crawler.js";
+import type { NavigationStep } from "./figma-navigator.js";
+import type { ScreenAnalysis } from "./screen-analyzer.js";
+export interface ScreenReport {
+    name: string;
+    url?: string;
+    screenshot: Buffer;
+    analysis: ScreenAnalysis;
+    transitionFrom?: string;
+    trigger?: string;
+}
+export interface FlowReport {
+    type: "web" | "figma";
+    totalScreens: number;
+    screens: ScreenReport[];
+    flowDiagram: string;
+    designTokens: DesignTokenSummary;
+    componentInventory: string[];
+    actionNeeded?: string;
+}
+export interface DesignTokenSummary {
+    colors: Array<{
+        hex: string;
+        percentage: number;
+    }>;
+    headings: string[];
+}
+/**
+ * Build a flow report from web crawler results and per-screen analyses.
+ */
+export declare function buildWebFlowReport(crawlResults: CrawlResult[], analyses: ScreenAnalysis[], missingFigmaUrl: boolean): FlowReport;
+/**
+ * Build a flow report from Figma navigator steps and per-screen analyses.
+ */
+export declare function buildFigmaFlowReport(steps: NavigationStep[], analyses: ScreenAnalysis[], missingDesignUrl: boolean): FlowReport;
+/**
+ * Format a FlowReport into MCP-compatible content blocks.
+ */
+export declare function formatFlowReportContent(report: FlowReport): Array<{
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+}>;
+//# sourceMappingURL=flow-reporter.d.ts.map

package/dist/src/prototype/flow-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-reporter.d.ts","sourceRoot":"","sources":["../../../src/prototype/flow-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,kBAAkB,CAAC;IACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,WAAW,EAAE,EAC3B,QAAQ,EAAE,cAAc,EAAE,EAC1B,eAAe,EAAE,OAAO,GACvB,UAAU,CAgCZ;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,cAAc,EAAE,EAC1B,gBAAgB,EAAE,OAAO,GACxB,UAAU,CA+BZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiG3F"}

package/dist/src/prototype/flow-reporter.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildWebFlowReport = buildWebFlowReport;
+exports.buildFigmaFlowReport = buildFigmaFlowReport;
+exports.formatFlowReportContent = formatFlowReportContent;
+/**
+ * Build a flow report from web crawler results and per-screen analyses.
+ */
+function buildWebFlowReport(crawlResults, analyses, missingFigmaUrl) {
+    const screens = crawlResults.map((cr, idx) => ({
+        name: cr.path === "/" ? "Home" : cr.path,
+        url: cr.url,
+        screenshot: cr.screenshot,
+        analysis: analyses[idx] || emptyAnalysis(),
+    }));
+    const flowDiagram = buildWebFlowDiagram(crawlResults);
+    const designTokens = aggregateDesignTokens(analyses);
+    const componentInventory = aggregateComponents(analyses);
+    let actionNeeded;
+    if (missingFigmaUrl) {
+        actionNeeded =
+            "ACTION NEEDED: Provide the Figma design link so I can extract exact " +
+                "design specs. Ask the developer:\n" +
+                "'Is there a Figma file for this prototype? I need it for pixel-perfect specs " +
+                "(colors, spacing, typography, component structure).'\n\n" +
+                "Without Figma: visual patterns extracted from screenshots (~85% accuracy).\n" +
+                "With Figma: exact design tokens + flow = near-100% accuracy.";
+    }
+    return {
+        type: "web",
+        totalScreens: screens.length,
+        screens,
+        flowDiagram,
+        designTokens,
+        componentInventory,
+        actionNeeded,
+    };
+}
+/**
+ * Build a flow report from Figma navigator steps and per-screen analyses.
+ */
+function buildFigmaFlowReport(steps, analyses, missingDesignUrl) {
+    const screens = steps.map((step, idx) => ({
+        name: step.screenName,
+        screenshot: step.screenshot,
+        analysis: analyses[idx] || emptyAnalysis(),
+        transitionFrom: step.fromScreenId
+            ? steps.find((s) => s.screenId === step.fromScreenId)?.screenName
+            : undefined,
+        trigger: step.trigger,
+    }));
+    const flowDiagram = buildFigmaFlowDiagram(steps);
+    const designTokens = aggregateDesignTokens(analyses);
+    const componentInventory = aggregateComponents(analyses);
+    let actionNeeded;
+    if (missingDesignUrl) {
+        actionNeeded =
+            "ACTION NEEDED: Also provide the Figma DESIGN link (figma.com/design/...) " +
+                "so I can extract exact design specs alongside the prototype flow.";
+    }
+    return {
+        type: "figma",
+        totalScreens: screens.length,
+        screens,
+        flowDiagram,
+        designTokens,
+        componentInventory,
+        actionNeeded,
+    };
+}
+/**
+ * Format a FlowReport into MCP-compatible content blocks.
+ */
+function formatFlowReportContent(report) {
+    const content = [];
+    const headerLines = [
+        `# Prototype Exploration Report`,
+        ``,
+        `Type: ${report.type === "web" ? "Web-hosted prototype" : "Figma prototype"}`,
+        `Total screens: ${report.totalScreens}`,
+        ``,
+        `## Flow Diagram`,
+        report.flowDiagram,
+        ``,
+    ];
+    if (report.designTokens.colors.length > 0) {
+        headerLines.push(`## Design Tokens (extracted)`);
+        headerLines.push(`### Colors`);
+        for (const c of report.designTokens.colors.slice(0, 10)) {
+            headerLines.push(`  ${c.hex} (${c.percentage.toFixed(1)}%)`);
+        }
+        headerLines.push(``);
+    }
+    if (report.designTokens.headings.length > 0) {
+        headerLines.push(`### Typography (headings found)`);
+        for (const h of report.designTokens.headings.slice(0, 15)) {
+            headerLines.push(`  - ${h}`);
+        }
+        headerLines.push(``);
+    }
+    if (report.componentInventory.length > 0) {
+        headerLines.push(`## Component Inventory`);
+        for (const c of report.componentInventory) {
+            headerLines.push(`  - ${c}`);
+        }
+        headerLines.push(``);
+    }
+    if (report.actionNeeded) {
+        headerLines.push(`---`);
+        headerLines.push(report.actionNeeded);
+        headerLines.push(``);
+    }
+    content.push({ type: "text", text: headerLines.join("\n") });
+    for (const screen of report.screens) {
+        const screenLines = [
+            `---`,
+            `### Screen: ${screen.name}`,
+        ];
+        if (screen.url) {
+            screenLines.push(`URL: ${screen.url}`);
+        }
+        if (screen.transitionFrom) {
+            screenLines.push(`Transition: from "${screen.transitionFrom}" via ${screen.trigger || "tap"}`);
+        }
+        const a = screen.analysis;
+        if (a.colorPalette.length > 0) {
+            screenLines.push(`Colors: ${a.colorPalette.slice(0, 5).map((c) => c.hex).join(", ")}`);
+        }
+        if (a.sectionCount > 0) {
+            screenLines.push(`Sections: ${a.sectionCount}`);
+        }
+        if (a.interactiveElements.length > 0) {
+            screenLines.push(`Interactive elements: ${a.interactiveElements.length}`);
+        }
+        if (a.components.length > 0) {
+            screenLines.push(`Components: ${a.components.map((c) => `${c.type}(${c.count})`).join(", ")}`);
+        }
+        if (a.navigationElements.length > 0) {
+            screenLines.push(`Nav: ${a.navigationElements.map((n) => n.text).join(", ")}`);
+        }
+        content.push({ type: "text", text: screenLines.join("\n") });
+        content.push({
+            type: "image",
+            data: screen.screenshot.toString("base64"),
+            mimeType: "image/png",
+        });
+    }
+    return content;
+}
+function buildWebFlowDiagram(results) {
+    if (results.length === 0)
+        return "(no screens found)";
+    const lines = [];
+    const homePage = results[0];
+    for (const result of results) {
+        const label = result.path === "/" ? "Home" : result.path;
+        const linkCount = result.domMetadata.links.length;
+        const interactiveCount = result.domMetadata.interactiveElements.length;
+        lines.push(`  [${label}] (${linkCount} links, ${interactiveCount} interactive)`);
+    }
+    const connections = [];
+    for (const result of results) {
+        const from = result.path === "/" ? "Home" : result.path;
+        for (const link of result.domMetadata.links) {
+            const toPath = extractPath(link.href);
+            const matchingScreen = results.find((r) => r.path === toPath);
+            if (matchingScreen && matchingScreen.path !== result.path) {
+                const to = matchingScreen.path === "/" ? "Home" : matchingScreen.path;
+                connections.push(`  ${from} --(${link.text || "link"})--> ${to}`);
+            }
+        }
+    }
+    return [
+        "Screens:",
+        ...lines,
+        "",
+        "Flow connections:",
+        ...deduplicateStrings(connections).slice(0, 30),
+    ].join("\n");
+}
+function buildFigmaFlowDiagram(steps) {
+    if (steps.length === 0)
+        return "(no screens found)";
+    const lines = ["Screens:"];
+    for (const step of steps) {
+        lines.push(`  [${step.screenName}] (id: ${step.screenId})`);
+    }
+    lines.push("", "Flow connections:");
+    for (const step of steps) {
+        if (step.fromScreenId) {
+            const fromName = steps.find((s) => s.screenId === step.fromScreenId)?.screenName ||
+                step.fromScreenId;
+            const trigger = step.trigger || "tap";
+            const transition = step.transitionType
+                ? ` (${step.transitionType}${step.transitionDuration ? ` ${step.transitionDuration}ms` : ""})`
+                : "";
+            lines.push(`  ${fromName} --(${trigger}${transition})--> ${step.screenName}`);
+        }
+    }
+    return lines.join("\n");
+}
+function aggregateDesignTokens(analyses) {
+    const colorMap = new Map();
+    const allHeadings = [];
+    for (const a of analyses) {
+        for (const c of a.colorPalette) {
+            colorMap.set(c.hex, (colorMap.get(c.hex) || 0) + c.percentage);
+        }
+        for (const t of a.typography) {
+            allHeadings.push(t.text);
+        }
+    }
+    const colors = [...colorMap.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([hex, percentage]) => ({ hex, percentage }));
+    return { colors, headings: deduplicateStrings(allHeadings) };
+}
+function aggregateComponents(analyses) {
+    const seen = new Set();
+    const items = [];
+    for (const a of analyses) {
+        for (const c of a.components) {
+            const key = `${c.type}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                items.push(`${c.type} (found ${c.count}x, e.g. ${c.examples.slice(0, 2).join(", ")})`);
+            }
+        }
+    }
+    return items;
+}
+function extractPath(url) {
+    try {
+        return new URL(url).pathname.replace(/\/+$/, "") || "/";
+    }
+    catch {
+        return "/";
+    }
+}
+function deduplicateStrings(arr) {
+    return [...new Set(arr)];
+}
+function emptyAnalysis() {
+    return {
+        colorPalette: [],
+        typography: [],
+        components: [],
+        interactiveElements: [],
+        navigationElements: [],
+        scrollDepth: 0,
+        sectionCount: 0,
+    };
+}
+//# sourceMappingURL=flow-reporter.js.map