@prosopo/icon-order-assets 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,202 @@
+import { createPrng } from "@prosopo/puzzle-assets";
+import sharp from "sharp";
+import { describe, expect, it } from "vitest";
+import { compositeIcons } from "../compose.js";
+import { GLYPH_KINDS, GlyphKind, glyphPath } from "../glyphs.js";
+import { DEFAULT_GEOMETRY, DEFAULT_RENDER_SETTINGS, LEGEND_ICON_SIZE, gradeClicks, renderIconOrder, } from "../index.js";
+import { placeIcons } from "../place.js";
+const seed = (byte) => Buffer.alloc(16, byte);
+const target = (over = {}) => ({
+    x: 100,
+    y: 100,
+    kind: GlyphKind.ring,
+    rotation: 0,
+    hue: 200,
+    size: 40,
+    ...over,
+});
+describe("glyphs", () => {
+    it("has path data for every kind in the vocabulary", () => {
+        for (const kind of GLYPH_KINDS) {
+            expect(glyphPath(kind).length).toBeGreaterThan(0);
+        }
+    });
+    it("exposes every enum member as a kind", () => {
+        expect([...GLYPH_KINDS].sort()).toEqual(Object.values(GlyphKind).sort());
+    });
+});
+describe("placeIcons", () => {
+    it("returns the requested number of targets and decoys", () => {
+        const { targets, decoys } = placeIcons(createPrng(seed(7)), DEFAULT_GEOMETRY, 3, 4);
+        expect(targets).toHaveLength(3);
+        expect(decoys).toHaveLength(4);
+    });
+    it("gives every icon on the frame a distinct glyph, so the legend is unambiguous", () => {
+        const { targets, decoys } = placeIcons(createPrng(seed(11)), DEFAULT_GEOMETRY, 3, 5);
+        const kinds = [...targets, ...decoys].map((icon) => icon.kind);
+        expect(new Set(kinds).size).toBe(kinds.length);
+    });
+    it("keeps whole icons inside the frame", () => {
+        const { targets, decoys } = placeIcons(createPrng(seed(3)), DEFAULT_GEOMETRY, 3, 4);
+        for (const icon of [...targets, ...decoys]) {
+            expect(icon.x).toBeGreaterThanOrEqual(0);
+            expect(icon.y).toBeGreaterThanOrEqual(0);
+            expect(icon.x).toBeLessThanOrEqual(DEFAULT_GEOMETRY.width);
+            expect(icon.y).toBeLessThanOrEqual(DEFAULT_GEOMETRY.height);
+        }
+    });
+    it("separates icons so no click can fall inside two hit radii", () => {
+        const { targets, decoys } = placeIcons(createPrng(seed(23)), DEFAULT_GEOMETRY, 3, 4);
+        const icons = [...targets, ...decoys];
+        for (let i = 0; i < icons.length; i++) {
+            for (let j = i + 1; j < icons.length; j++) {
+                const a = icons[i];
+                const b = icons[j];
+                if (!a || !b)
+                    throw new Error("icon underflow");
+                expect(Math.hypot(a.x - b.x, a.y - b.y)).toBeGreaterThanOrEqual(1.15 * Math.max(a.size, b.size));
+            }
+        }
+    });
+    it("throws rather than shortening the answer when a target cannot be placed", () => {
+        const cramped = {
+            width: 60,
+            height: 60,
+            iconSize: 50,
+        };
+        expect(() => placeIcons(createPrng(seed(5)), cramped, 3, 0)).toThrow(/could not place target icon/);
+    });
+    it("drops decoys rather than failing when the frame is crowded", () => {
+        const cramped = {
+            width: 120,
+            height: 90,
+            iconSize: 34,
+        };
+        const { targets, decoys } = placeIcons(createPrng(seed(9)), cramped, 2, 6);
+        expect(targets).toHaveLength(2);
+        expect(decoys.length).toBeLessThan(6);
+    });
+    it("refuses to ask for more distinct glyphs than exist", () => {
+        expect(() => placeIcons(createPrng(seed(1)), DEFAULT_GEOMETRY, 3, GLYPH_KINDS.length)).toThrow(/only \d+ exist/);
+    });
+});
+describe("gradeClicks", () => {
+    const targets = [
+        target({ x: 50, y: 50 }),
+        target({ x: 150, y: 60, kind: GlyphKind.star }),
+        target({ x: 240, y: 150, kind: GlyphKind.bolt }),
+    ];
+    const tolerance = 0.6;
+    it("accepts exact clicks in the right order", () => {
+        expect(gradeClicks(targets, [
+            { x: 50, y: 50 },
+            { x: 150, y: 60 },
+            { x: 240, y: 150 },
+        ], tolerance)).toBe(true);
+    });
+    it("accepts clicks inside the hit radius", () => {
+        expect(gradeClicks(targets, [
+            { x: 58, y: 55 },
+            { x: 143, y: 66 },
+            { x: 246, y: 143 },
+        ], tolerance)).toBe(true);
+    });
+    it("rejects the right icons clicked in the wrong order", () => {
+        expect(gradeClicks(targets, [
+            { x: 150, y: 60 },
+            { x: 50, y: 50 },
+            { x: 240, y: 150 },
+        ], tolerance)).toBe(false);
+    });
+    it("rejects a click outside the hit radius", () => {
+        expect(gradeClicks(targets, [
+            { x: 50, y: 50 },
+            { x: 150, y: 60 },
+            { x: 240, y: 190 },
+        ], tolerance)).toBe(false);
+    });
+    it("rejects too few and too many clicks", () => {
+        expect(gradeClicks(targets, [
+            { x: 50, y: 50 },
+            { x: 150, y: 60 },
+        ], tolerance)).toBe(false);
+        expect(gradeClicks(targets, [
+            { x: 50, y: 50 },
+            { x: 150, y: 60 },
+            { x: 240, y: 150 },
+            { x: 240, y: 150 },
+        ], tolerance)).toBe(false);
+    });
+    it("scales the hit radius with the icon, so jittered sizes are equally hittable", () => {
+        const small = [target({ x: 100, y: 100, size: 20 })];
+        const large = [target({ x: 100, y: 100, size: 60 })];
+        const click = [{ x: 118, y: 100 }];
+        expect(gradeClicks(small, click, 0.6)).toBe(false);
+        expect(gradeClicks(large, click, 0.6)).toBe(true);
+    });
+});
+describe("the collage background", () => {
+    const edgeEnergy = (image) => {
+        const { data, width, height } = image;
+        const channels = 4;
+        let total = 0;
+        let count = 0;
+        for (let y = 0; y < height; y++) {
+            for (let x = 1; x < width; x++) {
+                const i = (y * width + x) * channels;
+                const prev = i - channels;
+                for (let c = 0; c < 3; c++) {
+                    total += Math.abs((data[i + c] ?? 0) - (data[prev + c] ?? 0));
+                    count++;
+                }
+            }
+        }
+        return total / count;
+    };
+    it("puts more edges on the frame as clutter rises", async () => {
+        const frameAt = (backgroundClutter) => compositeIcons(createPrng(seed(7)), [], DEFAULT_GEOMETRY, {
+            ...DEFAULT_RENDER_SETTINGS,
+            backgroundClutter,
+        });
+        const [plain, busy] = await Promise.all([frameAt(0), frameAt(20)]);
+        expect(edgeEnergy(busy)).toBeGreaterThan(edgeEnergy(plain));
+    });
+    it("still renders at zero clutter, as the operator escape hatch", async () => {
+        const challenge = await renderIconOrder(DEFAULT_GEOMETRY, {
+            ...DEFAULT_RENDER_SETTINGS,
+            backgroundClutter: 0,
+        });
+        const meta = await sharp(challenge.background).metadata();
+        expect(meta.width).toBe(DEFAULT_GEOMETRY.width);
+        expect(challenge.targets).toHaveLength(DEFAULT_RENDER_SETTINGS.targetCount);
+    });
+});
+describe("renderIconOrder", () => {
+    it("renders a frame and a legend sized to the target count", async () => {
+        const challenge = await renderIconOrder();
+        const background = await sharp(challenge.background).metadata();
+        expect(background.width).toBe(DEFAULT_GEOMETRY.width);
+        expect(background.height).toBe(DEFAULT_GEOMETRY.height);
+        const legend = await sharp(challenge.legend).metadata();
+        expect(legend.height).toBe(LEGEND_ICON_SIZE);
+        expect(legend.width).toBe(DEFAULT_RENDER_SETTINGS.targetCount * (LEGEND_ICON_SIZE + 6) - 6);
+        expect(challenge.targets).toHaveLength(DEFAULT_RENDER_SETTINGS.targetCount);
+        expect(challenge.legendIconSize).toBe(LEGEND_ICON_SIZE);
+    });
+    it("produces a different frame every call, so a background is never reused", async () => {
+        const [a, b] = await Promise.all([renderIconOrder(), renderIconOrder()]);
+        expect(a.background.equals(b.background)).toBe(false);
+    });
+    it("honours the target and decoy counts it is given", async () => {
+        const settings = {
+            ...DEFAULT_RENDER_SETTINGS,
+            targetCount: 4,
+            decoyCount: 2,
+        };
+        const challenge = await renderIconOrder(DEFAULT_GEOMETRY, settings);
+        expect(challenge.targets).toHaveLength(4);
+        const legend = await sharp(challenge.legend).metadata();
+        expect(legend.width).toBe(4 * (LEGEND_ICON_SIZE + 6) - 6);
+    });
+});
+//# sourceMappingURL=iconOrderAssets.unit.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iconOrderAssets.unit.test.js","sourceRoot":"","sources":["../../src/tests/iconOrderAssets.unit.test.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EACN,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,eAAe,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAE9D,MAAM,MAAM,GAAG,CAAC,OAA+B,EAAE,EAAiB,EAAE,CAAC,CAAC;IACrE,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,IAAI,EAAE,SAAS,CAAC,IAAI;IACpB,QAAQ,EAAE,CAAC;IACX,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,EAAE;IACR,GAAG,IAAI;CACP,CAAC,CAAC;AAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACzD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CACrC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnB,gBAAgB,EAChB,CAAC,EACD,CAAC,CACD,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACvF,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CACrC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EACpB,gBAAgB,EAChB,CAAC,EACD,CAAC,CACD,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC7C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CACrC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnB,gBAAgB,EAChB,CAAC,EACD,CAAC,CACD,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC3D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACpE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CACrC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EACpB,gBAAgB,EAChB,CAAC,EACD,CAAC,CACD,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBAChD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAC9D,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAC/B,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAClF,MAAM,OAAO,GAAsB;YAClC,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;SACZ,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CACnE,6BAA6B,CAC7B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAsB;YAClC,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;SACZ,CAAC;QACF,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,GAAG,EAAE,CACX,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CACxE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC5B,MAAM,OAAO,GAAoB;QAChC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACxB,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;KAChD,CAAC;IACF,MAAM,SAAS,GAAG,GAAG,CAAC;IAEtB,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAClD,MAAM,CACL,WAAW,CACV,OAAO,EACP;YACC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SAClB,EACD,SAAS,CACT,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC/C,MAAM,CACL,WAAW,CACV,OAAO,EACP;YACC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SAClB,EACD,SAAS,CACT,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC7D,MAAM,CACL,WAAW,CACV,OAAO,EACP;YACC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SAClB,EACD,SAAS,CACT,CACD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACjD,MAAM,CACL,WAAW,CACV,OAAO,EACP;YACC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SAClB,EACD,SAAS,CACT,CACD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,MAAM,CACL,WAAW,CACV,OAAO,EACP;YACC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;SACjB,EACD,SAAS,CACT,CACD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,MAAM,CACL,WAAW,CACV,OAAO,EACP;YACC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;YAClB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SAClB,EACD,SAAS,CACT,CACD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACtF,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACvC,MAAM,UAAU,GAAG,CAAC,KAAgB,EAAU,EAAE;QAC/C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,CAAC;QACnB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;gBACrC,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;gBAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC5B,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAC9D,KAAK,EAAE,CAAC;gBACT,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,CAAC,iBAAyB,EAAsB,EAAE,CACjE,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE;YACzD,GAAG,uBAAuB;YAC1B,iBAAiB;SACjB,CAAC,CAAC;QACJ,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,gBAAgB,EAAE;YACzD,GAAG,uBAAuB;YAC1B,iBAAiB,EAAE,CAAC;SACpB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE,CAAC;QAE1C,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CACxB,uBAAuB,CAAC,WAAW,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,CAChE,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAC5E,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,QAAQ,GAA4B;YACzC,GAAG,uBAAuB;YAC1B,WAAW,EAAE,CAAC;YACd,UAAU,EAAE,CAAC;SACb,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QACpE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+import type { GlyphKind } from "./glyphs.js";
+export interface IconOrderGeometry {
+    width: number;
+    height: number;
+    iconSize: number;
+}
+export interface IconPlacement {
+    x: number;
+    y: number;
+    kind: GlyphKind;
+    rotation: number;
+    hue: number;
+    size: number;
+}
+export interface RenderedIconOrder {
+    background: Buffer;
+    legend: Buffer;
+    legendIconSize: number;
+    targets: IconPlacement[];
+}
+export interface IconOrderRenderSettings {
+    targetCount: number;
+    decoyCount: number;
+    strokeWidth: number;
+    iconOpacity: number;
+    haloOpacity: number;
+    backgroundClutter: 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":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,aAAa;IAE7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,SAAS,CAAC;IAEhB,QAAQ,EAAE,MAAM,CAAC;IAEjB,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAEjC,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,MAAM,CAAC;IAEf,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,aAAa,EAAE,CAAC;CACzB;AAGD,MAAM,WAAW,uBAAuB;IAEvC,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,CAAC;IAEpB,iBAAiB,EAAE,MAAM,CAAC;CAC1B"}

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

