browser-devtools-mcp 0.0.3 → 0.1.1

package/dist/tools/figma/compare/compare-text-embedding.js

@@ -0,0 +1,291 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compare = compare;
+const config_1 = require("../../../config");
+const vector_1 = require("./vector");
+const client_bedrock_runtime_1 = require("@aws-sdk/client-bedrock-runtime");
+const credential_providers_1 = require("@aws-sdk/credential-providers");
+const sharp_1 = __importDefault(require("sharp"));
+const UI_DESCRIBE_PROMPT = `
+You are analyzing a UI screenshot to compare it against another UI.
+
+Your goal is to produce a STRUCTURAL LAYOUT FINGERPRINT that remains stable
+even when real data, text values, or content change.
+
+Write a concise but highly informative description using the rules below.
+
+GENERAL RULES
+- Describe WHAT EXISTS and WHERE IT IS, not how it looks visually.
+- Prefer explicit structure and hierarchy over natural language.
+- Be consistent and deterministic in wording.
+- Do NOT describe colors, fonts, themes, or exact text.
+- Do NOT include user data, names, numbers, timestamps, or labels.
+
+LAYOUT STRUCTURE
+Describe the UI from top to bottom:
+
+1) PAGE REGIONS
+- Identify major regions in order:
+  - top header / app bar
+  - left or right sidebar
+  - main content area
+  - footer (if present)
+
+2) REGION DETAILS
+For EACH region, describe:
+- Position (top / left / right / center / full-width)
+- Layout type (row, column, grid, split, stacked)
+- Whether it is fixed or scrollable
+- Primary purpose (navigation, content, controls, metadata)
+
+3) COMPONENT INVENTORY
+List the components that exist, grouped by region:
+- navigation menus
+- tabs
+- tables (rows/columns, header present or not)
+- lists (vertical/horizontal, item density: sparse/medium/dense)
+- cards (count: single / few / many)
+- forms (inline / multi-section)
+- modals, drawers, overlays (present or not)
+
+4) HIERARCHY & RELATIONSHIPS
+Explicitly mention:
+- parent → child relationships
+- repeated patterns (e.g. "repeating card list", "uniform table rows")
+- alignment relationships (sidebar + main content, header spanning all columns)
+
+5) ABSENCE IS SIGNAL
+If something is NOT present, state it explicitly when relevant:
+- no sidebar
+- no table
+- no modal
+- no pagination
+
+FORMAT
+- Use short bullet-style sentences.
+- Use consistent phrasing across similar structures.
+- Avoid synonyms (always say “sidebar”, not sometimes “side panel”).
+- Keep the output under ~30 lines.
+
+Return plain text only. No markdown.
+`;
+/**
+ * -----------------------------------------------------------------------------
+ * Helpers
+ * -----------------------------------------------------------------------------
+ */
+function _resolvePrompt(opt) {
+    return opt?.prompt ?? UI_DESCRIBE_PROMPT.trim();
+}
+function _resolveMaxDim(opt) {
+    return typeof opt?.maxDim === 'number' && opt.maxDim > 0
+        ? Math.floor(opt.maxDim)
+        : 1024;
+}
+function _resolveImageFormat(opt) {
+    return opt?.imageFormat === 'jpeg' ? 'jpeg' : 'png';
+}
+function _resolveJpegQuality(opt) {
+    const q = opt?.jpegQuality;
+    return typeof q === 'number' && q >= 50 && q <= 100 ? Math.floor(q) : 90;
+}
+async function _preprocessImage(buf, opt) {
+    const maxDim = _resolveMaxDim(opt);
+    const format = _resolveImageFormat(opt);
+    const jpegQuality = _resolveJpegQuality(opt);
+    let img = (0, sharp_1.default)(buf).resize({
+        width: maxDim,
+        height: maxDim,
+        fit: 'inside',
+        withoutEnlargement: true,
+    });
+    let out;
+    let mimeType;
+    if (format === 'png') {
+        out = await img.png().toBuffer();
+        mimeType = 'image/png';
+    }
+    else {
+        out = await img.jpeg({ quality: jpegQuality }).toBuffer();
+        mimeType = 'image/jpeg';
+    }
+    return { bytes: out, mimeType };
+}
+/**
+ * -----------------------------------------------------------------------------
+ * Amazon Bedrock specific embedding implementations
+ * -----------------------------------------------------------------------------
+ */
+////////////////////////////////////////////////////////////////////////////////
+const SUPPORTED_AMAZON_BEDROCK_TEXT_EMBED_MODEL_IDS = new Set([
+    'amazon.titan-embed-text-v2:0',
+]);
+const DEFAULT_AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID = 'amazon.titan-embed-text-v2:0';
+const SUPPORTED_AMAZON_BEDROCK_VISION_MODEL_IDS = new Set([
+    'anthropic.claude-3-haiku-20240307-v1',
+    'anthropic.claude-3-sonnet-20240229-v1:0',
+    'anthropic.claude-3-5-sonnet-20241022-v2:0',
+    'anthropic.claude-3-7-sonnet-20250219-v1:0',
+    'anthropic.claude-3-opus-20240229-v1:0',
+    'anthropic.claude-haiku-4-5-20251001-v1:0',
+    'anthropic.claude-opus-4-1-20250805-v1:0',
+    'anthropic.claude-opus-4-5-20251101-v1:0',
+]);
+const DEFAULT_AMAZON_BEDROCK_VISION_MODEL_ID = 'anthropic.claude-3-sonnet-20240229-v1:0';
+let _bedrockClient;
+function _isAwsBedrockActive() {
+    // Minimal "is Bedrock usable?" check:
+    // - Amazon Bedrock must be enabled
+    // - Region must exist
+    // - Credentials are resolved by AWS SDK default chain or AWS_PROFILE
+    return config_1.AMAZON_BEDROCK_ENABLE && Boolean(config_1.AWS_REGION);
+}
+function _getOrCreateBedrockClient() {
+    if (_bedrockClient) {
+        return _bedrockClient;
+    }
+    const region = config_1.AWS_REGION;
+    if (!region) {
+        return undefined;
+    }
+    const profile = config_1.AWS_PROFILE;
+    if (profile) {
+        _bedrockClient = new client_bedrock_runtime_1.BedrockRuntimeClient({
+            region,
+            credentials: (0, credential_providers_1.fromIni)({ profile }),
+        });
+        return _bedrockClient;
+    }
+    _bedrockClient = new client_bedrock_runtime_1.BedrockRuntimeClient({ region });
+    return _bedrockClient;
+}
+async function _invokeBedrock(client, modelId, payload) {
+    const cmd = new client_bedrock_runtime_1.InvokeModelCommand({
+        modelId,
+        contentType: 'application/json',
+        accept: 'application/json',
+        body: Buffer.from(JSON.stringify(payload)),
+    });
+    const resp = await client.send(cmd);
+    const raw = Buffer.from(resp.body).toString('utf-8');
+    return JSON.parse(raw);
+}
+async function _describeUIWithAmazonBedrockClaude(ss, opt, client, modelId) {
+    const { bytes, mimeType } = await _preprocessImage(ss.image, opt);
+    const prompt = _resolvePrompt(opt);
+    const payload = {
+        anthropic_version: 'bedrock-2023-05-31',
+        max_tokens: 10_000,
+        temperature: 0,
+        messages: [
+            {
+                role: 'user',
+                content: [
+                    { type: 'text', text: prompt },
+                    {
+                        type: 'image',
+                        source: {
+                            type: 'base64',
+                            media_type: mimeType,
+                            data: bytes.toString('base64'),
+                        },
+                    },
+                ],
+            },
+        ],
+    };
+    const parsed = await _invokeBedrock(client, modelId, payload);
+    const text = parsed?.content?.[0]?.text ?? parsed?.output_text ?? parsed?.completion;
+    if (!text || !text.trim()) {
+        throw new Error('Amazon Bedrock Claude returned empty description.');
+    }
+    return text.trim();
+}
+async function _embedTextWithAmazonBedrockTitan(text, client, modelId) {
+    const payload = {
+        inputText: text,
+    };
+    const parsed = await _invokeBedrock(client, modelId, payload);
+    const emb = parsed?.embedding;
+    if (!Array.isArray(emb) || typeof emb[0] !== 'number') {
+        throw new Error('Unexpected embedding response for Amazon Bedrock Titan text embedding.');
+    }
+    return emb;
+}
+async function _describeUIWithAmazonBedrock(ss, opt, client) {
+    const modelId = opt?.visionModelId ??
+        config_1.AMAZON_BEDROCK_VISION_MODEL_ID ??
+        DEFAULT_AMAZON_BEDROCK_VISION_MODEL_ID;
+    if (!SUPPORTED_AMAZON_BEDROCK_VISION_MODEL_IDS.has(modelId)) {
+        throw new Error(`Unsupported Amazon Bedrock vision model id: ${modelId}`);
+    }
+    return await _describeUIWithAmazonBedrockClaude(ss, opt, client, modelId);
+}
+async function _embedTextWithAmazonBedrock(text, opt, client) {
+    const modelId = opt?.textEmbedModelId ??
+        config_1.AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID ??
+        DEFAULT_AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID;
+    if (!SUPPORTED_AMAZON_BEDROCK_TEXT_EMBED_MODEL_IDS.has(modelId)) {
+        throw new Error(`Unsupported Amazon Bedrock text embedding model id: ${modelId}`);
+    }
+    return await _embedTextWithAmazonBedrockTitan(text, client, modelId);
+}
+/**
+ * -----------------------------------------------------------------------------
+ * Routing (LLM-agnostic)
+ * -----------------------------------------------------------------------------
+ */
+async function _describeUI(ss, opt) {
+    // Provider A: Amazon Bedrock
+    if (_isAwsBedrockActive()) {
+        const client = _getOrCreateBedrockClient();
+        if (!client) {
+            return undefined;
+        }
+        return _describeUIWithAmazonBedrock(ss, opt, client);
+    }
+    // No providers active
+    return undefined;
+}
+async function _embedTextVector(text, opt) {
+    // Provider A: Amazon Bedrock
+    if (_isAwsBedrockActive()) {
+        const client = _getOrCreateBedrockClient();
+        if (!client) {
+            return undefined;
+        }
+        return _embedTextWithAmazonBedrock(text, opt, client);
+    }
+    // No providers active
+    return undefined;
+}
+/**
+ * -----------------------------------------------------------------------------
+ * Public API
+ * -----------------------------------------------------------------------------
+ */
+async function compare(page, figma, options) {
+    const normalize = typeof options?.normalize === 'boolean' ? options.normalize : true;
+    const figmaDesc = await _describeUI(figma, options);
+    if (!figmaDesc) {
+        return undefined;
+    }
+    const pageDesc = await _describeUI(page, options);
+    if (!pageDesc) {
+        return undefined;
+    }
+    const figmaVec = await _embedTextVector(figmaDesc, options);
+    if (!figmaVec) {
+        return undefined;
+    }
+    const pageVec = await _embedTextVector(pageDesc, options);
+    if (!pageVec) {
+        return undefined;
+    }
+    const score = (0, vector_1.cosineSimilarity)(figmaVec, pageVec, normalize);
+    return { score };
+}
+//# sourceMappingURL=compare-text-embedding.js.map

