pixelkiln 0.70.1 → 0.72.0

package/dist/client/gallery.css

@@ -326,3 +326,18 @@ form.edit .pal { margin-top:4px; }
 .poses svg.pose { width:112px; height:112px; background:var(--panel-deep); border:1px solid var(--line); image-rendering:pixelated; }
 .poses figcaption { font:10.5px/1 var(--mono); color:var(--dim); }
 textarea.mono { font-family:var(--mono); font-size:11.5px; }
+.pose-editor { display:grid; grid-template-columns:minmax(200px, 320px) 1fr; gap:12px; align-items:start; margin-top:10px; }
+.pose-stage svg.stage { width:100%; aspect-ratio:1; background:var(--panel-deep); border:1px solid var(--line); image-rendering:pixelated; touch-action:none; display:block; }
+.pose-stage svg.stage:focus { outline:1px solid var(--accent); }
+.pose-stage .joint { cursor:grab; }
+.pose-stage .joint:active { cursor:grabbing; }
+.pose-side { display:grid; gap:8px; align-content:start; }
+.pose-tools { display:flex; flex-wrap:wrap; gap:6px; }
+.pose-tools button { font:11.5px/1 var(--mono); padding:6px 8px; }
+.pose-status { font:11.5px/1.45 var(--mono); color:var(--dim); }
+.pose-strip { grid-column:1 / -1; }
+.pose-strip button { flex:none; padding:3px; display:grid; gap:3px; justify-items:center; }
+.pose-strip button.on { border-color:var(--accent); }
+.pose-strip svg.pose { width:64px; height:64px; }
+.pose-strip span { font:10.5px/1 var(--mono); color:var(--dim); }
+@media (max-width: 640px) { .pose-editor { grid-template-columns:1fr; } }

package/dist/client/gallery.js

@@ -363,13 +363,22 @@
     prompt.placeholder = 'What the loop does, e.g. "a slow idle sway".';
     prompt.required = true;
     const mode = el("select");
-    if (isCharacter) mode.append(new Option("template", "template"));
+    if (isCharacter) {
+      mode.append(
+        new Option("skeleton-v3 (a template, posed by the skeleton model; steadiest)", "skeleton-v3"),
+        new Option("template (a template, redrawn; 1 generation)", "template")
+      );
+    }
     mode.append(new Option("v3 (text-described)", "v3"), new Option("pro (sequential, high quality)", "pro"));
-    mode.value = "v3";
+    mode.value = isCharacter ? "skeleton-v3" : "v3";
     const template = el("input");
     template.type = "text";
     template.placeholder = "e.g. walk, breathing-idle";
-    const templateField = field("template id", template, "A PixelLab template; costs 1 generation regardless of frame count.");
+    const templateHint = {
+      "skeleton-v3": "A PixelLab template posed onto the character by the skeleton model, which moves it instead of redrawing it: steadier identity and colours. 2 to 4 generations and 3 to 5 minutes per direction; beta, Tier 1 plans and up.",
+      template: "A PixelLab template, redrawn frame by frame; 1 generation regardless of frame count."
+    };
+    const templateField = field("template id", template, templateHint.template);
     const frames = el("input");
     frames.type = "number";
     frames.min = "4";
