gravity-lite 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 DharuNamikaze
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# gravity-lite
+
+AI-powered CSS layout diagnostics. Zero-config MCP server for AI assistants.
+
+[![npm version](https://img.shields.io/npm/v/gravity-lite.svg)](https://www.npmjs.com/package/gravity-lite)
+[![license](https://img.shields.io/npm/l/gravity-lite.svg)](LICENSE)
+
+Give your AI assistant (Kiro, Cursor, Claude, etc.) the ability to **see what actually renders** in your browser — not just read source code. Gravity bridges AI tools to live Chrome tabs via the Chrome DevTools Protocol.
+
+## Install
+
+```bash
+npm install -g gravity-lite
+```
+
+**Requirements:** Node.js ≥ 16, Chrome ≥ 116
+
+---
+
+## Setup (one-time, ~2 minutes)
+
+### 1. Add to your IDE MCP config
+
+**Kiro** (`.kiro/settings/mcp.json`), **Cursor** (`~/.cursor/mcp.json`), or **Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "gravity": { "command": "gravity" }
+  }
+}
+```
+
+Restart your IDE. The MCP server starts automatically.
+
+### 2. Load the Chrome extension
+
+```
+chrome://extensions  →  enable Developer Mode  →  Load unpacked
+```
+
+Point it at the `extension/` folder inside the package:
+
+```bash
+# Print the exact path to load
+gravity doctor
+```
+
+### 3. Connect to a tab
+
+Click the **Gravity** icon in Chrome → **Connect to Tab**.
+
+Done. The extension connects to the MCP server automatically.
+
+---
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `connect_browser` | Check extension connection status |
+| `diagnose_layout` | Detect overflow, hidden, offscreen, unresolved CSS vars |
+| `inspect_stacking` | Debug z-index failures and stacking context traps |
+| `check_accessibility` | WCAG contrast ratio, touch targets, ARIA tree |
+| `inspect_responsive` | Fixed widths that break on mobile, viewport overflow |
+| `debug_flexgrid` | Flexbox/Grid container + children deep analysis |
+| `get_computed_layout` | Full computed style snapshot with CSS rule specificity |
+| `highlight_element` | Color-coded overlay in the browser (content/padding/border/margin) |
+| `screenshot_element` | Capture any element as a base64 PNG |
+| `get_page_performance` | Layout thrash metrics, paint timings |
+
+### Example prompts
+
+```
+diagnose the #header element
+why is .modal behind everything — inspect stacking context
+check accessibility of the .submit-btn
+screenshot the #hero section
+highlight .nav-bar for 5 seconds
+debug the flex container .card-grid
+```
+
+---
+
+## How it works
+
+```
+IDE / AI  ──stdio──►  MCP Server (Node.js)
+                           │
+                      WS :9224  ◄── extension connects OUT to server
+                           │         (no native messaging, no OS setup)
+                    Chrome Extension (MV3)
+                     ├── offscreen.js  — persistent WebSocket
+                     └── background.js — chrome.debugger API
+                           │
+                       Active Tab (CDP)
+```
+
+**The key insight:** The extension connects *out* to the MCP server, not the other way around. No native messaging, no registry keys, no OS-specific setup. Works on Linux, macOS, and Windows.
+
+---
+
+## Commands
+
+```bash
+gravity           # start MCP server (called by IDE automatically)
+gravity doctor    # check setup status and print extension path
+```
+
+## Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `GRAVITY_PORT` | `9224` | WebSocket bridge port |
+
+---
+
+## Troubleshooting
+
+| Problem | Fix |
+|---|---|
+| "Browser extension not connected" | Open Chrome, load the extension, click "Connect to Tab" |
+| "Port 9224 already in use" | Set `GRAVITY_PORT=9225` in your MCP config |
+| MCP server dot stays red in popup | Make sure `gravity` is running (check IDE MCP status) |
+| "Element not found: #selector" | Verify the selector exists on the current page |
+| Chrome ≥ 116 required | The offscreen documents API was added in Chrome 116 |

package/dist/bridge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * bridge.ts — WebSocket server that the Chrome extension connects to.
+ *
+ * The MCP server IS the WebSocket server. The extension connects OUT to us.
+ * No native messaging. No manifest. No OS-specific registration.
+ *
+ * Extension  ──WS──►  Bridge (this)  ──CDP──►  MCP tools
+ */
+export declare function startBridge(): Promise<void>;
+export declare function sendCDP(method: string, params?: Record<string, unknown>): Promise<unknown>;
+export declare function isExtensionConnected(): boolean;
+export declare function getBridgePort(): number;

package/dist/bridge.js

@@ -0,0 +1,103 @@
+/**
+ * bridge.ts — WebSocket server that the Chrome extension connects to.
+ *
+ * The MCP server IS the WebSocket server. The extension connects OUT to us.
+ * No native messaging. No manifest. No OS-specific registration.
+ *
+ * Extension  ──WS──►  Bridge (this)  ──CDP──►  MCP tools
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+const PORT = process.env.GRAVITY_PORT ? Number(process.env.GRAVITY_PORT) : 9224;
+const CDP_TIMEOUT_MS = 10_000;
+let extensionSocket = null;
+let msgIdCounter = 1;
+const pending = new Map();
+// ── Start the bridge server ───────────────────────────────────────────────────
+export function startBridge() {
+    return new Promise((resolve, reject) => {
+        const wss = new WebSocketServer({ port: PORT, host: '127.0.0.1' });
+        wss.on('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new Error(`Port ${PORT} is already in use. ` +
+                    `Set GRAVITY_PORT env var to use a different port, ` +
+                    `then reload the extension popup to reconnect.`));
+            }
+            else {
+                reject(err);
+            }
+        });
+        wss.on('listening', () => {
+            console.error(`[gravity] bridge listening on ws://127.0.0.1:${PORT}`);
+            resolve();
+        });
+        wss.on('connection', (ws, req) => {
+            const origin = req.headers.origin ?? 'unknown';
+            console.error(`[gravity] extension connected (origin: ${origin})`);
+            // Only one extension at a time — close the old one
+            if (extensionSocket && extensionSocket.readyState === WebSocket.OPEN) {
+                extensionSocket.close();
+            }
+            extensionSocket = ws;
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if (msg.type === 'cdp_response') {
+                        const p = pending.get(msg.id);
+                        if (p) {
+                            clearTimeout(p.timer);
+                            pending.delete(msg.id);
+                            if (msg.error) {
+                                p.reject(new Error(msg.error.message));
+                            }
+                            else {
+                                p.resolve(msg.result);
+                            }
+                        }
+                    }
+                }
+                catch (e) {
+                    console.error('[gravity] bridge parse error:', e);
+                }
+            });
+            ws.on('close', () => {
+                console.error('[gravity] extension disconnected');
+                if (extensionSocket === ws)
+                    extensionSocket = null;
+                // Reject all pending requests
+                for (const [id, p] of pending) {
+                    clearTimeout(p.timer);
+                    p.reject(new Error('Extension disconnected'));
+                    pending.delete(id);
+                }
+            });
+            ws.on('error', (err) => {
+                console.error('[gravity] extension socket error:', err.message);
+            });
+        });
+    });
+}
+// ── Send a CDP command through the extension ──────────────────────────────────
+export function sendCDP(method, params = {}) {
+    if (!extensionSocket || extensionSocket.readyState !== WebSocket.OPEN) {
+        return Promise.reject(new Error('Browser extension not connected. ' +
+            'Make sure Chrome is open, the Gravity extension is loaded, ' +
+            'and you clicked "Connect to Tab" in the popup.'));
+    }
+    const id = msgIdCounter++;
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            pending.delete(id);
+            reject(new Error(`CDP ${method} timed out after ${CDP_TIMEOUT_MS}ms`));
+        }, CDP_TIMEOUT_MS);
+        pending.set(id, { resolve, reject, timer });
+        extensionSocket.send(JSON.stringify({ type: 'cdp_request', id, method, params }));
+    });
+}
+// ── Status helpers ────────────────────────────────────────────────────────────
+export function isExtensionConnected() {
+    return extensionSocket !== null && extensionSocket.readyState === WebSocket.OPEN;
+}
+export function getBridgePort() {
+    return PORT;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * cli.ts — Gravity v3 CLI entry point
+ *
+ * Commands:
+ *   gravity          — start the MCP server (default)
+ *   gravity doctor   — check setup status
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * cli.ts — Gravity v3 CLI entry point
+ *
+ * Commands:
+ *   gravity          — start the MCP server (default)
+ *   gravity doctor   — check setup status
+ */
+import { program } from 'commander';
+import { createRequire } from 'module';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+program
+    .name('gravity')
+    .description('AI-powered CSS layout diagnostics — MCP server')
+    .version(pkg.version);
+// ── doctor ────────────────────────────────────────────────────────────────────
+program
+    .command('doctor')
+    .description('Check setup status and print instructions')
+    .action(async () => {
+    const { default: WebSocket } = await import('ws');
+    const port = process.env.GRAVITY_PORT ? Number(process.env.GRAVITY_PORT) : 9224;
+    console.log('\nGravity v' + pkg.version + ' — setup check');
+    console.log('─'.repeat(40));
+    // Node version
+    const nodeOk = parseInt(process.version.slice(1)) >= 16;
+    console.log(`${nodeOk ? '✓' : '✗'} Node.js ${process.version}${nodeOk ? '' : ' (need ≥16)'}`);
+    // Extension folder
+    const extDir = resolve(__dirname, '..', 'extension');
+    const extOk = existsSync(resolve(extDir, 'manifest.json'));
+    console.log(`${extOk ? '✓' : '✗'} Extension folder: ${extDir}`);
+    if (!extOk)
+        console.log('  ↳ Run: npm install -g gravity-lite');
+    // Port availability / existing server
+    try {
+        await new Promise((resolve, reject) => {
+            const ws = new WebSocket(`ws://127.0.0.1:${port}`);
+            const t = setTimeout(() => { ws.close(); reject(new Error('timeout')); }, 2000);
+            ws.on('open', () => { clearTimeout(t); ws.close(); resolve(); });
+            ws.on('error', (e) => { clearTimeout(t); reject(e); });
+        });
+        console.log(`✓ MCP server is running on port ${port}`);
+    }
+    catch {
+        console.log(`✗ MCP server not running on port ${port}`);
+        console.log('  ↳ Add gravity to your IDE MCP config and restart');
+    }
+    console.log('─'.repeat(40));
+    console.log('\nExtension setup (one-time):');
+    console.log(`  1. Open chrome://extensions  →  enable Developer Mode`);
+    console.log(`  2. "Load unpacked"  →  select: ${extDir}`);
+    console.log(`  3. Click the Gravity icon  →  "Connect to Tab"`);
+    console.log('\nMCP config (add to your IDE):');
+    console.log(JSON.stringify({
+        mcpServers: {
+            gravity: { command: 'gravity' }
+        }
+    }, null, 2));
+    console.log();
+});
+// ── default: run MCP server ───────────────────────────────────────────────────
+program.action(async () => {
+    const { GravityMCPServer } = await import('./mcp-server.js');
+    const srv = new GravityMCPServer();
+    await srv.run();
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,67 @@
+/**
+ * diagnostics.ts — CSS layout & accessibility analysis helpers.
+ * Pure functions — no I/O, no side effects.
+ */
+export interface Bounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+export interface Issue {
+    type: string;
+    severity: 'high' | 'medium' | 'low';
+    message: string;
+    suggestion: string;
+}
+export declare function extractBounds(model: {
+    content: number[];
+    width: number;
+    height: number;
+}): Bounds;
+export declare function checkVisibility(styles: Map<string, string>): Issue[];
+export declare function checkOffscreen(bounds: Bounds, vp: {
+    clientWidth: number;
+    clientHeight: number;
+}): Issue[];
+export declare function checkOverflow(styles: Map<string, string>): Issue[];
+export declare function checkZIndex(styles: Map<string, string>): Issue[];
+export declare function checkStackingContextCreators(styles: Map<string, string>): {
+    creates: boolean;
+    reasons: string[];
+};
+export declare function checkFlexGrid(styles: Map<string, string>): Issue[];
+export declare function checkResponsive(styles: Map<string, string>, bounds: Bounds, vp: {
+    clientWidth: number;
+}): Issue[];
+export declare function checkAccessibilityStyles(styles: Map<string, string>): Issue[];
+/**
+ * Parse any CSS color string to { r, g, b } (0–255).
+ * Supports: rgb(...), rgba(...), #rrggbb, #rgb
+ */
+export declare function parseColor(color: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/** Relative luminance per WCAG 2.1 */
+export declare function relativeLuminance(r: number, g: number, b: number): number;
+/** Contrast ratio between two colours (1–21) */
+export declare function contrastRatio(c1: {
+    r: number;
+    g: number;
+    b: number;
+}, c2: {
+    r: number;
+    g: number;
+    b: number;
+}): number;
+export declare function checkColorContrast(styles: Map<string, string>): Issue[];
+export declare function checkCustomProperties(styles: Map<string, string>): Issue[];
+export declare function sortBySeverity(issues: Issue[]): Issue[];
+export declare function validateSelector(selector: string): {
+    valid: boolean;
+    error?: string;
+};