@energy8platform/golem 0.6.0 → 0.8.0

package/dist/lib/cli.js

@@ -3,9 +3,9 @@ import { resolve as resolve3 } from "node:path";
 
 // src/editor/server.ts
 import { createServer } from "node:http";
-import { readFile as readFile10, stat as stat3, readdir as readdir5, mkdir as mkdir7, open } from "node:fs/promises";
+import { readFile as readFile10, stat as stat4, readdir as readdir5, mkdir as mkdir7, open } from "node:fs/promises";
 import { watch as fsWatch } from "node:fs";
-import { resolve as resolve2, dirname as dirname9, basename as basename5, extname as extname2, sep, join as join10, relative as relative3 } from "node:path";
+import { resolve as resolve2, dirname as dirname9, basename as basename5, extname as extname2, sep as sep2, join as join10, relative as relative4 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/rig-format.ts
@@ -251,7 +251,7 @@ var Key = z.object({
   /** Optional independent easing for numeric-array components (for example Spine RGBA curves). */
   componentEase: z.array(Ease).min(1).optional()
 });
-var Interpolation = { interpolation: z.enum(["segment", "pchip"]).optional() };
+var Interpolation = { interpolation: z.enum(["segment", "pchip", "spline"]).optional() };
 var Track = z.discriminatedUnion("target", [
   z.object({ target: z.literal("control"), id: Id, prop: z.literal("value"), ...Interpolation, keys: z.array(Key).min(1) }),
   z.object({ target: z.literal("bone"), id: Id, prop: BoneProp, ...Interpolation, keys: z.array(Key).min(1) }),
@@ -571,7 +571,7 @@ function parse(input) {
 // src/rig-api.ts
 import { z as z3 } from "zod";
 import { readFile as readFile9, writeFile as writeFile7, stat as stat2, mkdir as mkdir6, readdir as readdir4 } from "node:fs/promises";
-import { dirname as dirname8, join as join9, relative as relative2, isAbsolute } from "node:path";
+import { dirname as dirname8, join as join9, relative as relative3, isAbsolute as isAbsolute2 } from "node:path";
 
 // src/rig-io.ts
 import { mkdir, rename, rm, writeFile } from "node:fs/promises";
@@ -594,8 +594,10 @@ var saveJson = (path, value) => saveBytes(path, JSON.stringify(value, null, 2));
 // src/rig-queue.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 import { resolve } from "node:path";
-var pending = /* @__PURE__ */ new Map();
-var active = new AsyncLocalStorage();
+var { pending, active } = globalThis[Symbol.for("golem.rigQueue")] ??= {
+  pending: /* @__PURE__ */ new Map(),
+  active: new AsyncLocalStorage()
+};
 async function withRigQueue(path, op) {
   const key = resolve(path);
   const held = active.getStore();
@@ -735,6 +737,57 @@ function smoothValue(track, i, t, component, loop) {
   const u = (t - k[i].t) / h(i), u2 = u * u, u3 = u2 * u;
   return (2 * u3 - 3 * u2 + 1) * v(i) + (u3 - 2 * u2 + u) * h(i) * tangent(i) + (-2 * u3 + 3 * u2) * v(i + 1) + (u3 - u2) * h(i) * tangent(i + 1);
 }
+function tridiagonal(a, b, c, r) {
+  const n = b.length, cp = [], x = [];
+  let beta = b[0];
+  x[0] = r[0] / beta;
+  for (let i = 1; i < n; i++) {
+    cp[i] = c[i - 1] / beta;
+    beta = b[i] - a[i] * cp[i];
+    x[i] = (r[i] - a[i] * x[i - 1]) / beta;
+  }
+  for (let i = n - 2; i >= 0; i--) x[i] -= cp[i + 1] * x[i + 1];
+  return x;
+}
+function splineMoments(t, v, periodic) {
+  const n = t.length, h = (j2) => t[j2 + 1] - t[j2], d = (j2) => (v[j2 + 1] - v[j2]) / h(j2);
+  if (!periodic) {
+    const a2 = [], b2 = [], c2 = [], r2 = [];
+    for (let i = 0; i < n; i++) {
+      const hp = i > 0 ? h(i - 1) : 0, hn = i < n - 1 ? h(i) : 0;
+      a2.push(hp);
+      b2.push(2 * (hp + hn));
+      c2.push(hn);
+      r2.push(6 * ((i < n - 1 ? d(i) : 0) - (i > 0 ? d(i - 1) : 0)));
+    }
+    return tridiagonal(a2, b2, c2, r2);
+  }
+  const m = n - 1, a = [], b = [], c = [], r = [];
+  for (let i = 0; i < m; i++) {
+    const p = (i + m - 1) % m;
+    a.push(h(p));
+    b.push(2 * (h(p) + h(i)));
+    c.push(h(i));
+    r.push(6 * (d(i) - d(p)));
+  }
+  const top = a[0], bottom = c[m - 1], gamma = -b[0];
+  const bb = [...b];
+  bb[0] -= gamma;
+  bb[m - 1] -= bottom * top / gamma;
+  const x = tridiagonal(a, bb, c, r), u = new Array(m).fill(0);
+  u[0] = gamma;
+  u[m - 1] = bottom;
+  const z4 = tridiagonal(a, bb, c, u);
+  const f = (x[0] + top * x[m - 1] / gamma) / (1 + z4[0] + top * z4[m - 1] / gamma);
+  const M = x.map((xi, i) => xi - f * z4[i]);
+  return [...M, M[0]];
+}
+function splineValue(track, i, t, component, loop) {
+  const k = track.keys, ts = k.map((x) => x.t), vs = k.map((x) => component === void 0 ? x.v : x.v[component]);
+  const M = splineMoments(ts, vs, loop && k.length > 3 && vs[0] === vs[k.length - 1]);
+  const H = ts[i + 1] - ts[i], A = (ts[i + 1] - t) / H, B = (t - ts[i]) / H;
+  return A * vs[i] + B * vs[i + 1] + ((A ** 3 - A) * M[i] + (B ** 3 - B) * M[i + 1]) * H * H / 6;
+}
 function sample(track, t, loop = false) {
   const keys = track.keys;
   if (t <= keys[0].t) return keys[0].v;
@@ -746,11 +799,13 @@ function sample(track, t, loop = false) {
   if (a.ease === "step") return a.v;
   if (typeof a.v === "number" && typeof b.v === "number") {
     if (track.interpolation === "pchip") return smoothValue(track, i, t, void 0, loop);
+    if (track.interpolation === "spline") return splineValue(track, i, t, void 0, loop);
     const u = ease(a.ease)((t - a.t) / (b.t - a.t));
     return a.v + (b.v - a.v) * u;
   }
   if (Array.isArray(a.v) && Array.isArray(b.v) && typeof a.v[0] === "number") {
     if (track.interpolation === "pchip") return a.v.map((_, j2) => smoothValue(track, i, t, j2, loop));
+    if (track.interpolation === "spline") return a.v.map((_, j2) => splineValue(track, i, t, j2, loop));
     const phase = (t - a.t) / (b.t - a.t), av = a.v, bv = b.v;
     return av.map((v, k) => v + ((bv[k] ?? v) - v) * ease(a.componentEase?.[k] ?? a.ease)(phase));
   }
@@ -2011,8 +2066,9 @@ function createDoc(name, width, height, notes) {
 function createSymbol(name, asset, margin = 0.15, notes) {
   const mx = Math.ceil(asset.width * margin), my = Math.ceil(asset.height * margin);
   const width = asset.width + 2 * mx, height = asset.height + 2 * my;
-  const fromFile = asset.src.replace(/^.*\//, "").replace(/\.[^.]+$/, "").toLowerCase().replace(/[^a-z0-9_]/g, "_").replace(/^[^a-z]+/, "");
-  const id = asset.id ?? (fromFile || name);
+  const stem = asset.src.replace(/^.*\//, "").replace(/\.[^.]+$/, "").toLowerCase().replace(/[^a-z0-9_]/g, "_");
+  const fromFile = stem.replace(/^[^a-z]+/, "") || (stem ? `symbol_${stem}` : "");
+  const id = asset.id ?? (ID_RE.test(fromFile) ? fromFile : ID_RE.test(name) ? name : "symbol");
   let doc = createDoc(name, width, height, notes);
   doc = { ...doc, bones: [{ ...doc.bones[0], transform: { ...doc.bones[0].transform, x: width / 2, y: height - my } }] };
   doc = { ...doc, assets: [RigSchema.shape.assets.element.parse({ id, src: asset.src, width: asset.width, height: asset.height })] };
@@ -2481,7 +2537,8 @@ function adjustTrack(doc, animId, track, adj) {
     return { ...k, t: r42(adj.timeScale ? k.t * adj.timeScale : k.t), v: r42(v) };
   });
   const duration = Math.max(anim.duration, keys[keys.length - 1].t);
-  const next = { ...anim, duration, tracks: anim.tracks.map((t) => same(t) ? { ...t, keys } : t), preset: void 0 };
+  const interpolation = track.interpolation ?? tr.interpolation;
+  const next = { ...anim, duration, tracks: anim.tracks.map((t) => same(t) ? { ...t, keys, ...interpolation && { interpolation } } : t), preset: void 0 };
   return { ...doc, animations: doc.animations.map((a) => a.id === animId ? next : a) };
 }
 function removeAnimation(doc, id) {
@@ -2768,7 +2825,7 @@ function setGoal(doc, bone, x, y, opts) {
 
 // src/rig-import-layers.ts
 import { readdir, readFile } from "node:fs/promises";
-import { join as join2, basename as basename2 } from "node:path";
+import { join as join2, basename as basename2, isAbsolute, relative, sep } from "node:path";
 var DEFAULT_PARENT = {
   head: "neck",
   neck: "torso",
@@ -2794,6 +2851,10 @@ function pngSize(buf) {
   if (buf.readUInt32BE(12) !== 1229472850) throw new Error("not a PNG (IHDR missing)");
   return [buf.readUInt32BE(16), buf.readUInt32BE(20)];
 }
+function outsideDir(dir, file) {
+  const r = relative(dir, join2(dir, file));
+  return isAbsolute(file) || r === ".." || r.startsWith(".." + sep);
+}
 async function importLayers(doc, dir, relPrefix = "layers") {
   let specs;
   try {
@@ -2806,6 +2867,7 @@ async function importLayers(doc, dir, relPrefix = "layers") {
   let next = doc;
   const parsed = [];
   for (const s2 of specs) {
+    if (outsideDir(dir, s2.file)) throw new Error(`layers.json file "${s2.file}" is outside the layers folder (${dir})`);
     const buf = await readFile(join2(dir, s2.file));
     const [w, h] = pngSize(buf);
     const m = basename2(s2.file, ".png").match(/^(?:(\d+)_)?(.+)$/);
@@ -2893,19 +2955,20 @@ var requireSlot = (doc, id) => {
   if (!s2) throw new Error(`unknown slot "${id}"`);
   return s2;
 };
-function sampled(duration, n, f, ease2 = "linear") {
+function sampled(duration, n, f) {
   const keys = [];
   for (let i = 0; i <= n; i++) {
     const t = +(duration * i / n).toFixed(4);
-    keys.push({ t, v: +f(t).toFixed(4) + 0, ease: ease2 });
+    keys.push({ t, v: +f(t).toFixed(4) + 0, ease: "linear" });
   }
   return keys;
 }
-function boneTrack(bone, prop, keys) {
-  return { target: "bone", id: bone.id, prop, keys };
+var smooth = "spline";
+function boneTrack(bone, prop, keys, interpolation) {
+  return { target: "bone", id: bone.id, prop, keys, ...interpolation && { interpolation } };
 }
-function deformTrack(slot, prop, keys) {
-  return slot.attachment ? { target: "deform", id: slot.attachment, prop, keys } : void 0;
+function deformTrack(slot, prop, keys, interpolation) {
+  return slot.attachment ? { target: "deform", id: slot.attachment, prop, keys, ...interpolation && { interpolation } } : void 0;
 }
 var pushTrack = (tracks, t) => {
   if (t) tracks.push(t);
@@ -2929,18 +2992,18 @@ var idleBreathing = {
     const armsR = byRole(doc, "arm_r", "arm_upper_r");
     const chest = slotOfBone(doc, torso);
     if (chest?.attachment) {
-      pushTrack(tracks, deformTrack(chest, "bulge", sampled(T2, 8, (t) => p.amplitude * Math.sin(w * t), "ease_in_out")));
+      pushTrack(tracks, deformTrack(chest, "bulge", sampled(T2, 8, (t) => p.amplitude * Math.sin(w * t)), smooth));
     } else {
       const r = torso.transform;
-      tracks.push(boneTrack(torso, "scaleY", sampled(T2, 8, (t) => r.scaleY + p.amplitude * Math.sin(w * t), "ease_in_out")));
-      tracks.push(boneTrack(torso, "scaleX", sampled(T2, 8, (t) => r.scaleX - p.amplitude * 0.4 * Math.sin(w * t), "ease_in_out")));
+      tracks.push(boneTrack(torso, "scaleY", sampled(T2, 8, (t) => r.scaleY + p.amplitude * Math.sin(w * t)), smooth));
+      tracks.push(boneTrack(torso, "scaleX", sampled(T2, 8, (t) => r.scaleX - p.amplitude * 0.4 * Math.sin(w * t)), smooth));
     }
     for (const h of heads)
-      tracks.push(boneTrack(h, "y", sampled(T2, 8, (t) => h.transform.y - p.headBob * Math.sin(w * t + 0.4), "ease_in_out")));
+      tracks.push(boneTrack(h, "y", sampled(T2, 8, (t) => h.transform.y - p.headBob * Math.sin(w * t + 0.4)), smooth));
     for (const a of armsL)
-      tracks.push(boneTrack(a, "rotation", sampled(T2, 8, (t) => a.transform.rotation + p.armSway * Math.sin(w * t + 0.8), "ease_in_out")));
+      tracks.push(boneTrack(a, "rotation", sampled(T2, 8, (t) => a.transform.rotation + p.armSway * Math.sin(w * t + 0.8)), smooth));
     for (const a of armsR)
-      tracks.push(boneTrack(a, "rotation", sampled(T2, 8, (t) => a.transform.rotation - p.armSway * Math.sin(w * t + 0.8), "ease_in_out")));
+      tracks.push(boneTrack(a, "rotation", sampled(T2, 8, (t) => a.transform.rotation - p.armSway * Math.sin(w * t + 0.8)), smooth));
     return finish(this.name, p.id, T2, true, tracks, p);
   }
 };
@@ -2949,22 +3012,20 @@ var winBounce = {
   defaults: { id: "win", duration: 1.2, height: 40, bounces: 2, squash: 0.15 },
   build(doc, p) {
     const b = root(doc), r = b.transform, tracks = [];
-    const yK = [[0, r.y, "ease_out"]];
-    const sxK = [[0, r.scaleX, "ease_out"]];
-    const syK = [[0, r.scaleY, "ease_out"]];
+    const yK = [[0, r.y]], sxK = [[0, r.scaleX]], syK = [[0, r.scaleY]];
     const per = p.duration / p.bounces;
     for (let i = 0; i < p.bounces; i++) {
       const t0 = i * per, h = p.height * 0.55 ** i, s2 = p.squash * 0.7 ** i;
-      sxK.push([t0 + per * 0.08, r.scaleX * (1 + s2), "ease_out"], [t0 + per * 0.5, r.scaleX * (1 - s2 * 0.6), "ease_in"], [t0 + per * 0.95, r.scaleX * (1 + s2), "ease_out"]);
-      syK.push([t0 + per * 0.08, r.scaleY * (1 - s2), "ease_out"], [t0 + per * 0.5, r.scaleY * (1 + s2 * 0.6), "ease_in"], [t0 + per * 0.95, r.scaleY * (1 - s2), "ease_out"]);
-      yK.push([t0 + per * 0.08, r.y, "ease_out"], [t0 + per * 0.5, r.y - h, "ease_in"], [t0 + per * 0.95, r.y, "ease_out"]);
+      sxK.push([t0 + per * 0.08, r.scaleX * (1 + s2)], [t0 + per * 0.5, r.scaleX * (1 - s2 * 0.6)], [t0 + per * 0.95, r.scaleX * (1 + s2)]);
+      syK.push([t0 + per * 0.08, r.scaleY * (1 - s2)], [t0 + per * 0.5, r.scaleY * (1 + s2 * 0.6)], [t0 + per * 0.95, r.scaleY * (1 - s2)]);
+      yK.push([t0 + per * 0.08, r.y], [t0 + per * 0.5, r.y - h], [t0 + per * 0.95, r.y]);
     }
     yK.push([p.duration, r.y]);
     sxK.push([p.duration, r.scaleX]);
     syK.push([p.duration, r.scaleY]);
-    tracks.push(boneTrack(b, "y", K(...yK)), boneTrack(b, "scaleX", K(...sxK)), boneTrack(b, "scaleY", K(...syK)));
+    tracks.push(boneTrack(b, "y", K(...yK), "pchip"), boneTrack(b, "scaleX", K(...sxK), smooth), boneTrack(b, "scaleY", K(...syK), smooth));
     for (const h of byRole(doc, "head"))
-      tracks.push(boneTrack(h, "rotation", K([0, h.transform.rotation], [p.duration * 0.25, h.transform.rotation - 6, "back_out"], [p.duration * 0.6, h.transform.rotation + 4], [p.duration, h.transform.rotation])));
+      tracks.push(boneTrack(h, "rotation", K([0, h.transform.rotation], [p.duration * 0.25, h.transform.rotation - 6], [p.duration * 0.6, h.transform.rotation + 4], [p.duration, h.transform.rotation]), smooth));
     const anim = finish(this.name, p.id, p.duration, false, tracks, p);
     anim.events.push({ t: 0, name: "win_start" }, { t: per * 0.95, name: "land" });
     return anim;
@@ -2977,8 +3038,8 @@ var anticipationShake = {
     const b = root(doc), r = b.transform, tracks = [];
     const n = Math.ceil(p.duration * p.frequency * 4);
     const env = (t) => p.grow ? t / p.duration : 1;
-    tracks.push(boneTrack(b, "x", sampled(p.duration, n, (t) => r.x + p.amplitude * env(t) * Math.sin(2 * Math.PI * p.frequency * t), "linear")));
-    tracks.push(boneTrack(b, "rotation", sampled(p.duration, n, (t) => r.rotation + 0.6 * p.amplitude * env(t) * Math.sin(2 * Math.PI * p.frequency * t + 1.2), "linear")));
+    tracks.push(boneTrack(b, "x", sampled(p.duration, n, (t) => r.x + p.amplitude * env(t) * Math.sin(2 * Math.PI * p.frequency * t)), smooth));
+    tracks.push(boneTrack(b, "rotation", sampled(p.duration, n, (t) => r.rotation + 0.6 * p.amplitude * env(t) * Math.sin(2 * Math.PI * p.frequency * t + 1.2)), smooth));
     tracks.push(boneTrack(b, "scaleX", K([0, r.scaleX, "ease_in"], [p.duration, r.scaleX * p.scaleUp])));
     tracks.push(boneTrack(b, "scaleY", K([0, r.scaleY, "ease_in"], [p.duration, r.scaleY * p.scaleUp])));
     return finish(this.name, p.id, p.duration, false, tracks, p);
@@ -3003,6 +3064,7 @@ var mouthTalk = {
     if (!p.frames.length) throw new Error("mouth_talk: frames must not be empty");
     const n = Math.max(1, Math.round(p.duration * p.rate));
     const keys = S(...Array.from({ length: n }, (_, i) => [+(i / p.rate).toFixed(4), p.frames[i % p.frames.length]]));
+    if (keys.at(-1).t < p.duration && keys.at(-1).v !== keys[0].v) keys.push(...S([p.duration, keys[0].v]));
     return finish(this.name, p.id, p.duration, true, [slotTrack(slot, "attachment", keys)], p);
   }
 };
@@ -3020,10 +3082,10 @@ var symbolIdle = {
   build(doc, p) {
     const b = root(doc), r = b.transform, T2 = p.period, w = 2 * Math.PI / T2, tracks = [];
     const rise = (t) => 0.5 - 0.5 * Math.cos(w * t);
-    tracks.push(boneTrack(b, "y", sampled(T2, 8, (t) => r.y - p.float * rise(t), "ease_in_out")));
-    if (p.tilt) tracks.push(boneTrack(b, "rotation", sampled(T2, 8, (t) => r.rotation + p.tilt * Math.sin(w * t), "ease_in_out")));
+    tracks.push(boneTrack(b, "y", sampled(T2, 8, (t) => r.y - p.float * rise(t)), smooth));
+    if (p.tilt) tracks.push(boneTrack(b, "rotation", sampled(T2, 8, (t) => r.rotation + p.tilt * Math.sin(w * t)), smooth));
     if (p.pulse) for (const s2 of doc.slots.filter((s3) => s3.bone === b.id && s3.attachment))
-      pushTrack(tracks, deformTrack(s2, "bulge", sampled(T2, 8, (t) => p.pulse * rise(t), "ease_in_out")));
+      pushTrack(tracks, deformTrack(s2, "bulge", sampled(T2, 8, (t) => p.pulse * rise(t)), smooth));
     return finish(this.name, p.id, T2, true, tracks, p);
   }
 };
@@ -3033,12 +3095,12 @@ var symbolWin = {
   build(doc, p) {
     const b = root(doc), r = b.transform, d = p.duration, tracks = [];
     for (const [prop, rest] of [["scaleX", r.scaleX], ["scaleY", r.scaleY]])
-      tracks.push(boneTrack(b, prop, K([0, rest, "ease_out"], [d * 0.2, rest * (1 + p.pop), "ease_in_out"], [d * 0.5, rest * (1 - p.pop * 0.3), "ease_out"], [d, rest])));
+      tracks.push(boneTrack(b, prop, K([0, rest], [d * 0.2, rest * (1 + p.pop)], [d * 0.5, rest * (1 - p.pop * 0.3)], [d, rest]), smooth));
     if (p.wobble) {
       const n = Math.max(8, p.wobbles * 4);
-      const keys = sampled(d, n, (t) => p.wobble * Math.exp(-3 * t / d) * Math.sin(2 * Math.PI * p.wobbles * t / d), "ease_in_out");
+      const keys = sampled(d, n, (t) => p.wobble * Math.exp(-3 * t / d) * Math.sin(2 * Math.PI * p.wobbles * t / d));
       keys[keys.length - 1].v = 0;
-      for (const s2 of doc.slots.filter((s3) => s3.bone === b.id && s3.attachment)) pushTrack(tracks, deformTrack(s2, "sway", keys));
+      for (const s2 of doc.slots.filter((s3) => s3.bone === b.id && s3.attachment)) pushTrack(tracks, deformTrack(s2, "sway", keys, smooth));
     }
     const anim = finish(this.name, p.id, d, false, tracks, p);
     anim.events.push({ t: 0, name: "win_start" });
@@ -3052,11 +3114,11 @@ var weightShift = {
     const T2 = p.period, w = 2 * Math.PI / T2, N = 16, tracks = [];
     const hips = byRole(doc, "hips")[0] ?? root(doc), hr = hips.transform;
     const s2 = (t) => Math.sin(w * t);
-    tracks.push(boneTrack(hips, "x", sampled(T2, N, (t) => hr.x + p.shift * s2(t))));
-    if (p.dip) tracks.push(boneTrack(hips, "y", sampled(T2, N, (t) => hr.y + p.dip * s2(t) ** 2)));
+    tracks.push(boneTrack(hips, "x", sampled(T2, N, (t) => hr.x + p.shift * s2(t)), smooth));
+    if (p.dip) tracks.push(boneTrack(hips, "y", sampled(T2, N, (t) => hr.y + p.dip * s2(t) ** 2), smooth));
     const torso = byRole(doc, "torso", "body")[0];
-    if (torso && torso !== hips) tracks.push(boneTrack(torso, "rotation", sampled(T2, N, (t) => torso.transform.rotation - p.lean * s2(t))));
-    for (const h of byRole(doc, "head")) tracks.push(boneTrack(h, "rotation", sampled(T2, N, (t) => h.transform.rotation + p.lean / 2 * s2(t))));
+    if (torso && torso !== hips) tracks.push(boneTrack(torso, "rotation", sampled(T2, N, (t) => torso.transform.rotation - p.lean * s2(t)), smooth));
+    for (const h of byRole(doc, "head")) tracks.push(boneTrack(h, "rotation", sampled(T2, N, (t) => h.transform.rotation + p.lean / 2 * s2(t)), smooth));
     for (const leg of byRole(doc, "leg_l", "leg_r")) {
       const slot = slotOfBone(doc, leg), att = slot && doc.attachments.find((a) => a.id === slot.attachment && a.type === "region");
       const asset = att && att.type === "region" ? doc.assets.find((a) => a.id === att.asset) : void 0;
@@ -3066,8 +3128,8 @@ var weightShift = {
         length = Math.max(...[[0, -h / 2], [w2 / 2, 0], [0, h / 2], [-w2 / 2, 0]].map(([x, y]) => Math.hypot(...apply(m, x, y))));
       }
       if (!(length > p.shift)) continue;
-      tracks.push(boneTrack(leg, "rotation", sampled(T2, N, (t) => leg.transform.rotation + Math.asin(p.shift * s2(t) / length) * 180 / Math.PI)));
-      if (p.dip) tracks.push(boneTrack(leg, "y", sampled(T2, N, (t) => leg.transform.y - p.dip * s2(t) ** 2)));
+      tracks.push(boneTrack(leg, "rotation", sampled(T2, N, (t) => leg.transform.rotation + Math.asin(p.shift * s2(t) / length) * 180 / Math.PI), smooth));
+      if (p.dip) tracks.push(boneTrack(leg, "y", sampled(T2, N, (t) => leg.transform.y - p.dip * s2(t) ** 2), smooth));
     }
     return finish(this.name, p.id, T2, true, tracks, p);
   }
@@ -3310,13 +3372,13 @@ function motionQuality(doc, anim, opts = {}) {
       const before = delta(values(k.v), values(p.v)), after = delta(values(n.v), values(k.v));
       const pass = before.some((v, j2) => v * after[j2] > 1e-6);
       const speed = Math.max(magnitude(before) / (k.t - p.t), magnitude(after) / (n.t - k.t));
-      if (pass && Math.max(magnitude(left), magnitude(right)) < speed * 0.02) report("pass_key_stop", id, `motion stops at a pass-through key; use track interpolation pchip or matched tangents`, k.t);
+      if (pass && Math.max(magnitude(left), magnitude(right)) < speed * 0.02) report("pass_key_stop", id, `motion stops at a pass-through key; use track interpolation pchip or spline, or matched tangents`, k.t);
       const jump = magnitude(delta(left, right));
       if (jump > Math.max(0.1, speed * 0.1)) report("velocity_jump", id, `velocity jumps ${jump.toFixed(3)} units/s across this key`, k.t);
       const acceleration = (a, b, c) => values(at(b)).map((v, j2) => (values(at(c))[j2] - 2 * v + values(at(a))[j2]) / (h * h));
       const al = acceleration(k.t - 2 * h, k.t - h, k.t), ar = acceleration(k.t, k.t + h, k.t + 2 * h);
       const aj = magnitude(delta(al, ar));
-      if (aj > Math.max(1, speed / Math.min(k.t - p.t, n.t - k.t) * 2)) report("acceleration_jump", id, `acceleration changes by ${aj.toFixed(2)} units/s\xB2 at this key; PCHIP guarantees velocity, not acceleration continuity`, k.t, "info");
+      if (aj > Math.max(1, speed / Math.min(k.t - p.t, n.t - k.t) * 2)) report("acceleration_jump", id, `acceleration changes by ${aj.toFixed(2)} units/s\xB2 at this key; PCHIP guarantees velocity, not acceleration continuity \u2014 spline does both`, k.t, "info");
     }
   }
   const steps = Math.max(2, Math.ceil(D * 60));
@@ -3798,6 +3860,17 @@ function checkRig(doc, opts = {}) {
     out.push({ level: "warn", code: "never_visible", subject: s2.id, message: `slot "${s2.id}" has no attachment and no animation ever shows one` });
   return out;
 }
+function summarizeIgnoring(findings, rules, max) {
+  const hits = (r, f) => r.code === f.code && (r.subject ?? f.subject) === f.subject && (r.animation ?? f.animation) === f.animation;
+  const kept = findings.filter((f) => !rules.some((r) => hits(r, f)));
+  const idle = rules.filter((r) => !findings.some((f) => hits(r, f)));
+  const notes = [
+    ...kept.length < findings.length ? [`  (${findings.length - kept.length} ignored)`] : [],
+    ...idle.map((r) => `  ignore matched nothing: ${JSON.stringify(r)}`)
+  ];
+  return [summarize(kept, max), ...notes].join("\n");
+}
+var where = (f) => `${f.subject}${f.animation ? ` in ${f.animation}` : ""}${f.time !== void 0 ? ` @${+f.time.toFixed(4)}s` : ""}`;
 function summarize(findings, max = 12) {
   if (!findings.length) return "check: OK";
   const rank = { error: 0, warn: 1, info: 2 };
@@ -3812,7 +3885,7 @@ function summarize(findings, max = 12) {
   const lines = [];
   for (const f of sorted) {
     const shown = shownPerCode.get(f.code) ?? 0;
-    if (shown < PER_CODE) lines.push(`  [${f.level}] ${f.code}: ${f.message}`);
+    if (shown < PER_CODE) lines.push(`  [${f.level}] ${f.code} ${where(f)}: ${f.message}`);
     else if (shown === PER_CODE) lines.push(`  \u2026 ${codeTotal.get(f.code) - PER_CODE} more ${f.code}`);
     shownPerCode.set(f.code, shown + 1);
   }
@@ -4003,7 +4076,7 @@ function packRects(rects, opts = {}) {
       shelf = Math.max(shelf, r.height);
     }
     const height = y + shelf + pad;
-    if (height <= max) return { width, height, frames };
+    if (height <= max) return { width: Math.max(pad, ...[...frames.values()].map(([fx, , fw]) => fx + fw)) + pad, height, frames };
     if (width >= max) throw new Error(`atlas does not fit in ${max}\xD7${max} (needs ${width}\xD7${height})`);
     width *= 2;
   }
@@ -4062,7 +4135,7 @@ async function buildAtlas(doc, assetsDir, outDir, opts = {}) {
 
 // src/spine-import.ts
 import { readFile as readFile7, stat, writeFile as writeFile5 } from "node:fs/promises";
-import { basename as basename4, dirname as dirname6, extname, join as join8, relative } from "node:path";
+import { basename as basename4, dirname as dirname6, extname, join as join8, relative as relative2 } from "node:path";
 
 // src/ktx2.ts
 import { readFile as readFile6 } from "node:fs/promises";
@@ -4211,13 +4284,13 @@ var Ids = class {
 var spineToDoc = (x, y, originX, originY) => [x + originX, originY - y];
 var r4 = (v) => Math.round(v * 1e6) / 1e6 + 0;
 var hex8 = (c) => `#${(c ?? "ffffffff").toLowerCase().padEnd(8, "f").slice(0, 8)}`;
-function importSpine(json, atlasText, opts = {}) {
+function importSpine(json2, atlasText, opts = {}) {
   const warnings = [];
   const atlas = parseAtlas(atlasText);
-  const version = String(json.skeleton?.spine ?? "4.0");
-  if (json.physics?.length) warnings.push(`${json.physics.length} Spine physics constraints are not imported; bake their motion before delivery`);
+  const version = String(json2.skeleton?.spine ?? "4.0");
+  if (json2.physics?.length) warnings.push(`${json2.physics.length} Spine physics constraints are not imported; bake their motion before delivery`);
   const major = parseFloat(version);
-  const bounds = { x: json.skeleton?.x ?? 0, y: json.skeleton?.y ?? 0, w: json.skeleton?.width ?? 0, h: json.skeleton?.height ?? 0 };
+  const bounds = { x: json2.skeleton?.x ?? 0, y: json2.skeleton?.y ?? 0, w: json2.skeleton?.width ?? 0, h: json2.skeleton?.height ?? 0 };
   const margin = opts.margin ?? 0;
   let originX = -bounds.x + margin, originY = bounds.y + bounds.h + margin;
   const toDoc = (x, y) => spineToDoc(x, y, originX, originY);
@@ -4234,7 +4307,7 @@ function importSpine(json, atlasText, opts = {}) {
     }
     return id;
   };
-  const spineBones = json.bones ?? [];
+  const spineBones = json2.bones ?? [];
   const boneIndexByName = new Map(spineBones.map((b, i) => [b.name, i]));
   const bones = [{ id: ROOT, transform: { x: r4(originX), y: r4(originY) }, role: "root" }];
   for (const b of spineBones) {
@@ -4247,7 +4320,7 @@ function importSpine(json, atlasText, opts = {}) {
       ...b.color ? { color: b.color } : {}
     });
   }
-  const skins = Array.isArray(json.skins) ? json.skins : Object.entries(json.skins ?? {}).map(([name, attachments2]) => ({ name, attachments: attachments2 }));
+  const skins = Array.isArray(json2.skins) ? json2.skins : Object.entries(json2.skins ?? {}).map(([name, attachments2]) => ({ name, attachments: attachments2 }));
   const selectedSkin = opts.skin ? skins.find((s2) => s2.name === opts.skin) : skins.find((s2) => s2.name === "default") ?? skins[0];
   if (opts.skin && !selectedSkin) throw new Error(`Spine skin "${opts.skin}" not found; available: ${skins.map((s2) => s2.name).join(", ")}`);
   const lookupSkins = [selectedSkin, skins.find((s2) => s2.name === "default")].filter((s2, i, list) => s2 && list.indexOf(s2) === i);
@@ -4271,7 +4344,7 @@ function importSpine(json, atlasText, opts = {}) {
     const resolved = skinnedName.get(`${slot} ${name}`);
     return resolved === void 0 ? null : attachmentId(slot, resolved);
   };
-  const spineSlots = json.slots ?? [];
+  const spineSlots = json2.slots ?? [];
   const slotIndexByName = new Map(spineSlots.map((s2, i) => [s2.name, i]));
   const blendOf = (b) => b === "additive" ? "add" : b === "multiply" ? "multiply" : b === "screen" ? "screen" : "normal";
   const slots = spineSlots.map((s2, i) => ({
@@ -4437,7 +4510,7 @@ function importSpine(json, atlasText, opts = {}) {
     }
   }
   const activeConstraint = (kind, c) => !c.skin || lookupSkins.some((s2) => s2[kind]?.includes(c.name));
-  const ik = (json.ik ?? []).filter((c) => activeConstraint("ik", c)).map((c) => ({
+  const ik = (json2.ik ?? []).filter((c) => activeConstraint("ik", c)).map((c) => ({
     id: ikIds.get(c.name),
     order: c.order ?? 0,
     bones: c.bones.map((b) => boneIds.get(b)),
@@ -4450,7 +4523,7 @@ function importSpine(json, atlasText, opts = {}) {
     stretch: !!c.stretch,
     uniform: !!c.uniform
   }));
-  const transform = (json.transform ?? []).filter((c) => activeConstraint("transform", c)).map((c) => ({
+  const transform = (json2.transform ?? []).filter((c) => activeConstraint("transform", c)).map((c) => ({
     id: tcIds.get(c.name),
     order: c.order ?? 0,
     bones: c.bones.map((b) => boneIds.get(b)),
@@ -4470,7 +4543,7 @@ function importSpine(json, atlasText, opts = {}) {
     mixScaleY: c.mixScaleY ?? c.mixScaleX ?? c.scaleMix ?? 1,
     mixShearY: c.mixShearY ?? c.shearMix ?? 1
   }));
-  const path = (json.path ?? []).filter((c) => activeConstraint("path", c)).map((c) => ({
+  const path = (json2.path ?? []).filter((c) => activeConstraint("path", c)).map((c) => ({
     id: pcIds.get(c.name),
     order: c.order ?? 0,
     bones: c.bones.map((b) => boneIds.get(b)),
@@ -4524,7 +4597,7 @@ function importSpine(json, atlasText, opts = {}) {
     return keys;
   };
   const animations = [];
-  for (const [animName, a] of Object.entries(json.animations ?? {})) {
+  for (const [animName, a] of Object.entries(json2.animations ?? {})) {
     const tracks = [], events = [];
     let duration = 0;
     const seen = (frames) => {
@@ -4805,7 +4878,7 @@ function importSpine(json, atlasText, opts = {}) {
   const build = () => ({
     format: "energy8.rig",
     version: 2,
-    meta: { name: opts.name ?? json.skeleton?.hash ?? "spine", width, height, notes: opts.notes ?? `imported from Spine ${version}` },
+    meta: { name: opts.name ?? json2.skeleton?.hash ?? "spine", width, height, notes: opts.notes ?? `imported from Spine ${version}` },
     assets: [...assets.values()],
     bones,
     slots,
@@ -4858,7 +4931,7 @@ async function firstExisting(candidates, what) {
   throw new Error(`${what} not found, tried: ${candidates.join(", ")}`);
 }
 async function importSpineProject(opts) {
-  const json = JSON.parse(await readFile7(opts.json, "utf8"));
+  const json2 = JSON.parse(await readFile7(opts.json, "utf8"));
   const stem = opts.json.replace(/\.json$/i, "");
   const atlasPath = opts.atlas ?? await firstExisting([stem + ".atlas", stem + ".atlas.txt"], "atlas");
   const atlasText = await readFile7(atlasPath, "utf8");
@@ -4868,6 +4941,7 @@ async function importSpineProject(opts) {
   const rigDir = dirname6(opts.rigPath);
   const pagePaths = /* @__PURE__ */ new Map();
   for (const page2 of pages) {
+    if (!opts.image && outsideDir(dirname6(atlasPath), page2.name)) throw new Error(`atlas page "${page2.name}" is outside the atlas folder (${dirname6(atlasPath)})`);
     const pageStem = join8(dirname6(atlasPath), page2.name.replace(/\.[a-z0-9]+$/i, ""));
     const imagePath = opts.image ?? await firstExisting([join8(dirname6(atlasPath), page2.name), pageStem + ".png", pageStem + ".ktx2", ...pages.length === 1 ? [stem + ".png", stem + ".ktx2"] : []], `atlas page image ${page2.name}`);
     let pngPath = imagePath;
@@ -4880,10 +4954,10 @@ async function importSpineProject(opts) {
     }
     pagePaths.set(page2.name, pngPath);
   }
-  const pageImage = (page2) => relative(rigDir, pagePaths.get(page2)).split("\\").join("/");
+  const pageImage = (page2) => relative2(rigDir, pagePaths.get(page2)).split("\\").join("/");
   const name = opts.name ?? basename4(stem);
   const imagePaths = [...pagePaths.values()];
-  return { ...importSpine(json, atlasText, { name, skin: opts.skin, pageImage, margin: opts.margin, notes: opts.notes }), imagePath: imagePaths[0], imagePaths };
+  return { ...importSpine(json2, atlasText, { name, skin: opts.skin, pageImage, margin: opts.margin, notes: opts.notes }), imagePath: imagePaths[0], imagePaths };
 }
 
 // src/rig-templates.ts
@@ -5573,8 +5647,8 @@ async function load(path) {
 }
 var save = (path, doc) => saveJson(path, doc);
 var exists2 = (p) => stat2(p).then(() => true, () => false);
-var resolveFrom = (rigPath, p) => isAbsolute(p) ? p : join9(dirname8(rigPath), p);
-var srcFor = (rigPath, file) => relative2(dirname8(rigPath), file).split("\\").join("/");
+var resolveFrom = (rigPath, p) => isAbsolute2(p) ? p : join9(dirname8(rigPath), p);
+var srcFor = (rigPath, file) => relative3(dirname8(rigPath), file).split("\\").join("/");
 var libraryFor = (rigPath, lib) => lib ? resolveFrom(rigPath, lib) : join9(dirname8(rigPath), "presets.json");
 async function pngInfo(rigPath, file) {
   const abs = resolveFrom(rigPath, file);
@@ -5609,7 +5683,8 @@ function previewCheck(doc, animation) {
   const a = animation ? doc.animations.find((x) => x.id === animation) : void 0;
   return a ? `check: OK for "${a.id}" (${a.tracks.length} tracks, ${a.duration}s${a.loop ? " loop" : ""})` : "check: OK (rest pose)";
 }
-var TrackRef = { interpolation: z3.enum(["segment", "pchip"]).optional().describe("pchip: smooth through numeric keys, preserving extrema; segment: per-key easing"), target: z3.enum(["bone", "slot", "deform", "ik", "transform", "path", "drawOrder", "control"]), id: z3.string(), prop: z3.string() };
+var TrackId = { target: z3.enum(["bone", "slot", "deform", "ik", "transform", "path", "drawOrder", "control"]), id: z3.string(), prop: z3.string() };
+var TrackRef = { interpolation: z3.enum(["segment", "pchip", "spline"]).optional().describe("segment: per-key easing; pchip: smooth through numeric keys, never past them (continuous velocity); spline: C2 cubic through them, continuous acceleration too, may overshoot between keys \u2014 for sampled curves"), ...TrackId };
 tool(
   "rig_set_control",
   "Create or replace a semantic control with a finite min/max/default range. Animate target=control, prop=value. Changing a range requires matching binding grids.",
@@ -5802,11 +5877,21 @@ tool(
 );
 tool(
   "rig_check",
-  "Cheap self-critique without rendering: out_of_canvas (slot leaves the canvas, worst time), static_track, loop_seam, deform_flip (lattice folds over itself \u2014 an error), mesh_fold (a skinned/deformed mesh folds over itself: error when \u2265 5 % of the mesh folds, warning below \u2014 a dense mesh bent hard at a joint pinches the odd hairline triangle), weights_sum (skinned mesh vertex weights not summing to 1), patch_offset (a slot sits away from its asset's source bbox), rest_overlap, unused_asset, never_visible, and for constraints: constraint_dead (every mix is 0 at rest and no track lifts one \u2014 the solver skips it), constraint_cycle (the target is a bone the constraint drives, or hangs off one: it reads what it writes \u2014 an error), ik_unreachable (the target sits beyond the chain's reach for over 20 % of an animation, so the limb hangs straight), path_missing (a path constraint whose target slot never shows a path attachment \u2014 an error). Motion diagnostics also cover pass_key_stop, velocity_jump, acceleration_jump, loop_velocity and constraint_order; provide secondaryBones, frontOf slot pairs and named attachment UV landmarks for brief-specific frozen-motion, ordering and swap-registration checks. Findings are sorted by severity. Run it before spending vision tokens on a preview.",
-  { path: Path, animation: z3.string().optional().describe("limit to one animation (rest pose is always checked)"), fps: z3.number().positive().optional(), deformFps: z3.number().positive().optional(), secondaryBones: z3.array(z3.string()).optional(), frontOf: z3.array(z3.tuple([z3.string(), z3.string()])).optional(), landmarks: z3.record(z3.record(z3.tuple([z3.number(), z3.number()]))).optional(), landmarkTolerance: z3.number().nonnegative().optional() },
-  async ({ path, ...opts }) => {
+  "Cheap self-critique without rendering: out_of_canvas (slot leaves the canvas, worst time), static_track, loop_seam, deform_flip (lattice folds over itself \u2014 an error), mesh_fold (a skinned/deformed mesh folds over itself: error when \u2265 5 % of the mesh folds, warning below \u2014 a dense mesh bent hard at a joint pinches the odd hairline triangle), weights_sum (skinned mesh vertex weights not summing to 1), patch_offset (a slot sits away from its asset's source bbox), rest_overlap, unused_asset, never_visible, and for constraints: constraint_dead (every mix is 0 at rest and no track lifts one \u2014 the solver skips it), constraint_cycle (the target is a bone the constraint drives, or hangs off one: it reads what it writes \u2014 an error), ik_unreachable (the target sits beyond the chain's reach for over 20 % of an animation, so the limb hangs straight), path_missing (a path constraint whose target slot never shows a path attachment \u2014 an error). Motion diagnostics also cover pass_key_stop, velocity_jump, acceleration_jump, loop_velocity and constraint_order; provide secondaryBones, frontOf slot pairs and named attachment UV landmarks for brief-specific frozen-motion, ordering and swap-registration checks. Findings are sorted by severity; each line names its subject (a track as target.id.prop), animation and time. `ignore` drops findings you have read and accept \u2014 by code, narrowed by subject and animation; the reply counts them and names a rule that matched nothing. Run it before spending vision tokens on a preview.",
+  {
+    path: Path,
+    animation: z3.string().optional().describe("limit to one animation (rest pose is always checked)"),
+    fps: z3.number().positive().optional(),
+    deformFps: z3.number().positive().optional(),
+    secondaryBones: z3.array(z3.string()).optional(),
+    frontOf: z3.array(z3.tuple([z3.string(), z3.string()])).optional(),
+    landmarks: z3.record(z3.record(z3.tuple([z3.number(), z3.number()]))).optional(),
+    landmarkTolerance: z3.number().nonnegative().optional(),
+    ignore: z3.array(z3.object({ code: z3.string(), subject: z3.string().optional(), animation: z3.string().optional() }).strict()).optional()
+  },
+  async ({ path, ignore = [], ...opts }) => {
     try {
-      return text(summarize(checkRig(await load(path), opts), 100));
+      return text(summarizeIgnoring(checkRig(await load(path), opts), ignore, 100));
     } catch (e) {
       return fail(e);
     }
@@ -5825,9 +5910,9 @@ tool(
     margin: z3.number().optional().describe("canvas margin around the skeleton bounds, px"),
     notes: z3.string().optional()
   },
-  async ({ path, json, atlas, image, name, skin: skin2, margin, notes }) => {
+  async ({ path, json: json2, atlas, image, name, skin: skin2, margin, notes }) => {
     try {
-      const r = await importSpineProject({ json: resolveFrom(path, json), atlas: atlas && resolveFrom(path, atlas), image: image && resolveFrom(path, image), rigPath: path, name, skin: skin2, margin, notes });
+      const r = await importSpineProject({ json: resolveFrom(path, json2), atlas: atlas && resolveFrom(path, atlas), image: image && resolveFrom(path, image), rigPath: path, name, skin: skin2, margin, notes });
       const res = await create(path, parse(r.doc));
       if (r.warnings.length) res.text += `
 warnings:
@@ -6423,9 +6508,9 @@ tool(
 );
 tool(
   "rig_adjust_track",
-  "Re-tune an existing track without retyping keys: amplitude scales its deviation from the rest value (0.5 = half as strong, 2 = twice; scale props as ratios), offset adds a constant, timeScale stretches its key times (duration grows to fit). Drops the preset link.",
+  "Re-tune an existing track without retyping keys: amplitude scales its deviation from the rest value (0.5 = half as strong, 2 = twice; scale props as ratios), offset adds a constant, timeScale stretches its key times (duration grows to fit), interpolation switches segment / pchip / spline. Drops the preset link.",
   { path: Path, animation: z3.string(), ...TrackRef, amplitude: z3.number().optional(), offset: z3.number().optional(), timeScale: z3.number().positive().optional() },
-  async ({ path, animation, target, id, prop, ...adj }) => mutate(path, (d) => adjustTrack(d, animation, { target, id, prop }, adj))
+  async ({ path, animation, target, id, prop, interpolation, ...adj }) => mutate(path, (d) => adjustTrack(d, animation, { target, id, prop, interpolation }, adj))
 );
 tool(
   "rig_set_animation",
@@ -6443,7 +6528,7 @@ tool(
 tool(
   "rig_remove_keys",
   "Remove the keys of one track at the given times; an emptied track is dropped. Drops the preset link.",
-  { path: Path, animation: z3.string(), ...TrackRef, times: z3.array(z3.number()).min(1) },
+  { path: Path, animation: z3.string(), ...TrackId, times: z3.array(z3.number()).min(1) },
   async ({ path, animation, target, id, prop, times: times2 }) => mutate(path, (d) => removeKeys(d, animation, { target, id, prop }, times2))
 );
 tool(
@@ -6599,40 +6684,41 @@ tool(
   }
 );
 
+// src/rig-version.ts
+import { stat as stat3 } from "node:fs/promises";
+async function rigVersion(abs) {
+  try {
+    const s2 = await stat3(abs);
+    return `${s2.mtimeMs}:${s2.size}`;
+  } catch {
+    return "missing";
+  }
+}
+
 // src/editor/server.ts
 var TYPES = { ".html": "text/html; charset=utf-8", ".js": "text/javascript", ".css": "text/css", ".map": "application/json", ".json": "application/json", ".png": "image/png", ".jpg": "image/jpeg", ".webp": "image/webp" };
-async function startEditorServer(opts) {
+var json = (res, status, body) => {
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(JSON.stringify(body));
+};
+function createEditorHandler(opts) {
   const root3 = resolve2(opts.root);
   const assets = resolve2(opts.assets ?? fileURLToPath3(new URL("../..", import.meta.url)));
   const inside = (rel) => {
     const abs = resolve2(root3, rel);
-    return abs === root3 || abs.startsWith(root3 + sep) ? abs : void 0;
-  };
-  const version = async (abs) => {
-    try {
-      const s2 = await stat3(abs);
-      return `${s2.mtimeMs}:${s2.size}`;
-    } catch {
-      return "missing";
-    }
+    return abs === root3 || abs.startsWith(root3 + sep2) ? abs : void 0;
   };
   const readDoc = async (abs) => RigDocument.parse(JSON.parse(await readFile10(abs, "utf8")));
   const readDocAt = async (abs) => {
-    let v = await version(abs);
+    let v = await rigVersion(abs);
     for (let i = 0; i < 3; i++) {
       const doc = await readDoc(abs);
-      const after = await version(abs);
+      const after = await rigVersion(abs);
       if (after === v) return { doc, version: v };
       v = after;
     }
     return { doc: await readDoc(abs), version: v };
   };
-  const json = (res, status, body2) => {
-    res.writeHead(status, { "content-type": "application/json" });
-    res.end(JSON.stringify(body2));
-  };
-  let allowedHosts = /* @__PURE__ */ new Set();
-  const hostOk = (req) => allowedHosts.has(String(req.headers.host ?? "").toLowerCase());
   const clients = /* @__PURE__ */ new Map();
   const watchers = /* @__PURE__ */ new Map();
   function ensureWatch(abs) {
@@ -6644,7 +6730,7 @@ async function startEditorServer(opts) {
     const schedule = () => {
       clearTimeout(entry.timer);
       entry.timer = setTimeout(async () => {
-        const v = await version(abs);
+        const v = await rigVersion(abs);
         if (v === entry.last) return;
         entry.last = v;
         for (const res of clients.get(abs) ?? []) res.write(`event: changed
@@ -6653,7 +6739,7 @@ data: ${JSON.stringify({ version: v })}
 `);
       }, 50);
     };
-    version(abs).then((v) => {
+    rigVersion(abs).then((v) => {
       entry.last = v;
     });
     watchers.set(abs, entry);
@@ -6679,7 +6765,7 @@ data: ${JSON.stringify({ version: v })}
           name = String(JSON.parse(await readFile10(abs, "utf8")).meta?.name ?? "?");
         } catch {
         }
-        out.push({ rig: relative3(root3, abs).split(sep).join("/"), name, mtimeMs: (await stat3(abs)).mtimeMs });
+        out.push({ rig: relative4(root3, abs).split(sep2).join("/"), name, mtimeMs: (await stat4(abs)).mtimeMs });
       }
     };
     await walk(root3);
@@ -6713,20 +6799,22 @@ data: ${JSON.stringify({ version: v })}
     }
     return Buffer.concat(chunks);
   }
-  const server = createServer(async (req, res) => {
+  async function handle(req, res, rawUrl = req.url ?? "/") {
     try {
-      if (!hostOk(req)) return json(res, 403, { isError: true, text: `ERROR: forbidden Host "${req.headers.host ?? ""}" \u2014 this server answers only on 127.0.0.1 / localhost` });
-      const url = new URL(req.url ?? "/", "http://x");
+      const url = new URL(rawUrl, "http://x");
       if (url.pathname === "/") {
-        res.writeHead(302, { location: "/editor.html" + url.search });
-        return res.end();
+        res.writeHead(302, { location: "editor.html" + url.search });
+        return void res.end();
+      }
+      if (url.pathname.startsWith("/api/")) {
+        await api(url, req, res);
+        return;
       }
-      if (url.pathname.startsWith("/api/")) return await api(url, req, res);
       const STATIC = /* @__PURE__ */ new Set(["/editor.html", "/dist/editor.js", "/dist/editor.js.map", "/dist/editor.css", "/dist/editor.css.map"]);
       const abs = url.pathname.startsWith("/rig/") ? inside(decodeURIComponent(url.pathname.slice(5))) : STATIC.has(url.pathname) ? join10(assets, url.pathname) : void 0;
       if (!abs) {
         res.writeHead(403);
-        return res.end("forbidden");
+        return void res.end("forbidden");
       }
       try {
         const data = await readFile10(abs);
@@ -6744,7 +6832,7 @@ data: ${JSON.stringify({ version: v })}
       }
       json(res, 500, { isError: true, text: `ERROR: ${e.message}` });
     }
-  });
+  }
   async function api(url, req, res) {
     const rigOf = (rel) => {
       if (!rel) return void 0;
@@ -6761,7 +6849,7 @@ data: ${JSON.stringify({ version: v })}
         res.writeHead(403);
         return res.end();
       }
-      if (!await stat3(abs).then(() => true, () => false)) return json(res, 404, { isError: true, text: `ERROR: ${url.searchParams.get("rig")} does not exist under ${root3}` });
+      if (!await stat4(abs).then(() => true, () => false)) return json(res, 404, { isError: true, text: `ERROR: ${url.searchParams.get("rig")} does not exist under ${root3}` });
       ensureWatch(abs);
       res.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", connection: "keep-alive" });
       res.write(`: connected
@@ -6783,7 +6871,7 @@ data: ${JSON.stringify({ version: v })}
       if (!abs) return json(res, 403, { isError: true, text: "rig outside root" });
       ensureWatch(abs);
       return await withRigQueue(abs, async () => {
-        if (baseVersion !== void 0 && await version(abs) !== baseVersion) {
+        if (baseVersion !== void 0 && await rigVersion(abs) !== baseVersion) {
           const at = await readDocAt(abs);
           return json(res, 409, {
             isError: true,
@@ -6792,8 +6880,15 @@ data: ${JSON.stringify({ version: v })}
             text: `ERROR: the rig changed on disk (expected ${baseVersion}, found ${at.version}); nothing was written`
           });
         }
-        const r = await callTool(url.pathname.slice(10), { ...args2 ?? {}, path: abs });
-        return json(res, 200, { text: r.text, doc: r.doc, image: r.image?.toString("base64"), isError: r.isError, version: await version(abs) });
+        const tool2 = url.pathname.slice(10);
+        let given = { ...args2 ?? {}, path: abs };
+        try {
+          if (opts.args) given = opts.args(tool2, given);
+        } catch (e) {
+          return json(res, 400, { isError: true, text: `ERROR: ${e instanceof Error ? e.message : String(e)}` });
+        }
+        const r = await callTool(tool2, given);
+        return json(res, 200, { text: r.text, doc: r.doc, image: r.image?.toString("base64"), isError: r.isError, version: await rigVersion(abs) });
       });
     }
     if (url.pathname === "/api/rigs" && req.method === "GET") return json(res, 200, await listRigs());
@@ -6804,11 +6899,11 @@ data: ${JSON.stringify({ version: v })}
       if (typeof rig !== "string" || !/(^|\/)rig\.json$/.test(rig)) return json(res, 400, { isError: true, text: "ERROR: a project is a directory with a rig.json \u2014 the path must end with /rig.json" });
       const abs = inside(rig);
       if (!abs) return json(res, 403, { isError: true, text: "rig outside root" });
-      if (await stat3(abs).then(() => true, () => false)) return json(res, 409, { isError: true, text: `ERROR: ${rig} already exists \u2014 open it, or pick another directory` });
+      if (await stat4(abs).then(() => true, () => false)) return json(res, 409, { isError: true, text: `ERROR: ${rig} already exists \u2014 open it, or pick another directory` });
       await mkdir7(dirname9(abs), { recursive: true });
       const r = await callTool("rig_create", { path: abs, name: name ?? basename5(dirname9(abs)), width: width ?? 640, height: height ?? 700 });
       ensureWatch(abs);
-      return json(res, r.isError ? 400 : 200, { text: r.text, doc: r.doc, isError: r.isError, version: await version(abs) });
+      return json(res, r.isError ? 400 : 200, { text: r.text, doc: r.doc, isError: r.isError, version: await rigVersion(abs) });
     }
     if (url.pathname === "/api/files" && req.method === "GET") {
       const abs = rigOf(url.searchParams.get("rig"));
@@ -6822,8 +6917,8 @@ data: ${JSON.stringify({ version: v })}
       if (!/^[A-Za-z0-9._-]+\.png$/i.test(name) || name.startsWith(".")) return json(res, 400, { isError: true, text: `ERROR: bad file name "${name}" \u2014 letters, digits, . _ - and a .png extension` });
       if (!String(req.headers["content-type"] ?? "").toLowerCase().startsWith("image/png")) return json(res, 415, { isError: true, text: "ERROR: upload needs content-type: image/png" });
       const target = join10(dirname9(abs), name);
-      if (!inside(relative3(root3, target))) return json(res, 403, { isError: true, text: "file outside root" });
-      if (await stat3(target).then(() => true, () => false)) return json(res, 409, { isError: true, text: `ERROR: ${name} already exists next to the rig \u2014 rename the file` });
+      if (!inside(relative4(root3, target))) return json(res, 403, { isError: true, text: "file outside root" });
+      if (await stat4(target).then(() => true, () => false)) return json(res, 409, { isError: true, text: `ERROR: ${name} already exists next to the rig \u2014 rename the file` });
       const data = await bytes(req, UPLOAD_MAX);
       if (!data) return json(res, 413, { isError: true, text: `ERROR: ${name} is larger than ${UPLOAD_MAX / 1048576} MB` });
       let size;
@@ -6837,6 +6932,22 @@ data: ${JSON.stringify({ version: v })}
     }
     json(res, 404, { isError: true, text: "unknown api route" });
   }
+  return { handle, close() {
+    for (const w of watchers.values()) {
+      clearTimeout(w.timer);
+      w.w.close();
+    }
+    for (const set of clients.values()) for (const c of set) c.end();
+  } };
+}
+async function startEditorServer(opts) {
+  const editor = createEditorHandler(opts);
+  let allowedHosts = /* @__PURE__ */ new Set();
+  const server = createServer((req, res) => {
+    if (!allowedHosts.has(String(req.headers.host ?? "").toLowerCase()))
+      return json(res, 403, { isError: true, text: `ERROR: forbidden Host "${req.headers.host ?? ""}" \u2014 this server answers only on 127.0.0.1 / localhost` });
+    void editor.handle(req, res);
+  });
   await new Promise((ok, fail2) => {
     server.once("error", fail2);
     server.listen(opts.port ?? 8765, "127.0.0.1", () => {
@@ -6847,11 +6958,7 @@ data: ${JSON.stringify({ version: v })}
   const port2 = server.address().port;
   allowedHosts = /* @__PURE__ */ new Set([`127.0.0.1:${port2}`, `localhost:${port2}`, `[::1]:${port2}`]);
   return { port: port2, url: `http://127.0.0.1:${port2}`, close: async () => {
-    for (const w of watchers.values()) {
-      clearTimeout(w.timer);
-      w.w.close();
-    }
-    for (const set of clients.values()) for (const c of set) c.end();
+    editor.close();
     await new Promise((r) => server.close(() => r()));
   } };
 }