package/dist/tools/figma/compare/compare-text-embedding.js.map

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

package/dist/tools/figma/compare/index.js

@@ -0,0 +1,139 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareWithNotes = compareWithNotes;
+const compare_mssim_1 = require("./compare-mssim");
+const compare_image_embedding_1 = require("./compare-image-embedding");
+const compare_text_embedding_1 = require("./compare-text-embedding");
+/**
+ * ------------------------------------------------------------
+ * Constants
+ * ------------------------------------------------------------
+ */
+const DEFAULT_MSSIM_WEIGHT = 0.25;
+const DEFAULT_VECTOR_EMBEDDING_WEIGHT = 0.5;
+const DEFAULT_TEXT_EMBEDDING_WEIGHT = 0.25;
+/**
+ * ------------------------------------------------------------
+ * Helpers
+ * ------------------------------------------------------------
+ */
+function _clamp01(v) {
+    if (!Number.isFinite(v)) {
+        return 0;
+    }
+    return Math.max(0, Math.min(1, v));
+}
+function _weightOrDefault(v, def) {
+    if (typeof v === 'number' && Number.isFinite(v) && v > 0) {
+        return v;
+    }
+    return def;
+}
+/**
+ * ------------------------------------------------------------
+ * Main combiner
+ * ------------------------------------------------------------
+ *
+ * - MSSIM is assumed to always work
+ * - Image / text embedding may return `undefined`
+ * - Only successful signals participate in the weighted average
+ */
+async function compareWithNotes(page, figma, options) {
+    const notes = [];
+    const wMssim = _weightOrDefault(options?.weights?.mssim, DEFAULT_MSSIM_WEIGHT);
+    const wVector = _weightOrDefault(options?.weights?.vectorEmbedding, DEFAULT_VECTOR_EMBEDDING_WEIGHT);
+    const wText = _weightOrDefault(options?.weights?.textEmbedding, DEFAULT_TEXT_EMBEDDING_WEIGHT);
+    /**
+     * --------------------------------------------------------
+     * 1) MSSIM (always)
+     * --------------------------------------------------------
+     */
+    const mssimRes = await (0, compare_mssim_1.compare)(page, figma, options?.mssim);
+    const mssimScore = _clamp01(mssimRes.score);
+    notes.push(`mssim=${mssimScore.toFixed(5)}`);
+    /**
+     * --------------------------------------------------------
+     * 2) Image embedding (optional)
+     * --------------------------------------------------------
+     */
+    let imageScore;
+    try {
+        const res = await (0, compare_image_embedding_1.compare)(page, figma, options?.imageEmbedding);
+        if (res && typeof res.score === 'number') {
+            imageScore = _clamp01(res.score);
+            notes.push(`image-embedding=${imageScore.toFixed(5)}`);
+        }
+        else {
+            notes.push('image-embedding=skipped (inactive)');
+        }
+    }
+    catch (err) {
+        notes.push(`image-embedding=skipped (${err instanceof Error ? err.message : String(err)})`);
+    }
+    /**
+     * --------------------------------------------------------
+     * 3) Vision → text → text embedding (optional)
+     * --------------------------------------------------------
+     */
+    let textScore;
+    try {
+        const res = await (0, compare_text_embedding_1.compare)(page, figma, options?.textEmbedding);
+        if (res && typeof res.score === 'number') {
+            textScore = _clamp01(res.score);
+            notes.push(`text-embedding=${textScore.toFixed(5)}`);
+        }
+        else {
+            notes.push('text-embedding=skipped (inactive)');
+        }
+    }
+    catch (err) {
+        notes.push(`text-embedding=skipped (${err instanceof Error ? err.message : String(err)})`);
+    }
+    /**
+     * --------------------------------------------------------
+     * Combine scores (weight renormalization)
+     * --------------------------------------------------------
+     */
+    const parts = [
+        { name: 'mssim', score: mssimScore, weight: wMssim },
+    ];
+    if (typeof imageScore === 'number') {
+        parts.push({
+            name: 'image-embedding',
+            score: imageScore,
+            weight: wVector,
+        });
+    }
+    if (typeof textScore === 'number') {
+        parts.push({
+            name: 'text-embedding',
+            score: textScore,
+            weight: wText,
+        });
+    }
+    const totalWeight = parts.reduce((s, p) => s + p.weight, 0);
+    const combined = totalWeight > 0
+        ? parts.reduce((s, p) => s + p.score * (p.weight / totalWeight), 0)
+        : 0;
+    const score = _clamp01(combined);
+    notes.push(`combined=${score.toFixed(5)} (signals=${parts
+        .map((p) => p.name)
+        .join(', ')})`);
+    return { score, notes };
+}
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/figma/compare/index.js.map

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

