fidelity-kit 0.1.0 → 0.2.0

package/dist/watch.js

@@ -0,0 +1,96 @@
+import { watch } from 'chokidar';
+import { relative, resolve, sep } from 'node:path';
+import { SuiteProcessor } from './core/process.js';
+/** One processor and one batch in flight. Generated files are excluded before they reach either queue. */
+export async function watchResults(root, onResult = () => { }, opts = {}) {
+    const base = resolve(root);
+    const processor = await SuiteProcessor.create(base, opts);
+    let timer;
+    let running;
+    let closed = false;
+    let initializing = true;
+    let pending = false;
+    let configWarning = false;
+    const rel = (path) => relative(base, path).split(sep).join('/');
+    const relevant = (path) => path === 'fidelity.json' || processor.sceneForInput(path) !== null;
+    const flush = () => {
+        timer = undefined;
+        if (closed)
+            return;
+        processor.settle();
+        if (initializing || running || !pending)
+            return;
+        pending = false;
+        if (!processor.needsFlush)
+            return;
+        running = processor
+            .flush()
+            .then(onResult)
+            .catch((error) => console.error('Watch update failed:', error))
+            .finally(() => {
+            running = undefined;
+            if (pending && !timer && !closed)
+                timer = setTimeout(flush, 250);
+        });
+    };
+    const watcher = watch(base, {
+        ignoreInitial: true,
+        awaitWriteFinish: { stabilityThreshold: 500, pollInterval: 100 },
+        ignored: (path, stats) => !!stats?.isFile() && !relevant(rel(path)),
+    });
+    watcher.on('all', (event, path) => {
+        const input = rel(path);
+        if (closed)
+            return;
+        if (input === 'fidelity.json') {
+            if (!configWarning)
+                console.warn('fidelity.json changed; restart to apply renderer, output, or configuration changes.');
+            configWarning = true;
+            return;
+        }
+        if (event === 'unlinkDir')
+            processor.removeDirectory(input, true);
+        else {
+            if (event === 'addDir' || !relevant(input))
+                return;
+            processor.notify([input], true);
+        }
+        pending = true;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(flush, 250);
+    });
+    watcher.on('error', (error) => console.error('Watch error:', error));
+    try {
+        await new Promise((resolveReady, reject) => {
+            watcher.once('ready', resolveReady);
+            watcher.once('error', reject);
+        });
+        // Observe before scanning so changes during initial processing cannot fall through a startup gap.
+        onResult(await processor.initialize(opts.process ?? true));
+        initializing = false;
+        if (pending && !timer)
+            timer = setTimeout(flush, 250);
+    }
+    catch (error) {
+        closed = true;
+        if (timer)
+            clearTimeout(timer);
+        await watcher.close();
+        throw error;
+    }
+    return {
+        async close() {
+            closed = true;
+            if (timer)
+                clearTimeout(timer);
+            await watcher.close();
+            await running;
+            // Finish source events already accepted before shutdown.
+            processor.settle();
+            if (pending && processor.needsFlush)
+                onResult(await processor.flush());
+        },
+    };
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

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

package/dist/watch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watch.test.d.ts.map

package/dist/watch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.test.d.ts","sourceRoot":"","sources":["../src/watch.test.ts"],"names":[],"mappings":""}

package/dist/watch.test.js

@@ -0,0 +1,138 @@
+import { mkdtemp, mkdir, readFile, utimes, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import sharp from 'sharp';
+import { expect, test, vi } from 'vitest';
+import * as comparison from './core/compare.js';
+import { processChanges, processSuite } from './core/process.js';
+import { watchResults } from './watch.js';
+const image = (value) => sharp({ create: { width: 8, height: 8, channels: 3, background: { r: value, g: value, b: value } } })
+    .avif({ lossless: true })
+    .toBuffer();
+const index = async (root) => JSON.parse(await readFile(join(root, 'index.json'), 'utf8'));
+async function fixture() {
+    const root = await mkdtemp(join(tmpdir(), 'fk-watch-'));
+    await writeFile(join(root, 'fidelity.json'), JSON.stringify({ title: 'Watch', renderers: [{ id: 'ref', reference: true }, { id: 'a' }, { id: 'b' }] }));
+    const dir = join(root, 'one', 'beauty');
+    await mkdir(dir, { recursive: true });
+    for (const renderer of ['ref', 'a', 'b'])
+        await writeFile(join(dir, `${renderer}.avif`), await image(100));
+    await processSuite(root);
+    return { root, dir };
+}
+test('a changed renderer recomputes only its pair and updates the index; new scenes are inserted', async () => {
+    const { root, dir } = await fixture();
+    const before = await index(root);
+    const changed = join(dir, 'a.avif');
+    await writeFile(changed, await image(140));
+    const future = new Date(Date.now() + 2000);
+    await utimes(changed, future, future);
+    const progress = [];
+    expect(await processChanges(root, ['one/beauty/a.avif'], (update) => progress.push(update))).toMatchObject({
+        computed: 1,
+        failed: [],
+    });
+    expect(progress.at(-1)).toEqual({ phase: 'Writing index', completed: 1, total: 1, unit: 'files' });
+    expect(progress.find((update) => update.phase === 'Comparing' && update.completed === 1)).toBeDefined();
+    const after = await index(root);
+    expect(after.metrics['one/beauty/a.vs-ref.metrics.json'].maxError).toBeGreaterThan(0);
+    expect(after.metrics['one/beauty/b.vs-ref.metrics.json']).toEqual(before.metrics['one/beauty/b.vs-ref.metrics.json']);
+    const newDir = join(root, 'two', 'beauty');
+    await mkdir(newDir, { recursive: true });
+    await writeFile(join(newDir, 'ref.avif'), await image(90));
+    await writeFile(join(newDir, 'a.avif'), await image(110));
+    expect(await processChanges(root, ['two/beauty/a.avif'])).toMatchObject({ computed: 1, failed: [] });
+    expect((await index(root)).root.scenes.map((s) => s.path)).toEqual(['one', 'two']);
+});
+test('the watcher picks up an overwritten image and survives an invalid intermediate file', async () => {
+    const { root, dir } = await fixture();
+    const updates = [];
+    const watcher = await watchResults(root, (result) => updates.push(result.computed));
+    try {
+        await writeFile(join(dir, 'a.avif'), 'incomplete');
+        await new Promise((resolve) => setTimeout(resolve, 900));
+        await writeFile(join(dir, 'a.avif'), await image(160));
+        await new Promise((resolve, reject) => {
+            const deadline = setTimeout(() => reject(new Error('watch update timed out')), 6000);
+            const poll = setInterval(async () => {
+                if ((await index(root)).metrics['one/beauty/a.vs-ref.metrics.json']?.maxError > 0) {
+                    clearTimeout(deadline);
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 100);
+        });
+        expect(updates).toContain(1);
+    }
+    finally {
+        await watcher.close();
+    }
+});
+test('reference and metadata changes refresh the affected scene', async () => {
+    const { root, dir } = await fixture();
+    await writeFile(join(root, 'one', 'scene.json'), JSON.stringify({ title: 'Renamed', tags: ['new'] }));
+    expect(await processChanges(root, ['one/scene.json'])).toMatchObject({ computed: 0 });
+    expect((await index(root)).root.scenes[0]).toMatchObject({ title: 'Renamed', tags: ['new'] });
+    const changed = join(dir, 'ref.avif');
+    await writeFile(changed, await image(170));
+    const future = new Date(Date.now() + 2000);
+    await utimes(changed, future, future);
+    expect(await processChanges(root, ['one/beauty/ref.avif'])).toMatchObject({ computed: 2, failed: [] });
+});
+test('generated metrics, deltas, index and temporary writes never trigger watch updates', async () => {
+    const { root, dir } = await fixture();
+    const updates = [];
+    const watcher = await watchResults(root, (result) => updates.push(result.computed), { concurrency: 1 });
+    try {
+        const baseline = updates.length;
+        await writeFile(join(dir, 'a.vs-ref.metrics.json'), '{}');
+        await writeFile(join(dir, 'a.vs-ref.delta.avif'), await image(30));
+        await writeFile(join(dir, 'a.avif.write.tmp'), 'temporary');
+        await writeFile(join(root, 'index.json.write.tmp'), '{}');
+        await writeFile(join(root, 'index.json'), JSON.stringify(await index(root)));
+        await new Promise((resolve) => setTimeout(resolve, 1100));
+        expect(updates).toHaveLength(baseline);
+        await writeFile(join(dir, 'a.avif'), await image(190));
+        await expect.poll(() => updates.length, { timeout: 6000 }).toBe(baseline + 1);
+        expect(updates.at(-1)).toBe(1);
+        // The comparison itself writes all generated artifacts; none may feed back into the watcher.
+        await new Promise((resolve) => setTimeout(resolve, 1100));
+        expect(updates).toHaveLength(baseline + 1);
+    }
+    finally {
+        await watcher.close();
+    }
+}, 10000);
+test('changes during initial processing are observed and supersede the initial comparison', async () => {
+    const { root, dir } = await fixture();
+    await writeFile(join(dir, 'a.avif'), await image(130));
+    const started = Promise.withResolvers();
+    const release = Promise.withResolvers();
+    const original = comparison.compareImages;
+    const compare = vi.spyOn(comparison, 'compareImages').mockImplementationOnce(async (...args) => {
+        const result = await original(...args);
+        started.resolve();
+        await release.promise;
+        return result;
+    });
+    let watcher;
+    try {
+        const starting = watchResults(root);
+        await started.promise;
+        await writeFile(join(dir, 'a.avif'), await image(190));
+        // Let the real watcher deliver its stable-write notification while startup is still running.
+        await new Promise((resolve) => setTimeout(resolve, 900));
+        release.resolve();
+        watcher = await starting;
+        await expect
+            .poll(async () => (await index(root)).metrics['one/beauty/a.vs-ref.metrics.json']?.maxError, { timeout: 6000 })
+            .toBeGreaterThan(0.3);
+        expect(compare).toHaveBeenCalledTimes(2);
+    }
+    finally {
+        release.resolve();
+        await watcher?.close();
+        compare.mockRestore();
+    }
+}, 10000);
+//# sourceMappingURL=watch.test.js.map

package/dist/watch.test.js.map

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

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "fidelity-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Toolkit for renderer fidelity suites: metrics + delta CLI and a viewer served from any results folder.",
+  "keywords": [
+    "fidelity",
+    "image-comparison",
+    "image-diff",
+    "psnr",
+    "renderer",
+    "rendering",
+    "visual-regression"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -34,6 +43,7 @@
   "dependencies": {
     "@clidoc/core": "^1.0.0",
     "@clidoc/yargs": "^1.1.0",
+    "chokidar": "^5.0.0",
     "p-limit": "^7.3.3",
     "sharp": "^0.35.4",
     "yargs": "^18.0.0",