card harness dynamic changes

spikes/card-harness/public/card-art/README.md

@@ -0,0 +1,21 @@
+# Card Art Drop Folder
+
+Add each card as one PNG artwork and one matching PNG finish mask:
+
+```text
+david.png
+david-mask.png
+```
+
+The filename before `.png` is the card name shown in the harness. Names are
+case-sensitive. Artwork and mask must:
+
+- have identical dimensions;
+- use a 5:7 aspect ratio;
+- be fully opaque;
+- use an opaque grayscale mask.
+
+During `npm run dev`, adding or replacing either PNG refreshes the searchable
+card catalog automatically. Reopening or focusing the Card field also forces a
+rescan. Production builds generate `manifest.json` from this folder and fail if
+any pair is missing or invalid.

spikes/card-harness/public/card-art/manifest.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": 1,
+  "cards": [
+    {
+      "name": "David",
+      "artwork": "/card-art/David.png?v=a5541f0b4b68e13e",
+      "mask": "/card-art/David-mask.png?v=a5541f0b4b68e13e",
+      "revision": "a5541f0b4b68e13e",
+      "width": 1060,
+      "height": 1484
+    },
+    {
+      "name": "Timothy",
+      "artwork": "/card-art/Timothy.png?v=1118b083057106d4",
+      "mask": "/card-art/Timothy-mask.png?v=1118b083057106d4",
+      "revision": "1118b083057106d4",
+      "width": 1060,
+      "height": 1484
+    }
+  ],
+  "errors": []
+}