@@ -403,9 +412,11 @@
     form.append(row2);
     if (subject) form.append(field("subject override", subject));
     const syncMode = () => {
-      const isTemplate = isCharacter && mode.value === "template";
+      const isTemplate = isCharacter && (mode.value === "template" || mode.value === "skeleton-v3");
       templateField.style.display = isTemplate ? "" : "none";
+      if (isTemplate) templateField.querySelector("small").textContent = templateHint[mode.value];
       template.required = isTemplate;
+      prompt.required = !isTemplate;
       row2.style.display = isTemplate ? "none" : "";
     };
     if (isCharacter) {
@@ -433,8 +444,9 @@
       msg.textContent = "saving…";
       const animation = { of: item.assetId };
       if (directionField) animation.direction = directionField.select.value;
-      if (isCharacter && mode.value === "template" && template.value.trim()) {
+      if (isCharacter && (mode.value === "template" || mode.value === "skeleton-v3") && template.value.trim()) {
         animation.template = template.value.trim();
+        if (mode.value === "skeleton-v3") animation.mode = "skeleton-v3";
       } else {
         animation.mode = mode.value;
         if (frames.value.trim() !== "") animation.frames = Number(frames.value);
@@ -2107,6 +2119,291 @@
     return row2;
   }
 
+  // src/gallery/client/src/pose-editor.ts
+  var MIN_FRAMES = 3;
+  var MAX_FRAMES = 15;
+  var HISTORY = 100;
+  var NUDGE = 1 / 128;
+  var PLAY_MS = 125;
+  var clone = (set) => JSON.parse(JSON.stringify(set));
+  var clamp = (v) => Math.min(1, Math.max(0, Math.round(v * 1e3) / 1e3));
+  var mirrorLabel = (label) => label.startsWith("RIGHT ") ? "LEFT " + label.slice(6) : label.startsWith("LEFT ") ? "RIGHT " + label.slice(5) : label;
+  function poseEditor(initial, imageUrl, onChange) {
+    let set = clone(initial);
+    let index = set.frames.length ? 1 : 0;
+    let selected = null;
+    let playing = null;
+    const past = [];
+    const future = [];
+    const root = el("div", "pose-editor");
+    const stageWrap = el("div", "pose-stage");
+    const side = el("div", "pose-side");
+    const status = el("div", "pose-status");
+    const strip = el("div", "poses pose-strip");
+    const tools = el("div", "pose-tools");
+    side.append(tools, status);
+    root.append(stageWrap, side, strip);
+    const poseAt = (i) => i === 0 ? set.firstFrameKeypoints : set.frames[i - 1];
+    const count = () => set.frames.length + 1;
+    const name = (i) => i === 0 ? "start" : "frame " + i;
+    const remember = (before) => {
+      past.push(before);
+      if (past.length > HISTORY) past.shift();
+      future.length = 0;
+    };
+    const commit = (before) => {
+      if (JSON.stringify(set) === before) return;
+      remember(before);
+      onChange(clone(set));
+      drawStrip();
+      drawTools();
+    };
+    const edit = (change) => {
+      const before = JSON.stringify(set);
+      change();
+      commit(before);
+      drawStage();
+    };
+    let svg;
+    let joints = /* @__PURE__ */ new Map();
+    let bones = [];
+    function drawStage() {
+      stageWrap.textContent = "";
+      svg = svgEl("svg", { viewBox: "0 0 1 1", class: "pose stage", tabindex: 0 });
+      svg.setAttribute("aria-label", "Pose " + name(index) + ": drag joints, arrow keys nudge the selected one");
+      if (imageUrl) svg.append(svgEl("image", { href: imageUrl, x: 0, y: 0, width: 1, height: 1, preserveAspectRatio: "none" }));
+      if (index > 0) {
+        const prev = new Map(poseAt(index - 1).map((j) => [j.label, j]));
+        for (const [a, b] of SKELETON_BONES) {
+          const p = prev.get(a), q = prev.get(b);
+          if (p && q) svg.append(svgEl("line", { x1: p.x, y1: p.y, x2: q.x, y2: q.y, stroke: boneColor(b), "stroke-width": 0.012, opacity: 0.3, "stroke-linecap": "round" }));
+        }
+      }
+      const at = new Map(poseAt(index).map((j) => [j.label, j]));
+      joints = /* @__PURE__ */ new Map();
+      bones = [];
+      for (const [a, b] of SKELETON_BONES) {
+        const p = at.get(a), q = at.get(b);
+        if (!p || !q) continue;
+        const lines = [
+          svgEl("line", { x1: p.x, y1: p.y, x2: q.x, y2: q.y, stroke: "#000", "stroke-width": 0.03, "stroke-linecap": "round" }),
+          svgEl("line", { x1: p.x, y1: p.y, x2: q.x, y2: q.y, stroke: boneColor(b), "stroke-width": 0.015, "stroke-linecap": "round" })
+        ];
+        svg.append(...lines);
+        bones.push({ a, b, lines });
+      }
+      for (const j of poseAt(index)) {
+        const on = j.label === selected;
+        const ring = svgEl("circle", { cx: j.x, cy: j.y, r: on ? 0.034 : 0.026, fill: "#000" });
+        const dot = svgEl("circle", { cx: j.x, cy: j.y, r: on ? 0.022 : 0.016, fill: on ? "#fff" : boneColor(j.label) });
+        const hit = svgEl("circle", { cx: j.x, cy: j.y, r: 0.045, fill: "transparent", class: "joint" });
+        const title = svgEl("title", {});
+        title.textContent = j.label;
+        hit.append(title);
+        hit.addEventListener("pointerdown", (e) => startDrag(e, j.label));
+        svg.append(ring, dot, hit);
+        joints.set(j.label, [ring, dot, hit]);
+      }
+      svg.addEventListener("keydown", onKey);
+      stageWrap.append(svg);
+      drawStatus();
+    }
+    function place(label, x, y) {
+      for (const c of joints.get(label) || []) {
+        c.setAttribute("cx", String(x));
+        c.setAttribute("cy", String(y));
+      }
+      for (const bone of bones) {
+        for (const line of bone.lines) {
+          if (bone.a === label) {
+            line.setAttribute("x1", String(x));
+            line.setAttribute("y1", String(y));
+          }
+          if (bone.b === label) {
+            line.setAttribute("x2", String(x));
+            line.setAttribute("y2", String(y));
+          }
+        }
+      }
+    }
+    function toUnit(e) {
+      const m = svg.getScreenCTM();
+      if (!m) return { x: 0, y: 0 };
+      const p = new DOMPoint(e.clientX, e.clientY).matrixTransform(m.inverse());
+      return { x: clamp(p.x), y: clamp(p.y) };
+    }
+    function startDrag(e, label) {
+      if (playing) return;
+      e.preventDefault();
+      const before = JSON.stringify(set);
+      const joint = poseAt(index).find((j) => j.label === label);
+      const target = e.target;
+      target.setPointerCapture(e.pointerId);
+      const wasSelected = selected;
+      selected = label;
+      if (wasSelected !== label) {
+        for (const [l, [ring, dot]] of joints) {
+          const on = l === label;
+          ring.setAttribute("r", String(on ? 0.034 : 0.026));
+          dot.setAttribute("r", String(on ? 0.022 : 0.016));
+          dot.setAttribute("fill", on ? "#fff" : boneColor(l));
+        }
+      }
+      const move = (ev) => {
+        const { x, y } = toUnit(ev);
+        joint.x = x;
+        joint.y = y;
+        place(label, x, y);
+        drawStatus();
+      };
+      const end = () => {
+        target.removeEventListener("pointermove", move);
+        target.removeEventListener("pointerup", end);
+        target.removeEventListener("pointercancel", end);
+        commit(before);
+        svg.focus({ preventScroll: true });
+      };
+      target.addEventListener("pointermove", move);
+      target.addEventListener("pointerup", end);
+      target.addEventListener("pointercancel", end);
+      drawStatus();
+    }
+    function onKey(e) {
+      if ((e.ctrlKey || e.metaKey) && e.key.toLowerCase() === "z") {
+        e.preventDefault();
+        if (e.shiftKey) redo();
+        else undo();
+        return;
+      }
+      if (e.key === ",") {
+        e.preventDefault();
+        go(index - 1);
+        return;
+      }
+      if (e.key === ".") {
+        e.preventDefault();
+        go(index + 1);
+        return;
+      }
+      const step2 = (e.shiftKey ? 4 : 1) * NUDGE;
+      const d = { ArrowLeft: [-step2, 0], ArrowRight: [step2, 0], ArrowUp: [0, -step2], ArrowDown: [0, step2] }[e.key];
+      if (!d || !selected || playing) return;
+      e.preventDefault();
+      const label = selected;
+      edit(() => {
+        const joint = poseAt(index).find((j) => j.label === label);
+        joint.x = clamp(joint.x + d[0]);
+        joint.y = clamp(joint.y + d[1]);
+      });
+      svg.focus({ preventScroll: true });
+    }
+    function undo() {
+      const before = past.pop();
+      if (!before) return;
+      future.push(JSON.stringify(set));
+      set = JSON.parse(before);
+      index = Math.min(index, count() - 1);
+      onChange(clone(set));
+      redraw();
+    }
+    function redo() {
+      const next = future.pop();
+      if (!next) return;
+      past.push(JSON.stringify(set));
+      set = JSON.parse(next);
+      index = Math.min(index, count() - 1);
+      onChange(clone(set));
+      redraw();
+    }
+    function go(i) {
+      if (i < 0 || i >= count()) return;
+      index = i;
+      redraw();
+      svg.focus({ preventScroll: true });
+    }
+    const button = (label, title, onClick, disabled = false) => {
+      const b = el("button", null, label);
+      b.type = "button";
+      b.title = title;
+      b.disabled = disabled || !!playing && label !== "Stop";
+      b.onclick = onClick;
+      return b;
+    };
+    function drawTools() {
+      tools.textContent = "";
+      const frameOnly = index === 0;
+      tools.append(
+        button("◀", "Previous pose (,)", () => go(index - 1), index === 0),
+        button("▶", "Next pose (.)", () => go(index + 1), index >= count() - 1),
+        button(playing ? "Stop" : "Play", "Play the frames in a loop", () => togglePlay(), set.frames.length < 2 && !playing),
+        button("Copy previous", "Replace this pose with the one before it", () => edit(() => {
+          set.frames[index - 1] = poseAt(index - 1).map((j) => ({ ...j }));
+        }), frameOnly),
+        button("Mirror", "Flip this pose left to right, swapping left and right joints", () => edit(() => {
+          const flipped = poseAt(index).map((j) => ({ ...j, label: mirrorLabel(j.label), x: clamp(1 - j.x) }));
+          if (index === 0) set.firstFrameKeypoints = flipped;
+          else set.frames[index - 1] = flipped;
+        })),
+        button("+ Frame", "Add a copy of this pose after it", () => edit(() => {
+          set.frames.splice(index, 0, poseAt(index).map((j) => ({ ...j })));
+          index += 1;
+        }), set.frames.length >= MAX_FRAMES),
+        button("− Frame", "Remove this frame", () => edit(() => {
+          set.frames.splice(index - 1, 1);
+          index = Math.min(index, count() - 1);
+        }), frameOnly || set.frames.length <= MIN_FRAMES),
+        button("Undo", "Undo (Ctrl+Z)", undo, !past.length),
+        button("Redo", "Redo (Ctrl+Shift+Z)", redo, !future.length)
+      );
+    }
+    function togglePlay() {
+      if (playing) {
+        clearInterval(playing);
+        playing = null;
+        redraw();
+        return;
+      }
+      let i = index > 0 ? index : 1;
+      playing = setInterval(() => {
+        if (!root.isConnected) {
+          clearInterval(playing);
+          playing = null;
+          return;
+        }
+        i = i >= count() - 1 ? 1 : i + 1;
+        index = i;
+        drawStage();
+        drawStrip();
+      }, PLAY_MS);
+      drawTools();
+    }
+    function drawStatus() {
+      const j = selected && poseAt(index).find((x) => x.label === selected);
+      status.textContent = name(index) + " of " + set.frames.length + " frames" + (j ? " · " + j.label + " (" + j.x.toFixed(3) + ", " + j.y.toFixed(3) + ")" : " · drag a joint to move it") + (index === 0 ? " · the starting pose must match the sprite as drawn" : "");
+    }
+    function drawStrip() {
+      strip.textContent = "";
+      for (let i = 0; i < count(); i++) {
+        const cell = el("button", i === index ? "on" : null);
+        cell.type = "button";
+        cell.title = name(i);
+        cell.append(poseSvg(poseAt(i), imageUrl, i > 0), el("span", null, i === 0 ? "start" : String(i)));
+        const target = i;
+        cell.onclick = () => {
+          if (!playing) go(target);
+        };
+        strip.append(cell);
+      }
+    }
+    function redraw() {
+      drawStage();
+      drawStrip();
+      drawTools();
+    }
+    redraw();
+    return root;
+  }
+
   // src/gallery/client/src/skeleton.ts
   var SKELETON_BONES = [
     ["NOSE", "NECK"],
@@ -2260,7 +2557,7 @@
     const preview = el("div");
     const row2 = el("div", "row");
     row2.append(field("poses from", source), field("keypoints file", file, "Inside the project. The manifest records this path."));
-    form.append(row2, estimateRow, field("poses (JSON)", json, "Move joints frame by frame; x and y are fractions of the sprite."), overwriteField, status, preview);
+    form.append(row2, estimateRow, field("poses (JSON)", json, "Drag joints in the editor below, or edit the JSON; x and y are fractions of the sprite."), overwriteField, status, preview);
     const imageUrl = displayUrl(item);
     let set = null;
     const showPoses = () => {
@@ -2286,7 +2583,10 @@
         set = null;
         return;
       }
-      preview.append(poseStrip(set, imageUrl));
+      preview.append(poseEditor(set, imageUrl, (next) => {
+        set = next;
+        json.value = JSON.stringify(next, null, 2);
+      }));
     };
     const sync = () => {
       const pasting = source.value !== "file";
@@ -2373,6 +2673,51 @@
     setTimeout(() => id.focus(), 0);
     return form;
   }
+  function skeletonPoseForm(item, parentUrl) {
+    const form = el("form", "edit");
+    form.append(el("h3", null, "Edit poses of " + item.assetId));
+    let draft = item.skeleton.set;
+    let dirty = false;
+    const msg = el("span", "msg");
+    const save = el("button", "primary", "Save poses");
+    save.type = "submit";
+    save.disabled = true;
+    form.append(poseEditor(draft, parentUrl, (next) => {
+      draft = next;
+      dirty = true;
+      save.disabled = false;
+      msg.className = "msg";
+      msg.textContent = "unsaved";
+    }));
+    form.append(el("small", "state-dim", "Saving rewrites " + item.skeleton.keypointsFile + "; the animation is then stale until it is generated again."));
+    const cancel = el("button", null, "Cancel");
+    cancel.type = "button";
+    cancel.onclick = () => {
+      if (dirty && !confirm("Discard the pose changes?")) return;
+      ui.editing = null;
+      renderDrawer();
+    };
+    const actions = el("div", "actions");
+    actions.append(save, cancel, msg);
+    form.append(actions);
+    form.onsubmit = async (e) => {
+      e.preventDefault();
+      save.disabled = true;
+      msg.className = "msg";
+      msg.textContent = "saving…";
+      const body = { action: "update-skeleton-keypoints", styleId: item.styleId, assetId: item.assetId, expectedSha256: item.skeleton.sha256, set: draft };
+      if (item.project) body.project = item.project;
+      try {
+        S.snap = await postEdit(body);
+        ui.editing = null;
+        ui.notice = { id: item.id, text: "Poses saved to " + item.skeleton.keypointsFile + ". " + nextStep().replace("it", "the animation") };
+        render();
+      } catch (err) {
+        showSaveError(msg, save, err);
+      }
+    };
+    return form;
+  }
 
   // src/gallery/client/src/drawer.ts
   function row(dl, label, value, opts = {}) {
@@ -2737,8 +3082,23 @@
         row(dl, "keypoints", item.skeleton.keypointsFile, { mono: true });
         if (item.skeleton.set) {
           const parent = S.snap.items.find((i) => i.key === item.revisionParentKey && i.project === item.project);
-          s.append(poseStrip(item.skeleton.set, displayUrl(parent)));
-          s.append(el("small", "state-dim", "The starting pose must match the sprite; each frame is drawn over a dimmed copy. `pixelkiln skeleton-preview " + item.assetId + "` writes the same sheet as a PNG."));
+          const posesKey = "poses:" + item.id;
+          if (ui.editing === posesKey) {
+            s.append(skeletonPoseForm(item, displayUrl(parent)));
+          } else {
+            s.append(poseStrip(item.skeleton.set, displayUrl(parent)));
+            s.append(el("small", "state-dim", "The starting pose must match the sprite; each frame is drawn over a dimmed copy. `pixelkiln skeleton-preview " + item.assetId + "` writes the same sheet as a PNG."));
+            if (canEdit && item.skeleton.sha256) {
+              const b = el("button", "add", "Edit poses");
+              b.type = "button";
+              b.onclick = () => {
+                ui.editing = posesKey;
+                ui.notice = null;
+                renderDrawer();
+              };
+              s.append(b);
+            }
+          }
         } else {
           row(dl, "poses", el("span", "state-warn", "the keypoints file does not exist yet"));
         }

package/dist/index.cjs

@@ -449,7 +449,7 @@ var CharacterProportionsSchema = import_zod.z.union([
     hipWidth: import_zod.z.number().min(0.5).max(2).optional()
   }).strict()
 ]);
-var CharacterAnimationModeSchema = import_zod.z.enum(["template", "v3", "pro"]);
+var CharacterAnimationModeSchema = import_zod.z.enum(["template", "skeleton-v3", "v3", "pro"]);
 var UiPieceSchema = import_zod.z.discriminatedUnion("kind", [
   import_zod.z.object({
     id: import_zod.z.string().min(1),
@@ -563,7 +563,11 @@ var CharacterAnimationSchema = import_zod.z.object({
   fps: import_zod.z.number().int().min(1).max(60).default(8),
   /** v3 only: keep the resting pose as frame 0, so `frames` generated frames land as `frames + 1` files. */
   keepFirstFrame: import_zod.z.boolean().default(true),
-  /** `template` when a template is named, otherwise `v3`; `pro` for the sequential high-quality engine. */
+  /**
+   * `template` when a template is named, otherwise `v3`; `skeleton-v3`
+   * poses a template with PixelLab's skeleton model instead; `pro` for the
+   * sequential high-quality engine.
+   */
   mode: CharacterAnimationModeSchema.optional(),
   /**
    * v3 only: a manifest-relative image of the pose to start from, instead
@@ -600,7 +604,7 @@ var CharacterAnimationSchema = import_zod.z.object({
     if (animation[key] !== void 0 && mode2 !== "v3") {
       context.addIssue({
         code: import_zod.z.ZodIssueCode.custom,
-        message: `${key} is for v3 loops; a ${mode2} loop ${mode2 === "template" ? "starts from the character's rotation and follows its template" : "takes neither"}`,
+        message: `${key} is for v3 loops; a ${mode2} loop ${mode2 === "template" || mode2 === "skeleton-v3" ? "starts from the character's rotation and follows its template" : "takes neither"}`,
         path: [key]
       });
     }
@@ -610,10 +614,10 @@ var CharacterAnimationSchema = import_zod.z.object({
       context.addIssue({ code: import_zod.z.ZodIssueCode.custom, message: `${key} overrides apply to template loops only`, path: [key] });
     }
   }
-  if (animation.template && animation.mode && animation.mode !== "template") {
+  if (animation.template && animation.mode && animation.mode !== "template" && animation.mode !== "skeleton-v3") {
     context.addIssue({
       code: import_zod.z.ZodIssueCode.custom,
-      message: `a template animation cannot use mode "${animation.mode}"`,
+      message: `a template animation cannot use mode "${animation.mode}"; use "template" or "skeleton-v3"`,
       path: ["mode"]
     });
   }
@@ -624,8 +628,8 @@ var CharacterAnimationSchema = import_zod.z.object({
       path: ["frames"]
     });
   }
-  if (!animation.template && animation.mode === "template") {
-    context.addIssue({ code: import_zod.z.ZodIssueCode.custom, message: "template mode needs a template", path: ["template"] });
+  if (!animation.template && (animation.mode === "template" || animation.mode === "skeleton-v3")) {
+    context.addIssue({ code: import_zod.z.ZodIssueCode.custom, message: `${animation.mode} mode needs a template`, path: ["template"] });
   }
 });
 var RevisionDitheringSchema = import_zod.z.enum(["none", "2x2", "4x4", "8x8"]);
@@ -2559,12 +2563,20 @@ var PixelLabClient = class {
   }
   /**
    * One animation of one character. Template mode costs a generation per
-   * direction and fixes the frame count; v3 draws `frameCount` frames from
-   * the action text; pro is the sequential engine. One job per direction.
+   * direction and fixes the frame count; skeleton-v3 poses the same template
+   * with the skeleton video model (2-4 generations per direction); v3 draws
+   * `frameCount` frames from the action text; pro is the sequential engine.
+   * One job per direction.
+   *
+   * Every mode but skeleton-v3 goes to `/animate-character`, the path whose
+   * shapes were measured live. skeleton-v3 is documented only on
+   * `/characters/animations`, which takes the same request and answers with
+   * the same job list (plus an `animation_group_id`).
    */
   async animateCharacter(args) {
     const encode = (image) => ({ type: "base64", base64: image.base64, format: image.format });
-    const raw = await this.request("/animate-character", {
+    const endpoint = args.mode === "skeleton-v3" ? "/characters/animations" : "/animate-character";
+    const raw = await this.request(endpoint, {
       method: "POST",
       body: JSON.stringify({
         character_id: args.characterId,
@@ -2588,7 +2600,7 @@ var PixelLabClient = class {
         ...args.seed != null ? { seed: args.seed } : {}
       })
     });
-    return validateResponse(AnimateSubmitSchema, raw, "animate-character");
+    return validateResponse(AnimateSubmitSchema, raw, endpoint.slice(1));
   }
   /**
    * A full-body sprite in, a bust portrait out (or the reverse, unused
@@ -3881,6 +3893,7 @@ function characterCost(spec) {
   if (character.kind === "animation") {
     const animation = character.animation;
     if (animation.mode === "template") return 1;
+    if (animation.mode === "skeleton-v3") return 4;
     if (animation.mode === "v3") return Math.max(1, Math.ceil(px * animation.frames / 65536));
     return generationCost(spec.width, spec.height, "1dir");
   }
@@ -4473,7 +4486,7 @@ var PixelLabProvider = class _PixelLabProvider {
           `${spec.styleId}/${spec.assetId} animates "${character.animation.direction}", but its character has ${character.directions} directions: ${allowed.join(", ")}`
         );
       }
-      if (character.animation.mode !== "template" && !spec.prompt.trim()) {
+      if (character.animation.mode !== "template" && character.animation.mode !== "skeleton-v3" && !spec.prompt.trim()) {
         throw new Error(`${spec.styleId}/${spec.assetId} needs a prompt describing the motion, or a template`);
       }
     }
@@ -9401,8 +9414,8 @@ async function resolveObjectProShape(assetId, asset, style, kind, files) {
         );
       }
     }
-    if (asset.animation.mode === "template") {
-      throw new Error(`assets.${assetId}: objectPro animations have no "template" mode; use "v3" or "pro"`);
+    if (asset.animation.mode === "template" || asset.animation.mode === "skeleton-v3") {
+      throw new Error(`assets.${assetId}: objectPro animations have no "${asset.animation.mode}" mode; use "v3" or "pro"`);
     }
     const pose = async (rel, what) => {
       const image = await files.load(rel, what);
@@ -15947,6 +15960,15 @@ var SkeletonAnimationRequestSchema = import_zod10.z.object({
   /** Replace an existing `keypointsFile` with `set`. */
   overwrite: import_zod10.z.boolean().optional()
 }).strict();
+var SkeletonKeypointsUpdateSchema = import_zod10.z.object({
+  action: import_zod10.z.literal("update-skeleton-keypoints"),
+  project: import_zod10.z.string().min(1).optional(),
+  styleId: import_zod10.z.string().min(1),
+  assetId: import_zod10.z.string().min(1),
+  /** The file's SHA-256 when the page loaded it; anything else on disk is a concurrent edit. */
+  expectedSha256: import_zod10.z.string().regex(/^[0-9a-f]{64}$/),
+  set: SkeletonSetSchema
+}).strict();
 async function createSkeletonAnimation(manifestPath, request) {
   const root = import_node_path29.default.dirname(import_node_path29.default.resolve(manifestPath));
   const file = import_node_path29.default.resolve(root, request.keypointsFile);
@@ -15992,6 +16014,26 @@ async function createSkeletonAnimation(manifestPath, request) {
     throw error;
   }
 }
+async function updateSkeletonKeypoints(ctx, request) {
+  const key = lockKey(request.styleId, request.assetId);
+  const spec = ctx.specs.find((candidate) => lockKey(candidate.styleId, candidate.assetId) === key);
+  if (!spec) throw new ManifestEditError(`"${key}" is not declared by the manifest`);
+  const file = spec.revision?.mode === "animate-skeleton" ? spec.revision.keypointsFile : void 0;
+  if (!file) throw new ManifestEditError(`${key} is not an animate-skeleton revision`);
+  const relative = import_node_path29.default.relative(ctx.loaded.root, file);
+  if (relative.startsWith("..") || import_node_path29.default.isAbsolute(relative)) {
+    throw new ManifestEditError(`${key}'s keypoints file is outside the project; edit it by hand`);
+  }
+  const current = (0, import_node_fs25.existsSync)(file) ? sha256(await (0, import_promises22.readFile)(file)) : null;
+  if (current !== request.expectedSha256) {
+    throw Object.assign(
+      new Error(`${relative.split(import_node_path29.default.sep).join("/")} changed on disk since this page loaded it; press Refresh and edit again`),
+      { status: 409 }
+    );
+  }
+  await (0, import_promises22.writeFile)(file, JSON.stringify(request.set, null, 2) + "\n");
+  return relative.split(import_node_path29.default.sep).join("/");
+}
 
 // src/gallery/edit.ts
 var Base64 = import_zod11.z.string().regex(/^[A-Za-z0-9+/]*={0,2}$/).max(Math.ceil(MAX_HAND_EDIT_BYTES / 3) * 4);
@@ -16068,6 +16110,18 @@ function createGalleryEditHandler(opts) {
       }
       return opts.reload();
     }
+    const poses = SkeletonKeypointsUpdateSchema.safeParse(body);
+    if (poses.success) {
+      if (!opts.loadProject) throw new ManifestEditError("pose edits are not available in this gallery");
+      const written = await updateSkeletonKeypoints(await opts.loadProject(poses.data.project), poses.data);
+      log(`  poses saved: ${written} (${poses.data.styleId}/${poses.data.assetId} is stale until generated again)`);
+      return opts.reload();
+    }
+    if (body?.action === "update-skeleton-keypoints") {
+      throw new ManifestEditError(
+        "invalid pose edit: " + poses.error.issues.slice(0, 3).map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")
+      );
+    }
     const skeleton = SkeletonAnimationRequestSchema.safeParse(body);
     if (skeleton.success) {
       let manifestPath2;
@@ -16441,7 +16495,8 @@ async function buildGallerySnapshot(opts) {
       mirrorOfKey: spec.mirror ? lockKey(spec.styleId, spec.mirror.sourceAssetId) : entry?.mirror ? lockKey(spec.styleId, entry.mirror.sourceAssetId) : null,
       skeleton: spec.revision?.mode === "animate-skeleton" && spec.revision.keypointsFile ? {
         keypointsFile: portableOutputPath(spec.revision.keypointsFile, root),
-        set: spec.revision.skeleton ?? null
+        set: spec.revision.skeleton ?? null,
+        sha256: spec.revision.keypointsSha256 ?? null
       } : null,
       character: describeCharacter(spec, entry),
       outputs,