@anvpx/motion 0.0.0-stage → 0.1.0

package/luts/warm.cube

@@ -0,0 +1,520 @@
+# motion-kit warm grade LUT
+# CC0-1.0: original procedural work by motion-kit, dedicated to the public domain.
+# Source: packages/assets/luts/warm.cube (this repository).
+TITLE "motion-kit warm (CC0-1.0)"
+LUT_3D_SIZE 8
+DOMAIN_MIN 0.0 0.0 0.0
+DOMAIN_MAX 1.0 1.0 1.0
+
+0.015000 0.000000 0.000000
+0.169286 0.000000 0.000000
+0.323571 0.000000 0.000000
+0.477857 0.000000 0.000000
+0.632143 0.000000 0.000000
+0.786429 0.000000 0.000000
+0.940714 0.000000 0.000000
+1.000000 0.000000 0.000000
+0.015000 0.145714 0.000000
+0.169286 0.145714 0.000000
+0.323571 0.145714 0.000000
+0.477857 0.145714 0.000000
+0.632143 0.145714 0.000000
+0.786429 0.145714 0.000000
+0.940714 0.145714 0.000000
+1.000000 0.145714 0.000000
+0.015000 0.291429 0.000000
+0.169286 0.291429 0.000000
+0.323571 0.291429 0.000000
+0.477857 0.291429 0.000000
+0.632143 0.291429 0.000000
+0.786429 0.291429 0.000000
+0.940714 0.291429 0.000000
+1.000000 0.291429 0.000000
+0.015000 0.437143 0.000000
+0.169286 0.437143 0.000000
+0.323571 0.437143 0.000000
+0.477857 0.437143 0.000000
+0.632143 0.437143 0.000000
+0.786429 0.437143 0.000000
+0.940714 0.437143 0.000000
+1.000000 0.437143 0.000000
+0.015000 0.582857 0.000000
+0.169286 0.582857 0.000000
+0.323571 0.582857 0.000000
+0.477857 0.582857 0.000000
+0.632143 0.582857 0.000000
+0.786429 0.582857 0.000000
+0.940714 0.582857 0.000000
+1.000000 0.582857 0.000000
+0.015000 0.728571 0.000000
+0.169286 0.728571 0.000000
+0.323571 0.728571 0.000000
+0.477857 0.728571 0.000000
+0.632143 0.728571 0.000000
+0.786429 0.728571 0.000000
+0.940714 0.728571 0.000000
+1.000000 0.728571 0.000000
+0.015000 0.874286 0.000000
+0.169286 0.874286 0.000000
+0.323571 0.874286 0.000000
+0.477857 0.874286 0.000000
+0.632143 0.874286 0.000000
+0.786429 0.874286 0.000000
+0.940714 0.874286 0.000000
+1.000000 0.874286 0.000000
+0.015000 1.000000 0.000000
+0.169286 1.000000 0.000000
+0.323571 1.000000 0.000000
+0.477857 1.000000 0.000000
+0.632143 1.000000 0.000000
+0.786429 1.000000 0.000000
+0.940714 1.000000 0.000000
+1.000000 1.000000 0.000000
+0.015000 0.000000 0.121429
+0.169286 0.000000 0.121429
+0.323571 0.000000 0.121429
+0.477857 0.000000 0.121429
+0.632143 0.000000 0.121429
+0.786429 0.000000 0.121429
+0.940714 0.000000 0.121429
+1.000000 0.000000 0.121429
+0.015000 0.145714 0.121429
+0.169286 0.145714 0.121429
+0.323571 0.145714 0.121429
+0.477857 0.145714 0.121429
+0.632143 0.145714 0.121429
+0.786429 0.145714 0.121429
+0.940714 0.145714 0.121429
+1.000000 0.145714 0.121429
+0.015000 0.291429 0.121429
+0.169286 0.291429 0.121429
+0.323571 0.291429 0.121429
+0.477857 0.291429 0.121429
+0.632143 0.291429 0.121429
+0.786429 0.291429 0.121429
+0.940714 0.291429 0.121429
+1.000000 0.291429 0.121429
+0.015000 0.437143 0.121429
+0.169286 0.437143 0.121429
+0.323571 0.437143 0.121429
+0.477857 0.437143 0.121429
+0.632143 0.437143 0.121429
+0.786429 0.437143 0.121429
+0.940714 0.437143 0.121429
+1.000000 0.437143 0.121429
+0.015000 0.582857 0.121429
+0.169286 0.582857 0.121429
+0.323571 0.582857 0.121429
+0.477857 0.582857 0.121429
+0.632143 0.582857 0.121429
+0.786429 0.582857 0.121429
+0.940714 0.582857 0.121429
+1.000000 0.582857 0.121429
+0.015000 0.728571 0.121429
+0.169286 0.728571 0.121429
+0.323571 0.728571 0.121429
+0.477857 0.728571 0.121429
+0.632143 0.728571 0.121429
+0.786429 0.728571 0.121429
+0.940714 0.728571 0.121429
+1.000000 0.728571 0.121429
+0.015000 0.874286 0.121429
+0.169286 0.874286 0.121429
+0.323571 0.874286 0.121429
+0.477857 0.874286 0.121429
+0.632143 0.874286 0.121429
+0.786429 0.874286 0.121429
+0.940714 0.874286 0.121429
+1.000000 0.874286 0.121429
+0.015000 1.000000 0.121429
+0.169286 1.000000 0.121429
+0.323571 1.000000 0.121429
+0.477857 1.000000 0.121429
+0.632143 1.000000 0.121429
+0.786429 1.000000 0.121429
+0.940714 1.000000 0.121429
+1.000000 1.000000 0.121429
+0.015000 0.000000 0.252857
+0.169286 0.000000 0.252857
+0.323571 0.000000 0.252857
+0.477857 0.000000 0.252857
+0.632143 0.000000 0.252857
+0.786429 0.000000 0.252857
+0.940714 0.000000 0.252857
+1.000000 0.000000 0.252857
+0.015000 0.145714 0.252857
+0.169286 0.145714 0.252857
+0.323571 0.145714 0.252857
+0.477857 0.145714 0.252857
+0.632143 0.145714 0.252857
+0.786429 0.145714 0.252857
+0.940714 0.145714 0.252857
+1.000000 0.145714 0.252857
+0.015000 0.291429 0.252857
+0.169286 0.291429 0.252857
+0.323571 0.291429 0.252857
+0.477857 0.291429 0.252857
+0.632143 0.291429 0.252857
+0.786429 0.291429 0.252857
+0.940714 0.291429 0.252857
+1.000000 0.291429 0.252857
+0.015000 0.437143 0.252857
+0.169286 0.437143 0.252857
+0.323571 0.437143 0.252857
+0.477857 0.437143 0.252857
+0.632143 0.437143 0.252857
+0.786429 0.437143 0.252857
+0.940714 0.437143 0.252857
+1.000000 0.437143 0.252857
+0.015000 0.582857 0.252857
+0.169286 0.582857 0.252857
+0.323571 0.582857 0.252857
+0.477857 0.582857 0.252857
+0.632143 0.582857 0.252857
+0.786429 0.582857 0.252857
+0.940714 0.582857 0.252857
+1.000000 0.582857 0.252857
+0.015000 0.728571 0.252857
+0.169286 0.728571 0.252857
+0.323571 0.728571 0.252857
+0.477857 0.728571 0.252857
+0.632143 0.728571 0.252857
+0.786429 0.728571 0.252857
+0.940714 0.728571 0.252857
+1.000000 0.728571 0.252857
+0.015000 0.874286 0.252857
+0.169286 0.874286 0.252857
+0.323571 0.874286 0.252857
+0.477857 0.874286 0.252857
+0.632143 0.874286 0.252857
+0.786429 0.874286 0.252857
+0.940714 0.874286 0.252857
+1.000000 0.874286 0.252857
+0.015000 1.000000 0.252857
+0.169286 1.000000 0.252857
+0.323571 1.000000 0.252857
+0.477857 1.000000 0.252857
+0.632143 1.000000 0.252857
+0.786429 1.000000 0.252857
+0.940714 1.000000 0.252857
+1.000000 1.000000 0.252857
+0.015000 0.000000 0.384286
+0.169286 0.000000 0.384286
+0.323571 0.000000 0.384286
+0.477857 0.000000 0.384286
+0.632143 0.000000 0.384286
+0.786429 0.000000 0.384286
+0.940714 0.000000 0.384286
+1.000000 0.000000 0.384286
+0.015000 0.145714 0.384286
+0.169286 0.145714 0.384286
+0.323571 0.145714 0.384286
+0.477857 0.145714 0.384286
+0.632143 0.145714 0.384286
+0.786429 0.145714 0.384286
+0.940714 0.145714 0.384286
+1.000000 0.145714 0.384286
+0.015000 0.291429 0.384286
+0.169286 0.291429 0.384286
+0.323571 0.291429 0.384286
+0.477857 0.291429 0.384286
+0.632143 0.291429 0.384286
+0.786429 0.291429 0.384286
+0.940714 0.291429 0.384286
+1.000000 0.291429 0.384286
+0.015000 0.437143 0.384286
+0.169286 0.437143 0.384286
+0.323571 0.437143 0.384286
+0.477857 0.437143 0.384286
+0.632143 0.437143 0.384286
+0.786429 0.437143 0.384286
+0.940714 0.437143 0.384286
+1.000000 0.437143 0.384286
+0.015000 0.582857 0.384286
+0.169286 0.582857 0.384286
+0.323571 0.582857 0.384286
+0.477857 0.582857 0.384286
+0.632143 0.582857 0.384286
+0.786429 0.582857 0.384286
+0.940714 0.582857 0.384286
+1.000000 0.582857 0.384286
+0.015000 0.728571 0.384286
+0.169286 0.728571 0.384286
+0.323571 0.728571 0.384286
+0.477857 0.728571 0.384286
+0.632143 0.728571 0.384286
+0.786429 0.728571 0.384286
+0.940714 0.728571 0.384286
+1.000000 0.728571 0.384286
+0.015000 0.874286 0.384286
+0.169286 0.874286 0.384286
+0.323571 0.874286 0.384286
+0.477857 0.874286 0.384286
+0.632143 0.874286 0.384286
+0.786429 0.874286 0.384286
+0.940714 0.874286 0.384286
+1.000000 0.874286 0.384286
+0.015000 1.000000 0.384286
+0.169286 1.000000 0.384286
+0.323571 1.000000 0.384286
+0.477857 1.000000 0.384286
+0.632143 1.000000 0.384286
+0.786429 1.000000 0.384286
+0.940714 1.000000 0.384286
+1.000000 1.000000 0.384286
+0.015000 0.000000 0.515714
+0.169286 0.000000 0.515714
+0.323571 0.000000 0.515714
+0.477857 0.000000 0.515714
+0.632143 0.000000 0.515714
+0.786429 0.000000 0.515714
+0.940714 0.000000 0.515714
+1.000000 0.000000 0.515714
+0.015000 0.145714 0.515714
+0.169286 0.145714 0.515714
+0.323571 0.145714 0.515714
+0.477857 0.145714 0.515714
+0.632143 0.145714 0.515714
+0.786429 0.145714 0.515714
+0.940714 0.145714 0.515714
+1.000000 0.145714 0.515714
+0.015000 0.291429 0.515714
+0.169286 0.291429 0.515714
+0.323571 0.291429 0.515714
+0.477857 0.291429 0.515714
+0.632143 0.291429 0.515714
+0.786429 0.291429 0.515714
+0.940714 0.291429 0.515714
+1.000000 0.291429 0.515714
+0.015000 0.437143 0.515714
+0.169286 0.437143 0.515714
+0.323571 0.437143 0.515714
+0.477857 0.437143 0.515714
+0.632143 0.437143 0.515714
+0.786429 0.437143 0.515714
+0.940714 0.437143 0.515714
+1.000000 0.437143 0.515714
+0.015000 0.582857 0.515714
+0.169286 0.582857 0.515714
+0.323571 0.582857 0.515714
+0.477857 0.582857 0.515714
+0.632143 0.582857 0.515714
+0.786429 0.582857 0.515714
+0.940714 0.582857 0.515714
+1.000000 0.582857 0.515714
+0.015000 0.728571 0.515714
+0.169286 0.728571 0.515714
+0.323571 0.728571 0.515714
+0.477857 0.728571 0.515714
+0.632143 0.728571 0.515714
+0.786429 0.728571 0.515714
+0.940714 0.728571 0.515714
+1.000000 0.728571 0.515714
+0.015000 0.874286 0.515714
+0.169286 0.874286 0.515714
+0.323571 0.874286 0.515714
+0.477857 0.874286 0.515714
+0.632143 0.874286 0.515714
+0.786429 0.874286 0.515714
+0.940714 0.874286 0.515714
+1.000000 0.874286 0.515714
+0.015000 1.000000 0.515714
+0.169286 1.000000 0.515714
+0.323571 1.000000 0.515714
+0.477857 1.000000 0.515714
+0.632143 1.000000 0.515714
+0.786429 1.000000 0.515714
+0.940714 1.000000 0.515714
+1.000000 1.000000 0.515714
+0.015000 0.000000 0.647143
+0.169286 0.000000 0.647143
+0.323571 0.000000 0.647143
+0.477857 0.000000 0.647143
+0.632143 0.000000 0.647143
+0.786429 0.000000 0.647143
+0.940714 0.000000 0.647143
+1.000000 0.000000 0.647143
+0.015000 0.145714 0.647143
+0.169286 0.145714 0.647143
+0.323571 0.145714 0.647143
+0.477857 0.145714 0.647143
+0.632143 0.145714 0.647143
+0.786429 0.145714 0.647143
+0.940714 0.145714 0.647143
+1.000000 0.145714 0.647143
+0.015000 0.291429 0.647143
+0.169286 0.291429 0.647143
+0.323571 0.291429 0.647143
+0.477857 0.291429 0.647143
+0.632143 0.291429 0.647143
+0.786429 0.291429 0.647143
+0.940714 0.291429 0.647143
+1.000000 0.291429 0.647143
+0.015000 0.437143 0.647143
+0.169286 0.437143 0.647143
+0.323571 0.437143 0.647143
+0.477857 0.437143 0.647143
+0.632143 0.437143 0.647143
+0.786429 0.437143 0.647143
+0.940714 0.437143 0.647143
+1.000000 0.437143 0.647143
+0.015000 0.582857 0.647143
+0.169286 0.582857 0.647143
+0.323571 0.582857 0.647143
+0.477857 0.582857 0.647143
+0.632143 0.582857 0.647143
+0.786429 0.582857 0.647143
+0.940714 0.582857 0.647143
+1.000000 0.582857 0.647143
+0.015000 0.728571 0.647143
+0.169286 0.728571 0.647143
+0.323571 0.728571 0.647143
+0.477857 0.728571 0.647143
+0.632143 0.728571 0.647143
+0.786429 0.728571 0.647143
+0.940714 0.728571 0.647143
+1.000000 0.728571 0.647143
+0.015000 0.874286 0.647143
+0.169286 0.874286 0.647143
+0.323571 0.874286 0.647143
+0.477857 0.874286 0.647143
+0.632143 0.874286 0.647143
+0.786429 0.874286 0.647143
+0.940714 0.874286 0.647143
+1.000000 0.874286 0.647143
+0.015000 1.000000 0.647143
+0.169286 1.000000 0.647143
+0.323571 1.000000 0.647143
+0.477857 1.000000 0.647143
+0.632143 1.000000 0.647143
+0.786429 1.000000 0.647143
+0.940714 1.000000 0.647143
+1.000000 1.000000 0.647143
+0.015000 0.000000 0.778571
+0.169286 0.000000 0.778571
+0.323571 0.000000 0.778571
+0.477857 0.000000 0.778571
+0.632143 0.000000 0.778571
+0.786429 0.000000 0.778571
+0.940714 0.000000 0.778571
+1.000000 0.000000 0.778571
+0.015000 0.145714 0.778571
+0.169286 0.145714 0.778571
+0.323571 0.145714 0.778571
+0.477857 0.145714 0.778571
+0.632143 0.145714 0.778571
+0.786429 0.145714 0.778571
+0.940714 0.145714 0.778571
+1.000000 0.145714 0.778571
+0.015000 0.291429 0.778571
+0.169286 0.291429 0.778571
+0.323571 0.291429 0.778571
+0.477857 0.291429 0.778571
+0.632143 0.291429 0.778571
+0.786429 0.291429 0.778571
+0.940714 0.291429 0.778571
+1.000000 0.291429 0.778571
+0.015000 0.437143 0.778571
+0.169286 0.437143 0.778571
+0.323571 0.437143 0.778571
+0.477857 0.437143 0.778571
+0.632143 0.437143 0.778571
+0.786429 0.437143 0.778571
+0.940714 0.437143 0.778571
+1.000000 0.437143 0.778571
+0.015000 0.582857 0.778571
+0.169286 0.582857 0.778571
+0.323571 0.582857 0.778571
+0.477857 0.582857 0.778571
+0.632143 0.582857 0.778571
+0.786429 0.582857 0.778571
+0.940714 0.582857 0.778571
+1.000000 0.582857 0.778571
+0.015000 0.728571 0.778571
+0.169286 0.728571 0.778571
+0.323571 0.728571 0.778571
+0.477857 0.728571 0.778571
+0.632143 0.728571 0.778571
+0.786429 0.728571 0.778571
+0.940714 0.728571 0.778571
+1.000000 0.728571 0.778571
+0.015000 0.874286 0.778571
+0.169286 0.874286 0.778571
+0.323571 0.874286 0.778571
+0.477857 0.874286 0.778571
+0.632143 0.874286 0.778571
+0.786429 0.874286 0.778571
+0.940714 0.874286 0.778571
+1.000000 0.874286 0.778571
+0.015000 1.000000 0.778571
+0.169286 1.000000 0.778571
+0.323571 1.000000 0.778571
+0.477857 1.000000 0.778571
+0.632143 1.000000 0.778571
+0.786429 1.000000 0.778571
+0.940714 1.000000 0.778571
+1.000000 1.000000 0.778571
+0.015000 0.000000 0.910000
+0.169286 0.000000 0.910000
+0.323571 0.000000 0.910000
+0.477857 0.000000 0.910000
+0.632143 0.000000 0.910000
+0.786429 0.000000 0.910000
+0.940714 0.000000 0.910000
+1.000000 0.000000 0.910000
+0.015000 0.145714 0.910000
+0.169286 0.145714 0.910000
+0.323571 0.145714 0.910000
+0.477857 0.145714 0.910000
+0.632143 0.145714 0.910000
+0.786429 0.145714 0.910000
+0.940714 0.145714 0.910000
+1.000000 0.145714 0.910000
+0.015000 0.291429 0.910000
+0.169286 0.291429 0.910000
+0.323571 0.291429 0.910000
+0.477857 0.291429 0.910000
+0.632143 0.291429 0.910000
+0.786429 0.291429 0.910000
+0.940714 0.291429 0.910000
+1.000000 0.291429 0.910000
+0.015000 0.437143 0.910000
+0.169286 0.437143 0.910000
+0.323571 0.437143 0.910000
+0.477857 0.437143 0.910000
+0.632143 0.437143 0.910000
+0.786429 0.437143 0.910000
+0.940714 0.437143 0.910000
+1.000000 0.437143 0.910000
+0.015000 0.582857 0.910000
+0.169286 0.582857 0.910000
+0.323571 0.582857 0.910000
+0.477857 0.582857 0.910000
+0.632143 0.582857 0.910000
+0.786429 0.582857 0.910000
+0.940714 0.582857 0.910000
+1.000000 0.582857 0.910000
+0.015000 0.728571 0.910000
+0.169286 0.728571 0.910000
+0.323571 0.728571 0.910000
+0.477857 0.728571 0.910000
+0.632143 0.728571 0.910000
+0.786429 0.728571 0.910000
+0.940714 0.728571 0.910000
+1.000000 0.728571 0.910000
+0.015000 0.874286 0.910000
+0.169286 0.874286 0.910000
+0.323571 0.874286 0.910000
+0.477857 0.874286 0.910000
+0.632143 0.874286 0.910000
+0.786429 0.874286 0.910000
+0.940714 0.874286 0.910000
+1.000000 0.874286 0.910000
+0.015000 1.000000 0.910000
+0.169286 1.000000 0.910000
+0.323571 1.000000 0.910000
+0.477857 1.000000 0.910000
+0.632143 1.000000 0.910000
+0.786429 1.000000 0.910000
+0.940714 1.000000 0.910000
+1.000000 1.000000 0.910000

