pixelkiln 0.46.1 → 0.47.1

package/README.md

@@ -54,6 +54,7 @@ provenance and no long-lived npm token.
 | Generate and review | Resumable submit/poll/pick/fetch pipeline, exact next-step hints, candidate or atomic frame-set review, and a provenance gallery that can edit intent, generate under a budget, and compare records. |
 | Hand edits | Touch-ups in your own editor or a pinned in-browser Pixelorama, kept beside the generated art with the generation still the record; frame and tile sets member by member. |
 | Controlled inputs | Hashed image-to-image/inpaint lineage, fail-closed parent approval, source-versus-candidate review, and content-addressed per-asset ComfyUI bindings. |
+| Characters | A base in 4 or 8 directions from a prompt or your own sprite (four PixelLab engines), poses and loops as dependent assets generated in waves, free mirrored directions, account adoption, and SpriteFrames export. |
 | Existing-art onboarding | Manifest scaffolding, exact-hash account adoption, and prompt recovery. |
 | Recovery | Safe stale-output replacement, validated caches, durable references, resumable paid jobs, and per-asset generation history with free restores. |
 | Shared-account safety | Cross-project claim files or a registered workspace catalog, sibling-style exclusion, reviewed salvage, keep/discard tags, separate confirmed purge. |
@@ -177,8 +178,8 @@ packaging layer.
   "styles": {
     "base": {
       "generator": "map",
-      "promptPrefix": "Pixel-art game prop: ",
-      "promptSuffix": ", isolated, transparent background",
+      "promptPrefix": "pixel-art game prop",
+      "promptSuffix": "isolated, transparent background",
       "outDir": "assets/generated/base",
       "tags": ["my-game"]
     }
@@ -390,9 +391,8 @@ package share one source. Policies: [Contributing](./CONTRIBUTING.md),
 
 ## Scope
 
-Salvaging characters, and PixelLab's portrait and outfit tools, are not
-implemented. Cross-project content-cache reuse and `workspace find`
-are deferred. See the open [roadmap issues](https://github.com/gfargo/pixelkiln/issues).
+Salvaging characters, PixelLab's portrait and outfit tools, cross-project
+cache reuse, and `workspace find` are not implemented; see the open [issues](https://github.com/gfargo/pixelkiln/issues).
 
 ## License
 

package/dist/cli.js

@@ -5641,6 +5641,10 @@ function pixelLabObjectUrl(generator, objectId) {
     const setId = objectId.split("#")[0];
     return setId ? `https://www.pixellab.ai/maps/tiles/${encodeURIComponent(setId)}` : null;
   }
+  if (generator === "character") {
+    const characterId = objectId.split("#")[0];
+    return characterId ? `https://www.pixellab.ai/create-character/${encodeURIComponent(characterId)}` : null;
+  }
   return null;
 }
 function characterCost(spec) {
@@ -14597,15 +14601,27 @@ function packSprites(inputs, options = {}) {
   const sheetH = rows * cellH;
   const rgba = Buffer.alloc(sheetW * sheetH * 4);
   const frames = [];
+  const pivot = options.pivot ?? "top-left";
   sprites.forEach((sprite, i) => {
-    const ox = i % columns * cellW;
-    const oy = Math.floor(i / columns) * cellH;
+    const cellOx = i % columns * cellW;
+    const cellOy = Math.floor(i / columns) * cellH;
+    const offsetX = pivot === "bottom-center" ? Math.floor((cellW - sprite.width) / 2) : 0;
+    const offsetY = pivot === "bottom-center" ? cellH - sprite.height : 0;
+    const ox = cellOx + offsetX;
+    const oy = cellOy + offsetY;
     for (let y = 0; y < sprite.height; y++) {
       const src = y * sprite.width * 4;
       const dst = ((oy + y) * sheetW + ox) * 4;
       sprite.pixels.copy(rgba, dst, src, src + sprite.width * 4);
     }
-    frames.push({ id: sprite.id, x: ox, y: oy, width: sprite.width, height: sprite.height });
+    frames.push({
+      id: sprite.id,
+      x: ox,
+      y: oy,
+      width: sprite.width,
+      height: sprite.height,
+      ...offsetX || offsetY ? { offsetX, offsetY } : {}
+    });
   });
   return {
     png: encodeRgbaPng(sheetW, sheetH, rgba),
@@ -15122,12 +15138,15 @@ function renderAsepriteSheet(atlas, opts) {
   }
   const frames = {};
   for (const frame of atlas.frames) {
+    const offsetX = frame.offsetX ?? 0;
+    const offsetY = frame.offsetY ?? 0;
+    const pivoted = offsetX !== 0 || offsetY !== 0;
     frames[frame.id] = {
       frame: { x: frame.x, y: frame.y, w: frame.width, h: frame.height },
       rotated: false,
-      trimmed: false,
-      spriteSourceSize: { x: 0, y: 0, w: frame.width, h: frame.height },
-      sourceSize: { w: frame.width, h: frame.height },
+      trimmed: pivoted,
+      spriteSourceSize: pivoted ? { x: offsetX, y: offsetY, w: frame.width, h: frame.height } : { x: 0, y: 0, w: frame.width, h: frame.height },
+      sourceSize: pivoted ? { w: atlas.cell.width, h: atlas.cell.height } : { w: frame.width, h: frame.height },
       duration: durations.get(frame.id) ?? ASEPRITE_DEFAULT_DURATION_MS
     };
   }
@@ -15232,16 +15251,18 @@ async function runPack(args) {
   const manifestDir = path38.dirname(path38.resolve(args.manifest));
   const styleIds = args.styles.length ? args.styles : Object.keys(loaded.manifest.styles);
   for (const styleId of styleIds) {
+    const style = loaded.manifest.styles[styleId];
+    const pivot = style?.generator === "character" ? "bottom-center" : "top-left";
     const packagingSpecs = await resolveSpecs(loaded, { styles: [styleId] });
     const qualitySources = await requireApprovedQualitySources(packagingSpecs, lock);
     const { png, atlas, skipped, sources } = packStyle(lock, styleId, manifestDir, {
       columns: args.columns,
       outputRoles: args.outputRoles,
       primaryOnly: args.primaryOnly,
+      pivot,
       sourceOverrides: qualitySources,
       sources: manifestSources(loaded.manifest, styleId)
     });
-    const style = loaded.manifest.styles[styleId];
     const base = args.out ? path38.resolve(args.out.replace(/\.(?:png|json|tres)$/i, "")) : path38.resolve(manifestDir, style.outDir, `${styleId}-sheet`);
     const format = sheetFormat(args);
     const { extension, document } = renderSheetDocument(format, atlas, { imageName: path38.basename(`${base}.png`) });
@@ -15268,6 +15289,7 @@ async function runPack(args) {
         format,
         order: "id",
         outputRoles: [...args.outputRoles].sort(),
+        pivot,
         primaryOnly: args.primaryOnly,
         style: styleId
       }