package/dist/tools/figma/compare/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tools/figma/compare/types.js.map

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

package/dist/tools/figma/compare/vector.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dot = dot;
+exports.norm = norm;
+exports.l2Normalize = l2Normalize;
+exports.cosineSimilarity = cosineSimilarity;
+function dot(a, b) {
+    const n = Math.min(a.length, b.length);
+    let s = 0;
+    for (let i = 0; i < n; i++) {
+        s += a[i] * b[i];
+    }
+    return s;
+}
+function norm(a) {
+    let s = 0;
+    for (let i = 0; i < a.length; i++) {
+        const x = a[i];
+        s += x * x;
+    }
+    return Math.sqrt(s);
+}
+function l2Normalize(v) {
+    const n = norm(v);
+    if (n === 0) {
+        return v.slice();
+    }
+    const out = new Array(v.length);
+    for (let i = 0; i < v.length; i++) {
+        out[i] = v[i] / n;
+    }
+    return out;
+}
+function cosineSimilarity(a, b, normalize) {
+    if (normalize) {
+        const na = l2Normalize(a);
+        const nb = l2Normalize(b);
+        return dot(na, nb);
+    }
+    const denom = norm(a) * norm(b);
+    if (denom === 0) {
+        return 0;
+    }
+    return dot(a, b) / denom;
+}
+//# sourceMappingURL=vector.js.map

package/dist/tools/figma/compare/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../../../src/tools/figma/compare/vector.ts"],"names":[],"mappings":";;AAEA,kBAOC;AAED,oBAOC;AAED,kCAWC;AAED,4CAgBC;AA/CD,SAAgB,GAAG,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,CAAC,GAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAW,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED,SAAgB,IAAI,CAAC,CAAS;IAC1B,IAAI,CAAC,GAAW,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAgB,WAAW,CAAC,CAAS;IACjC,MAAM,CAAC,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACV,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,GAAG,GAAW,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAgB,gBAAgB,CAC5B,CAAS,EACT,CAAS,EACT,SAAkB;IAElB,IAAI,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,GAAW,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,EAAE,GAAW,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAW,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACd,OAAO,CAAC,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAC7B,CAAC"}