tevra-design-kit 0.0.0-stage → 1.0.0

package/dist/packages/registry/src/index.js

@@ -0,0 +1,132 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { validate } from '../../design-context/src/validation.js';
+import { kitRoot } from '../../filesystem/src/resources.js';
+export function validateRegistry(input) {
+    const registry = validate('skill-registry.schema.json', input);
+    const identities = new Map();
+    const names = new Set();
+    for (const skill of registry.skills) {
+        if (identities.has(skill.id) || names.has(skill.name))
+            throw new Error(`Duplicate skill identity: ${skill.id}`);
+        if (/^(?:[a-z]:|[\\/])/iu.test(skill.entrypoint) || skill.entrypoint.split(/[\\/]/u).some(part => part === '..' || part === '.') || skill.entrypoint.includes('\0'))
+            throw new Error(`Unsafe entrypoint: ${skill.id}`);
+        identities.set(skill.id, skill);
+        names.add(skill.name);
+    }
+    for (const skill of registry.skills) {
+        for (const id of [...skill.dependencies, ...skill.conflicts]) {
+            if (!identities.has(id))
+                throw new Error(`Missing dependency or conflict ${id} for ${skill.id}`);
+            if (id === skill.id)
+                throw new Error(`Self dependency or conflict: ${id}`);
+        }
+    }
+    const visited = new Set();
+    const active = new Set();
+    function visit(skill) {
+        if (active.has(skill.id))
+            throw new Error(`Dependency cycle: ${skill.id}`);
+        if (visited.has(skill.id))
+            return;
+        active.add(skill.id);
+        for (const id of skill.dependencies) {
+            const dependency = identities.get(id);
+            if (!dependency)
+                throw new Error(`Missing dependency: ${id}`);
+            visit(dependency);
+        }
+        active.delete(skill.id);
+        visited.add(skill.id);
+    }
+    for (const skill of registry.skills)
+        visit(skill);
+    return registry;
+}
+export async function loadRegistry(extensionFiles = []) {
+    const files = [resolve(kitRoot(), 'registry/skills.json'), ...extensionFiles];
+    const skills = [];
+    for (const path of files) {
+        const extension = validate('skill-registry.schema.json', JSON.parse(await readFile(path, 'utf8')));
+        skills.push(...extension.skills);
+    }
+    return validateRegistry({ version: 1, skills });
+}
+export function selectCapabilities(registryInput, capabilities, options = {}) {
+    const registry = validateRegistry(registryInput);
+    const owners = {};
+    const duplicates = {};
+    const selected = new Map();
+    const compatible = (skill) => (!options.framework || skill.frameworks.includes(options.framework)) &&
+        (!options.platform || skill.platforms.includes(options.platform)) &&
+        (!options.agent || skill.agents.includes(options.agent));
+    for (const capability of [...new Set(capabilities)].sort()) {
+        const candidates = registry.skills.filter(skill => skill.capabilities.includes(capability) && compatible(skill))
+            .sort((a, b) => b.priority - a.priority || a.id.localeCompare(b.id, 'en'));
+        const override = options.overrides?.[capability];
+        const winner = override ? candidates.find(skill => skill.id === override) : candidates[0];
+        if (!winner)
+            throw new Error(`No compatible owner for ${capability}${override ? ` (override ${override})` : ''}`);
+        owners[capability] = winner.id;
+        selected.set(winner.id, winner);
+        if (candidates.length > 1)
+            duplicates[capability] = candidates.map(skill => skill.id);
+    }
+    const ordered = [];
+    const added = new Set();
+    function add(skill) {
+        if (added.has(skill.id))
+            return;
+        if (!compatible(skill))
+            throw new Error(`Incompatible dependency: ${skill.id}`);
+        for (const id of skill.dependencies) {
+            const dependency = registry.skills.find(candidate => candidate.id === id);
+            if (!dependency)
+                throw new Error(`Missing dependency: ${id}`);
+            add(dependency);
+        }
+        added.add(skill.id);
+        ordered.push(skill);
+    }
+    for (const skill of selected.values())
+        add(skill);
+    for (const skill of ordered) {
+        const conflict = skill.conflicts.find(id => added.has(id));
+        if (conflict)
+            throw new Error(`Capability conflict: ${skill.id} conflicts with ${conflict}`);
+    }
+    return { skills: ordered, owners, duplicates };
+}
+export function registryGraph(registry) {
+    validateRegistry(registry);
+    const lines = ['graph TD'];
+    const nodes = new Map(registry.skills.map((skill, index) => [skill.id, `s${index}`]));
+    for (const skill of registry.skills) {
+        lines.push(`  ${nodes.get(skill.id)}["${skill.id}"]`);
+        for (const dependency of skill.dependencies)
+            lines.push(`  ${nodes.get(dependency)} --> ${nodes.get(skill.id)}`);
+        for (const conflict of skill.conflicts)
+            lines.push(`  ${nodes.get(skill.id)} -. conflict .-> ${nodes.get(conflict)}`);
+    }
+    return lines.join('\n');
+}
+export async function validateBundledProvenance(registry) {
+    const sources = validate('sources.schema.json', JSON.parse(await readFile(resolve(kitRoot(), 'registry/sources.json'), 'utf8')));
+    if (new Set(sources.sources.map(source => source.id)).size !== sources.sources.length)
+        throw new Error('Duplicate source IDs');
+    for (const skill of registry.skills.filter(skill => skill.id.startsWith('tevra.')))
+        for (const id of skill.source.references)
+            if (!sources.sources.some(source => source.id === id))
+                throw new Error(`Missing source provenance: ${id}`);
+    const ownership = validate('capability-ownership.schema.json', JSON.parse(await readFile(resolve(kitRoot(), 'registry/capability-ownership.json'), 'utf8')));
+    if (new Set(ownership.capabilities.map(capability => capability.id)).size !== ownership.capabilities.length)
+        throw new Error('Duplicate capability ownership');
+    for (const capability of ownership.capabilities) {
+        if (capability.primary && !registry.skills.some(skill => skill.id === capability.primary && skill.capabilities.includes(capability.id)))
+            throw new Error(`Invalid capability owner: ${capability.id}`);
+        for (const supporting of capability.supporting)
+            if (!registry.skills.some(skill => skill.id === supporting))
+                throw new Error(`Unknown supporting skill: ${supporting}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/packages/registry/src/index.js.map

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

package/dist/packages/visual-testing/src/capture.d.ts

@@ -0,0 +1,12 @@
+import axe from 'axe-core';
+import type { Config } from '../../contracts/src/index.js';
+import type { CaptureManifest } from './types.js';
+declare global {
+    interface Window {
+        axe: typeof axe;
+    }
+}
+export declare function configHash(config: Config): string;
+export declare function manifestHash(manifest: CaptureManifest): string;
+export declare function comparisonSettingsHash(config: Config): string;
+export declare function capture(root: string, config: Config, kind: CaptureManifest['kind'], revision: number, approveBaseline?: boolean, allowCustomBrowser?: boolean): Promise<CaptureManifest>;

package/dist/packages/visual-testing/src/capture.js

@@ -0,0 +1,174 @@
+import { chromium } from 'playwright';
+import axe from 'axe-core';
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, stat } from 'node:fs/promises';
+import { isMissing, redact, safePath, withLock, writeJSON } from '../../filesystem/src/index.js';
+export function configHash(config) {
+    return createHash('sha256').update(JSON.stringify({ baseURL: config.baseURL, origins: config.permittedOrigins, browser: config.browser, viewports: config.viewports, routes: config.routes, readySelector: config.readySelector, colorScheme: config.colorScheme ?? 'light', reducedMotion: config.reducedMotion ?? 'reduce' })).digest('hex');
+}
+export function manifestHash(manifest) { return createHash('sha256').update(JSON.stringify(manifest)).digest('hex'); }
+export function comparisonSettingsHash(config) { return createHash('sha256').update(JSON.stringify({ diffRatio: config.thresholds.diffRatio, pixelSensitivity: config.thresholds.pixelSensitivity })).digest('hex'); }
+export async function capture(root, config, kind, revision, approveBaseline = false, allowCustomBrowser = false) {
+    if (config.browser.executablePath && !allowCustomBrowser)
+        throw new Error('Custom browser executable requires explicit --allow-custom-browser authorization');
+    if (kind === 'baseline' && !approveBaseline)
+        throw new Error('Baseline capture requires explicit --approve-baseline authorization');
+    return withLock(root, '.tevra/visual.lock', async () => {
+        if (kind === 'baseline') {
+            try {
+                await stat(await safePath(root, '.tevra/artifacts/baseline/manifest.json'));
+                throw new Error('Baseline already exists; archive it explicitly before establishing a new baseline');
+            }
+            catch (error) {
+                if (!isMissing(error))
+                    throw error;
+            }
+        }
+        const runId = randomUUID();
+        await writeJSON(root, `.tevra/artifacts/${kind}/attempt.json`, { status: 'running', runId });
+        try {
+            const browser = await chromium.launch({ ...config.browser, headless: true, timeout: config.timeoutMs });
+            try {
+                const manifest = { version: 1, kind, runId, createdAt: new Date().toISOString(), configHash: configHash(config), contextRevision: revision, browserVersion: browser.version(), entries: [] };
+                for (const route of config.routes)
+                    for (const state of route.states)
+                        for (const viewport of config.viewports) {
+                            const id = `${route.name}--${state.name}--${viewport.name}`;
+                            const file = `.tevra/artifacts/${kind}/${runId}/${id}.png`;
+                            const path = await safePath(root, file);
+                            await mkdir(await safePath(root, `.tevra/artifacts/${kind}/${runId}`), { recursive: true });
+                            const context = await browser.newContext({ viewport: { width: viewport.width, height: viewport.height }, reducedMotion: config.reducedMotion ?? 'reduce', colorScheme: config.colorScheme ?? 'light', locale: 'en-US', timezoneId: 'UTC', serviceWorkers: 'block', acceptDownloads: false });
+                            try {
+                                await context.routeWebSocket('**/*', socket => {
+                                    const url = new URL(socket.url());
+                                    url.protocol = url.protocol === 'wss:' ? 'https:' : 'http:';
+                                    if (config.permittedOrigins.includes(url.origin))
+                                        socket.connectToServer();
+                                    else
+                                        socket.close();
+                                });
+                                await context.route('**/*', async (request) => {
+                                    const url = new URL(request.request().url());
+                                    if (['data:', 'blob:', 'about:'].includes(url.protocol) || config.permittedOrigins.includes(url.origin))
+                                        await request.continue();
+                                    else
+                                        await request.abort('blockedbyclient');
+                                });
+                                const page = await context.newPage();
+                                page.setDefaultTimeout(config.timeoutMs);
+                                const consoleErrors = [];
+                                const networkErrors = [];
+                                let assertions = 0;
+                                page.on('console', message => { if (message.type() === 'error')
+                                    consoleErrors.push(redact(message.text())); });
+                                page.on('requestfailed', request => networkErrors.push(redact(`${request.method()} ${request.url()}: ${request.failure()?.errorText ?? 'failed'}`)));
+                                page.on('response', response => { if (response.status() >= 400)
+                                    networkErrors.push(redact(`HTTP ${response.status()} ${response.url()}`)); });
+                                const pageErrors = [];
+                                page.on('pageerror', error => pageErrors.push(redact(error.message)));
+                                const response = await page.goto(new URL(route.path, config.baseURL).href, { waitUntil: 'load', timeout: config.timeoutMs });
+                                if (!response?.ok())
+                                    throw new Error(`Route failed with HTTP ${response?.status() ?? 'no response'}: ${route.name}`);
+                                if (!config.permittedOrigins.includes(new URL(page.url()).origin))
+                                    throw new Error(`Redirect outside permitted origins: ${route.name}`);
+                                if (config.readySelector)
+                                    await page.locator(config.readySelector).waitFor({ state: 'attached' });
+                                for (const action of state.actions) {
+                                    const control = page.locator(action.selector);
+                                    if (action.type === 'click')
+                                        await control.click();
+                                    else if (action.type === 'check')
+                                        await control.check();
+                                    else if (action.type === 'fill') {
+                                        if (action.value === undefined)
+                                            throw new Error('fill requires a value');
+                                        await control.fill(action.value);
+                                    }
+                                    else if (action.type === 'press') {
+                                        if (action.value === undefined)
+                                            throw new Error('press requires a value');
+                                        await control.press(action.value);
+                                    }
+                                    else {
+                                        if (action.type === 'expect-visible')
+                                            await control.waitFor({ state: 'visible' });
+                                        else if (action.type === 'expect-hidden')
+                                            await control.waitFor({ state: 'hidden' });
+                                        else if (action.type === 'expect-checked') {
+                                            if (!await control.isChecked())
+                                                throw new Error(`Expected checked control: ${action.selector}`);
+                                        }
+                                        else {
+                                            if (action.value === undefined)
+                                                throw new Error('expect-text requires a value');
+                                            await control.filter({ hasText: action.value }).waitFor({ state: 'visible' });
+                                        }
+                                        assertions += 1;
+                                    }
+                                }
+                                if (state.waitFor)
+                                    await page.locator(state.waitFor).waitFor({ state: 'visible' });
+                                await page.waitForFunction(() => document.fonts.status === 'loaded');
+                                for (const selector of state.masks)
+                                    if (!await page.locator(selector).count())
+                                        throw new Error(`Mask matches no elements: ${selector}`);
+                                await page.addScriptTag({ content: axe.source });
+                                const accessibility = await page.evaluate(async () => {
+                                    return window.axe.run(document, { runOnly: { type: 'tag', values: ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa'] } });
+                                });
+                                const geometry = await page.evaluate(() => {
+                                    const overflow = [];
+                                    const smallTargets = [];
+                                    for (const element of document.querySelectorAll('body *')) {
+                                        const box = element.getBoundingClientRect();
+                                        const style = getComputedStyle(element);
+                                        if (!box.width || !box.height || style.visibility === 'hidden' || style.display === 'none')
+                                            continue;
+                                        if (box.right > innerWidth + 1 || box.left < -1) {
+                                            let ancestor = element.parentElement;
+                                            let scrollable = false;
+                                            while (ancestor && ancestor !== document.body) {
+                                                if (['auto', 'scroll'].includes(getComputedStyle(ancestor).overflowX)) {
+                                                    scrollable = true;
+                                                    break;
+                                                }
+                                                ancestor = ancestor.parentElement;
+                                            }
+                                            if (!scrollable)
+                                                overflow.push(`${element.tagName.toLowerCase()}${element.id ? `#${element.id}` : ''}`);
+                                        }
+                                        if (element.matches('button,input:not([type=hidden]),select,[role=button]') && (box.width < 24 || box.height < 24))
+                                            smallTargets.push(`${element.tagName.toLowerCase()}${element.id ? `#${element.id}` : ''}`);
+                                    }
+                                    if (document.documentElement.scrollWidth > innerWidth + 1)
+                                        overflow.push('document-horizontal-overflow');
+                                    return { overflow: [...new Set(overflow)].slice(0, 100), smallTargets: [...new Set(smallTargets)].slice(0, 100) };
+                                });
+                                await safePath(root, file);
+                                const pixelArea = await page.evaluate(() => innerWidth * Math.max(document.documentElement.scrollHeight, innerHeight));
+                                if (pixelArea > 40_000_000)
+                                    throw new Error('Rendered page exceeds the 40 million pixel capture limit');
+                                const image = await page.screenshot({ path, fullPage: true, animations: 'disabled', mask: state.masks.map(selector => page.locator(selector)), maskColor: '#777777' });
+                                manifest.entries.push({ id, route: route.name, state: state.name, viewport, file, imageHash: createHash('sha256').update(image).digest('hex'), masks: state.masks, ...geometry,
+                                    axeViolations: accessibility.violations.map(violation => ({ id: violation.id, impact: violation.impact ?? 'unknown', targets: violation.nodes.map(node => node.target.join(' ')), help: violation.help })),
+                                    incompleteRules: accessibility.incomplete.map(rule => rule.id), pageErrors, consoleErrors, networkErrors, assertions });
+                            }
+                            finally {
+                                await context.close();
+                            }
+                        }
+                await writeJSON(root, `.tevra/artifacts/${kind}/manifest.json`, manifest);
+                await writeJSON(root, `.tevra/artifacts/${kind}/attempt.json`, { status: 'passed', runId });
+                return manifest;
+            }
+            finally {
+                await browser.close();
+            }
+        }
+        catch (error) {
+            await writeJSON(root, `.tevra/artifacts/${kind}/attempt.json`, { status: 'failed', runId, error: redact(error instanceof Error ? error.message : String(error)) });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=capture.js.map

package/dist/packages/visual-testing/src/capture.js.map

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

package/dist/packages/visual-testing/src/checks.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../../contracts/src/index.js';
+import type { CaptureManifest } from './types.js';
+export declare function captureChecks(manifest: CaptureManifest): Check[];

package/dist/packages/visual-testing/src/checks.js

@@ -0,0 +1,17 @@
+export function captureChecks(manifest) {
+    const evidence = [`.tevra/artifacts/${manifest.kind}/manifest.json`];
+    const violations = manifest.entries.flatMap(entry => entry.axeViolations.map(violation => `${entry.id}: ${violation.id} (${violation.impact})`));
+    const overflow = manifest.entries.flatMap(entry => entry.overflow.map(selector => `${entry.id}: ${selector}`));
+    const errors = manifest.entries.flatMap(entry => entry.pageErrors.map(error => `${entry.id}: ${error}`));
+    const consoleErrors = manifest.entries.flatMap(entry => (entry.consoleErrors ?? []).map(error => `${entry.id}: ${error}`));
+    const networkErrors = manifest.entries.flatMap(entry => (entry.networkErrors ?? []).map(error => `${entry.id}: ${error}`));
+    const smallTargets = manifest.entries.flatMap(entry => entry.smallTargets.map(selector => `${entry.id}: ${selector}`));
+    const check = (id, category, kind, issues, severity, correction) => ({ id, category, kind, status: issues.length ? 'failed' : 'passed', severity, evidence, issue: issues.length ? issues.join('; ') : `No ${id} findings in captured states.`, component: 'configured viewport/state matrix', correction });
+    return [
+        { id: 'functional-tests', category: 'functional', kind: 'deterministic', status: manifest.entries.every(entry => (entry.assertions ?? 0) > 0) ? 'passed' : 'unverified', severity: 'critical', evidence, issue: 'Only explicitly configured assertions establish behavior coverage.', component: 'configured browser flows', correction: 'Add relevant expect-visible/text/hidden/checked actions to every configured state.' },
+        check('console-errors', 'functional', 'deterministic', consoleErrors, 'critical', 'Resolve unexpected console errors.'),
+        check('network-errors', 'functional', 'deterministic', networkErrors, 'major', 'Inspect failed or blocked network requests.'),
+        check('axe', 'accessibility', 'deterministic', violations, 'critical', 'Resolve axe barriers and perform manual keyboard/screen-reader checks.'), check('overflow', 'responsive', 'heuristic', overflow, 'major', 'Inspect clipping and unintended horizontal overflow.'), check('runtime-errors', 'functional', 'deterministic', errors, 'critical', 'Fix browser runtime errors before delivery.'), check('touch-targets', 'accessibility', 'heuristic', smallTargets, 'minor', 'Inspect 24px target-size or spacing exceptions; increase targets where needed.')
+    ];
+}
+//# sourceMappingURL=checks.js.map

package/dist/packages/visual-testing/src/checks.js.map

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

package/dist/packages/visual-testing/src/compare.d.ts

@@ -0,0 +1,12 @@
+import type { Config } from '../../contracts/src/index.js';
+import type { CaptureManifest, ComparisonResult } from './types.js';
+export declare function validateCaptureAttempt(root: string, manifest: CaptureManifest): Promise<void>;
+export declare function assertCaptureMatchesConfig(manifest: CaptureManifest, config: Config): void;
+export declare function compareImages(baseline: Buffer, current: Buffer, sensitivity: number, limit: number): {
+    png: Buffer;
+    differentPixels: number;
+    ratio: number;
+    sizeMismatch: boolean;
+    passed: boolean;
+};
+export declare function compare(root: string, config: Config): Promise<ComparisonResult>;

package/dist/packages/visual-testing/src/compare.js

@@ -0,0 +1,85 @@
+import { readFile } from 'node:fs/promises';
+import pixelmatch from 'pixelmatch';
+import { PNG } from 'pngjs';
+import { createHash } from 'node:crypto';
+import { readJSON, safePath, withLock, writeAtomic, writeJSON } from '../../filesystem/src/index.js';
+import { validate } from '../../design-context/src/validation.js';
+import { configHash, manifestHash, comparisonSettingsHash } from './capture.js';
+export async function validateCaptureAttempt(root, manifest) {
+    const attempt = await readJSON(root, `.tevra/artifacts/${manifest.kind}/attempt.json`);
+    if (!attempt || typeof attempt !== 'object' || !('status' in attempt) || attempt.status !== 'passed' || !('runId' in attempt) || attempt.runId !== manifest.runId)
+        throw new Error(`Latest ${manifest.kind} capture did not pass; recapture before comparison/reporting`);
+    for (const entry of manifest.entries) {
+        const digest = createHash('sha256').update(await readFile(await safePath(root, entry.file))).digest('hex');
+        if (digest !== entry.imageHash)
+            throw new Error(`Screenshot changed after capture: ${entry.id}`);
+    }
+}
+export function assertCaptureMatchesConfig(manifest, config) {
+    if (manifest.configHash !== configHash(config))
+        throw new Error('Capture does not match the active configuration');
+    const expected = config.routes.flatMap(route => route.states.flatMap(state => config.viewports.map(viewport => `${route.name}--${state.name}--${viewport.name}`)));
+    if (manifest.entries.length !== expected.length || new Set(manifest.entries.map(entry => entry.id)).size !== expected.length || expected.some(id => !manifest.entries.some(entry => entry.id === id)))
+        throw new Error('Capture artifact sets differ');
+    for (const entry of manifest.entries) {
+        const viewport = config.viewports.find(profile => profile.name === entry.viewport.name);
+        if (!viewport || viewport.width !== entry.viewport.width || viewport.height !== entry.viewport.height)
+            throw new Error('Capture viewport dimensions differ from configuration');
+    }
+}
+export function compareImages(baseline, current, sensitivity, limit) {
+    for (const buffer of [baseline, current]) {
+        if (buffer.length < 24 || buffer.subarray(0, 8).toString('hex') !== '89504e470d0a1a0a' || buffer.subarray(12, 16).toString() !== 'IHDR')
+            throw new Error('Invalid PNG header');
+        if (buffer.readUInt32BE(16) * buffer.readUInt32BE(20) > 40_000_000)
+            throw new Error('Screenshot exceeds 40 million pixel comparison limit');
+    }
+    const left = PNG.sync.read(baseline);
+    const right = PNG.sync.read(current);
+    const width = Math.max(left.width, right.width);
+    const height = Math.max(left.height, right.height);
+    if (width * height > 40_000_000)
+        throw new Error('Screenshot exceeds 40 million pixel comparison limit');
+    const paddedLeft = new PNG({ width, height });
+    const paddedRight = new PNG({ width, height });
+    const diff = new PNG({ width, height });
+    PNG.bitblt(left, paddedLeft, 0, 0, left.width, left.height, 0, 0);
+    PNG.bitblt(right, paddedRight, 0, 0, right.width, right.height, 0, 0);
+    const differentPixels = pixelmatch(paddedLeft.data, paddedRight.data, diff.data, width, height, { threshold: sensitivity, includeAA: false });
+    const ratio = differentPixels / (width * height);
+    const sizeMismatch = left.width !== right.width || left.height !== right.height;
+    return { png: PNG.sync.write(diff), differentPixels, ratio, sizeMismatch, passed: !sizeMismatch && ratio <= limit };
+}
+export async function compare(root, config) {
+    return withLock(root, '.tevra/visual.lock', async () => {
+        const baseline = validate('capture-manifest.schema.json', await readJSON(root, '.tevra/artifacts/baseline/manifest.json'));
+        const current = validate('capture-manifest.schema.json', await readJSON(root, '.tevra/artifacts/current/manifest.json'));
+        if (baseline.kind !== 'baseline' || current.kind !== 'current')
+            throw new Error('Invalid capture kinds');
+        await validateCaptureAttempt(root, baseline);
+        await validateCaptureAttempt(root, current);
+        assertCaptureMatchesConfig(baseline, config);
+        assertCaptureMatchesConfig(current, config);
+        if (baseline.configHash !== current.configHash)
+            throw new Error('Capture configurations differ; establish matching evidence rather than hiding the difference');
+        if (baseline.contextRevision !== current.contextRevision)
+            throw new Error('Capture context revisions differ');
+        if (baseline.browserVersion !== current.browserVersion)
+            throw new Error('Browser versions differ; compare in a consistent environment');
+        const comparisons = [];
+        for (const entry of current.entries) {
+            const original = baseline.entries.find(candidate => candidate.id === entry.id);
+            if (!original)
+                throw new Error(`Missing baseline: ${entry.id}`);
+            const result = compareImages(await readFile(await safePath(root, original.file)), await readFile(await safePath(root, entry.file)), config.thresholds.pixelSensitivity, config.thresholds.diffRatio);
+            const diff = `.tevra/artifacts/diff/${entry.id}.png`;
+            await writeAtomic(root, diff, result.png);
+            comparisons.push({ id: entry.id, ratio: result.ratio, differentPixels: result.differentPixels, sizeMismatch: result.sizeMismatch, passed: result.passed, diff });
+        }
+        const evidence = comparisons.map(comparison => comparison.diff);
+        const result = { version: 1, createdAt: new Date().toISOString(), settingsHash: comparisonSettingsHash(config), currentManifestHash: manifestHash(current), comparisons, checks: [{ id: 'visual-diff', category: 'consistency', kind: 'deterministic', status: comparisons.every(value => value.passed) ? 'passed' : 'failed', severity: 'major', evidence, component: 'configured visual matrix', issue: 'Changed-pixel ratio and screenshot dimensions compared to baseline.', correction: 'Inspect generated differences; obtain approval for intended changes before replacing baselines.' }] };
+        await writeJSON(root, '.tevra/artifacts/comparison.json', result);
+        return result;
+    });
+}
+//# sourceMappingURL=compare.js.map

package/dist/packages/visual-testing/src/compare.js.map

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

package/dist/packages/visual-testing/src/types.d.ts

@@ -0,0 +1,49 @@
+import type { Check, Viewport } from '../../contracts/src/index.js';
+export interface CaptureEntry {
+    id: string;
+    route: string;
+    state: string;
+    viewport: Viewport;
+    file: string;
+    imageHash: string;
+    masks: string[];
+    overflow: string[];
+    smallTargets: string[];
+    axeViolations: {
+        id: string;
+        impact: string;
+        targets: string[];
+        help: string;
+    }[];
+    incompleteRules: string[];
+    pageErrors: string[];
+    consoleErrors?: string[];
+    networkErrors?: string[];
+    assertions?: number;
+}
+export interface CaptureManifest {
+    version: 1;
+    kind: 'baseline' | 'current';
+    runId: string;
+    createdAt: string;
+    configHash: string;
+    contextRevision: number;
+    browserVersion: string;
+    entries: CaptureEntry[];
+}
+export interface Comparison {
+    id: string;
+    ratio: number;
+    differentPixels: number;
+    sizeMismatch: boolean;
+    diff: string;
+    passed: boolean;
+}
+export interface ComparisonResult {
+    version: 1;
+    createdAt: string;
+    settingsHash: string;
+    currentManifestHash: string;
+    comparisons: Comparison[];
+    checks: Check[];
+}

package/dist/packages/visual-testing/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/packages/visual-testing/src/types.js.map

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

package/dist/packages/workflow-engine/src/index.d.ts

@@ -0,0 +1,11 @@
+import type { Plan } from '../../contracts/src/index.js';
+export interface StageResult {
+    status: 'passed' | 'failed' | 'blocked' | 'skipped';
+    evidence: string[];
+    message: string;
+}
+export type StageAdapter = () => Promise<StageResult>;
+export declare function runWorkflow(root: string, path: string, adapters: Record<string, StageAdapter>): Promise<{
+    status: 'passed' | 'failed' | 'blocked';
+    plan: Plan;
+}>;