@energy8platform/golem 0.5.0 → 0.7.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
@@ -176,7 +176,9 @@ var PathAttachment = z.object({
   /** curve lengths for constant-speed positioning */
   lengths: z.array(z.number()).default([]),
   closed: z.boolean().default(false),
-  constantSpeed: z.boolean().default(true)
+  constantSpeed: z.boolean().default(true),
+  /** Spine-style active clipping span in the posed draw order; end slot is inclusive. */
+  clipping: z.object({ end: Id.optional() }).optional()
 });
 var Attachment = z.discriminatedUnion("type", [RegionAttachment, MeshAttachment, PathAttachment]);
 var IkConstraint = z.object({
@@ -245,7 +247,9 @@ var Key = z.object({
   t: z.number().nonnegative(),
   v: KeyValue,
   /** easing INTO the next key */
-  ease: Ease.default("ease_in_out")
+  ease: Ease.default("ease_in_out"),
+  /** 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 Track = z.discriminatedUnion("target", [
@@ -432,6 +436,10 @@ function validate(doc) {
       else if (a.slot !== s2.id) errs.push(`slot "${s2.id}": attachment "${s2.attachment}" belongs to slot "${a.slot}"`);
     }
   }
+  for (const a of doc.attachments) if (a.type === "path" && a.clipping) {
+    if (!a.closed) errs.push(`attachment "${a.id}": clipping path must be closed`);
+    if (a.clipping.end && !slots.has(a.clipping.end)) errs.push(`attachment "${a.id}": unknown clipping end slot "${a.clipping.end}"`);
+  }
   const vertexCount2 = (a) => {
     if (a.type === "region") return 4;
     if (a.type === "mesh") return a.uvs.length / 2;
@@ -515,6 +523,7 @@ function validate(doc) {
       const att = t.target === "deform" ? attachments.get(t.id) : void 0;
       let prev = -1;
       for (const k of t.keys) {
+        if (k.componentEase && (!Array.isArray(k.v) || !k.v.every((v) => typeof v === "number") || k.componentEase.length !== k.v.length)) errs.push(`animation "${a.id}" ${tid}: componentEase must match the numeric-array value length`);
         if (k.t <= prev && prev >= 0) errs.push(`animation "${a.id}" ${tid}: keys not strictly increasing`);
         if (k.t > a.duration) errs.push(`animation "${a.id}" ${tid}: key at ${k.t}s exceeds duration`);
         if (t.target === "control") {
@@ -562,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";
@@ -585,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();
@@ -742,8 +753,8 @@ function sample(track, t, loop = false) {
   }
   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));
-    const u = ease(a.ease)((t - a.t) / (b.t - a.t)), av = a.v, bv = b.v;
-    return av.map((v, k) => v + ((bv[k] ?? v) - v) * u);
+    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));
   }
   return a.v;
 }
@@ -835,6 +846,13 @@ function boneWorldOf(bone, s2, parent) {
   if (!parent) return local;
   if (bone.inherit === "normal") return mul(parent, local);
   const [tx, ty] = apply(parent, s2.x, s2.y);
+  if (bone.inherit === "noScale" || bone.inherit === "noScaleOrReflection") {
+    const r = s2.rotation * DEG2, x = parent.a * Math.cos(r) + parent.c * Math.sin(r), y = parent.b * Math.cos(r) + parent.d * Math.sin(r);
+    const length = Math.hypot(x, y), a = length > 1e-5 ? x / length : x, b = length > 1e-5 ? y / length : y;
+    const sign = bone.inherit === "noScale" && parent.a * parent.d - parent.b * parent.c < 0 ? -1 : 1;
+    const basis3 = { a, b, c: -b * sign, d: a * sign, tx: 0, ty: 0 };
+    return { ...mul(basis3, affineOf(0, 0, 0, s2.scaleX, s2.scaleY, s2.shearX, s2.shearY)), tx, ty };
+  }
   return { ...mul(inheritedParentLinear(bone, parent), { ...local, tx: 0, ty: 0 }), tx, ty };
 }
 var orderCache = /* @__PURE__ */ new WeakMap();
@@ -867,11 +885,11 @@ var localOf = (doc, pose, b) => {
     shearY: num(pose, pk("bone", id, "shearY"), r.shearY)
   };
 };
-function updateSubtree(skel, root3) {
+function updateSubtree(skel, root3, includeRoot = true) {
   const doc = skel.doc;
   const kids = /* @__PURE__ */ new Map();
   for (const b of doc.bones) if (b.parent) (kids.get(b.parent) ?? kids.set(b.parent, []).get(b.parent)).push(b);
-  const stack = [root3];
+  const stack = includeRoot ? [root3] : (kids.get(root3) ?? []).map((b) => b.id);
   while (stack.length) {
     const id = stack.pop(), b = boneOf(doc, id), st = skel.bones.get(id);
     st.world = boneWorldOf(b, st, b.parent ? skel.bones.get(b.parent).world : void 0);
@@ -1114,7 +1132,8 @@ function applyTransformConstraint(skel, c) {
   if (!mixRotate && !mixX && !mixY && !mixScaleX && !mixScaleY && !mixShearY) return;
   c = { ...c, ...Object.fromEntries(["x", "y", "rotation", "scaleX", "scaleY", "shearY"].map((p) => [p, cnum(skel, "transform", c.id, p, c[p])])) };
   const target = skel.bones.get(c.target), tw = target.world;
-  const offsetRotation = c.rotation * DEG2, offsetShearY = c.shearY * DEG2;
+  const handedness = tw.a * tw.d - tw.b * tw.c < 0 ? -1 : 1;
+  const offsetRotation = c.rotation * DEG2 * (c.local ? 1 : handedness), offsetShearY = c.shearY * DEG2 * (c.local ? 1 : handedness);
   for (const id of c.bones) {
     const b = boneOf(skel.doc, id), st = skel.bones.get(id);
     if (c.local) {
@@ -1276,6 +1295,7 @@ function applyPathConstraint(skel, c) {
   const position = cnum(skel, "path", c.id, "position", c.position), spacing = cnum(skel, "path", c.id, "spacing", c.spacing);
   const tangents = c.rotateMode === "tangent", scale = c.rotateMode === "chainScale";
   const bones = c.bones.map((id) => ({ b: boneOf(skel.doc, id), st: skel.bones.get(id) }));
+  const inputWorlds = bones.map(({ st }) => ({ ...st.world }));
   const spacesCount = tangents ? bones.length : bones.length + 1;
   const spaces = new Array(spacesCount).fill(0), worldLengths = [];
   let sum = 0;
@@ -1310,9 +1330,10 @@ function applyPathConstraint(skel, c) {
     if (tw.a * tw.d - tw.b * tw.c < 0) offsetRotation = -offsetRotation;
   }
   let boneX = samples[0].x, boneY = samples[0].y;
+  const solvedWorlds = /* @__PURE__ */ new Map();
   for (let i = 0; i < bones.length; i++) {
     const { b, st } = bones[i];
-    let w = { ...st.world };
+    let w = { ...inputWorlds[i] };
     w.tx += (boneX - w.tx) * mixX;
     w.ty += (boneY - w.ty) * mixY;
     const next = samples[i + 1] ?? { x: 0, y: 0, angle: 0 };
@@ -1342,7 +1363,11 @@ function applyPathConstraint(skel, c) {
       const cos = Math.cos(r), sin = Math.sin(r);
       w = { a: cos * a - sin * bb, b: sin * a + cos * bb, c: cos * cc - sin * d, d: sin * cc + cos * d, tx: w.tx, ty: w.ty };
     }
-    setEffectiveWorld(skel, b, st, w);
+    solvedWorlds.set(b.id, w);
+  }
+  for (const b of boneOrder(skel.doc)) {
+    const world = solvedWorlds.get(b.id);
+    if (world) setEffectiveWorld(skel, b, skel.bones.get(b.id), world);
   }
 }
 function measuredPathLength(points, closed, lengths, constantSpeed) {
@@ -1371,9 +1396,14 @@ function inheritedParentLinear(bone, parent) {
     case "onlyTranslation":
       return { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
     case "noRotationOrReflection": {
-      const lenX = Math.hypot(parent.a, parent.b) || 1;
+      const lenX = Math.hypot(parent.a, parent.b);
       const det = parent.a * parent.d - parent.b * parent.c;
-      return { a: lenX, b: 0, c: 0, d: Math.abs(det) / lenX, tx: 0, ty: 0 };
+      if (lenX * lenX <= 1e-4) {
+        const lenY = Math.hypot(parent.c, parent.d), ux2 = lenY ? parent.c / lenY : 0, uy2 = lenY ? parent.d / lenY : 0;
+        return { a: lenY * ux2 * ux2, b: lenY * ux2 * uy2, c: lenY * ux2 * uy2, d: lenY * uy2 * uy2, tx: 0, ty: 0 };
+      }
+      const ux = parent.a / lenX, uy = parent.b / lenX, sy = Math.abs(det) / lenX;
+      return { a: lenX * ux * ux + sy * uy * uy, b: (lenX - sy) * ux * uy, c: (lenX - sy) * ux * uy, d: lenX * uy * uy + sy * ux * ux, tx: 0, ty: 0 };
     }
     case "noScale":
     case "noScaleOrReflection": {
@@ -1399,7 +1429,16 @@ function setEffectiveWorld(skel, bone, st, world) {
   st.scaleY = Math.hypot(lin.c, lin.d);
   st.shearX = 0;
   st.shearY = shortest(Math.atan2(lin.d, lin.c) / DEG2 - st.rotation - 90);
-  updateSubtree(skel, bone.id);
+  if (parent && (bone.inherit === "noScale" || bone.inherit === "noScaleOrReflection")) {
+    const direction = mul(invert({ ...parent, tx: 0, ty: 0 }), { ...world, tx: 0, ty: 0 });
+    st.rotation = Math.atan2(direction.b, direction.a) / DEG2;
+    st.scaleX = Math.hypot(world.a, world.b);
+    st.scaleY = Math.hypot(world.c, world.d);
+    const sign = bone.inherit === "noScale" && parent.a * parent.d - parent.b * parent.c < 0 ? -1 : 1;
+    st.shearY = shortest((Math.atan2(world.d, world.c) - Math.atan2(world.b, world.a)) / DEG2 * sign - 90);
+  }
+  st.world = world;
+  updateSubtree(skel, bone.id, false);
 }
 function attachmentWorldVertices(skel, slotId, att) {
   const deform = skel.pose.get(pk("deform", att.id, "vertices"));
@@ -1974,8 +2013,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 })] };
@@ -2158,7 +2198,7 @@ function removeSlot(doc, id) {
   return patchDrawOrder({
     ...doc,
     slots: doc.slots.filter((s2) => s2.id !== id).map((s2) => gone.has(s2.clip ?? "") ? { ...s2, clip: void 0 } : s2),
-    attachments: doc.attachments.filter((a) => a.slot !== id),
+    attachments: doc.attachments.filter((a) => a.slot !== id).map((a) => a.type === "path" && a.clipping?.end === id ? { ...a, clipping: {} } : a),
     animations: doc.animations.map((a) => ({ ...a, tracks: a.tracks.filter((t) => !(t.target === "slot" && t.id === id || t.target === "deform" && gone.has(t.id))) }))
   }, (o) => o.filter((s2) => s2 !== id));
 }
@@ -2554,7 +2594,7 @@ function rename2(doc, kind, id, to) {
       return {
         ...doc,
         slots: doc.slots.map((s2) => ({ ...s2, id: sub(s2.id) })),
-        attachments: doc.attachments.map((a) => ({ ...a, slot: sub(a.slot) })),
+        attachments: doc.attachments.map((a) => ({ ...a, slot: sub(a.slot), ...a.type === "path" && a.clipping?.end ? { clipping: { end: sub(a.clipping.end) } } : {} })),
         path: doc.path.map((c) => ({ ...c, target: sub(c.target) }))
       };
     }
@@ -2731,7 +2771,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",
@@ -2757,6 +2797,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 {
@@ -2769,6 +2813,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+)_)?(.+)$/);
@@ -4025,7 +4070,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";
@@ -4167,21 +4212,26 @@ var Ids = class {
   has(name) {
     return this.map.has(name);
   }
+  reserve(id) {
+    this.used.add(id);
+  }
 };
 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");
+  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);
   const boneIds = new Ids("b_"), slotIds = new Ids("s_"), assetIds = new Ids("a_"), attIds = new Ids("att_"), ikIds = new Ids("ik_"), tcIds = new Ids("tc_"), pcIds = new Ids("pc_"), animIds = new Ids("anim_");
   const ROOT = "origin";
+  boneIds.reserve(ROOT);
   const attachmentIdMap = /* @__PURE__ */ new Map();
   const attachmentId = (slot, name) => {
     const key = `${slot} ${name}`;
@@ -4192,7 +4242,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) {
@@ -4205,14 +4255,18 @@ 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);
+  if (skins.length > 1) warnings.push(`Spine skin "${selectedSkin?.name}" selected; setup and attachment timelines are flattened to this skin with default fallback (no runtime skin switching)`);
   const frameSuffix = (seq, index) => {
-    const n = String((seq.start ?? 0) + index);
+    const n = String((seq.start ?? 1) + index);
     return "0".repeat(Math.max(0, (seq.digits ?? 0) - n.length)) + n;
   };
   const sequences = /* @__PURE__ */ new Map();
   const skinnedName = /* @__PURE__ */ new Map();
-  for (const skin2 of skins) {
+  for (const skin2 of lookupSkins) {
     const prefix = skin2.name === "default" ? "" : `${skin2.name}_`;
     for (const [slotName, atts] of Object.entries(skin2.attachments ?? {}))
       for (const [name, a] of Object.entries(atts)) {
@@ -4221,19 +4275,23 @@ function importSpine(json, atlasText, opts = {}) {
         if (!skinnedName.has(key)) skinnedName.set(key, prefix + name + (seq ? frameSuffix(seq, seq.setupIndex ?? 0) : ""));
       }
   }
-  const attachmentRef = (slot, name) => attachmentId(slot, skinnedName.get(`${slot} ${name}`) ?? name);
-  const spineSlots = json.slots ?? [];
+  const attachmentRef = (slot, name) => {
+    const resolved = skinnedName.get(`${slot} ${name}`);
+    return resolved === void 0 ? null : attachmentId(slot, resolved);
+  };
+  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) => ({
     id: slotIds.get(s2.name),
     bone: boneIds.get(s2.bone),
     z: i,
-    ...s2.attachment ? { attachment: attachmentRef(s2.name, s2.attachment) } : {},
+    ...s2.attachment && attachmentRef(s2.name, s2.attachment) ? { attachment: attachmentRef(s2.name, s2.attachment) } : {},
     blend: blendOf(s2.blend),
     color: hex8(s2.color),
     alpha: 1
   }));
+  if (spineSlots.some((s2) => s2.dark)) warnings.push("Spine setup dark two-color tint is not supported");
   const pageImage = (page2) => typeof opts.pageImage === "function" ? opts.pageImage(page2) : opts.pageImage ?? page2;
   const assets = /* @__PURE__ */ new Map();
   const regionByName = new Map(atlas.regions.map((r) => [r.name, r]));
@@ -4259,6 +4317,7 @@ function importSpine(json, atlasText, opts = {}) {
     return id;
   };
   const attachments = [];
+  const clipDeforms = /* @__PURE__ */ new Map();
   const readVertices = (a, vertexCount2) => {
     const v = a.vertices ?? [];
     if (v.length === vertexCount2 * 2) {
@@ -4279,6 +4338,22 @@ function importSpine(json, atlasText, opts = {}) {
     }
     return { weights };
   };
+  const meshGeometry = (skinName, slot, name, visiting = /* @__PURE__ */ new Set()) => {
+    const key = JSON.stringify([skinName, slot, name]);
+    if (visiting.has(key)) {
+      warnings.push(`linked mesh cycle at "${skinName}/${slot}/${name}" skipped`);
+      return void 0;
+    }
+    const raw = skins.find((s2) => s2.name === skinName)?.attachments?.[slot]?.[name];
+    if (!raw) {
+      warnings.push(`linked mesh parent "${skinName}/${slot}/${name}" not found`);
+      return void 0;
+    }
+    if (!raw.parent) return raw;
+    visiting.add(key);
+    return meshGeometry(raw.skin ?? "default", slot, raw.parent, visiting);
+  };
+  const inheritedDeform = /* @__PURE__ */ new Map();
   for (const skin2 of skins) {
     const prefix = skin2.name === "default" ? "" : `${skin2.name}_`;
     for (const [slotName, atts] of Object.entries(skin2.attachments ?? {})) {
@@ -4290,7 +4365,7 @@ function importSpine(json, atlasText, opts = {}) {
       for (const [name, a] of Object.entries(atts)) {
         if (a.sequence) {
           sequences.set(`${slotName} ${prefix}${name}`, a.sequence);
-          const base = a.path ?? name;
+          const base = a.path ?? a.name ?? name;
           for (let i = 0; i < (a.sequence.count ?? 0); i++) {
             const suffix = frameSuffix(a.sequence, i), asset = assetFor(base + suffix);
             if (!asset) continue;
@@ -4313,7 +4388,7 @@ function importSpine(json, atlasText, opts = {}) {
         }
         const type = a.type ?? "region", id = attachmentId(slotName, prefix + name);
         if (type === "region") {
-          const asset = assetFor(a.path ?? name);
+          const asset = assetFor(a.path ?? a.name ?? name);
           if (!asset) continue;
           attachments.push({
             id,
@@ -4329,21 +4404,48 @@ function importSpine(json, atlasText, opts = {}) {
             ...a.height ? { height: a.height } : {}
           });
         } else if (type === "mesh" || type === "linkedmesh") {
-          if (type === "linkedmesh") {
-            warnings.push(`linked mesh "${slotName}/${name}" skipped`);
-            continue;
-          }
-          const asset = assetFor(a.path ?? name);
+          const geometry = a.parent ? meshGeometry(skin2.name, slotName, name) : a;
+          if (!geometry) continue;
+          const asset = assetFor(a.path ?? a.name ?? name);
           if (!asset) continue;
-          const n = (a.uvs?.length ?? 0) / 2;
-          attachments.push({ id, slot, type: "mesh", asset, uvs: a.uvs, triangles: a.triangles, ...readVertices(a, n), hull: a.hull ?? 0, ...a.width ? { width: a.width } : {}, ...a.height ? { height: a.height } : {} });
+          const n = (geometry.uvs?.length ?? 0) / 2;
+          attachments.push({ id, slot, type: "mesh", asset, uvs: geometry.uvs, triangles: geometry.triangles, ...readVertices(geometry, n), hull: geometry.hull ?? 0, ...geometry.width ? { width: geometry.width } : {}, ...geometry.height ? { height: geometry.height } : {} });
+          if (a.parent && (a.timelines ?? a.deform ?? true)) {
+            const parentSkin = a.skin ?? "default";
+            inheritedDeform.set(id, attachmentId(slotName, (parentSkin === "default" ? "" : `${parentSkin}_`) + a.parent));
+          }
         } else if (type === "path") {
           attachments.push({ id, slot, type: "path", ...readVertices(a, a.vertexCount ?? 0), lengths: a.lengths ?? [], closed: !!a.closed, constantSpeed: a.constantSpeed ?? true });
+        } else if (type === "clipping") {
+          const data = readVertices(a, a.vertexCount), n = a.vertexCount;
+          const recipes = Array.from({ length: n }, (_, i) => [
+            [[(i + n - 1) % n, 1 / 3], [i, 2 / 3]],
+            [[i, 1]],
+            [[i, 2 / 3], [(i + 1) % n, 1 / 3]]
+          ]).flat();
+          let geometry;
+          if (data.weights) {
+            const starts = [];
+            let offset = 0;
+            for (const list of data.weights) {
+              starts.push(offset);
+              offset += list.length * 2;
+            }
+            const mapping = recipes.flatMap((recipe) => recipe.flatMap(([index]) => data.weights[index].map((_, k) => starts[index] + k * 2)));
+            geometry = { weights: recipes.map((recipe) => recipe.flatMap(([index, factor]) => data.weights[index].map((inf) => ({ ...inf, w: inf.w * factor })))) };
+            clipDeforms.set(id, (offsets) => mapping.flatMap((index) => [offsets[index] ?? 0, offsets[index + 1] ?? 0]));
+          } else {
+            const expand = (values2) => recipes.flatMap((recipe) => [0, 1].map((axis) => recipe.reduce((sum, [index, factor]) => sum + (values2[index * 2 + axis] ?? 0) * factor, 0)));
+            geometry = { vertices: expand(data.vertices) };
+            clipDeforms.set(id, expand);
+          }
+          attachments.push({ id, slot, type: "path", ...geometry, closed: true, clipping: { ...a.end ? { end: slotIds.get(a.end) } : {} } });
         } else warnings.push(`attachment "${slotName}/${name}" of type ${type} skipped`);
       }
     }
   }
-  const ik = (json.ik ?? []).map((c) => ({
+  const activeConstraint = (kind, c) => !c.skin || lookupSkins.some((s2) => s2[kind]?.includes(c.name));
+  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)),
@@ -4356,7 +4458,7 @@ function importSpine(json, atlasText, opts = {}) {
     stretch: !!c.stretch,
     uniform: !!c.uniform
   }));
-  const transform = (json.transform ?? []).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)),
@@ -4376,7 +4478,7 @@ function importSpine(json, atlasText, opts = {}) {
     mixScaleY: c.mixScaleY ?? c.mixScaleX ?? c.scaleMix ?? 1,
     mixShearY: c.mixShearY ?? c.shearMix ?? 1
   }));
-  const path = (json.path ?? []).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)),
@@ -4411,17 +4513,35 @@ function importSpine(json, atlasText, opts = {}) {
     for (let i = 0; i < frames.length; i++) {
       const f = frames[i], next = frames[i + 1], t = f.time ?? 0;
       const ease2 = next ? easeOf(f.curve, comp, t, next.time ?? 0, f[field] ?? def, next[field] ?? def) : "linear";
-      keys.push({ t: r4(t), v: r4(abs(f[field] ?? def)), ease: ease2 });
+      const curve = major >= 4 && Array.isArray(f.curve) ? f.curve.slice(comp * 4, comp * 4 + 4) : [];
+      const value = f[field] ?? def;
+      if (next && value === (next[field] ?? def) && curve.length === 4 && (curve[1] !== value || curve[3] !== value)) {
+        const cubic = (p0, p1, p2, p3, u) => (1 - u) ** 3 * p0 + 3 * (1 - u) ** 2 * u * p1 + 3 * (1 - u) * u * u * p2 + u ** 3 * p3;
+        const inner = Array.from({ length: 9 }, (_, k) => {
+          const u = (k + 1) / 10;
+          return { t: r4(cubic(t, curve[0], curve[2], next.time ?? 0, u)), v: r4(abs(cubic(value, curve[1], curve[3], value, u))), ease: "linear" };
+        });
+        if (inner.every((k, i2) => k.t > (i2 ? inner[i2 - 1].t : t) && k.t < (next.time ?? 0))) {
+          keys.push({ t: r4(t), v: r4(abs(value)), ease: "linear" }, ...inner);
+          continue;
+        }
+        warnings.push(`equal-endpoint ${field} curve at ${t}s has non-monotonic control times and could not be lowered`);
+      }
+      keys.push({ t: r4(t), v: r4(abs(value)), ease: ease2 });
     }
     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) => {
       for (const f of frames) duration = Math.max(duration, f.time ?? 0);
     };
+    if (a.physics) {
+      warnings.push(`${animName}: Spine physics timelines are not imported`);
+      for (const timelines of Object.values(a.physics)) for (const frames of Object.values(timelines)) seen(frames);
+    }
     for (const [boneName, tl] of Object.entries(a.bones ?? {})) {
       const sb = spineBones[boneIndexByName.get(boneName)];
       if (!sb) {
@@ -4462,19 +4582,22 @@ function importSpine(json, atlasText, opts = {}) {
         if (kind === "attachment") {
           attachmentFrames.set(slotName, frames);
           tracks.push(track("slot", id, "attachment", frames.map((f) => ({ t: r4(f.time ?? 0), v: f.name ? attachmentRef(slotName, f.name) : null, ease: "step" }))));
-        } else if (kind === "rgba" || kind === "color") {
+        } else if (["rgba", "color", "rgb", "rgba2", "rgb2"].includes(kind)) {
+          const setupAlpha = parseInt(hex8(spineSlots[slotIndexByName.get(slotName)].color).slice(7), 16) / 255;
+          const rgbOnly = kind === "rgb" || kind === "rgb2";
           const rgbaOf = (f) => {
-            const c = hex8(f.color);
-            return [0, 2, 4, 6].map((k) => parseInt(c.slice(1 + k, 3 + k), 16) / 255);
+            const c = hex8(f.color ?? f.light);
+            return [0, 2, 4, 6].map((k, i) => i === 3 && rgbOnly ? setupAlpha : parseInt(c.slice(1 + k, 3 + k), 16) / 255);
           };
+          if (kind.endsWith("2")) warnings.push(`${animName}/${slotName}: ${kind} light color imported; dark two-color tint is not supported`);
           tracks.push(track("slot", id, "color", frames.map((f, i) => {
             const rgba = rgbaOf(f), next = frames[i + 1];
-            return { t: r4(f.time ?? 0), v: rgba.map(r4), ease: next ? easeOf(f.curve, 0, f.time ?? 0, next.time ?? 0, rgba[0], rgbaOf(next)[0]) : "linear" };
-          })));
-        } else if (kind === "rgb") {
-          tracks.push(track("slot", id, "color", frames.map((f) => {
-            const c = hex8((f.color ?? "ffffff") + "ff");
-            return { t: r4(f.time ?? 0), v: [0, 2, 4, 6].map((k) => r4(parseInt(c.slice(1 + k, 3 + k), 16) / 255)), ease: "linear" };
+            return {
+              t: r4(f.time ?? 0),
+              v: rgba.map(r4),
+              ease: "linear",
+              ...next ? { componentEase: rgba.map((v, k) => rgbOnly && k === 3 ? "linear" : easeOf(f.curve, k, f.time ?? 0, next.time ?? 0, v, rgbaOf(next)[k])) } : {}
+            };
           })));
         } else if (kind === "alpha") tracks.push(track("slot", id, "alpha", numeric(frames, "value", 1, (v) => v, 0)));
         else warnings.push(`${animName}/${slotName}: ${kind} timeline skipped`);
@@ -4513,15 +4636,30 @@ function importSpine(json, atlasText, opts = {}) {
         warnings.push(`${animName}: deform of unknown attachment ${slotName}/${attName}`);
         continue;
       }
-      const length = att.weights ? 2 * att.weights.reduce((s2, l) => s2 + l.length, 0) : att.vertices?.length ?? 0;
+      const rawClip = skins.find((s2) => s2.name === skinName)?.attachments?.[slotName]?.[attName];
+      const clipData = clipDeforms.has(id) ? readVertices(rawClip, rawClip.vertexCount) : void 0;
+      const data = clipData ?? att;
+      const length = data.weights ? 2 * data.weights.reduce((s2, l) => s2 + l.length, 0) : data.vertices?.length ?? 0;
       tracks.push(track("deform", id, "vertices", frames.map((f, i) => {
         const full = new Array(length).fill(0);
         const off = f.offset ?? 0, vs = f.vertices ?? [];
         for (let k = 0; k < vs.length; k++) full[off + k] = (k + off) % 2 === 1 ? -vs[k] : vs[k];
         const next = frames[i + 1];
-        return { t: r4(f.time ?? 0), v: full.map(r4), ease: next ? easeOf(f.curve, 0, f.time ?? 0, next.time ?? 0, 0, 1) : "linear" };
+        return { t: r4(f.time ?? 0), v: (clipDeforms.get(id)?.(full) ?? full).map(r4), ease: next ? easeOf(f.curve, 0, f.time ?? 0, next.time ?? 0, 0, 1) : "linear" };
       })));
     }
+    for (let pass = 0; pass < inheritedDeform.size; pass++) {
+      let changed = false;
+      for (const [child, parent] of inheritedDeform) {
+        if (tracks.some((t) => t.target === "deform" && t.id === child)) continue;
+        const source = tracks.find((t) => t.target === "deform" && t.id === parent);
+        if (source) {
+          tracks.push({ ...source, id: child, keys: structuredClone(source.keys) });
+          changed = true;
+        }
+      }
+      if (!changed) break;
+    }
     const drawOrderFrames = a.drawOrder ?? a.draworder;
     if (Array.isArray(drawOrderFrames)) {
       seen(drawOrderFrames);
@@ -4544,20 +4682,25 @@ function importSpine(json, atlasText, opts = {}) {
     for (const [name, frames] of Object.entries(a.ik ?? {})) {
       seen(frames);
       const id = ikIds.get(name);
+      if (!ik.some((c) => c.id === id)) continue;
       tracks.push(track("ik", id, "mix", numeric(frames, "mix", 1, (v) => v, 0)));
       tracks.push(track("ik", id, "softness", numeric(frames, "softness", 0, (v) => v, 1)));
       tracks.push(track("ik", id, "bendPositive", frames.map((f) => ({ t: r4(f.time ?? 0), v: f.bendPositive ?? true ? 0 : 1, ease: "step" }))));
       tracks.push(track("ik", id, "compress", frames.map((f) => ({ t: r4(f.time ?? 0), v: f.compress ? 1 : 0, ease: "step" }))));
       tracks.push(track("ik", id, "stretch", frames.map((f) => ({ t: r4(f.time ?? 0), v: f.stretch ? 1 : 0, ease: "step" }))));
     }
-    const mixTrack = (target, id, frames, prop, old, comp) => track(target, id, prop, frames.map((f, i) => ({
-      t: r4(f.time ?? 0),
-      v: r4(f[prop] ?? f[old] ?? 1),
-      ease: frames[i + 1] ? easeOf(f.curve, comp, f.time ?? 0, frames[i + 1].time ?? 0, f[prop] ?? f[old] ?? 1, frames[i + 1][prop] ?? frames[i + 1][old] ?? 1) : "linear"
-    })));
+    const mixTrack = (target, id, frames, prop, old, comp) => {
+      const value = (f) => f[prop] ?? (prop === "mixY" ? f.mixX : prop === "mixScaleY" ? f.mixScaleX : void 0) ?? f[old] ?? 1;
+      return track(target, id, prop, frames.map((f, i) => ({
+        t: r4(f.time ?? 0),
+        v: r4(value(f)),
+        ease: frames[i + 1] ? easeOf(f.curve, comp, f.time ?? 0, frames[i + 1].time ?? 0, value(f), value(frames[i + 1])) : "linear"
+      })));
+    };
     for (const [name, frames] of Object.entries(a.transform ?? {})) {
       seen(frames);
       const id = tcIds.get(name);
+      if (!transform.some((c) => c.id === id)) continue;
       const props = [["mixRotate", "rotateMix", 0], ["mixX", "translateMix", 1], ["mixY", "translateMix", 2], ["mixScaleX", "scaleMix", 3], ["mixScaleY", "scaleMix", 4], ["mixShearY", "shearMix", 5]];
       for (const [prop, old, comp] of props) tracks.push(mixTrack("transform", id, frames, prop, old, comp));
     }
@@ -4565,6 +4708,7 @@ function importSpine(json, atlasText, opts = {}) {
       const id = pcIds.get(name);
       for (const [kind, frames] of Object.entries(tl)) {
         seen(frames);
+        if (!path.some((c) => c.id === id)) continue;
         if (kind === "position" || kind === "spacing") tracks.push(track("path", id, kind, numeric(frames, "value", 0, (v) => v, 0)));
         else if (kind === "mix") for (const [prop, old, comp] of [["mixRotate", "rotateMix", 0], ["mixX", "translateMix", 1], ["mixY", "translateMix", 2]])
           tracks.push(mixTrack("path", id, frames, prop, old, comp));
@@ -4669,7 +4813,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,
@@ -4722,26 +4866,33 @@ 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");
   const { pages } = parseAtlas(atlasText);
-  if (pages.length !== 1) throw new Error(`expected one atlas page, got ${pages.length}`);
-  const pageStem = join8(dirname6(atlasPath), pages[0].name.replace(/\.[a-z0-9]+$/i, ""));
-  const imagePath = opts.image ?? await firstExisting([join8(dirname6(atlasPath), pages[0].name), pageStem + ".png", pageStem + ".ktx2", stem + ".png", stem + ".ktx2"], "atlas page image");
+  if (!pages.length) throw new Error("atlas has no pages");
+  if (opts.image && pages.length !== 1) throw new Error("image override requires a single-page atlas; multi-page atlases resolve each named page beside the atlas");
   const rigDir = dirname6(opts.rigPath);
-  let pngPath = imagePath;
-  if (extname(imagePath).toLowerCase() === ".ktx2") {
-    pngPath = join8(rigDir, basename4(imagePath).replace(/\.ktx2$/i, ".png"));
-    if (!await exists(pngPath)) {
-      const { png } = await ktx2ToPng(new Uint8Array(await readFile7(imagePath)));
-      await writeFile5(pngPath, png);
+  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;
+    if (extname(imagePath).toLowerCase() === ".ktx2") {
+      pngPath = join8(rigDir, basename4(imagePath).replace(/\.ktx2$/i, ".png"));
+      if (!await exists(pngPath)) {
+        const { png } = await ktx2ToPng(new Uint8Array(await readFile7(imagePath)));
+        await writeFile5(pngPath, png);
+      }
     }
+    pagePaths.set(page2.name, pngPath);
   }
-  const pageImage = relative(rigDir, pngPath).split("\\").join("/");
+  const pageImage = (page2) => relative2(rigDir, pagePaths.get(page2)).split("\\").join("/");
   const name = opts.name ?? basename4(stem);
-  return { ...importSpine(json, atlasText, { name, pageImage, margin: opts.margin, notes: opts.notes }), imagePath: pngPath };
+  const imagePaths = [...pagePaths.values()];
+  return { ...importSpine(json2, atlasText, { name, skin: opts.skin, pageImage, margin: opts.margin, notes: opts.notes }), imagePath: imagePaths[0], imagePaths };
 }
 
 // src/rig-templates.ts
@@ -5274,13 +5425,14 @@ function attachToBone(doc, animation, bone, target, t) {
   if (Math.abs(to.a * to.d - to.b * to.c) < 1e-10) throw new Error("cannot attach to a singular target");
   const [x, y] = apply(invert(to), from.tx, from.ty);
   const id = `attach_${bone}_${target}`;
+  const handedness = to.a * to.d - to.b * to.c < 0 ? -1 : 1;
   const offset = {
     x,
     y,
-    rotation: wrap2(rotationOf(from) - rotationOf(to)),
+    rotation: wrap2(rotationOf(from) - rotationOf(to)) * handedness,
     scaleX: Math.hypot(from.a, from.b) - Math.hypot(to.a, to.b),
     scaleY: Math.hypot(from.c, from.d) - Math.hypot(to.c, to.d),
-    shearY: wrap2((Math.atan2(from.d, from.c) - Math.atan2(from.b, from.a) - Math.atan2(to.d, to.c) + Math.atan2(to.b, to.a)) * 180 / Math.PI)
+    shearY: wrap2((Math.atan2(from.d, from.c) - Math.atan2(from.b, from.a) - Math.atan2(to.d, to.c) + Math.atan2(to.b, to.a)) * 180 / Math.PI) * handedness
   };
   const order = Math.max(0, ...doc.ik.map((c) => c.order), ...doc.transform.map((c) => c.order), ...doc.path.map((c) => c.order)) + 1;
   let next = setConstraint(doc, "transform", id, { bones: [bone], target, order, ...offset, mixX: 0, mixY: 0, mixRotate: 0, mixScaleX: 0, mixScaleY: 0, mixShearY: 0 });
@@ -5430,8 +5582,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);
@@ -5543,10 +5695,11 @@ tool(
 var KeyIn = z3.object({
   t: z3.number().describe("seconds"),
   v: z3.union([z3.number(), z3.string(), z3.null(), z3.array(z3.number()), z3.array(z3.string())]),
+  componentEase: z3.array(Ease).min(1).optional().describe("optional independent easing per numeric-array component"),
   ease: Ease.optional().describe("into the next key: linear|step|ease_in|ease_out|ease_in_out|back_out|elastic_out|{bezier:[x1,y1,x2,y2]}; default ease_in_out; minimum_jerk for a rest-to-rest segment")
 });
 var roundKey = (k) => Array.isArray(k.v) && k.v.every((x) => typeof x === "number") ? { ...k, v: k.v.map(round6) } : k;
-var KEY_DOC = "Keys are {t, v, ease?}. Bone values are ABSOLUTE local-transform values, not offsets (rest x=4 \u2192 key v=0 moves it 4px); deform values are relative (0 = rest). bone: x|y|rotation|scaleX|scaleY|shearX|shearY; slot: alpha|attachment(asset id or null)|z; deform (3\xD73 mesh on the slot's image): bulge|bend|sway|squash (fractions of the image size, |v|\u22640.9/1) or p<row><col>x|y (px, rows/cols 0..2 top-left first). Some values are arrays: deform `vertices` keys are number arrays (2\xB7n offsets, or 2\xB7\u03A3influences for weighted meshes); drawOrder keys are slot-id arrays; slot color keys are [r,g,b,a].";
+var KEY_DOC = "Keys are {t, v, ease?, componentEase?}; componentEase selects independent easing for numeric-array components. Bone values are ABSOLUTE local-transform values, not offsets (rest x=4 \u2192 key v=0 moves it 4px); deform values are relative (0 = rest). bone: x|y|rotation|scaleX|scaleY|shearX|shearY; slot: alpha|attachment(asset id or null)|z; deform (3\xD73 mesh on the slot's image): bulge|bend|sway|squash (fractions of the image size, |v|\u22640.9/1) or p<row><col>x|y (px, rows/cols 0..2 top-left first). Some values are arrays: deform `vertices` keys are number arrays (2\xB7n offsets, or 2\xB7\u03A3influences for weighted meshes); drawOrder keys are slot-id arrays; slot color keys are [r,g,b,a].";
 tool(
   "rig_create",
   "Create a new empty rig document with a root bone at bottom-center.",
@@ -5670,19 +5823,20 @@ tool(
 );
 tool(
   "rig_import_spine",
-  "Import a Spine project (skeleton .json 3.8/4.x + .atlas + page image) as a new rig: bones, slots, region/mesh/path attachments with weights, IK / transform / path constraints and every animation (deform, draw order, colors), converted to this document's y-down space. The atlas may be plain or base64 text; a KTX2 page is transcoded to PNG next to rig.json. Then use rig_get / rig_render_preview / rig_check as with any rig.",
+  "Import a Spine project (skeleton .json 3.8/4.x + .atlas + page image) as a new rig: bones, slots, region/mesh/path attachments with weights, IK / transform / path constraints and every animation (deform, draw order, colors), converted to this document's y-down space. The atlas may be plain or base64 text; named pages resolve beside the atlas, and KTX2 pages transcode to PNG next to rig.json. Read warnings for unsupported physics and dark tint. Then use rig_get / rig_render_preview / rig_check as with any rig.",
   {
     path: Path,
     json: z3.string().describe("Spine skeleton .json, absolute or relative to rig.json dir"),
     atlas: z3.string().optional().describe("atlas file; default: <json>.atlas or <json>.atlas.txt"),
     image: z3.string().optional().describe("atlas page image (.png or .ktx2); default: the page named in the atlas, next to it"),
+    skin: z3.string().optional().describe("skin to flatten; default: default skin, or first skin if no default exists; no runtime skin switching"),
     name: z3.string().optional().describe("default: the json file name"),
     margin: z3.number().optional().describe("canvas margin around the skeleton bounds, px"),
     notes: z3.string().optional()
   },
-  async ({ path, json, atlas, image, name, 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, 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:
@@ -6454,40 +6608,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) {
@@ -6499,7 +6654,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
@@ -6508,7 +6663,7 @@ data: ${JSON.stringify({ version: v })}
 `);
       }, 50);
     };
-    version(abs).then((v) => {
+    rigVersion(abs).then((v) => {
       entry.last = v;
     });
     watchers.set(abs, entry);
@@ -6534,7 +6689,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);
@@ -6568,20 +6723,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);
@@ -6599,7 +6756,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;
@@ -6616,7 +6773,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
@@ -6638,7 +6795,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,
@@ -6647,8 +6804,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());
@@ -6659,11 +6823,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"));
@@ -6677,8 +6841,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;
@@ -6692,6 +6856,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", () => {
@@ -6702,11 +6882,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()));
   } };
 }