rlint 0.4.0 → 0.6.0

package/dist/checks/touch-targets.js

@@ -1,6 +1,6 @@
 export const touchTargetsCheck = {
     name: 'touch-targets',
-    description: 'Ensures interactive elements meet minimum touch target size (44x44px)',
+    description: 'Ensures interactive elements meet minimum touch target size and spacing (44x44px, 8px gap)',
     async run(ctx) {
         const { page, config } = ctx;
         const checkConfig = typeof config.checks?.touchTargets === 'object'
@@ -8,6 +8,7 @@ export const touchTargetsCheck = {
             : {};
         const minWidth = checkConfig.minWidth ?? 44;
         const minHeight = checkConfig.minHeight ?? 44;
+        const MIN_GAP = 8;
         const selectors = checkConfig.selectors || [
             'button',
             'a',
@@ -25,12 +26,32 @@ export const touchTargetsCheck = {
             ...(checkConfig.ignore || []),
             '[data-rlint-ignore]',
         ];
-        const smallElements = await page.evaluate(({ selectors, ignoreSelectors, minWidth, minHeight }) => {
-            const results = [];
+        const { smallElements, tooClosePairs } = await page.evaluate(({ selectors, ignoreSelectors, minWidth, minHeight, minGap }) => {
+            const smalls = [];
             const selectorString = selectors.join(', ');
             const elements = document.querySelectorAll(selectorString);
+            function makeSelector(el) {
+                let s = el.tagName.toLowerCase();
+                if (el.id)
+                    s += `#${el.id}`;
+                if (el.className && typeof el.className === 'string') {
+                    s += '.' + el.className.trim().split(/\s+/).join('.');
+                }
+                return s;
+            }
+            function makeRect(rect) {
+                return {
+                    width: rect.width,
+                    height: rect.height,
+                    left: rect.left,
+                    top: rect.top,
+                    right: rect.right,
+                    bottom: rect.bottom,
+                };
+            }
+            // Collect all visible interactive elements and their rects
+            const visibleElements = [];
             for (const el of elements) {
-                // Skip ignored elements
                 const shouldIgnore = ignoreSelectors.some(sel => {
                     try {
                         return el.matches(sel);
@@ -41,7 +62,6 @@ export const touchTargetsCheck = {
                 });
                 if (shouldIgnore)
                     continue;
-                // Skip hidden elements
                 const style = getComputedStyle(el);
                 if (style.display === 'none' ||
                     style.visibility === 'hidden' ||
@@ -49,68 +69,135 @@ export const touchTargetsCheck = {
                     continue;
                 }
                 const rect = el.getBoundingClientRect();
-                // Skip zero-size elements (likely hidden)
                 if (rect.width === 0 && rect.height === 0)
                     continue;
-                // Skip off-screen elements
                 if (rect.right < 0 ||
                     rect.bottom < 0 ||
                     rect.left > window.innerWidth ||
                     rect.top > window.innerHeight) {
                     continue;
                 }
-                // Check if too small
+                visibleElements.push({ el, rect });
+                // Size check
                 if (rect.width < minWidth || rect.height < minHeight) {
-                    let selector = el.tagName.toLowerCase();
-                    if (el.id)
-                        selector += `#${el.id}`;
-                    if (el.className && typeof el.className === 'string') {
-                        selector += '.' + el.className.trim().split(/\s+/).join('.');
-                    }
-                    results.push({
-                        selector,
+                    smalls.push({
+                        selector: makeSelector(el),
                         tagName: el.tagName,
                         className: typeof el.className === 'string' ? el.className : '',
                         id: el.id || null,
                         textContent: el.textContent?.slice(0, 30)?.trim() || null,
-                        rect: {
-                            width: rect.width,
-                            height: rect.height,
-                            left: rect.left,
-                            top: rect.top,
-                            right: rect.right,
-                            bottom: rect.bottom,
-                        },
+                        rect: makeRect(rect),
                         actualWidth: rect.width,
                         actualHeight: rect.height,
                     });
                 }
             }
-            return results;
-        }, { selectors, ignoreSelectors, minWidth, minHeight });
-        const issues = smallElements.map(el => ({
-            check: 'touch-targets',
-            severity: 'warning',
-            message: `Touch target too small: ${Math.round(el.actualWidth)}x${Math.round(el.actualHeight)}px (min: ${minWidth}x${minHeight}px)`,
-            element: {
-                selector: el.selector,
-                tagName: el.tagName,
-                className: el.className,
-                id: el.id,
-                textContent: el.textContent,
-                rect: el.rect,
-            },
-            details: {
-                actualWidth: el.actualWidth,
-                actualHeight: el.actualHeight,
-                minWidth,
-                minHeight,
-            },
-            fixHint: `Add min-width: ${minWidth}px and min-height: ${minHeight}px, or increase padding`,
-        }));
+            // Spacing check: find pairs of interactive elements that are too close
+            const closePairs = [];
+            const MAX_PAIRS = 20;
+            for (let i = 0; i < visibleElements.length && closePairs.length < MAX_PAIRS; i++) {
+                const a = visibleElements[i];
+                for (let j = i + 1; j < visibleElements.length && closePairs.length < MAX_PAIRS; j++) {
+                    const b = visibleElements[j];
+                    // Skip if one contains the other (parent-child)
+                    if (a.el.contains(b.el) || b.el.contains(a.el))
+                        continue;
+                    // Calculate gap between bounding boxes
+                    const horizGap = Math.max(0, Math.max(b.rect.left - a.rect.right, a.rect.left - b.rect.right));
+                    const vertGap = Math.max(0, Math.max(b.rect.top - a.rect.bottom, a.rect.top - b.rect.bottom));
+                    // If they don't overlap on one axis, the gap is the distance on that axis
+                    // If they overlap on both axes, gap is 0 (overlapping)
+                    const overlapHoriz = a.rect.right > b.rect.left && b.rect.right > a.rect.left;
+                    const overlapVert = a.rect.bottom > b.rect.top && b.rect.bottom > a.rect.top;
+                    let gap;
+                    if (overlapHoriz && overlapVert) {
+                        gap = 0; // overlapping
+                    }
+                    else if (overlapHoriz) {
+                        gap = vertGap; // horizontally aligned, measure vertical gap
+                    }
+                    else if (overlapVert) {
+                        gap = horizGap; // vertically aligned, measure horizontal gap
+                    }
+                    else {
+                        // Diagonal — use the Euclidean distance between nearest corners
+                        gap = Math.sqrt(horizGap * horizGap + vertGap * vertGap);
+                    }
+                    if (gap < minGap) {
+                        closePairs.push({
+                            elementA: {
+                                selector: makeSelector(a.el),
+                                tagName: a.el.tagName,
+                                className: typeof a.el.className === 'string' ? a.el.className : '',
+                                id: a.el.id || null,
+                                textContent: a.el.textContent?.slice(0, 30)?.trim() || null,
+                                rect: makeRect(a.rect),
+                            },
+                            elementB: {
+                                selector: makeSelector(b.el),
+                                tagName: b.el.tagName,
+                                className: typeof b.el.className === 'string' ? b.el.className : '',
+                                id: b.el.id || null,
+                                textContent: b.el.textContent?.slice(0, 30)?.trim() || null,
+                                rect: makeRect(b.rect),
+                            },
+                            gap: Math.round(gap),
+                        });
+                    }
+                }
+            }
+            return { smallElements: smalls, tooClosePairs: closePairs };
+        }, { selectors, ignoreSelectors, minWidth, minHeight, minGap: MIN_GAP });
+        const issues = [];
+        // Size issues
+        for (const el of smallElements) {
+            issues.push({
+                check: 'touch-targets',
+                severity: 'warning',
+                message: `Touch target too small: ${Math.round(el.actualWidth)}x${Math.round(el.actualHeight)}px (min: ${minWidth}x${minHeight}px)`,
+                element: {
+                    selector: el.selector,
+                    tagName: el.tagName,
+                    className: el.className,
+                    id: el.id,
+                    textContent: el.textContent,
+                    rect: el.rect,
+                },
+                details: {
+                    actualWidth: el.actualWidth,
+                    actualHeight: el.actualHeight,
+                    minWidth,
+                    minHeight,
+                },
+                fixHint: `Add min-width: ${minWidth}px and min-height: ${minHeight}px, or increase padding`,
+            });
+        }
+        // Spacing issues
+        for (const pair of tooClosePairs) {
+            issues.push({
+                check: 'touch-targets',
+                severity: 'warning',
+                message: `Touch targets too close: ${pair.gap}px gap between ${pair.elementA.selector} and ${pair.elementB.selector} (min: ${MIN_GAP}px)`,
+                element: {
+                    selector: pair.elementA.selector,
+                    tagName: pair.elementA.tagName,
+                    className: pair.elementA.className,
+                    id: pair.elementA.id,
+                    textContent: pair.elementA.textContent,
+                    rect: pair.elementA.rect,
+                },
+                details: {
+                    gap: pair.gap,
+                    minGap: MIN_GAP,
+                    nearElement: pair.elementB.selector,
+                },
+                fixHint: `Add at least ${MIN_GAP}px margin between ${pair.elementA.selector} and ${pair.elementB.selector}`,
+            });
+        }
+        const totalElements = (await page.$$(selectors.join(', '))).length;
         return {
             check: 'touch-targets',
-            passed: Math.max(0, (await page.$$(selectors.join(', '))).length - issues.length),
+            passed: Math.max(0, totalElements - issues.length),
             issues,
         };
     },

package/dist/checks/touch-targets.js.map

@@ -1 +1 @@
-{"version":3,"file":"touch-targets.js","sourceRoot":"","sources":["../../src/checks/touch-targets.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,iBAAiB,GAAU;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,uEAAuE;IAEpF,KAAK,CAAC,GAAG,CAAC,GAAiB;QACzB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAC7B,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ;YACjE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY;YAC5B,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC;QAE9C,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI;YACzC,QAAQ;YACR,GAAG;YACH,4BAA4B;YAC5B,QAAQ;YACR,UAAU;YACV,iBAAiB;YACjB,eAAe;YACf,mBAAmB;YACnB,gBAAgB;YAChB,gBAAgB;SACjB,CAAC;QAEF,MAAM,eAAe,GAAG;YACtB,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YACxB,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;YAC7B,qBAAqB;SACtB,CAAC;QAEF,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CACvC,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;YACtD,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YAE3D,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,wBAAwB;gBACxB,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;oBAC9C,IAAI,CAAC;wBACH,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACzB,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,IAAI,YAAY;oBAAE,SAAS;gBAE3B,uBAAuB;gBACvB,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBACnC,IACE,KAAK,CAAC,OAAO,KAAK,MAAM;oBACxB,KAAK,CAAC,UAAU,KAAK,QAAQ;oBAC7B,KAAK,CAAC,OAAO,KAAK,GAAG,EACrB,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;gBAExC,0CAA0C;gBAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAEpD,2BAA2B;gBAC3B,IACE,IAAI,CAAC,KAAK,GAAG,CAAC;oBACd,IAAI,CAAC,MAAM,GAAG,CAAC;oBACf,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,UAAU;oBAC7B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,EAC7B,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,qBAAqB;gBACrB,IAAI,IAAI,CAAC,KAAK,GAAG,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;oBACrD,IAAI,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxC,IAAI,EAAE,CAAC,EAAE;wBAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;oBACnC,IAAI,EAAE,CAAC,SAAS,IAAI,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;wBACrD,QAAQ,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC/D,CAAC;oBAED,OAAO,CAAC,IAAI,CAAC;wBACX,QAAQ;wBACR,OAAO,EAAE,EAAE,CAAC,OAAO;wBACnB,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;wBAC/D,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI;wBACjB,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI;wBACzD,IAAI,EAAE;4BACJ,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,GAAG,EAAE,IAAI,CAAC,GAAG;4BACb,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,MAAM,EAAE,IAAI,CAAC,MAAM;yBACpB;wBACD,WAAW,EAAE,IAAI,CAAC,KAAK;wBACvB,YAAY,EAAE,IAAI,CAAC,MAAM;qBAC1B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC,EACD,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,CACpD,CAAC;QAEF,MAAM,MAAM,GAAY,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE,SAAkB;YAC5B,OAAO,EAAE,2BAA2B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,QAAQ,IAAI,SAAS,KAAK;YACnI,OAAO,EAAE;gBACP,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,EAAE,EAAE,EAAE,CAAC,EAAE;gBACT,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,IAAI,EAAE,EAAE,CAAC,IAAI;aACd;YACD,OAAO,EAAE;gBACP,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,QAAQ;gBACR,SAAS;aACV;YACD,OAAO,EAAE,kBAAkB,QAAQ,sBAAsB,SAAS,yBAAyB;SAC5F,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACjF,MAAM;SACP,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"touch-targets.js","sourceRoot":"","sources":["../../src/checks/touch-targets.ts"],"names":[],"mappings":"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"}

package/dist/checks/viewport-meta.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+export declare const viewportMetaCheck: Check;
+//# sourceMappingURL=viewport-meta.d.ts.map

package/dist/checks/viewport-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-meta.d.ts","sourceRoot":"","sources":["../../src/checks/viewport-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAuB,MAAM,aAAa,CAAC;AAU9D,eAAO,MAAM,iBAAiB,EAAE,KA+H/B,CAAC"}

package/dist/checks/viewport-meta.js

@@ -0,0 +1,113 @@
+export const viewportMetaCheck = {
+    name: 'viewport-meta',
+    description: 'Checks for a proper viewport meta tag for mobile rendering',
+    async run(ctx) {
+        const { page, config } = ctx;
+        const checkConfig = typeof config.checks?.viewportMeta === 'object'
+            ? config.checks.viewportMeta
+            : {};
+        const ignoreSelectors = [
+            ...(config.ignore || []),
+            ...(checkConfig.ignore || []),
+        ];
+        const result = await page.evaluate(() => {
+            const meta = document.querySelector('meta[name="viewport"]');
+            if (!meta) {
+                return {
+                    exists: false,
+                    content: null,
+                    hasWidthDeviceWidth: false,
+                    hasUserScalableNo: false,
+                    hasMaximumScale1: false,
+                };
+            }
+            const content = meta.getAttribute('content') || '';
+            const directives = content.split(',').map(d => d.trim().toLowerCase());
+            const hasWidthDeviceWidth = directives.some(d => d.replace(/\s+/g, '').startsWith('width=device-width'));
+            const hasUserScalableNo = directives.some(d => {
+                const cleaned = d.replace(/\s+/g, '');
+                return cleaned === 'user-scalable=no' || cleaned === 'user-scalable=0';
+            });
+            const hasMaximumScale1 = directives.some(d => {
+                const cleaned = d.replace(/\s+/g, '');
+                return cleaned.startsWith('maximum-scale=') && parseFloat(cleaned.split('=')[1]) <= 1;
+            });
+            return {
+                exists: true,
+                content,
+                hasWidthDeviceWidth,
+                hasUserScalableNo,
+                hasMaximumScale1,
+            };
+        });
+        const issues = [];
+        const dummyElement = {
+            selector: 'head',
+            tagName: 'HEAD',
+            className: '',
+            id: null,
+            textContent: null,
+            rect: { width: 0, height: 0, left: 0, top: 0, right: 0, bottom: 0 },
+        };
+        if (!result.exists) {
+            issues.push({
+                check: 'viewport-meta',
+                severity: 'warning',
+                message: 'Missing viewport meta tag — page will not render correctly on mobile devices',
+                element: dummyElement,
+                details: {
+                    expected: '<meta name="viewport" content="width=device-width, initial-scale=1">',
+                },
+                fixHint: 'Add <meta name="viewport" content="width=device-width, initial-scale=1"> to <head>',
+            });
+        }
+        else {
+            if (!result.hasWidthDeviceWidth) {
+                issues.push({
+                    check: 'viewport-meta',
+                    severity: 'warning',
+                    message: 'Viewport meta tag is missing width=device-width — mobile browsers will use default 980px width',
+                    element: dummyElement,
+                    details: {
+                        current: result.content,
+                        expected: 'width=device-width',
+                    },
+                    fixHint: 'Add width=device-width to your viewport meta tag',
+                });
+            }
+            if (result.hasUserScalableNo) {
+                issues.push({
+                    check: 'viewport-meta',
+                    severity: 'warning',
+                    message: 'Viewport meta tag disables user scaling — this is an accessibility problem (WCAG 1.4.4)',
+                    element: dummyElement,
+                    details: {
+                        current: result.content,
+                        problem: 'user-scalable=no',
+                    },
+                    fixHint: 'Remove user-scalable=no from your viewport meta tag to allow pinch-to-zoom',
+                });
+            }
+            if (result.hasMaximumScale1) {
+                issues.push({
+                    check: 'viewport-meta',
+                    severity: 'warning',
+                    message: 'Viewport meta tag restricts maximum scale to 1 — this prevents pinch-to-zoom (WCAG 1.4.4)',
+                    element: dummyElement,
+                    details: {
+                        current: result.content,
+                        problem: 'maximum-scale=1',
+                    },
+                    fixHint: 'Remove maximum-scale=1 or set it to at least 5 to allow zooming',
+                });
+            }
+        }
+        const passed = issues.length === 0 ? 1 : 0;
+        return {
+            check: 'viewport-meta',
+            passed,
+            issues,
+        };
+    },
+};
+//# sourceMappingURL=viewport-meta.js.map

package/dist/checks/viewport-meta.js.map

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