card harness dynamic changes

spikes/card-harness/scripts/card-catalog.test.mjs

@@ -0,0 +1,47 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { resolve } from 'node:path'
+import { PNG } from 'pngjs'
+import { scanCardCatalog } from './card-catalog.mjs'
+
+function png(width, height, pixel) {
+  const image = new PNG({ width, height })
+  for (let offset = 0; offset < image.data.length; offset += 4) {
+    image.data.set(pixel, offset)
+  }
+  return PNG.sync.write(image)
+}
+
+test('catalog pairs filename-based card art with validated masks', async (t) => {
+  const root = await mkdtemp(resolve(tmpdir(), 'card-catalog-'))
+  t.after(() => rm(root, { recursive: true }))
+  await Promise.all([
+    writeFile(resolve(root, 'david.png'), png(10, 14, [20, 40, 60, 255])),
+    writeFile(resolve(root, 'david-mask.png'), png(10, 14, [128, 128, 128, 255])),
+  ])
+  const catalog = await scanCardCatalog(root)
+  assert.deepEqual(catalog.errors, [])
+  assert.equal(catalog.cards.length, 1)
+  assert.equal(catalog.cards[0].name, 'david')
+  assert.match(catalog.cards[0].artwork, /^\/card-art\/david\.png\?v=[0-9a-f]{16}$/)
+  assert.equal(catalog.cards[0].width, 10)
+  assert.equal(catalog.cards[0].height, 14)
+})
+
+test('catalog reports missing pairs and invalid runtime images explicitly', async (t) => {
+  const root = await mkdtemp(resolve(tmpdir(), 'card-catalog-invalid-'))
+  t.after(() => rm(root, { recursive: true }))
+  await Promise.all([
+    writeFile(resolve(root, 'orphan.png'), png(10, 14, [20, 40, 60, 255])),
+    writeFile(resolve(root, 'mask-only-mask.png'), png(10, 14, [0, 0, 0, 255])),
+    writeFile(resolve(root, 'bad.png'), png(10, 14, [20, 40, 60, 254])),
+    writeFile(resolve(root, 'bad-mask.png'), png(10, 14, [20, 21, 20, 255])),
+  ])
+  const catalog = await scanCardCatalog(root)
+  assert.deepEqual(catalog.cards, [])
+  assert.ok(catalog.errors.some(error => error.includes('Missing orphan-mask.png')))
+  assert.ok(catalog.errors.some(error => error.includes('Missing mask-only.png')))
+  assert.ok(catalog.errors.some(error => error.includes('bad.png must be fully opaque')))
+})