gravity-lite 3.0.0

package/dist/diagnostics.js

@@ -0,0 +1,329 @@
+/**
+ * diagnostics.ts — CSS layout & accessibility analysis helpers.
+ * Pure functions — no I/O, no side effects.
+ */
+// ── Box model helpers ─────────────────────────────────────────────────────────
+export function extractBounds(model) {
+    const c = model.content;
+    return {
+        left: Math.round(Math.min(c[0], c[6])),
+        top: Math.round(Math.min(c[1], c[3])),
+        right: Math.round(Math.max(c[2], c[4])),
+        bottom: Math.round(Math.max(c[5], c[7])),
+        width: Math.round(model.width),
+        height: Math.round(model.height),
+    };
+}
+// ── Layout checks ─────────────────────────────────────────────────────────────
+export function checkVisibility(styles) {
+    const issues = [];
+    if (styles.get('display') === 'none')
+        issues.push({ type: 'hidden-display', severity: 'high', message: 'Element has display: none', suggestion: 'Remove display: none to make visible' });
+    if (styles.get('visibility') === 'hidden')
+        issues.push({ type: 'hidden-visibility', severity: 'high', message: 'Element has visibility: hidden', suggestion: 'Change to visibility: visible' });
+    if (parseFloat(styles.get('opacity') ?? '1') === 0)
+        issues.push({ type: 'hidden-opacity', severity: 'high', message: 'Element has opacity: 0', suggestion: 'Change to opacity: 1' });
+    return issues;
+}
+export function checkOffscreen(bounds, vp) {
+    const issues = [];
+    const T = 2;
+    if (bounds.right > vp.clientWidth + T)
+        issues.push({ type: 'offscreen-right', severity: 'high', message: `Element extends ${bounds.right - vp.clientWidth}px beyond right edge`, suggestion: 'Add max-width: 100% or overflow: hidden to parent' });
+    if (bounds.left < -T)
+        issues.push({ type: 'offscreen-left', severity: 'high', message: `Element starts ${Math.abs(bounds.left)}px left of viewport`, suggestion: 'Check left/margin-left values' });
+    if (bounds.top < -T)
+        issues.push({ type: 'offscreen-top', severity: 'high', message: `Element starts ${Math.abs(bounds.top)}px above viewport`, suggestion: 'Check top/margin-top values' });
+    if (bounds.bottom > vp.clientHeight + T)
+        issues.push({ type: 'offscreen-bottom', severity: 'medium', message: `Element extends ${bounds.bottom - vp.clientHeight}px below viewport fold`, suggestion: 'Add max-height or overflow: auto' });
+    return issues;
+}
+export function checkOverflow(styles) {
+    const issues = [];
+    if (styles.get('overflow') === 'hidden')
+        issues.push({ type: 'overflow-hidden', severity: 'low', message: 'overflow: hidden may clip child content', suggestion: 'Change to overflow: auto if content is being clipped' });
+    return issues;
+}
+// ── z-index / stacking context checks ────────────────────────────────────────
+export function checkZIndex(styles) {
+    const issues = [];
+    const zRaw = styles.get('z-index') ?? 'auto';
+    const position = styles.get('position') ?? 'static';
+    const zNum = parseInt(zRaw, 10);
+    // z-index has no effect on static elements
+    if (!isNaN(zNum) && position === 'static') {
+        issues.push({
+            type: 'zindex-no-effect',
+            severity: 'high',
+            message: `z-index: ${zNum} has no effect — element has position: static`,
+            suggestion: 'Add position: relative (or absolute/fixed/sticky) for z-index to take effect',
+        });
+    }
+    // Suspiciously high z-index — usually a sign of a stacking context war
+    if (!isNaN(zNum) && zNum >= 9999) {
+        issues.push({
+            type: 'zindex-magic-number',
+            severity: 'medium',
+            message: `z-index: ${zNum} is a magic number — element may still be trapped in a stacking context`,
+            suggestion: 'Check parent elements for: transform, opacity < 1, filter, isolation: isolate, will-change — these create stacking contexts that trap z-index',
+        });
+    }
+    return issues;
+}
+// ── Properties that create stacking contexts ──────────────────────────────────
+export function checkStackingContextCreators(styles) {
+    const reasons = [];
+    const position = styles.get('position') ?? 'static';
+    const zIndex = styles.get('z-index') ?? 'auto';
+    const opacity = parseFloat(styles.get('opacity') ?? '1');
+    const transform = styles.get('transform') ?? 'none';
+    const filter = styles.get('filter') ?? 'none';
+    const isolation = styles.get('isolation') ?? 'auto';
+    const mixBlend = styles.get('mix-blend-mode') ?? 'normal';
+    const willChange = styles.get('will-change') ?? 'auto';
+    const contain = styles.get('contain') ?? 'none';
+    if (['absolute', 'relative', 'fixed', 'sticky'].includes(position) && zIndex !== 'auto')
+        reasons.push(`position: ${position} + z-index: ${zIndex}`);
+    if (opacity < 1)
+        reasons.push(`opacity: ${opacity}`);
+    if (transform !== 'none')
+        reasons.push(`transform: ${transform}`);
+    if (filter !== 'none')
+        reasons.push(`filter: ${filter}`);
+    if (isolation === 'isolate')
+        reasons.push('isolation: isolate');
+    if (mixBlend !== 'normal')
+        reasons.push(`mix-blend-mode: ${mixBlend}`);
+    if (willChange.includes('transform') || willChange.includes('opacity'))
+        reasons.push(`will-change: ${willChange}`);
+    if (contain !== 'none' && contain !== '')
+        reasons.push(`contain: ${contain}`);
+    return { creates: reasons.length > 0, reasons };
+}
+// ── Flexbox/Grid checks ───────────────────────────────────────────────────────
+export function checkFlexGrid(styles) {
+    const issues = [];
+    const display = styles.get('display') ?? '';
+    if (display === 'flex' || display === 'inline-flex') {
+        const minWidth = styles.get('min-width') ?? 'auto';
+        // flex children with no min-width: 0 can overflow their container
+        if (minWidth === 'auto') {
+            const overflow = styles.get('overflow') ?? 'visible';
+            if (overflow === 'visible') {
+                issues.push({
+                    type: 'flex-min-width',
+                    severity: 'low',
+                    message: 'Flex container children default to min-width: auto which can cause overflow',
+                    suggestion: 'Add min-width: 0 to flex children that should shrink below their content size',
+                });
+            }
+        }
+        const height = styles.get('height') ?? 'auto';
+        const alignItems = styles.get('align-items') ?? 'stretch';
+        if (height === '0px' || height === '0') {
+            issues.push({
+                type: 'flex-zero-height',
+                severity: 'high',
+                message: 'Flex container has height: 0 — children may be invisible',
+                suggestion: 'Set an explicit height, min-height, or ensure a parent provides height',
+            });
+        }
+        if (alignItems === 'stretch') {
+            const explicitHeight = styles.get('height');
+            if (!explicitHeight || explicitHeight === 'auto') {
+                issues.push({
+                    type: 'flex-stretch-no-height',
+                    severity: 'low',
+                    message: 'align-items: stretch (default) with no explicit height — container height depends on content',
+                    suggestion: 'Set an explicit height on the flex container if you need consistent item sizing',
+                });
+            }
+        }
+    }
+    if (display === 'grid' || display === 'inline-grid') {
+        const gridTemplateColumns = styles.get('grid-template-columns') ?? '';
+        const gridTemplateRows = styles.get('grid-template-rows') ?? '';
+        if (!gridTemplateColumns && !gridTemplateRows) {
+            issues.push({
+                type: 'grid-no-template',
+                severity: 'medium',
+                message: 'Grid container has no grid-template-columns or grid-template-rows defined',
+                suggestion: 'Define grid-template-columns (e.g. repeat(3, 1fr)) to create a proper grid layout',
+            });
+        }
+    }
+    return issues;
+}
+// ── Responsive / sizing checks ────────────────────────────────────────────────
+export function checkResponsive(styles, bounds, vp) {
+    const issues = [];
+    const width = styles.get('width') ?? '';
+    // Fixed pixel width on an element that is nearly as wide as the viewport
+    const pxMatch = width.match(/^(\d+(?:\.\d+)?)px$/);
+    if (pxMatch && bounds.width > vp.clientWidth * 0.85) {
+        issues.push({
+            type: 'fixed-width-large',
+            severity: 'medium',
+            message: `Fixed width of ${width} is ${Math.round((bounds.width / vp.clientWidth) * 100)}% of viewport — will break on smaller screens`,
+            suggestion: 'Use max-width instead of width, or switch to a relative unit like % or vw',
+        });
+    }
+    // Very small touch target
+    if (bounds.width > 0 && bounds.height > 0 && (bounds.width < 44 || bounds.height < 44)) {
+        issues.push({
+            type: 'small-touch-target',
+            severity: 'medium',
+            message: `Element is ${bounds.width}×${bounds.height}px — below the 44×44px minimum touch target size (WCAG 2.5.5)`,
+            suggestion: 'Increase padding or min-width/min-height to at least 44px for touch accessibility',
+        });
+    }
+    return issues;
+}
+// ── Accessibility checks (from computed styles) ───────────────────────────────
+export function checkAccessibilityStyles(styles) {
+    const issues = [];
+    // pointer-events: none makes elements unclikable
+    if (styles.get('pointer-events') === 'none') {
+        issues.push({
+            type: 'pointer-events-none',
+            severity: 'medium',
+            message: 'pointer-events: none — element is not clickable/interactive',
+            suggestion: 'Remove pointer-events: none if the element should be interactive',
+        });
+    }
+    // user-select: none on interactive elements
+    if (styles.get('user-select') === 'none' || styles.get('-webkit-user-select') === 'none') {
+        issues.push({
+            type: 'user-select-none',
+            severity: 'low',
+            message: 'user-select: none prevents text selection — may frustrate users trying to copy content',
+            suggestion: 'Remove user-select: none from text content; keep it only on UI controls like buttons',
+        });
+    }
+    // cursor: default on something that looks interactive
+    const cursor = styles.get('cursor') ?? '';
+    if (cursor === 'default') {
+        const display = styles.get('display') ?? '';
+        if (display === 'inline-flex' || display === 'flex') {
+            issues.push({
+                type: 'missing-pointer-cursor',
+                severity: 'low',
+                message: 'Flex element has cursor: default — if this is a button/link, set cursor: pointer',
+                suggestion: "Add cursor: pointer to indicate the element is interactive",
+            });
+        }
+    }
+    return issues;
+}
+// ── Color contrast check (pure math, no CDP needed) ──────────────────────────
+/**
+ * Parse any CSS color string to { r, g, b } (0–255).
+ * Supports: rgb(...), rgba(...), #rrggbb, #rgb
+ */
+export function parseColor(color) {
+    // rgb / rgba
+    const rgbMatch = color.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);
+    if (rgbMatch)
+        return { r: +rgbMatch[1], g: +rgbMatch[2], b: +rgbMatch[3] };
+    // #rrggbb
+    const hex6 = color.match(/^#([0-9a-f]{6})$/i);
+    if (hex6) {
+        const v = parseInt(hex6[1], 16);
+        return { r: (v >> 16) & 0xff, g: (v >> 8) & 0xff, b: v & 0xff };
+    }
+    // #rgb
+    const hex3 = color.match(/^#([0-9a-f]{3})$/i);
+    if (hex3) {
+        const r = parseInt(hex3[1][0] + hex3[1][0], 16);
+        const g = parseInt(hex3[1][1] + hex3[1][1], 16);
+        const b = parseInt(hex3[1][2] + hex3[1][2], 16);
+        return { r, g, b };
+    }
+    return null;
+}
+/** Relative luminance per WCAG 2.1 */
+export function relativeLuminance(r, g, b) {
+    const toLinear = (c) => {
+        const s = c / 255;
+        return s <= 0.04045 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+    };
+    return 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);
+}
+/** Contrast ratio between two colours (1–21) */
+export function contrastRatio(c1, c2) {
+    const l1 = relativeLuminance(c1.r, c1.g, c1.b);
+    const l2 = relativeLuminance(c2.r, c2.g, c2.b);
+    const lighter = Math.max(l1, l2);
+    const darker = Math.min(l1, l2);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+export function checkColorContrast(styles) {
+    const issues = [];
+    const colorStr = styles.get('color');
+    const bgStr = styles.get('background-color');
+    const fontSizeStr = styles.get('font-size') ?? '16px';
+    const fontWeight = styles.get('font-weight') ?? '400';
+    if (!colorStr || !bgStr)
+        return issues;
+    const fg = parseColor(colorStr);
+    const bg = parseColor(bgStr);
+    if (!fg || !bg)
+        return issues;
+    // Skip fully transparent background
+    if (bgStr.includes('rgba') && bgStr.includes(', 0)'))
+        return issues;
+    const ratio = contrastRatio(fg, bg);
+    const fontSize = parseFloat(fontSizeStr);
+    const isBold = parseInt(fontWeight, 10) >= 700;
+    const isLargeText = fontSize >= 18 || (isBold && fontSize >= 14);
+    // WCAG AA thresholds
+    const minAA = isLargeText ? 3.0 : 4.5;
+    // WCAG AAA thresholds
+    const minAAA = isLargeText ? 4.5 : 7.0;
+    if (ratio < minAA) {
+        issues.push({
+            type: 'contrast-fail-aa',
+            severity: 'high',
+            message: `Color contrast ratio is ${ratio.toFixed(2)}:1 — fails WCAG AA (minimum ${minAA}:1 for ${isLargeText ? 'large' : 'normal'} text)`,
+            suggestion: `Increase contrast between text color (${colorStr}) and background (${bgStr}). Use a contrast checker to find a compliant combination.`,
+        });
+    }
+    else if (ratio < minAAA) {
+        issues.push({
+            type: 'contrast-fail-aaa',
+            severity: 'low',
+            message: `Color contrast ratio is ${ratio.toFixed(2)}:1 — passes WCAG AA but fails AAA (${minAAA}:1)`,
+            suggestion: 'Consider increasing contrast for better readability, especially for users with low vision.',
+        });
+    }
+    return issues;
+}
+// ── CSS custom property resolver ──────────────────────────────────────────────
+export function checkCustomProperties(styles) {
+    const issues = [];
+    for (const [prop, value] of styles.entries()) {
+        // A CSS variable that failed to resolve shows as the initial/empty value or the var() call itself
+        if (value.includes('var(--') && value.includes(')')) {
+            issues.push({
+                type: 'unresolved-css-var',
+                severity: 'high',
+                message: `Property "${prop}" uses an unresolved CSS variable: ${value}`,
+                suggestion: `Define the variable on :root or a parent element. Check spelling and scope.`,
+            });
+        }
+    }
+    return issues;
+}
+// ── Utilities ─────────────────────────────────────────────────────────────────
+export function sortBySeverity(issues) {
+    const rank = { high: 0, medium: 1, low: 2 };
+    return [...issues].sort((a, b) => rank[a.severity] - rank[b.severity]);
+}
+export function validateSelector(selector) {
+    if (!selector?.trim())
+        return { valid: false, error: 'Selector must be a non-empty string' };
+    if (/^\d/.test(selector.trim()))
+        return { valid: false, error: 'Selector cannot start with a number' };
+    return { valid: true };
+}
+//# 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/mcp-server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * mcp-server.ts — Gravity MCP Server v3
+ *
+ * Tools built around the top real-world UI debugging pain points:
+ *   1. connect_browser        — check extension connection status
+ *   2. diagnose_layout        — offscreen, hidden, overflow issues
+ *   3. inspect_stacking       — z-index traps, stacking context analysis
+ *   4. check_accessibility    — contrast ratio, touch targets, ARIA
+ *   5. inspect_responsive     — fixed widths, breakpoint analysis
+ *   6. debug_flexgrid         — flexbox/grid container + children analysis
+ *   7. get_computed_layout    — full computed style snapshot
+ *   8. highlight_element      — visual overlay in browser
+ *   9. screenshot_element     — capture element as PNG
+ *  10. get_page_performance   — layout paint metrics from Chrome
+ */
+export declare class GravityMCPServer {
+    run(): Promise<void>;
+}