@@ -1,6 +1,56 @@
 {
   "name": "@prosopo/icon-order-assets",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Procedural imagery for the ordered-icon selection captcha",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "engines": {
+    "node": "^24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prosopo/captcha.git",
+    "directory": "packages/icon-order-assets"
+  },
+  "author": "Prosopo Limited",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/prosopo/captcha/issues"
+  },
+  "homepage": "https://github.com/prosopo/captcha#readme",
+  "dependencies": {
+    "@prosopo/puzzle-assets": "0.2.1",
+    "sharp": "0.35.4"
+  },
+  "devDependencies": {
+    "@prosopo/config": "3.4.3",
+    "@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,
+  "scripts": {
+    "clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
+    "build": "pnpm 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}; pnpm exec vitest run --config ./vite.test.config.ts",
+    "typecheck": "tsc --project tsconfig.types.json"
+  }
 }

package/scripts/preview.ts

@@ -0,0 +1,73 @@
+// 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 { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { encodePng } from "@prosopo/puzzle-assets";
+import sharp from "sharp";
+import {
+	DEFAULT_GEOMETRY,
+	DEFAULT_RENDER_SETTINGS,
+	renderIconOrder,
+} from "../src/index.js";
+
+/** Writes sample challenges to `preview/` as PNG, so codec artefacts don't hide generator output. */
+const main = async (): Promise<void> => {
+	const outDir = path.resolve("preview");
+	await mkdir(outDir, { recursive: true });
+
+	for (let i = 0; i < 4; i++) {
+		const challenge = await renderIconOrder(
+			DEFAULT_GEOMETRY,
+			DEFAULT_RENDER_SETTINGS,
+		);
+		const background = await sharp(challenge.background)
+			.ensureAlpha()
+			.raw()
+			.toBuffer({ resolveWithObject: true });
+		const legend = await sharp(challenge.legend)
+			.ensureAlpha()
+			.raw()
+			.toBuffer({ resolveWithObject: true });
+
+		await writeFile(
+			path.join(outDir, `frame-${i}.png`),
+			await encodePng({
+				data: background.data,
+				width: background.info.width,
+				height: background.info.height,
+			}),
+		);
+		await writeFile(
+			path.join(outDir, `legend-${i}.png`),
+			await encodePng({
+				data: legend.data,
+				width: legend.info.width,
+				height: legend.info.height,
+			}),
+		);
+		console.log(
+			"frame-%d: targets %s",
+			i,
+			challenge.targets
+				.map((t) => `${t.kind}@${Math.round(t.x)},${Math.round(t.y)}`)
+				.join(" "),
+		);
+	}
+};
+
+main().catch((err: unknown) => {
+	console.error(err);
+	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,22 @@
+// 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";
+
+export default function () {
+	return ViteEsmConfig(path.basename("."), path.resolve("./tsconfig.json"), [
+		"src/index.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();

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.