@prosopo/puzzle-assets 0.1.3

package/dist/tests/puzzleAssets.unit.test.js

@@ -0,0 +1,257 @@
+import { describe, expect, it } from "vitest";
+import { generateBackground } from "../background.js";
+import { cutNotch } from "../compose.js";
+import { paintDecoyPiece, paintDecoys } from "../decoys.js";
+import { DEFAULT_GEOMETRY, DEFAULT_RENDER_SETTINGS, createBackground, renderPuzzle, } from "../index.js";
+import { coverageFromDistance, createNotchShape } from "../notch.js";
+import { createPrng, createSeed } from "../prng.js";
+const SEED_A = Buffer.from("0123456789abcdef", "utf-8");
+const SEED_B = Buffer.from("fedcba9876543210", "utf-8");
+const meanLuma = (image) => {
+    let total = 0;
+    const pixels = image.width * image.height;
+    for (let i = 0; i < pixels; i++) {
+        const o = i * 4;
+        total +=
+            0.299 * (image.data[o] ?? 0) +
+                0.587 * (image.data[o + 1] ?? 0) +
+                0.114 * (image.data[o + 2] ?? 0);
+    }
+    return total / pixels;
+};
+describe("prng", () => {
+    it("is deterministic for a given seed", () => {
+        const a = createPrng(SEED_A);
+        const b = createPrng(SEED_A);
+        const drawA = [a.next(), a.next(), a.next()];
+        const drawB = [b.next(), b.next(), b.next()];
+        expect(drawA).toEqual(drawB);
+    });
+    it("diverges for different seeds", () => {
+        const a = createPrng(SEED_A);
+        const b = createPrng(SEED_B);
+        expect(a.next()).not.toBe(b.next());
+    });
+    it("stays within bounds", () => {
+        const prng = createPrng(SEED_A);
+        for (let i = 0; i < 500; i++) {
+            const v = prng.next();
+            expect(v).toBeGreaterThanOrEqual(0);
+            expect(v).toBeLessThan(1);
+            const n = prng.int(3, 7);
+            expect(n).toBeGreaterThanOrEqual(3);
+            expect(n).toBeLessThanOrEqual(7);
+        }
+    });
+    it("rejects a seed shorter than 128 bits", () => {
+        expect(() => createPrng(Buffer.alloc(8))).toThrow(/seed must be at least/);
+    });
+    it("issues 128-bit seeds", () => {
+        expect(createSeed()).toHaveLength(16);
+        expect(createSeed().equals(createSeed())).toBe(false);
+    });
+});
+describe("generateBackground", () => {
+    it("fills every pixel opaque", () => {
+        const image = generateBackground(createPrng(SEED_A), 60, 40);
+        expect(image.data).toHaveLength(60 * 40 * 4);
+        for (let i = 0; i < 60 * 40; i++) {
+            expect(image.data[i * 4 + 3]).toBe(255);
+        }
+    });
+    it("is reproducible from its seed", () => {
+        const a = generateBackground(createPrng(SEED_A), 60, 40);
+        const b = generateBackground(createPrng(SEED_A), 60, 40);
+        expect(a.data.equals(b.data)).toBe(true);
+    });
+    it("produces a different picture for a different seed", () => {
+        const a = generateBackground(createPrng(SEED_A), 60, 40);
+        const b = generateBackground(createPrng(SEED_B), 60, 40);
+        expect(a.data.equals(b.data)).toBe(false);
+    });
+    it("is not a flat wash", () => {
+        const image = generateBackground(createPrng(SEED_A), 300, 200);
+        let min = 255;
+        let max = 0;
+        for (let i = 0; i < image.width * image.height; i++) {
+            const o = i * 4;
+            const luma = 0.299 * (image.data[o] ?? 0) +
+                0.587 * (image.data[o + 1] ?? 0) +
+                0.114 * (image.data[o + 2] ?? 0);
+            min = Math.min(min, luma);
+            max = Math.max(max, luma);
+        }
+        expect(max - min).toBeGreaterThan(25);
+    });
+});
+describe("cutNotch", () => {
+    const geometry = DEFAULT_GEOMETRY;
+    const placement = { targetX: 200, targetY: 100 };
+    it("darkens the hole and leaves the rest of the frame alone", () => {
+        const prng = createPrng(SEED_A);
+        const original = generateBackground(createPrng(SEED_A), geometry.width, geometry.height);
+        const working = generateBackground(createPrng(SEED_A), geometry.width, geometry.height);
+        const shape = createNotchShape(prng, geometry.notchSize);
+        const { background, piece } = cutNotch(prng, working, shape, geometry.notchSize, placement, DEFAULT_RENDER_SETTINGS.holeDarken);
+        const centre = (placement.targetY * geometry.width + placement.targetX) * 4;
+        expect(background.data[centre]).toBeLessThan(original.data[centre] ?? 255);
+        const far = (10 * geometry.width + 10) * 4;
+        expect(background.data[far]).toBe(original.data[far]);
+        expect(piece.width).toBe(geometry.notchSize);
+        expect(piece.height).toBe(geometry.notchSize);
+    });
+    it("makes the piece opaque inside the shape and transparent at the corners", () => {
+        const prng = createPrng(SEED_A);
+        const background = createBackground(geometry);
+        const shape = createNotchShape(prng, geometry.notchSize);
+        const { piece } = cutNotch(prng, background, shape, geometry.notchSize, placement, DEFAULT_RENDER_SETTINGS.holeDarken);
+        const half = Math.floor(geometry.notchSize / 2);
+        const centreAlpha = piece.data[(half * geometry.notchSize + half) * 4 + 3] ?? 0;
+        expect(centreAlpha).toBe(255);
+        expect(piece.data[3] ?? 255).toBeLessThan(128);
+    });
+    it("clips the piece to transparent where the placement overhangs the frame", () => {
+        const prng = createPrng(SEED_A);
+        const bg = createBackground(geometry);
+        const shape = createNotchShape(prng, geometry.notchSize);
+        const overhangPlacement = {
+            targetX: geometry.width,
+            targetY: 0,
+        };
+        const { piece } = cutNotch(prng, bg, shape, geometry.notchSize, overhangPlacement, DEFAULT_RENDER_SETTINGS.holeDarken);
+        const half = geometry.notchSize / 2;
+        const left = Math.round(overhangPlacement.targetX - half);
+        const top = Math.round(overhangPlacement.targetY - half);
+        let outOfFrameOpaque = 0;
+        for (let ly = 0; ly < geometry.notchSize; ly++) {
+            for (let lx = 0; lx < geometry.notchSize; lx++) {
+                const bx = left + lx;
+                const by = top + ly;
+                const inFrame = bx >= 0 && by >= 0 && bx < geometry.width && by < geometry.height;
+                if (inFrame)
+                    continue;
+                const alpha = piece.data[(ly * geometry.notchSize + lx) * 4 + 3] ?? 0;
+                if (alpha !== 0)
+                    outOfFrameOpaque++;
+            }
+        }
+        expect(outOfFrameOpaque).toBe(0);
+    });
+    it("does not reproduce the background pixel-exactly in the piece", () => {
+        const prng = createPrng(SEED_A);
+        const reference = generateBackground(createPrng(SEED_A), geometry.width, geometry.height);
+        const working = generateBackground(createPrng(SEED_A), geometry.width, geometry.height);
+        const shape = createNotchShape(prng, geometry.notchSize);
+        const { piece } = cutNotch(prng, working, shape, geometry.notchSize, placement, DEFAULT_RENDER_SETTINGS.holeDarken);
+        const half = geometry.notchSize / 2;
+        const left = Math.round(placement.targetX - half);
+        const top = Math.round(placement.targetY - half);
+        let identical = 0;
+        let compared = 0;
+        for (let ly = 0; ly < geometry.notchSize; ly++) {
+            for (let lx = 0; lx < geometry.notchSize; lx++) {
+                const pi = (ly * geometry.notchSize + lx) * 4;
+                if ((piece.data[pi + 3] ?? 0) < 255)
+                    continue;
+                const bi = ((top + ly) * geometry.width + (left + lx)) * 4;
+                compared++;
+                if (piece.data[pi] === reference.data[bi])
+                    identical++;
+            }
+        }
+        expect(compared).toBeGreaterThan(100);
+        expect(identical / compared).toBeLessThan(0.5);
+    });
+});
+describe("renderPuzzle", () => {
+    it("encodes both halves as webp", async () => {
+        const rendered = await renderPuzzle(createBackground(), {
+            targetX: 200,
+            targetY: 100,
+        });
+        expect(rendered.background.subarray(0, 4).toString("ascii")).toBe("RIFF");
+        expect(rendered.background.subarray(8, 12).toString("ascii")).toBe("WEBP");
+        expect(rendered.piece.subarray(8, 12).toString("ascii")).toBe("WEBP");
+        expect(rendered.pieceSize).toBe(DEFAULT_GEOMETRY.notchSize);
+    });
+    it("honors a `pieceSize` override independently of `notchSize`", async () => {
+        const overrideSize = 180;
+        const rendered = await renderPuzzle(createBackground(), { targetX: 150, targetY: 100 }, { ...DEFAULT_GEOMETRY, pieceSize: overrideSize });
+        expect(rendered.pieceSize).toBe(overrideSize);
+    });
+    it("stays small enough to inline as a data uri", async () => {
+        const rendered = await renderPuzzle(createBackground(), {
+            targetX: 200,
+            targetY: 100,
+        });
+        const base64Bytes = Math.ceil(rendered.background.length / 3) * 4 +
+            Math.ceil(rendered.piece.length / 3) * 4;
+        expect(base64Bytes).toBeLessThan(120_000);
+    });
+});
+describe("coverageFromDistance", () => {
+    it("is 1 well inside, 0 well outside and partial on the boundary", () => {
+        expect(coverageFromDistance(-5)).toBe(1);
+        expect(coverageFromDistance(5)).toBe(0);
+        const edge = coverageFromDistance(0);
+        expect(edge).toBeGreaterThan(0);
+        expect(edge).toBeLessThan(1);
+    });
+});
+describe("background brightness", () => {
+    it("keeps a usable mid-range so the piece stays visible", () => {
+        for (const seed of [SEED_A, SEED_B]) {
+            const luma = meanLuma(generateBackground(createPrng(seed), 300, 200));
+            expect(luma).toBeGreaterThan(60);
+            expect(luma).toBeLessThan(215);
+        }
+    });
+});
+describe("paintDecoys", () => {
+    const notch = { targetX: 220, targetY: 140 };
+    const { decoyEdgeDarkness, decoyBodyBrightness, decoyHoleDarken } = DEFAULT_RENDER_SETTINGS;
+    it("is a no-op for count <= 0", () => {
+        const bg = generateBackground(createPrng(SEED_A), 300, 200);
+        const before = Buffer.from(bg.data);
+        paintDecoys(bg, createPrng(SEED_A), 0, DEFAULT_GEOMETRY.notchSize, notch, decoyEdgeDarkness, decoyBodyBrightness, decoyHoleDarken);
+        expect(bg.data.equals(before)).toBe(true);
+    });
+    it("mutates the background when count > 0", () => {
+        const bg = generateBackground(createPrng(SEED_A), 300, 200);
+        const before = Buffer.from(bg.data);
+        paintDecoys(bg, createPrng(SEED_B), 3, DEFAULT_GEOMETRY.notchSize, notch, decoyEdgeDarkness, decoyBodyBrightness, decoyHoleDarken);
+        expect(bg.data.equals(before)).toBe(false);
+    });
+    it("is deterministic for a given prng seed", () => {
+        const bg1 = generateBackground(createPrng(SEED_A), 300, 200);
+        const bg2 = generateBackground(createPrng(SEED_A), 300, 200);
+        paintDecoys(bg1, createPrng(SEED_B), 3, DEFAULT_GEOMETRY.notchSize, notch, decoyEdgeDarkness, decoyBodyBrightness, decoyHoleDarken);
+        paintDecoys(bg2, createPrng(SEED_B), 3, DEFAULT_GEOMETRY.notchSize, notch, decoyEdgeDarkness, decoyBodyBrightness, decoyHoleDarken);
+        expect(bg1.data.equals(bg2.data)).toBe(true);
+    });
+    it("blackens the decoy interior when holeDarken is zero", () => {
+        const bg = generateBackground(createPrng(SEED_A), 300, 200);
+        const cx = 150;
+        const cy = 100;
+        paintDecoyPiece(bg, createPrng(SEED_B), DEFAULT_GEOMETRY.notchSize, cx, cy, 0, 0, 0);
+        const i = (cy * bg.width + cx) * 4;
+        expect(bg.data[i]).toBe(0);
+        expect(bg.data[i + 1]).toBe(0);
+        expect(bg.data[i + 2]).toBe(0);
+    });
+});
+describe("renderPuzzle with decoys", () => {
+    it("still returns a matching piece when decoys are present", async () => {
+        const bg = createBackground(DEFAULT_GEOMETRY);
+        const rendered = await renderPuzzle(bg, { targetX: 150, targetY: 100 }, DEFAULT_GEOMETRY, { ...DEFAULT_RENDER_SETTINGS, decoyCount: 3 });
+        expect(rendered.background.length).toBeGreaterThan(0);
+        expect(rendered.piece.length).toBeGreaterThan(0);
+        expect(rendered.pieceSize).toBe(DEFAULT_GEOMETRY.notchSize);
+    });
+    it("honors decoyCount 0 (no decoys) end-to-end", async () => {
+        const target = { targetX: 150, targetY: 100 };
+        const rendered = await renderPuzzle(createBackground(DEFAULT_GEOMETRY), target, DEFAULT_GEOMETRY, { ...DEFAULT_RENDER_SETTINGS, decoyCount: 0 });
+        expect(rendered.background.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=puzzleAssets.unit.test.js.map

package/dist/tests/puzzleAssets.unit.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export interface RgbaImage {
+    data: Buffer;
+    width: number;
+    height: number;
+}
+export interface NotchPlacement {
+    targetX: number;
+    targetY: number;
+}
+export interface RenderedPuzzle {
+    background: Buffer;
+    piece: Buffer;
+    pieceSize: number;
+}
+export interface PuzzleGeometry {
+    width: number;
+    height: number;
+    notchSize: number;
+    pieceSize?: number;
+}
+export interface PuzzleRenderSettings {
+    decoyCount: number;
+    decoyEdgeDarkness: number;
+    decoyBodyBrightness: number;
+    holeDarken: number;
+    decoyHoleDarken: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAE9B,UAAU,EAAE,MAAM,CAAC;IAEnB,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAMf,SAAS,EAAE,MAAM,CAAC;IAOlB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD,MAAM,WAAW,oBAAoB;IAOpC,UAAU,EAAE,MAAM,CAAC;IAMnB,iBAAiB,EAAE,MAAM,CAAC;IAM1B,mBAAmB,EAAE,MAAM,CAAC;IAM5B,UAAU,EAAE,MAAM,CAAC;IAOnB,eAAe,EAAE,MAAM,CAAC;CACxB"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+	"name": "@prosopo/puzzle-assets",
+	"version": "0.1.3",
+	"description": "Procedural imagery for the slider puzzle captcha",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"type": "module",
+	"engines": {
+		"node": "^24",
+		"npm": "^11"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/cjs/index.cjs"
+		},
+		"./browser": {
+			"types": "./dist/browser.d.ts",
+			"import": "./dist/browser.js",
+			"require": "./dist/cjs/browser.cjs"
+		}
+	},
+	"scripts": {
+		"clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
+		"build": "npm run build:cross-env -- --mode ${NODE_ENV:-development}",
+		"build:cross-env": "vite build --config vite.esm.config.ts",
+		"build:tsc": "tsc --build --verbose",
+		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
+		"preview": "tsx scripts/preview.ts",
+		"test": "NODE_ENV=${NODE_ENV:-test}; npx vitest run --config ./vite.test.config.ts",
+		"typecheck": "tsc --project tsconfig.types.json"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/prosopo/captcha.git",
+		"directory": "packages/puzzle-assets"
+	},
+	"author": "Prosopo Limited",
+	"license": "Apache-2.0",
+	"bugs": {
+		"url": "https://github.com/prosopo/captcha/issues"
+	},
+	"homepage": "https://github.com/prosopo/captcha#readme",
+	"dependencies": {
+		"sharp": "0.35.4"
+	},
+	"devDependencies": {
+		"@prosopo/config": "3.3.13",
+		"@types/node": "22.10.2",
+		"@vitest/coverage-v8": "4.1.11",
+		"del-cli": "6.0.0",
+		"dotenv": "16.4.5",
+		"tslib": "2.7.0",
+		"tsx": "4.20.3",
+		"typescript": "5.6.2",
+		"vite": "8.1.5",
+		"vitest": "4.1.11"
+	},
+	"sideEffects": false
+}

package/scripts/preview.ts

@@ -0,0 +1,197 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * Eyeball the generator.
+ *
+ * Writes N puzzles as PNG pairs plus a contact-sheet HTML page that lays the
+ * piece over the background at its origin, so the output can be judged the way
+ * a user would see it.
+ *
+ *   npm -w @prosopo/puzzle-assets run preview -- --count 24 --out ./preview
+ */
+
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import sharp from "sharp";
+import { cutNotch } from "../src/compose.js";
+import {
+	DEFAULT_GEOMETRY,
+	createBackground,
+	encodePng,
+	renderPuzzle,
+} from "../src/index.js";
+import { createNotchShape } from "../src/notch.js";
+import { createPrng, createSeed } from "../src/prng.js";
+
+interface Args {
+	count: number;
+	out: string;
+}
+
+const parseArgs = (argv: readonly string[]): Args => {
+	const args: Args = { count: 24, out: "./preview" };
+	for (let i = 0; i < argv.length; i++) {
+		const flag = argv[i];
+		const value = argv[i + 1];
+		if (flag === "--count" && value) {
+			args.count = Number.parseInt(value, 10);
+			i++;
+		} else if (flag === "--out" && value) {
+			args.out = value;
+			i++;
+		}
+	}
+	return args;
+};
+
+// Mirrors the provider's placement ranges (puzzleTasks.ts).
+const placementFor = (): {
+	targetX: number;
+	targetY: number;
+	originX: number;
+	originY: number;
+} => {
+	const prng = createPrng(createSeed());
+	return {
+		targetX: prng.int(150, 280),
+		targetY: prng.int(30, 170),
+		originX: prng.int(20, 130),
+		originY: prng.int(30, 170),
+	};
+};
+
+const main = async (): Promise<void> => {
+	const { count, out } = parseArgs(process.argv.slice(2));
+	const outDir = resolve(out);
+	mkdirSync(outDir, { recursive: true });
+
+	const cells: string[] = [];
+	const sheetTiles: sharp.OverlayOptions[] = [];
+	const sheetCols = 3;
+	const sheetGap = 10;
+	const started = process.hrtime.bigint();
+
+	for (let i = 0; i < count; i++) {
+		const placement = placementFor();
+
+		// Same pipeline as renderPuzzle, but kept in PNG so the preview shows
+		// the raw output rather than WebP artefacts.
+		const background = createBackground(DEFAULT_GEOMETRY);
+		const prng = createPrng(createSeed());
+		const shape = createNotchShape(prng, DEFAULT_GEOMETRY.notchSize);
+		const { background: cut, piece } = cutNotch(
+			prng,
+			background,
+			shape,
+			DEFAULT_GEOMETRY.notchSize,
+			placement,
+		);
+
+		const [bgPng, piecePng] = await Promise.all([
+			encodePng(cut),
+			encodePng(piece),
+		]);
+		writeFileSync(join(outDir, `puzzle-${i}-bg.png`), bgPng);
+		writeFileSync(join(outDir, `puzzle-${i}-piece.png`), piecePng);
+
+		const half = DEFAULT_GEOMETRY.notchSize / 2;
+
+		// Contact-sheet tile: the piece composited at its origin, so a whole
+		// batch can be judged in one image rather than file by file.
+		sheetTiles.push({
+			input: await sharp(bgPng)
+				.composite([
+					{
+						input: piecePng,
+						left: Math.round(placement.originX - half),
+						top: Math.round(placement.originY - half),
+					},
+				])
+				.png()
+				.toBuffer(),
+			left: (i % sheetCols) * (DEFAULT_GEOMETRY.width + sheetGap),
+			top: Math.floor(i / sheetCols) * (DEFAULT_GEOMETRY.height + sheetGap),
+		});
+		cells.push(`
+	<figure>
+		<div class="stage">
+			<img class="bg" src="puzzle-${i}-bg.png" alt="">
+			<img class="piece" style="left:${placement.originX - half}px;top:${placement.originY - half}px" src="puzzle-${i}-piece.png" alt="">
+		</div>
+		<figcaption>#${i} &middot; target ${placement.targetX},${placement.targetY}</figcaption>
+	</figure>`);
+	}
+
+	const sheetRows = Math.ceil(count / sheetCols);
+	writeFileSync(
+		join(outDir, "sheet.png"),
+		await sharp({
+			create: {
+				width: sheetCols * DEFAULT_GEOMETRY.width + (sheetCols - 1) * sheetGap,
+				height:
+					sheetRows * DEFAULT_GEOMETRY.height + (sheetRows - 1) * sheetGap,
+				channels: 4,
+				background: { r: 20, g: 22, b: 28, alpha: 1 },
+			},
+		})
+			.composite(sheetTiles)
+			.png()
+			.toBuffer(),
+	);
+
+	// Timing for the real (WebP) path, which is what the provider will run.
+	const benchStart = process.hrtime.bigint();
+	const benchRuns = 20;
+	for (let i = 0; i < benchRuns; i++) {
+		await renderPuzzle(createBackground(), { targetX: 200, targetY: 100 });
+	}
+	const perRenderMs =
+		Number(process.hrtime.bigint() - benchStart) / 1e6 / benchRuns;
+
+	writeFileSync(
+		join(outDir, "index.html"),
+		`<!doctype html>
+<meta charset="utf-8">
+<title>puzzle-assets preview</title>
+<style>
+	body { background:#14161c; color:#e7e9ee; font:14px/1.5 ui-sans-serif,system-ui,sans-serif; margin:24px; }
+	h1 { font-size:16px; font-weight:600; margin:0 0 4px; }
+	p { color:#9aa1ad; margin:0 0 24px; }
+	.grid { display:flex; flex-wrap:wrap; gap:20px; }
+	figure { margin:0; }
+	.stage { position:relative; width:${DEFAULT_GEOMETRY.width}px; height:${DEFAULT_GEOMETRY.height}px; border-radius:8px; overflow:hidden; }
+	.bg { display:block; width:100%; height:100%; }
+	.piece { position:absolute; width:${DEFAULT_GEOMETRY.notchSize}px; height:${DEFAULT_GEOMETRY.notchSize}px; }
+	figcaption { color:#9aa1ad; font-size:12px; margin-top:6px; }
+</style>
+<h1>puzzle-assets preview &mdash; ${count} samples</h1>
+<p>Piece shown at its origin. WebP render: ${perRenderMs.toFixed(1)} ms per puzzle.</p>
+<div class="grid">${cells.join("")}
+</div>
+`,
+	);
+
+	const totalMs = Number(process.hrtime.bigint() - started) / 1e6;
+	console.log(`wrote ${count} puzzles to ${outDir}`);
+	console.log(`open ${join(outDir, "index.html")}`);
+	console.log(
+		`render cost: ${perRenderMs.toFixed(1)} ms/puzzle (webp), preview total ${totalMs.toFixed(0)} ms`,
+	);
+};
+
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});

package/vite.cjs.config.ts

@@ -0,0 +1,23 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import path from "node:path";
+import { ViteCommonJSConfig } from "@prosopo/config";
+
+export default function () {
+	return ViteCommonJSConfig(
+		path.basename("."),
+		path.resolve("./tsconfig.json"),
+	);
+}

package/vite.esm.config.ts

@@ -0,0 +1,27 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import path from "node:path";
+import { ViteEsmConfig } from "@prosopo/config";
+
+// Both `.` and `./browser` are advertised in package.json exports. Vite
+// only emits `dist/browser.js` if it's declared as an entry — otherwise
+// downstream browser consumers can't resolve @prosopo/puzzle-assets/browser
+// after the ESM build runs.
+export default function () {
+	return ViteEsmConfig(path.basename("."), path.resolve("./tsconfig.json"), [
+		"src/index.ts",
+		"src/browser.ts",
+	]);
+}

package/vite.test.config.ts

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { ViteTestConfig } from "@prosopo/config";
+import dotenv from "dotenv";
+process.env.NODE_ENV = "test";
+// if .env.test exists at this level, use it, otherwise use the one at the root
+const envFile = `.env.${process.env.NODE_ENV || "development"}`;
+let envPath = envFile;
+if (fs.existsSync(envFile)) {
+	envPath = path.resolve(envFile);
+} else if (fs.existsSync(`../../${envFile}`)) {
+	envPath = path.resolve(`../../${envFile}`);
+} else {
+	throw new Error(`No ${envFile} file found`);
+}
+
+dotenv.config({ path: envPath });
+
+export default ViteTestConfig();