add ifl helpers

scripts/inspect-ifl.ts

@@ -0,0 +1,61 @@
+import fs from "node:fs";
+import { inspect, parseArgs } from "node:util";
+import { parseImageFrameList } from "@/src/ifl";
+import { getFilePath } from "@/src/manifest";
+
+async function run() {
+  const { values, positionals } = parseArgs({
+    allowPositionals: true,
+    options: {
+      name: {
+        type: "string",
+        short: "n",
+      },
+      list: {
+        type: "boolean",
+        short: "l",
+      },
+    },
+  });
+
+  if (values.list) {
+    if (values.name || positionals[0]) {
+      console.error("Cannot specify --list (-l) with other options.");
+      return 1;
+    }
+    const manifest = (await import("../public/manifest.json")).default;
+    const fileNames = Object.keys(manifest);
+    console.log(
+      fileNames
+        .map((f) => f.match(/^textures\/skins\/(.+)\.ifl$/))
+        .filter(Boolean)
+        .map((match) => match[1])
+        .join("\n")
+    );
+    return;
+  } else if (
+    (values.name && positionals[0]) ||
+    (!values.name && !positionals[0])
+  ) {
+    console.error(
+      "Must specify exactly one of --name (-n) or a positional filename."
+    );
+    return 1;
+  }
+
+  let framesFile = positionals[0];
+  if (values.name) {
+    const resourcePath = `textures/skins/${values.name}.ifl`;
+    framesFile = getFilePath(resourcePath);
+  }
+  const missionScript = fs.readFileSync(framesFile, "utf8");
+  console.log(
+    inspect(parseImageFrameList(missionScript), {
+      colors: true,
+      depth: Infinity,
+    })
+  );
+}
+
+const code = await run();
+process.exit(code ?? 0);