package/music/LICENSE-CC0.txt

@@ -0,0 +1,32 @@
+CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
+=====================================================================
+
+The motion-kit music bed in this directory (bed.wav) is an original
+procedural work by the motion-kit authors (1 s of digital silence,
+24 kHz mono 16-bit PCM, generated procedurally), dedicated to the public
+domain under CC0 1.0.
+
+The longer music bed in this directory (bed-full.wav) is also an
+original procedural work by the motion-kit authors (32 s audible
+chord progression, 48 kHz stereo 16-bit PCM, sine triads 220-523 Hz
+with 2 Hz pulse, peak -12 dBFS, 2 s fade in/out, generated procedurally),
+dedicated to the public domain under CC0 1.0.
+
+To the extent possible under law, the authors have waived all copyright and
+related rights to these .wav files. You may copy, modify, and distribute them
+without permission, including for commercial purposes.
+
+Full legal text: https://creativecommons.org/publicdomain/zero/1.0/
+
+File hashes (sha256):
+  bed.wav      e5ea01a23fcb85fd8e608c5c672ea5c22dfab6b0e581d782242f478e4b1c5900
+  bed-full.wav 51a5977617fccbaec6c2dcfd6449757aa48a7c92f01dda354d9263321a6cc9b1
+
+This file is DATA, never code: it contains only a RIFF/WAVE header plus
+silent PCM samples. No executable content is present.
+
+Mixing any bed is opt-in behind an explicit music flag; absent means
+narration-only or silent. A missing bed wav fails closed. Dist ships this
+default with the installed package.
+A gated mix stays unsupported without an explicit bed: supply your own CC0 wav
+or use this procedural bed.

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@anvpx/motion",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Storyboard JSON to animated video, rendered locally with HyperFrames: the mk CLI plus the full pipeline.",
+  "license": "MIT",
+  "author": "anvpx",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "video",
+    "video-generation",
+    "animation",
+    "motion-graphics",
+    "storyboard",
+    "explainer",
+    "infographic",
+    "hyperframes",
+    "llm",
+    "agent",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "mk": "./dist/main.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "plugins/**/*",
+    "skills/**/*",
+    "luts/*.cube",
+    "luts/LICENSE-CC0.txt",
+    "music/*.wav",
+    "music/LICENSE-CC0.txt",
+    "packs/**/*",
+    "assets.json",
+    "templates/**/*",
+    "shared/themes/**/*",
+    "stopwords.json",
+    "icons/icons.json",
+    "icons/licences.json",
+    "icons/LICENSE-lucide",
+    "CATALOG.md"
+  ],
+  "dependencies": {
+    "@fontsource/inter": "5.3.0",
+    "@fontsource/jetbrains-mono": "5.3.0",
+    "@fontsource/source-serif-4": "5.3.1",
+    "@fontsource/space-grotesk": "5.3.0",
+    "@anvpx/motion-assets": "0.1.0",
+    "@anvpx/motion-audio": "0.1.0",
+    "@anvpx/motion-build": "0.1.0",
+    "@anvpx/motion-cli": "0.1.0",
+    "@anvpx/motion-scenes": "0.1.0",
+    "@anvpx/motion-schema": "0.1.0",
+    "@anvpx/motion-templates": "0.1.0",
+    "@anvpx/motion-themes": "0.1.0",
+    "hyperframes": "0.8.212",
+    "postprocessing": "6.39.5",
+    "three": "0.186.0",
+    "zod": "4.6.7"
+  },
+  "scripts": {}
 }

