foundry-design 0.2.0-beta.21 → 0.2.0-beta.23

package/dist/visual-check-capture.js

@@ -0,0 +1,331 @@
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { promisify } from 'node:util';
+export class UnsupportedVisualContextError extends Error {
+}
+// tsx/esbuild can preserve nested function names through a local __name helper.
+// Keep that helper inside this evaluation, never on the project's global object.
+function evaluateInPage(page, callback, argument) {
+    return page.evaluate(`(() => { const __name = (target) => target; return (${callback.toString()})(${JSON.stringify(argument)}); })()`);
+}
+export function validateVisualUrl(input) {
+    const url = new URL(input);
+    if (!['http:', 'https:'].includes(url.protocol) ||
+        !['localhost', '127.0.0.1', '[::1]'].includes(url.hostname) ||
+        url.username ||
+        url.password) {
+        throw new Error('Visual checks require an HTTP(S) loopback project URL without credentials.');
+    }
+    if ([...url.searchParams.keys()].some((key) => /token|secret|password|capability|session/i.test(key))) {
+        throw new Error('Register the product URL without session credentials or secret query parameters.');
+    }
+    return url;
+}
+export function screenConfigurationHash(screen) {
+    return createHash('sha256').update(JSON.stringify(screen)).digest('hex');
+}
+async function projectRevision(projectRoot) {
+    try {
+        const execute = promisify(execFile);
+        const { stdout: revision } = await execute('git', ['rev-parse', 'HEAD'], {
+            cwd: projectRoot,
+            timeout: 5000,
+        });
+        const { stdout: status } = await execute('git', ['status', '--porcelain', '--untracked-files=normal', '--', '.', ':!.foundry/visual-checks'], { cwd: projectRoot, timeout: 5000 });
+        return { sourceRevision: revision.trim(), sourceDirty: Boolean(status.trim()) };
+    }
+    catch {
+        return {};
+    }
+}
+async function applyHook(page, axis, value, hook) {
+    if (!hook) {
+        if (value !== 'current')
+            throw new UnsupportedVisualContextError(`${axis} “${value}” needs an explicit authored attribute or class hook.`);
+        return;
+    }
+    const result = await evaluateInPage(page, ({ hook, axis }) => {
+        const nodes = document.querySelectorAll(hook.selector);
+        if (nodes.length !== 1)
+            return `${axis} hook must resolve to exactly one target (found ${nodes.length}).`;
+        const target = nodes[0];
+        const styles = [];
+        function collect(rules) {
+            for (const rule of Array.from(rules)) {
+                if ('selectorText' in rule)
+                    styles.push(rule.selectorText);
+                if ('cssRules' in rule)
+                    collect(rule.cssRules);
+            }
+        }
+        for (const sheet of Array.from(document.styleSheets)) {
+            try {
+                collect(sheet.cssRules);
+            }
+            catch {
+                /* Cross-origin rules cannot prove an authored hook. */
+            }
+        }
+        const hookSelector = hook.attribute === 'class'
+            ? `.${CSS.escape(hook.value)}`
+            : `[${hook.attribute}="${CSS.escape(hook.value)}"]`;
+        const normalize = (selector) => selector.replace(/\[([^\]=]+)=['"]?([^\]'"\s]+)['"]?\]/g, '[$1="$2"]');
+        if (!styles.some((selector) => normalize(selector).includes(hookSelector))) {
+            return `No readable authored CSS selector was found for ${axis} ${hookSelector}.`;
+        }
+        if (hook.attribute === 'class')
+            target.classList.add(hook.value);
+        else
+            target.setAttribute(hook.attribute, hook.value);
+        return null;
+    }, { hook, axis });
+    if (result)
+        throw new UnsupportedVisualContextError(result);
+}
+async function stableGeometry(page, screen) {
+    const sample = () => evaluateInPage(page, ({ masks, targets }) => {
+        const masked = (node) => masks.some((selector) => node.matches(selector) || node.closest(selector));
+        const selectorFor = (node) => {
+            if (node.id && document.querySelectorAll(`#${CSS.escape(node.id)}`).length === 1)
+                return `#${CSS.escape(node.id)}`;
+            const path = [];
+            let cursor = node;
+            while (cursor && cursor !== document.documentElement) {
+                const parent = cursor.parentElement;
+                const position = parent ? Array.from(parent.children).indexOf(cursor) + 1 : 1;
+                path.unshift(`${cursor.tagName.toLowerCase()}:nth-child(${position})`);
+                cursor = parent;
+            }
+            return `html > ${path.join(' > ')}`;
+        };
+        const nodes = [
+            ...new Set(targets.length
+                ? targets.flatMap((selector) => Array.from(document.querySelectorAll(selector)))
+                : Array.from(document.body.querySelectorAll('*'))),
+        ];
+        const geometry = [];
+        const findings = [];
+        for (const node of nodes.slice(0, 2000)) {
+            if (masked(node))
+                continue;
+            const rect = node.getBoundingClientRect();
+            const style = getComputedStyle(node);
+            if (!rect.width ||
+                !rect.height ||
+                style.visibility === 'hidden' ||
+                style.display === 'none')
+                continue;
+            const selector = selectorFor(node);
+            const round = (value) => Math.round(value * 100) / 100;
+            geometry.push({
+                selector,
+                x: round(rect.x),
+                y: round(rect.y),
+                width: round(rect.width),
+                height: round(rect.height),
+            });
+            if (rect.right > innerWidth + 1 || rect.left < -1)
+                findings.push({
+                    kind: 'horizontal-overflow',
+                    selector,
+                    message: 'Element extends beyond the horizontal viewport.',
+                });
+            if ((['hidden', 'clip'].includes(style.overflowX) &&
+                node.scrollWidth > node.clientWidth + 1) ||
+                (['hidden', 'clip'].includes(style.overflowY) &&
+                    node.scrollHeight > node.clientHeight + 1))
+                findings.push({
+                    kind: 'clipped-content',
+                    selector,
+                    message: 'Content exceeds a clipped element. This may be intentional.',
+                });
+            if (node.matches('button, a[href], input:not([type="hidden"]), select, textarea, [role="button"]')) {
+                if (rect.width < 44 || rect.height < 44)
+                    findings.push({
+                        kind: 'small-target',
+                        selector,
+                        message: `Interactive target measures ${round(rect.width)} × ${round(rect.height)}px; check whether a 44px target is appropriate.`,
+                    });
+                const labelled = node
+                    .getAttribute('aria-labelledby')
+                    ?.split(/\s+/)
+                    .map((id) => document.getElementById(id)?.textContent || '')
+                    .join('');
+                const inputLabels = 'labels' in node
+                    ? Array.from(node.labels ?? [])
+                        .map((label) => label.textContent)
+                        .join('')
+                    : '';
+                const text = (node.getAttribute('aria-label') ||
+                    labelled ||
+                    inputLabels ||
+                    node.textContent ||
+                    node.getAttribute('title') ||
+                    ('value' in node && node.matches('input[type="submit"],input[type="button"]')
+                        ? String(node.value)
+                        : '')).trim();
+                if (!text)
+                    findings.push({
+                        kind: 'missing-name',
+                        selector,
+                        message: 'No accessible name was found by the basic name check.',
+                    });
+            }
+            if (node.matches('img') &&
+                !node.hasAttribute('alt') &&
+                node.getAttribute('role') !== 'presentation' &&
+                node.getAttribute('aria-hidden') !== 'true')
+                findings.push({
+                    kind: 'missing-alt',
+                    selector,
+                    message: 'Image has no alt attribute.',
+                });
+        }
+        return { geometry, findings, truncated: nodes.length > 2000 };
+    }, { masks: screen.masks, targets: screen.targets });
+    let previous = '';
+    let stable = 0;
+    for (let attempt = 0; attempt < 25; attempt++) {
+        const value = await sample();
+        const signature = JSON.stringify(value.geometry);
+        stable = signature === previous ? stable + 1 : 0;
+        if (stable >= 3)
+            return value;
+        previous = signature;
+        await page.waitForTimeout(100);
+    }
+    throw new Error('Layout did not become stable. Mask dynamic content or fix the preview before capturing.');
+}
+export async function captureVisualScreen(browser, screen, projectRoot, screenshot) {
+    validateVisualUrl(screen.url);
+    const context = await browser.newContext({
+        viewport: screen.viewport,
+        deviceScaleFactor: 1,
+        reducedMotion: 'reduce',
+        locale: 'en-US',
+        timezoneId: 'UTC',
+    });
+    try {
+        await context.route('**/*', async (route) => {
+            if (route.request().isNavigationRequest()) {
+                try {
+                    validateVisualUrl(route.request().url());
+                }
+                catch {
+                    await route.abort('blockedbyclient');
+                    return;
+                }
+            }
+            await route.continue();
+        });
+        const page = await context.newPage();
+        page.setDefaultTimeout(10000);
+        const response = await page.goto(screen.url, { waitUntil: 'domcontentloaded', timeout: 15000 });
+        if (!response?.ok())
+            throw new Error(`Preview returned HTTP ${response?.status() ?? 'no response'}.`);
+        validateVisualUrl(page.url());
+        // Client-rendered previews can mount after DOMContentLoaded (notably Storybook).
+        // Wait for the registered content before applying hooks or measuring its assets.
+        const selectors = new Set([
+            ...screen.targets,
+            ...screen.masks,
+            ...(screen.themeHook ? [screen.themeHook.selector] : []),
+            ...(screen.stateHook ? [screen.stateHook.selector] : []),
+        ]);
+        await Promise.all([...selectors].map(async (selector) => {
+            try {
+                await page.locator(selector).first().waitFor({ state: 'attached', timeout: 10000 });
+            }
+            catch {
+                throw new UnsupportedVisualContextError(`Registered selector did not become available: ${selector}`);
+            }
+        }));
+        await evaluateInPage(page, async () => {
+            await Promise.race([
+                document.fonts.ready,
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Fonts did not finish loading.')), 10000)),
+            ]);
+        }, undefined);
+        await applyHook(page, 'Theme', screen.theme, screen.themeHook);
+        await applyHook(page, 'State', screen.state, screen.stateHook);
+        await page.addStyleTag({
+            content: '*,*::before,*::after{animation:none!important;transition:none!important;caret-color:transparent!important;scroll-behavior:auto!important}',
+        });
+        await evaluateInPage(page, async (masks) => {
+            // Force style/layout after authored hooks so newly requested fonts are included.
+            document.body.getBoundingClientRect();
+            const ready = async () => {
+                await document.fonts.ready;
+                const failedFonts = Array.from(document.fonts).filter((face) => face.status === 'error');
+                if (failedFonts.length)
+                    throw new Error('A project font failed to load. Capture cannot verify the intended typography.');
+                await Promise.all(Array.from(document.images)
+                    .filter((image) => {
+                    const rect = image.getBoundingClientRect();
+                    return (!masks.some((selector) => image.matches(selector) || image.closest(selector)) &&
+                        rect.width > 0 &&
+                        rect.height > 0 &&
+                        rect.bottom > 0 &&
+                        rect.top < innerHeight);
+                })
+                    .map(async (image) => {
+                    if (!image.complete)
+                        await image.decode();
+                    if (!image.naturalWidth)
+                        throw new Error('A visible project image failed to load.');
+                }));
+            };
+            await Promise.race([
+                ready(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Fonts or visible images did not become ready.')), 10000)),
+            ]);
+        }, screen.masks);
+        for (const selector of [...screen.targets, ...screen.masks]) {
+            if (!(await page.locator(selector).count()))
+                throw new UnsupportedVisualContextError(`Registered selector was not found: ${selector}`);
+        }
+        const measured = await stableGeometry(page, screen);
+        const bytes = await page.screenshot({
+            path: screenshot,
+            animations: 'disabled',
+            caret: 'hide',
+            mask: screen.masks.map((selector) => page.locator(selector)),
+            maskColor: '#808080',
+            fullPage: false,
+        });
+        const after = await stableGeometry(page, screen);
+        if (JSON.stringify(measured.geometry) !== JSON.stringify(after.geometry))
+            throw new Error('Layout changed during capture. The capture cannot be used as evidence.');
+        return {
+            version: 1,
+            screen,
+            configurationHash: screenConfigurationHash(screen),
+            createdAt: new Date().toISOString(),
+            ...(await projectRevision(projectRoot)),
+            browser: browser.version(),
+            platform: `${process.platform}/${process.arch}`,
+            deviceScaleFactor: 1,
+            motion: 'reduced; CSS animations and transitions disabled',
+            screenshot,
+            screenshotHash: createHash('sha256').update(bytes).digest('hex'),
+            geometry: measured.geometry,
+            findings: measured.findings,
+            evidence: [
+                'Waited for registered targets, masks and authored hook elements before capture.',
+                'Waited for document.fonts.ready.',
+                'Geometry stable across four samples before and after capture.',
+                'Fresh isolated browser context; locale en-US, timezone UTC.',
+                'Basic overflow, clipping, target-size and name/alt checks only; not a complete accessibility audit.',
+                ...(measured.truncated
+                    ? [
+                        'Geometry checks limited to the first 2000 elements. Register explicit targets to narrow this screen.',
+                    ]
+                    : []),
+            ],
+        };
+    }
+    finally {
+        await context.close();
+    }
+}
+//# sourceMappingURL=visual-check-capture.js.map

package/dist/visual-check-capture.js.map

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

package/dist/visual-check.d.ts

@@ -0,0 +1,10 @@
+import { type VisualCapture, type VisualCheckReport, type VisualCheckResult, type VisualScreen } from 'foundry-design-protocol';
+export declare function registerVisualScreen(projectRoot: string, input: unknown): Promise<VisualScreen>;
+export declare function visualCheckExitCode(results: VisualCheckResult[]): VisualCheckReport['exitCode'];
+export declare function compareVisualCaptures(baseline: VisualCapture, current: VisualCapture, baselineImage: string, currentImage: string, diffImage: string): Promise<Pick<VisualCheckResult, 'status' | 'reason' | 'changedPixels' | 'totalPixels' | 'changedRatio' | 'geometryChanges' | 'newFindings'>>;
+export declare function renderVisualCheckHtml(report: VisualCheckReport): string;
+export declare function runVisualChecks(projectRoot: string, name?: string): Promise<VisualCheckReport>;
+export declare function approveVisualBaseline(projectRoot: string, runId: string, name: string): Promise<string>;
+export declare function listVisualCheckReports(projectRoot: string): Promise<VisualCheckReport[]>;
+export declare function runVisualCheckCli(args: string[], projectRoot: string): Promise<number>;
+//# sourceMappingURL=visual-check.d.ts.map

package/dist/visual-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-check.d.ts","sourceRoot":"","sources":["../src/visual-check.ts"],"names":[],"mappings":"AAgBA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEtB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAkGjC,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAS/F;AAMD,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CACR,IAAI,CACF,iBAAiB,EACf,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,aAAa,CAChB,CACF,CA4FA;AAUD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAOvE;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAkG5B;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAED,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmB9F;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiF5F"}