gravity-core 1.0.1

package/dist/diagnostics.js

@@ -0,0 +1,262 @@
+/**
+ * Layout diagnostics engine
+ * Analyzes layout issues and generates diagnostic reports
+ */
+export class DiagnosticsEngine {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Diagnose layout issues for an element
+     */
+    async diagnose(selector) {
+        // Validate selector
+        const validation = this.validateSelector(selector);
+        if (!validation.valid) {
+            throw new Error(`Invalid selector: ${validation.error}`);
+        }
+        // Get document root
+        const doc = await this.connection.sendCommand('DOM.getDocument', { depth: -1 });
+        const root = doc.root;
+        // Query for element
+        const queryResult = await this.connection.sendCommand('DOM.querySelector', {
+            nodeId: root.nodeId,
+            selector,
+        });
+        if (!queryResult.nodeId) {
+            throw new Error(`Element not found: ${selector}`);
+        }
+        const nodeId = queryResult.nodeId;
+        // Get box model
+        const boxResult = await this.connection.sendCommand('DOM.getBoxModel', { nodeId });
+        const model = boxResult.model;
+        // Get viewport metrics
+        const layoutMetrics = await this.connection.sendCommand('Page.getLayoutMetrics', {});
+        const viewport = layoutMetrics.layoutViewport;
+        // Get computed styles
+        const styleResult = await this.connection.sendCommand('CSS.getComputedStyleForNode', { nodeId });
+        const styleMap = new Map(styleResult.computedStyle.map((prop) => [prop.name, prop.value]));
+        // Extract bounds
+        const bounds = this.extractBounds(model);
+        // Run diagnostic checks
+        const issues = [];
+        issues.push(...this.checkVisibility(styleMap));
+        issues.push(...this.checkOffscreen(bounds, viewport));
+        issues.push(...this.checkModalIssues(styleMap, bounds, viewport));
+        issues.push(...this.checkOverflow(styleMap));
+        // Sort by severity
+        const severityOrder = { high: 0, medium: 1, low: 2 };
+        issues.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+        // Build result
+        const result = {
+            element: selector,
+            timestamp: new Date().toISOString(),
+            found: true,
+            position: {
+                left: bounds.left,
+                top: bounds.top,
+                right: bounds.right,
+                bottom: bounds.bottom,
+                width: bounds.width,
+                height: bounds.height,
+            },
+            viewport: {
+                width: viewport.clientWidth,
+                height: viewport.clientHeight,
+            },
+            computedStyles: {
+                display: styleMap.get('display') ?? '',
+                position: styleMap.get('position') ?? '',
+                width: styleMap.get('width') ?? '',
+                height: styleMap.get('height') ?? '',
+                overflow: styleMap.get('overflow') ?? '',
+                zIndex: styleMap.get('z-index') ?? '',
+                visibility: styleMap.get('visibility') ?? '',
+                opacity: styleMap.get('opacity') ?? '',
+            },
+            issues: issues.length > 0 ? issues : [
+                {
+                    type: 'none',
+                    severity: 'low',
+                    message: 'No layout issues detected',
+                    suggestion: 'Element appears to be positioned correctly',
+                },
+            ],
+            confidence: issues.length > 0 ? 0.95 : 0.85,
+            summary: {
+                totalIssues: issues.length,
+                highSeverity: issues.filter(i => i.severity === 'high').length,
+                mediumSeverity: issues.filter(i => i.severity === 'medium').length,
+                lowSeverity: issues.filter(i => i.severity === 'low').length,
+            },
+        };
+        return result;
+    }
+    /**
+     * Validate CSS selector
+     */
+    validateSelector(selector) {
+        if (!selector || typeof selector !== 'string') {
+            return { valid: false, error: 'Selector must be a non-empty string' };
+        }
+        const trimmed = selector.trim();
+        if (trimmed.length === 0) {
+            return { valid: false, error: 'Selector cannot be empty' };
+        }
+        if (/^[0-9]/.test(trimmed)) {
+            return { valid: false, error: 'Selector cannot start with a number' };
+        }
+        const openBrackets = (trimmed.match(/\[/g) || []).length;
+        const closeBrackets = (trimmed.match(/\]/g) || []).length;
+        if (openBrackets !== closeBrackets) {
+            return { valid: false, error: 'Unbalanced brackets' };
+        }
+        return { valid: true };
+    }
+    /**
+     * Extract element bounds from box model
+     */
+    extractBounds(boxModel) {
+        const left = Math.min(boxModel.content[0], boxModel.content[6]);
+        const top = Math.min(boxModel.content[1], boxModel.content[3]);
+        const right = Math.max(boxModel.content[2], boxModel.content[4]);
+        const bottom = Math.max(boxModel.content[5], boxModel.content[7]);
+        return {
+            left: Math.round(left),
+            top: Math.round(top),
+            right: Math.round(right),
+            bottom: Math.round(bottom),
+            width: Math.round(boxModel.width),
+            height: Math.round(boxModel.height),
+        };
+    }
+    /**
+     * Check visibility issues
+     */
+    checkVisibility(styleMap) {
+        const issues = [];
+        const display = styleMap.get('display');
+        if (display === 'none') {
+            issues.push({
+                type: 'hidden-display',
+                severity: 'high',
+                message: 'Element has display: none',
+                suggestion: 'Change to display: block/flex/grid to make visible',
+            });
+        }
+        const visibility = styleMap.get('visibility');
+        if (visibility === 'hidden') {
+            issues.push({
+                type: 'hidden-visibility',
+                severity: 'high',
+                message: 'Element has visibility: hidden',
+                suggestion: 'Change to visibility: visible',
+            });
+        }
+        const opacity = styleMap.get('opacity');
+        if (opacity !== undefined) {
+            const opacityValue = parseFloat(opacity);
+            if (opacityValue === 0) {
+                issues.push({
+                    type: 'hidden-opacity',
+                    severity: 'high',
+                    message: 'Element has opacity: 0',
+                    suggestion: 'Change to opacity: 1',
+                });
+            }
+            else if (opacityValue < 0.1) {
+                issues.push({
+                    type: 'low-opacity',
+                    severity: 'medium',
+                    message: `Element has very low opacity: ${opacity}`,
+                    suggestion: 'Increase opacity for better visibility',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * Check offscreen issues
+     */
+    checkOffscreen(bounds, viewport) {
+        const issues = [];
+        const THRESHOLD = 2;
+        if (bounds.right > viewport.clientWidth + THRESHOLD) {
+            const overflow = bounds.right - viewport.clientWidth;
+            issues.push({
+                type: 'offscreen-right',
+                severity: 'high',
+                message: `Element extends ${overflow}px beyond right edge`,
+                suggestion: 'Add max-width: 100% or use overflow: hidden on parent',
+                pixels: overflow,
+            });
+        }
+        if (bounds.bottom > viewport.clientHeight + THRESHOLD) {
+            const overflow = bounds.bottom - viewport.clientHeight;
+            issues.push({
+                type: 'offscreen-bottom',
+                severity: 'medium',
+                message: `Element extends ${overflow}px beyond bottom edge`,
+                suggestion: 'Add max-height: 100vh or enable scrolling',
+                pixels: overflow,
+            });
+        }
+        if (bounds.left < -THRESHOLD) {
+            const overflow = Math.abs(bounds.left);
+            issues.push({
+                type: 'offscreen-left',
+                severity: 'high',
+                message: `Element starts ${overflow}px to the left`,
+                suggestion: 'Check left/margin-left values',
+                pixels: overflow,
+            });
+        }
+        if (bounds.top < -THRESHOLD) {
+            const overflow = Math.abs(bounds.top);
+            issues.push({
+                type: 'offscreen-top',
+                severity: 'high',
+                message: `Element starts ${overflow}px above viewport`,
+                suggestion: 'Check top/margin-top values',
+                pixels: overflow,
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check modal/positioning issues
+     */
+    checkModalIssues(styleMap, bounds, viewport) {
+        const issues = [];
+        const position = styleMap.get('position');
+        const zIndex = styleMap.get('z-index');
+        if (position === 'fixed' || position === 'absolute') {
+            if (zIndex === 'auto' || !zIndex) {
+                issues.push({
+                    type: 'modal-no-zindex',
+                    severity: 'medium',
+                    message: `Positioned element (${position}) has no z-index`,
+                    suggestion: 'Add z-index: 1000 or higher for modals',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * Check overflow issues
+     */
+    checkOverflow(styleMap) {
+        const issues = [];
+        const overflow = styleMap.get('overflow');
+        if (overflow === 'hidden') {
+            issues.push({
+                type: 'overflow-hidden',
+                severity: 'low',
+                message: 'Element has overflow: hidden',
+                suggestion: 'Content may be clipped; change to overflow: auto if needed',
+            });
+        }
+        return issues;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * gravity-core
+ *
+ * Universal Gravity - Connect any IDE or AI assistant to browser DevTools
+ * for real-time layout diagnostics and element inspection.
+ *
+ * No manual setup needed! Just:
+ * 1. npm install gravity-core
+ * 2. Load extension in Chrome (chrome://extensions)
+ * 3. Add MCP config to your IDE
+ * 4. Ask your AI to diagnose elements!
+ *
+ * Usage:
+ * ```typescript
+ * import { Gravity } from 'gravity-core';
+ *
+ * const bridge = new Gravity();
+ * await bridge.connectBrowser();
+ * const result = await bridge.diagnoseLayout('#modal');
+ * console.log(result);
+ * ```
+ */
+export { Gravity } from './bridge.js';
+export { BrowserConnection } from './browser-connection.js';
+export { DiagnosticsEngine } from './diagnostics.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * gravity-core
+ *
+ * Universal Gravity - Connect any IDE or AI assistant to browser DevTools
+ * for real-time layout diagnostics and element inspection.
+ *
+ * No manual setup needed! Just:
+ * 1. npm install gravity-core
+ * 2. Load extension in Chrome (chrome://extensions)
+ * 3. Add MCP config to your IDE
+ * 4. Ask your AI to diagnose elements!
+ *
+ * Usage:
+ * ```typescript
+ * import { Gravity } from 'gravity-core';
+ *
+ * const bridge = new Gravity();
+ * await bridge.connectBrowser();
+ * const result = await bridge.diagnoseLayout('#modal');
+ * console.log(result);
+ * ```
+ */
+export { Gravity } from './bridge.js';
+export { BrowserConnection } from './browser-connection.js';
+export { DiagnosticsEngine } from './diagnostics.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Core type definitions for Gravity
+ */
+export interface DiagnosticResult {
+    element: string;
+    timestamp: string;
+    found: boolean;
+    position: ElementPosition;
+    viewport: ViewportInfo;
+    computedStyles: ComputedStyles;
+    issues: LayoutIssue[];
+    confidence: number;
+    summary: IssueSummary;
+}
+export interface ElementPosition {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+export interface ViewportInfo {
+    width: number;
+    height: number;
+}
+export interface ComputedStyles {
+    display: string;
+    position: string;
+    width: string;
+    height: string;
+    overflow: string;
+    zIndex: string;
+    visibility: string;
+    opacity: string;
+    [key: string]: string;
+}
+export interface LayoutIssue {
+    type: string;
+    severity: 'high' | 'medium' | 'low';
+    message: string;
+    suggestion: string;
+    pixels?: number;
+}
+export interface IssueSummary {
+    totalIssues: number;
+    highSeverity: number;
+    mediumSeverity: number;
+    lowSeverity: number;
+}
+export interface ElementInfo {
+    selector: string;
+    tagName: string;
+    classes: string[];
+    id?: string;
+    position: ElementPosition;
+    styles: ComputedStyles;
+}
+export interface ConnectionStatus {
+    connected: boolean;
+    message: string;
+    timestamp: string;
+}
+export interface BridgeOptions {
+    port?: number;
+    timeout?: number;
+    autoReconnect?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for Gravity
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "gravity-core",
+  "version": "1.0.1",
+  "description": "Gravity - AI-powered CSS layout diagnostics for any IDE. Connect your browser to get real-time layout issue detection.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "gravity": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SETUP.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --test dist/**/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "devtools",
+    "browser",
+    "debugging",
+    "layout",
+    "diagnostics",
+    "ai",
+    "mcp",
+    "css",
+    "vscode",
+    "cursor",
+    "ide"
+  ],
+  "author": "Gravity Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DharuNamikaze/Gravity-Package.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.7.3"
+  }
+}