uxinspect 0.2.0 → 0.11.0

package/dist/animation-audit.js

@@ -0,0 +1,296 @@
+const MAX_ENTRIES = 30;
+export async function auditAnimations(page) {
+    const url = page.url();
+    const scan = await page.evaluate(() => {
+        const SENTINEL = 9999;
+        const LIMIT = 30;
+        const LONG_MS = 5000;
+        const MAX_TOTAL = 20;
+        const COMPOSITED = new Set(['opacity', 'transform', 'filter']);
+        function buildSelector(el) {
+            const id = el.id;
+            if (id)
+                return `#${CSS.escape(id)}`;
+            const testid = el.getAttribute('data-testid');
+            if (testid)
+                return `[data-testid="${testid}"]`;
+            const tag = el.tagName.toLowerCase();
+            const classes = Array.from(el.classList).slice(0, 3);
+            return classes.length
+                ? `${tag}.${classes.map(c => CSS.escape(c)).join('.')}`
+                : tag;
+        }
+        function camelToKebab(s) {
+            return s.replace(/[A-Z]/g, m => `-${m.toLowerCase()}`);
+        }
+        function firstAnimatedProperty(anim) {
+            try {
+                const effect = anim.effect;
+                if (!effect || typeof effect.getKeyframes !== 'function') {
+                    return undefined;
+                }
+                const frames = effect.getKeyframes();
+                for (const frame of frames) {
+                    for (const key of Object.keys(frame)) {
+                        if (key === 'offset' ||
+                            key === 'computedOffset' ||
+                            key === 'easing' ||
+                            key === 'composite') {
+                            continue;
+                        }
+                        return camelToKebab(key);
+                    }
+                }
+            }
+            catch {
+                // ignore
+            }
+            return undefined;
+        }
+        function getDurationMs(anim) {
+            try {
+                const effect = anim.effect;
+                if (!effect || typeof effect.getTiming !== 'function')
+                    return 0;
+                const timing = effect.getTiming();
+                const d = timing.duration;
+                if (typeof d === 'number' && isFinite(d))
+                    return d;
+                return 0;
+            }
+            catch {
+                return 0;
+            }
+        }
+        function getIterations(anim) {
+            try {
+                const effect = anim.effect;
+                if (!effect || typeof effect.getTiming !== 'function')
+                    return 1;
+                const timing = effect.getTiming();
+                const iter = timing.iterations;
+                if (typeof iter !== 'number')
+                    return 1;
+                if (!isFinite(iter))
+                    return SENTINEL;
+                return iter;
+            }
+            catch {
+                return 1;
+            }
+        }
+        function getAnimationName(anim) {
+            const named = anim;
+            if (typeof named.animationName === 'string' && named.animationName) {
+                return named.animationName;
+            }
+            const id = anim.id;
+            return id ? id : undefined;
+        }
+        function getTargetEl(anim) {
+            const effect = anim.effect;
+            if (!effect)
+                return null;
+            const target = effect.target;
+            return target instanceof Element ? target : null;
+        }
+        function isCssAnimation(anim) {
+            const name = anim.constructor?.name ?? '';
+            return name === 'CSSAnimation';
+        }
+        function isJsAnimation(anim) {
+            const name = anim.constructor?.name ?? '';
+            return name === 'Animation';
+        }
+        function pseudoElementOf(anim) {
+            const effect = anim.effect;
+            if (!effect)
+                return null;
+            const pseudo = effect.pseudoElement;
+            return typeof pseudo === 'string' ? pseudo : null;
+        }
+        const cssAnimations = [];
+        const jsAnimations = [];
+        const collected = [];
+        let infiniteCount = 0;
+        const seen = new Set();
+        function collectFromElement(el) {
+            const anyEl = el;
+            if (typeof anyEl.getAnimations !== 'function')
+                return;
+            let anims = [];
+            try {
+                anims = anyEl.getAnimations({ subtree: false });
+            }
+            catch {
+                return;
+            }
+            for (const anim of anims) {
+                if (seen.has(anim))
+                    continue;
+                seen.add(anim);
+                if (pseudoElementOf(anim) === '::marker')
+                    continue;
+                const target = getTargetEl(anim) ?? el;
+                const duration = getDurationMs(anim);
+                const iterations = getIterations(anim);
+                const animatedProperty = firstAnimatedProperty(anim);
+                const name = getAnimationName(anim);
+                const info = {
+                    target: buildSelector(target),
+                    duration,
+                    iterations,
+                };
+                if (name !== undefined)
+                    info.name = name;
+                if (animatedProperty !== undefined)
+                    info.animatedProperty = animatedProperty;
+                if (iterations === SENTINEL)
+                    infiniteCount++;
+                const composited = animatedProperty
+                    ? COMPOSITED.has(animatedProperty)
+                    : true;
+                collected.push({ info, composited });
+                if (isCssAnimation(anim)) {
+                    if (cssAnimations.length < LIMIT)
+                        cssAnimations.push(info);
+                }
+                else if (isJsAnimation(anim)) {
+                    if (jsAnimations.length < LIMIT)
+                        jsAnimations.push(info);
+                }
+            }
+        }
+        const all = document.querySelectorAll('*');
+        for (let i = 0; i < all.length; i++) {
+            collectFromElement(all[i]);
+        }
+        // Also walk shadow-less supplemental via getComputedStyle for elements
+        // whose CSS animationName is set but weren't captured above (fallback).
+        if (cssAnimations.length < LIMIT) {
+            for (let i = 0; i < all.length && cssAnimations.length < LIMIT; i++) {
+                const el = all[i];
+                try {
+                    const cs = getComputedStyle(el);
+                    const animName = cs.animationName;
+                    if (!animName || animName === 'none')
+                        continue;
+                    const already = cssAnimations.some(a => a.target === buildSelector(el));
+                    if (already)
+                        continue;
+                    const durRaw = cs.animationDuration.split(',')[0]?.trim() ?? '';
+                    const iterRaw = cs.animationIterationCount.split(',')[0]?.trim() ?? '1';
+                    const durMs = /ms$/.test(durRaw)
+                        ? parseFloat(durRaw)
+                        : /s$/.test(durRaw)
+                            ? parseFloat(durRaw) * 1000
+                            : 0;
+                    const iter = iterRaw === 'infinite'
+                        ? SENTINEL
+                        : isFinite(parseFloat(iterRaw))
+                            ? parseFloat(iterRaw)
+                            : 1;
+                    if (iter === SENTINEL)
+                        infiniteCount++;
+                    const info = {
+                        target: buildSelector(el),
+                        name: animName.split(',')[0]?.trim(),
+                        duration: isFinite(durMs) ? durMs : 0,
+                        iterations: iter,
+                    };
+                    cssAnimations.push(info);
+                    collected.push({ info, composited: true });
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        // Detect @media (prefers-reduced-motion: reduce) rules in stylesheets.
+        let prefersReducedMotionHonored = false;
+        function walkRules(rules) {
+            if (!rules)
+                return;
+            for (let i = 0; i < rules.length; i++) {
+                const rule = rules[i];
+                if (rule instanceof CSSMediaRule) {
+                    const mediaText = (rule.conditionText || rule.media.mediaText || '').toLowerCase();
+                    if (mediaText.includes('prefers-reduced-motion')) {
+                        prefersReducedMotionHonored = true;
+                    }
+                    walkRules(rule.cssRules);
+                    continue;
+                }
+                const withRules = rule;
+                if (withRules.cssRules) {
+                    walkRules(withRules.cssRules);
+                }
+            }
+        }
+        for (const sheet of Array.from(document.styleSheets)) {
+            try {
+                walkRules(sheet.cssRules);
+            }
+            catch {
+                // cross-origin stylesheet — cannot read cssRules
+            }
+        }
+        const issues = [];
+        if (infiniteCount > 0 && !prefersReducedMotionHonored) {
+            issues.push({
+                type: 'infinite-animation-no-reduced-motion-fallback',
+                detail: `${infiniteCount} infinite animation(s) with no prefers-reduced-motion fallback`,
+            });
+        }
+        for (const entry of collected) {
+            if (entry.info.duration > LONG_MS) {
+                issues.push({
+                    type: 'long-animation',
+                    target: entry.info.target,
+                    detail: `animation duration ${Math.round(entry.info.duration)}ms exceeds ${LONG_MS}ms`,
+                });
+            }
+        }
+        const seenNonComposited = new Set();
+        for (const entry of collected) {
+            if (entry.composited)
+                continue;
+            const prop = entry.info.animatedProperty ?? 'unknown';
+            const key = `${entry.info.target}::${prop}`;
+            if (seenNonComposited.has(key))
+                continue;
+            seenNonComposited.add(key);
+            issues.push({
+                type: 'non-composited-property',
+                target: entry.info.target,
+                detail: `animates non-composited property "${prop}" (triggers layout/paint)`,
+            });
+        }
+        const total = cssAnimations.length + jsAnimations.length;
+        if (total > MAX_TOTAL) {
+            issues.push({
+                type: 'too-many-animations',
+                detail: `${total} concurrent animations exceed recommended max of ${MAX_TOTAL}`,
+            });
+        }
+        return {
+            cssAnimations,
+            jsAnimations,
+            infiniteAnimations: infiniteCount,
+            prefersReducedMotionHonored,
+            issues,
+        };
+    });
+    const truncatedCss = scan.cssAnimations.slice(0, MAX_ENTRIES);
+    const truncatedJs = scan.jsAnimations.slice(0, MAX_ENTRIES);
+    return {
+        page: url,
+        cssAnimations: truncatedCss,
+        jsAnimations: truncatedJs,
+        infiniteAnimations: scan.infiniteAnimations,
+        prefersReducedMotionHonored: scan.prefersReducedMotionHonored,
+        issues: scan.issues,
+        passed: scan.issues.length === 0,
+    };
+}
+//# sourceMappingURL=animation-audit.js.map

package/dist/animation-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-audit.js","sourceRoot":"","sources":["../src/animation-audit.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,IAAI,GAAwB,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAwB,EAAE;QAqB9E,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QAEvE,SAAS,aAAa,CAAC,EAAW;YAChC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACjB,IAAI,EAAE;gBAAE,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YAC9C,IAAI,MAAM;gBAAE,OAAO,iBAAiB,MAAM,IAAI,CAAC;YAC/C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,OAAO,CAAC,MAAM;gBACnB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBACvD,CAAC,CAAC,GAAG,CAAC;QACV,CAAC;QAED,SAAS,YAAY,CAAC,CAAS;YAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,SAAS,qBAAqB,CAC5B,IAAe;YAEf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC3B,IAAI,CAAC,MAAM,IAAI,OAAQ,MAAyB,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;oBAC7E,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,MAAM,MAAM,GAAI,MAAyB,CAAC,YAAY,EAAE,CAAC;gBACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrC,IACE,GAAG,KAAK,QAAQ;4BAChB,GAAG,KAAK,gBAAgB;4BACxB,GAAG,KAAK,QAAQ;4BAChB,GAAG,KAAK,WAAW,EACnB,CAAC;4BACD,SAAS;wBACX,CAAC;wBACD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,SAAS,aAAa,CAAC,IAAe;YACpC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU;oBAAE,OAAO,CAAC,CAAC;gBAChE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,CAAC;gBACnD,OAAO,CAAC,CAAC;YACX,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,SAAS,aAAa,CAAC,IAAe;YACpC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU;oBAAE,OAAO,CAAC,CAAC;gBAChE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;gBAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,OAAO,CAAC,CAAC;gBACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO,QAAQ,CAAC;gBACrC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,SAAS,gBAAgB,CAAC,IAAe;YACvC,MAAM,KAAK,GAAG,IAA8C,CAAC;YAC7D,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACnE,OAAO,KAAK,CAAC,aAAa,CAAC;YAC7B,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7B,CAAC;QAED,SAAS,WAAW,CAAC,IAAe;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAA+B,CAAC;YACpD,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,OAAO,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;QAED,SAAS,cAAc,CAAC,IAAe;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;YAC1C,OAAO,IAAI,KAAK,cAAc,CAAC;QACjC,CAAC;QAED,SAAS,aAAa,CAAC,IAAe;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;YAC1C,OAAO,IAAI,KAAK,WAAW,CAAC;QAC9B,CAAC;QAED,SAAS,eAAe,CAAC,IAAe;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAEZ,CAAC;YACT,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;YACpC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,CAAC;QAED,MAAM,aAAa,GAAW,EAAE,CAAC;QACjC,MAAM,YAAY,GAAW,EAAE,CAAC;QAChC,MAAM,SAAS,GAA+C,EAAE,CAAC;QACjE,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAa,CAAC;QAElC,SAAS,kBAAkB,CAAC,EAAW;YACrC,MAAM,KAAK,GAAG,EAEb,CAAC;YACF,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,UAAU;gBAAE,OAAO;YACtD,IAAI,KAAK,GAAgB,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAEf,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,UAAU;oBAAE,SAAS;gBAEnD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBAEpC,MAAM,IAAI,GAAS;oBACjB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;oBAC7B,QAAQ;oBACR,UAAU;iBACX,CAAC;gBACF,IAAI,IAAI,KAAK,SAAS;oBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzC,IAAI,gBAAgB,KAAK,SAAS;oBAAE,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;gBAE7E,IAAI,UAAU,KAAK,QAAQ;oBAAE,aAAa,EAAE,CAAC;gBAE7C,MAAM,UAAU,GAAG,gBAAgB;oBACjC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC;oBAClC,CAAC,CAAC,IAAI,CAAC;gBACT,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;gBAErC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,IAAI,aAAa,CAAC,MAAM,GAAG,KAAK;wBAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7D,CAAC;qBAAM,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,IAAI,YAAY,CAAC,MAAM,GAAG,KAAK;wBAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,aAAa,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClB,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;oBAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,aAAa,CAAC;oBAClC,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,MAAM;wBAAE,SAAS;oBAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;oBACxE,IAAI,OAAO;wBAAE,SAAS;oBACtB,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBAChE,MAAM,OAAO,GAAG,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;oBACxE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;wBAC9B,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;wBACpB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;4BACjB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI;4BAC3B,CAAC,CAAC,CAAC,CAAC;oBACR,MAAM,IAAI,GACR,OAAO,KAAK,UAAU;wBACpB,CAAC,CAAC,QAAQ;wBACV,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;4BAC7B,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;4BACrB,CAAC,CAAC,CAAC,CAAC;oBACV,IAAI,IAAI,KAAK,QAAQ;wBAAE,aAAa,EAAE,CAAC;oBACvC,MAAM,IAAI,GAAS;wBACjB,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;wBACzB,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;wBACpC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;wBACrC,UAAU,EAAE,IAAI;qBACjB,CAAC;oBACF,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACzB,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC7C,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,IAAI,2BAA2B,GAAG,KAAK,CAAC;QAExC,SAAS,SAAS,CAAC,KAA8B;YAC/C,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,YAAY,YAAY,EAAE,CAAC;oBACjC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;oBACnF,IAAI,SAAS,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;wBACjD,2BAA2B,GAAG,IAAI,CAAC;oBACrC,CAAC;oBACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACzB,SAAS;gBACX,CAAC;gBACD,MAAM,SAAS,GAAG,IAA4C,CAAC;gBAC/D,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;oBACvB,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC;gBACH,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAY,EAAE,CAAC;QAE3B,IAAI,aAAa,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,+CAA+C;gBACrD,MAAM,EAAE,GAAG,aAAa,gEAAgE;aACzF,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,gBAAgB;oBACtB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;oBACzB,MAAM,EAAE,sBAAsB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,OAAO,IAAI;iBACvF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,UAAU;gBAAE,SAAS;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,SAAS,CAAC;YACtD,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5C,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACzC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,yBAAyB;gBAC/B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;gBACzB,MAAM,EAAE,qCAAqC,IAAI,2BAA2B;aAC7E,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QACzD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,qBAAqB;gBAC3B,MAAM,EAAE,GAAG,KAAK,oDAAoD,SAAS,EAAE;aAChF,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,aAAa;YACb,YAAY;YACZ,kBAAkB,EAAE,aAAa;YACjC,2BAA2B;YAC3B,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAE5D,OAAO;QACL,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,WAAW;QACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;QAC7D,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/api.d.ts

@@ -0,0 +1,3 @@
+import type { ApiFlow, ApiFlowResult } from './types.js';
+export declare function runApiFlows(flows: ApiFlow[]): Promise<ApiFlowResult[]>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAW,MAAM,YAAY,CAAC;AAElE,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAW5E"}

package/dist/api.js

@@ -0,0 +1,85 @@
+import { request as createRequest } from 'playwright';
+export async function runApiFlows(flows) {
+    const ctx = await createRequest.newContext();
+    const results = [];
+    try {
+        for (const flow of flows) {
+            results.push(await runOne(ctx, flow));
+        }
+    }
+    finally {
+        await ctx.dispose().catch(() => { });
+    }
+    return results;
+}
+async function runOne(ctx, flow) {
+    const stepResults = [];
+    let lastResponse = null;
+    let lastBody = '';
+    let passed = true;
+    let error;
+    for (const step of flow.steps) {
+        const start = Date.now();
+        try {
+            if ('request' in step) {
+                const r = step.request;
+                lastResponse = await ctx.fetch(r.url, {
+                    method: r.method,
+                    headers: r.headers,
+                    data: r.body,
+                });
+                lastBody = await lastResponse.text().catch(() => '');
+                stepResults.push({ step, passed: true, durationMs: Date.now() - start, status: lastResponse.status() });
+            }
+            else if ('expect' in step) {
+                const e = step.expect;
+                if (!lastResponse)
+                    throw new Error('no prior response to assert on');
+                if (e.status !== undefined && lastResponse.status() !== e.status) {
+                    throw new Error(`status ${lastResponse.status()} !== ${e.status}`);
+                }
+                if (e.statusIn && !e.statusIn.includes(lastResponse.status())) {
+                    throw new Error(`status ${lastResponse.status()} not in ${e.statusIn.join(',')}`);
+                }
+                if (e.headerIncludes) {
+                    const v = lastResponse.headers()[e.headerIncludes.name.toLowerCase()] ?? '';
+                    if (!v.includes(e.headerIncludes.value))
+                        throw new Error(`header ${e.headerIncludes.name} missing ${e.headerIncludes.value}`);
+                }
+                if (e.bodyIncludes && !lastBody.includes(e.bodyIncludes)) {
+                    throw new Error(`body missing ${e.bodyIncludes}`);
+                }
+                if (e.jsonPath) {
+                    const obj = JSON.parse(lastBody || 'null');
+                    const val = getPath(obj, e.jsonPath.path);
+                    if (e.jsonPath.exists === true && val === undefined)
+                        throw new Error(`jsonPath ${e.jsonPath.path} missing`);
+                    if (e.jsonPath.exists === false && val !== undefined)
+                        throw new Error(`jsonPath ${e.jsonPath.path} should be missing`);
+                    if (e.jsonPath.equals !== undefined && JSON.stringify(val) !== JSON.stringify(e.jsonPath.equals)) {
+                        throw new Error(`jsonPath ${e.jsonPath.path}: ${JSON.stringify(val)} !== ${JSON.stringify(e.jsonPath.equals)}`);
+                    }
+                }
+                stepResults.push({ step, passed: true, durationMs: Date.now() - start, status: lastResponse.status() });
+            }
+        }
+        catch (e) {
+            passed = false;
+            error = e?.message ?? String(e);
+            stepResults.push({ step, passed: false, durationMs: Date.now() - start, status: lastResponse?.status(), error });
+            break;
+        }
+    }
+    return { name: flow.name, passed, steps: stepResults, error };
+}
+function getPath(obj, path) {
+    const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.').filter(Boolean);
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null)
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/aria-audit.d.ts

@@ -0,0 +1,20 @@
+import type { Page } from 'playwright';
+export type AriaIssueType = 'invalid-role' | 'abstract-role' | 'role-on-wrong-element' | 'aria-hidden-on-focusable' | 'empty-button' | 'empty-link' | 'missing-name-on-widget' | 'duplicate-id' | 'tabindex-gt-zero' | 'presentational-with-content' | 'invalid-aria-attr';
+export interface AriaIssue {
+    type: AriaIssueType;
+    target: string;
+    detail: string;
+}
+export interface AriaLandmarkCount {
+    role: string;
+    count: number;
+}
+export interface AriaAuditResult {
+    page: string;
+    issues: AriaIssue[];
+    landmarks: AriaLandmarkCount[];
+    rolesUsed: Record<string, number>;
+    passed: boolean;
+}
+export declare function auditAria(page: Page): Promise<AriaAuditResult>;
+//# sourceMappingURL=aria-audit.d.ts.map

package/dist/aria-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-audit.d.ts","sourceRoot":"","sources":["../src/aria-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,uBAAuB,GACvB,0BAA0B,GAC1B,cAAc,GACd,YAAY,GACZ,wBAAwB,GACxB,cAAc,GACd,kBAAkB,GAClB,6BAA6B,GAC7B,mBAAmB,CAAC;AAExB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;CACjB;AAQD,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAscpE"}