pixelkiln 0.71.0 → 0.72.0

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);

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);