@ludic-labs/assembly 0.0.0-stage → 0.4.0

package/tools/svg-asset.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import {
+  compileSvgAsset,
+  renderSvgFrame,
+  exportSvgAnimation,
+  SvgAssetError,
+  SVG_ASSET_LIMITS,
+} from "../dist/svg.js";
+
+try {
+  const [source, target, ...args] = process.argv.slice(2);
+  if (!source || !target)
+    throw new Error(
+      "Usage: node tools/svg-asset.mjs source.json output.svg [--clip name] [--time seconds] [--animated | --frames] [--fps 24] [--params overrides.json]. --frames uses output as a directory.",
+    );
+  const options = {},
+    flags = new Set();
+  for (let i = 0; i < args.length; i++) {
+    const key = args[i];
+    if (key === "--animated" || key === "--frames") {
+      flags.add(key);
+      continue;
+    }
+    if (!["--clip", "--time", "--fps", "--params"].includes(key) || args[i + 1] === undefined)
+      throw new Error(`Unknown or incomplete option ${key}`);
+    const value = args[++i];
+    if (key === "--clip") options.animation = value;
+    if (key === "--time") options.time = Number(value);
+    if (key === "--fps") options.fps = Number(value);
+    if (key === "--params") options.params = JSON.parse(await readFile(value, "utf8"));
+  }
+  if (flags.size > 1 || (flags.size && options.time !== undefined))
+    throw new Error("Choose a static time, --animated, or --frames.");
+  if (options.params && (typeof options.params !== "object" || Array.isArray(options.params)))
+    throw new Error("Parameter overrides must be a JSON object.");
+  const compiled = compileSvgAsset(JSON.parse(await readFile(source, "utf8")));
+  if (!compiled.ok) {
+    console.error(JSON.stringify({ ok: false, diagnostics: compiled.diagnostics }, null, 2));
+    process.exitCode = 1;
+  } else {
+    const asset = compiled.asset;
+    if (flags.has("--frames")) {
+      const name = options.animation ?? asset.spec.defaultAnimation;
+      if (!name || !Object.hasOwn(asset.spec.animations ?? {}, name))
+        throw new Error("Select an existing clip for frame export.");
+      const clip = asset.spec.animations[name],
+        fps = options.fps ?? 24;
+      if (!Number.isFinite(fps) || fps < 1 || fps > 60) throw new Error("fps must be in [1, 60].");
+      const steps = Math.ceil(clip.duration * fps),
+        count = steps + (clip.loop ? 0 : 1);
+      if (count > SVG_ASSET_LIMITS.frames) throw new Error(`Frame count exceeds ${SVG_ASSET_LIMITS.frames}.`);
+      // Evaluate the entire bounded sequence before writing any outputs.
+      let size = 0;
+      const frames = Array.from({ length: count }, (_, index) => {
+        const time = (index * clip.duration) / steps;
+        const svg = renderSvgFrame(asset, { ...options, animation: name, time });
+        size += svg.length;
+        if (size > SVG_ASSET_LIMITS.outputCharacters)
+          throw new Error("Frame sequence exceeds output budget.");
+        return { file: `${String(index).padStart(4, "0")}.svg`, time, svg };
+      });
+      await mkdir(target, { recursive: true });
+      for (const { file, svg } of frames) await writeFile(join(target, file), svg);
+      await writeFile(
+        join(target, "manifest.json"),
+        JSON.stringify(
+          {
+            schema: "svg-frames/0.1",
+            source,
+            animation: name,
+            duration: clip.duration,
+            loop: clip.loop,
+            requestedFps: fps,
+            sampleFps: steps / clip.duration,
+            viewBox: asset.spec.viewBox,
+            frames: frames.map(({ file, time }) => ({ file, time })),
+          },
+          null,
+          2,
+        ) + "\n",
+      );
+    } else
+      await writeFile(
+        target,
+        flags.has("--animated") ? exportSvgAnimation(asset, options) : renderSvgFrame(asset, options),
+      );
+    console.log(JSON.stringify({ ok: true, output: target }));
+  }
+} catch (error) {
+  console.error(
+    JSON.stringify(
+      {
+        ok: false,
+        diagnostics:
+          error instanceof SvgAssetError
+            ? error.diagnostics
+            : [{ code: "SVG_CLI", path: "$", message: error.message }],
+      },
+      null,
+      2,
+    ),
+  );
+  process.exitCode = 1;
+}