@toonstrip/cli 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { validatePack } from "./pack-validate.js";
+function usage() {
+    console.error("Usage: toonstrip pack validate <dir>");
+    process.exit(1);
+}
+const [command, subcommand, arg] = process.argv.slice(2);
+if (command === "pack" && subcommand === "validate") {
+    if (!arg)
+        usage();
+    const result = validatePack(arg);
+    if (result.ok) {
+        console.log(`OK: ${arg} is a valid pack`);
+        process.exit(0);
+    }
+    console.error(`FAIL: ${arg} is not a valid pack`);
+    for (const error of result.errors)
+        console.error(`  - ${error}`);
+    process.exit(1);
+}
+else {
+    usage();
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { validatePack, type ValidationResult } from "./pack-validate.js";
+export { readPngDimensions } from "./png-dimensions.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { validatePack } from "./pack-validate.js";
+export { readPngDimensions } from "./png-dimensions.js";

package/dist/pack-validate.d.ts

@@ -0,0 +1,5 @@
+export interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare function validatePack(dir: string): ValidationResult;

package/dist/pack-validate.js

@@ -0,0 +1,84 @@
+/**
+ * `toonstrip pack validate <dir>` — checks a pack against the contract in
+ * TOONSTRIP_DEV_PLAN.md §6: `pack.json` shape, that every declared character's
+ * sheet + manifest exist and every character has at least the minimum
+ * required pose (NEUTRAL), and that every declared backdrop file exists with
+ * dimensions matching what `pack.json` declares. Modeled on grues-in-comic's
+ * `art/test/roster.test.ts` gate-2 inventory check.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { readPngDimensions } from "./png-dimensions.js";
+const REQUIRED_EMOTIONS = ["NEUTRAL"];
+function fail(errors, message) {
+    errors.push(message);
+}
+export function validatePack(dir) {
+    const errors = [];
+    const packJsonPath = join(dir, "pack.json");
+    if (!existsSync(packJsonPath)) {
+        return { ok: false, errors: [`${packJsonPath}: pack.json not found`] };
+    }
+    let pack;
+    try {
+        pack = JSON.parse(readFileSync(packJsonPath, "utf8"));
+    }
+    catch (err) {
+        return { ok: false, errors: [`${packJsonPath}: invalid JSON (${err.message})`] };
+    }
+    for (const field of ["name", "version", "license"]) {
+        if (!pack[field])
+            fail(errors, `pack.json: missing required field "${field}"`);
+    }
+    if (!Array.isArray(pack.characters))
+        fail(errors, `pack.json: "characters" must be an array`);
+    if (!Array.isArray(pack.backdrops))
+        fail(errors, `pack.json: "backdrops" must be an array`);
+    const seenIds = new Set();
+    for (const entry of pack.characters ?? []) {
+        if (seenIds.has(entry.id))
+            fail(errors, `character "${entry.id}" declared more than once`);
+        seenIds.add(entry.id);
+        const manifestPath = join(dir, entry.manifest);
+        const sheetPath = join(dir, entry.sheet);
+        if (!existsSync(manifestPath)) {
+            fail(errors, `character "${entry.id}": manifest not found at ${entry.manifest}`);
+            continue;
+        }
+        if (!existsSync(sheetPath)) {
+            fail(errors, `character "${entry.id}": sheet not found at ${entry.sheet}`);
+        }
+        let avatar;
+        try {
+            avatar = JSON.parse(readFileSync(manifestPath, "utf8"));
+        }
+        catch (err) {
+            fail(errors, `character "${entry.id}": invalid manifest JSON (${err.message})`);
+            continue;
+        }
+        const faces = avatar.faces ?? [];
+        for (const required of REQUIRED_EMOTIONS) {
+            if (!faces.some((f) => f.kind === "face" && f.emotion === required)) {
+                fail(errors, `character "${entry.id}": missing required "${required}" face`);
+            }
+        }
+    }
+    for (const backdrop of pack.backdrops ?? []) {
+        const filePath = join(dir, backdrop.file);
+        if (!existsSync(filePath)) {
+            fail(errors, `backdrop "${backdrop.id}": file not found at ${backdrop.file}`);
+            continue;
+        }
+        try {
+            const dims = readPngDimensions(filePath);
+            if (dims.width !== backdrop.width || dims.height !== backdrop.height) {
+                fail(errors, `backdrop "${backdrop.id}": pack.json declares ${backdrop.width}x${backdrop.height}, ` +
+                    `file is ${dims.width}x${dims.height}`);
+            }
+        }
+        catch (err) {
+            fail(errors, `backdrop "${backdrop.id}": ${err.message}`);
+        }
+    }
+    return { ok: errors.length === 0, errors };
+}

package/dist/png-dimensions.d.ts

@@ -0,0 +1,5 @@
+/** Reads a PNG's declared width/height straight out of its IHDR chunk. */
+export declare function readPngDimensions(path: string): {
+    width: number;
+    height: number;
+};

package/dist/png-dimensions.js

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/** Reads a PNG's declared width/height straight out of its IHDR chunk. */
+export function readPngDimensions(path) {
+    const buf = readFileSync(path);
+    if (!buf.subarray(0, 8).equals(PNG_SIGNATURE)) {
+        throw new Error(`${path}: not a PNG file`);
+    }
+    // IHDR is always the first chunk: 8-byte signature, 4-byte length, 4-byte
+    // "IHDR" tag, then width (4 bytes) and height (4 bytes), both big-endian.
+    const width = buf.readUInt32BE(16);
+    const height = buf.readUInt32BE(20);
+    return { width, height };
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@toonstrip/cli",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "toonstrip": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}