package/packs/INDEX.md

@@ -0,0 +1,22 @@
+# Pack index (generated)
+
+> Generated from the installed pack manifests — do not edit by hand.
+> Ordering is id-sorted and byte-stable.
+
+## Use
+
+Packs are authoring guidance only. Expand at authoring time; never persist pack refs in storyboards.
+
+Runtime scene props live in `mk catalog`; this index is authoring documentation only.
+
+## Budget and stability
+
+- Canonical index payload (UTF-8): <= 8192 bytes.
+- Byte-stable: id-sorted rows, final newline.
+- Qualified rows only: inbox rows stay out.
+
+## Packs
+
+| ID      | Summary                                                                                                                                                                                                          | Guide           |
+| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
+| painted | Warm hand-painted explainer vocabulary in three current-only media reads (watercolour, oil, dry-ink): staged reveals, persistent shapes, paper calm. Maps to existing native scenes; no brush renderer promised. | painted/look.md |

package/packs/painted/checklist.md

@@ -0,0 +1,30 @@
+# Painted — review checklist (inbox, authoring only)
+
+Human review on the contact sheet / stills. Mark every row
+`tested` (scripted verify), `by_eye` (reviewer saw it), or
+`not_checked`. Any `not_checked` blocks promotion to qualified.
+
+## Reads and continuity
+
+- [ ] First frame is clean paper; no mark appears early. (by_eye)
+- [ ] Reveals follow narrative order, not screen position. (by_eye)
+- [ ] Earlier marks persist or dim; viewer never re-orients. (by_eye)
+- [ ] One carried shape/position anchors multi-shot runs. (by_eye)
+- [ ] Full-frame hold >= 0.5 s after the final reveal. (tested/by_eye)
+- [ ] At most ~8 words visible at once per shot. (tested/by_eye)
+
+## Restraint
+
+- [ ] At most one accent color job per film. (by_eye)
+- [ ] No photorealism, texture, or baked-in image text. (by_eye)
+- [ ] No p5 brush, hand asset, or new font smuggled in. (tested)
+- [ ] Audio added only on explicit request. (by_eye)
+
+## Honesty and state
+
+- [ ] Copy traces to the brief/source; illustrative marked so. (by_eye)
+- [ ] Unsupported effects (streaming ink, mask reveal, SRT import,
+  brush rendering) listed, not silently dropped. (by_eye)
+- [ ] Pack status is stated on the index row; an inbox pack is not a
+  qualified proof. (tested)
+- [ ] The pack index still omits an unqualified inbox pack. (tested)