pixelkiln 0.29.0 → 0.31.0

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import path30 from "path";
-import { existsSync as existsSync23 } from "fs";
+import { existsSync as existsSync24 } from "fs";
 import { readFile as readFile25 } from "fs/promises";
 
 // src/env.ts
@@ -3478,10 +3478,11 @@ registerProvider({
 
 // src/manifest.ts
 import { readFile as readFile3 } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import path6 from "path";
 
 // src/outputs.ts
+import { existsSync as existsSync4 } from "fs";
 import path5 from "path";
 
 // src/lock.ts
@@ -3678,12 +3679,15 @@ function memberPath(file, role, index, total, mediaType) {
   const safeRole = (role ?? fallbackOutputRole(index)).replace(/[^a-zA-Z0-9_-]+/g, "-");
   return `${stem}-${safeRole}${ext}`;
 }
-function isFrameSetEntry(entry) {
-  return entry.generator === "frames" && entry.outputs.length > 1;
+function isMemberSetEntry(entry) {
+  return entry.outputs.length > 1 && entry.outputs.every((output) => !output.mediaType || output.mediaType === "image/png");
+}
+function sourceIsStem(source, entry, manifestDir) {
+  return isMemberSetEntry(entry) && !existsSync4(path5.resolve(manifestDir, source));
 }
 function sourceOutputPath(source, entry, index, manifestDir) {
   const absolute = path5.resolve(manifestDir, source);
-  if (!isFrameSetEntry(entry)) return absolute;
+  if (!sourceIsStem(source, entry, manifestDir)) return absolute;
   const output = entry.outputs[index];
   return memberPath(absolute, output.role, index, entry.outputs.length, output.mediaType);
 }
@@ -3771,7 +3775,7 @@ function resolveSpecOutputs(spec, lock, manifestDir) {
 // src/manifest.ts
 async function loadManifest(manifestPath) {
   const abs = path6.resolve(manifestPath);
-  if (!existsSync4(abs)) throw new Error(`No manifest at ${abs}`);
+  if (!existsSync5(abs)) throw new Error(`No manifest at ${abs}`);
   const input = ManifestInputSchema.safeParse(JSON.parse(await readFile3(abs, "utf8")));
   if (!input.success) {
     const issues = formatManifestIssues(input.error.issues);
@@ -3943,7 +3947,7 @@ async function resolveSpecs(loaded, filter) {
     const abs = path6.resolve(root, rel);
     let hit = styleImageCache.get(abs);
     if (!hit) {
-      if (!existsSync4(abs)) throw new Error(`Style image not found: ${abs}`);
+      if (!existsSync5(abs)) throw new Error(`Style image not found: ${abs}`);
       const buf = await readFile3(abs);
       const metadata = imageMetadata(buf);
       if (!metadata) throw new Error(`Style image is not a readable PNG or JPEG: ${abs}`);
@@ -4184,7 +4188,7 @@ function pngPath(file) {
   return extension ? `${file.slice(0, -extension.length)}.png` : `${file}.png`;
 }
 async function optionalRevisionImage(file, label, requiredFormat) {
-  if (!existsSync4(file)) return null;
+  if (!existsSync5(file)) return null;
   const bytes = await readFile3(file);
   const metadata = imageMetadata(bytes);
   if (!metadata) throw new Error(`${label} is not a readable PNG or JPEG: ${file}`);
@@ -4349,7 +4353,7 @@ function packStyle(lock, styleId, manifestDir, options = {}) {
       inputs.push({ id, path: path7.resolve(manifestDir, source) });
       continue;
     }
-    if (source && isFrameSetEntry(entry)) {
+    if (source && sourceIsStem(source, entry, manifestDir)) {
       outputs = outputs.map((output) => ({ ...output, absolutePath: sourceOutputPath(source, entry, output.index, manifestDir) }));
     }
     let selected = outputs;
@@ -4474,7 +4478,7 @@ function mountStyle(lock, styleId, manifestDir, mount, cells, sources = {}, outp
     const cell = cells[id];
     const source = sources[id];
     const entry = lock.entries[`${styleId}/${id}`];
-    if (source && !(entry && isFrameSetEntry(entry))) {
+    if (source && !(entry && sourceIsStem(source, entry, manifestDir))) {
       placements.push({ id, path: path7.resolve(manifestDir, source), cell });
       continue;
     }
@@ -4528,11 +4532,11 @@ function mountStyle(lock, styleId, manifestDir, mount, cells, sources = {}, outp
 }
 
 // src/pipeline/plan.ts
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 import path13 from "path";
 
 // src/pipeline/quality-profile.ts
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import path11 from "path";
 
 // src/pipeline/refine.ts
@@ -5000,7 +5004,7 @@ async function writeArtifactBundle(files, options = {}) {
 
 // src/pipeline/audit.ts
 import { readFile as readFile5 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import path9 from "path";
 function colorDistance(a, b) {
   const rmean = (a.r + b.r) / 2;
@@ -5046,7 +5050,7 @@ async function auditStyle(loaded, specs, styleId, lock) {
   const unreadable = [];
   for (const spec of mine) {
     for (const output of resolveSpecOutputs(spec, lock, loaded.root)) {
-      if (!existsSync5(output.absolutePath)) {
+      if (!existsSync6(output.absolutePath)) {
         missing.push(output.id);
         continue;
       }
@@ -5076,7 +5080,7 @@ async function auditStyle(loaded, specs, styleId, lock) {
   const refPalettes = [];
   for (const img of style.styleImages) {
     const abs = path9.resolve(loaded.root, img.path);
-    if (!existsSync5(abs)) continue;
+    if (!existsSync6(abs)) continue;
     try {
       refPalettes.push(extractPalette(decodePng(await readFile5(abs)), 12));
     } catch {
@@ -5705,7 +5709,7 @@ async function qualitySource(spec, lock) {
       return { items: null, reason: "frame-set quality requires ordered downloaded provider outputs" };
     }
     const source = path11.resolve(spec.root, spec.source);
-    return existsSync6(source) ? { items: [{ role: "source", path: source }] } : { items: null, reason: `declared source is missing: ${spec.source}` };
+    return existsSync7(source) ? { items: [{ role: "source", path: source }] } : { items: null, reason: `declared source is missing: ${spec.source}` };
   }
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
   if (!entry) return { items: null, reason: "raw provider output is not in the lockfile" };
@@ -5734,7 +5738,7 @@ async function qualitySource(spec, lock) {
     }
     if (role) roles.add(role);
     const source = currentEntryOutputPath(entry, spec, index);
-    if (!existsSync6(source)) return { items: null, reason: `raw provider output is missing: ${source}` };
+    if (!existsSync7(source)) return { items: null, reason: `raw provider output is missing: ${source}` };
     if (await sha256File(source) !== output.sha256) {
       return { items: null, reason: "raw provider output was modified after download" };
     }
@@ -5753,7 +5757,7 @@ async function inspectQualityProfile(spec, lock) {
   }
   const sourcePaths = source.items.map((item) => item.path);
   const expectedOutputs = spec.generator === "frames" ? source.items.map((item, index) => qualityFrameOutputPath(output, item.role, index)) : [output];
-  if (!existsSync6(record)) {
+  if (!existsSync7(record)) {
     return {
       key,
       state: "needs-refinement",
@@ -5934,7 +5938,7 @@ async function requireApprovedQualitySources(specs, lock, assetIds, outputRoles)
 }
 
 // src/pipeline/revision.ts
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import path12 from "path";
 async function inspectRevisionReadiness(spec, lock) {
   if (!spec.revision) return null;
@@ -5950,14 +5954,14 @@ async function inspectRevision(spec, lock, seen) {
       reason: `revision source ${spec.styleId}/${revision.sourceAssetId} is not ready: ${dependency.reason}`
     };
   }
-  if (!revision.sourceSha256 || !existsSync7(revision.sourceFile)) {
+  if (!revision.sourceSha256 || !existsSync8(revision.sourceFile)) {
     return { ready: false, reason: `revision source is missing: ${revision.sourceFile}` };
   }
   if (await sha256File(revision.sourceFile) !== revision.sourceSha256) {
     return { ready: false, reason: "revision source changed after the manifest was resolved" };
   }
   if (revision.maskFile) {
-    if (!revision.maskSha256 || !existsSync7(revision.maskFile)) {
+    if (!revision.maskSha256 || !existsSync8(revision.maskFile)) {
       return { ready: false, reason: `revision mask is missing: ${revision.maskFile}` };
     }
     if (await sha256File(revision.maskFile) !== revision.maskSha256) {
@@ -5988,7 +5992,7 @@ async function inspectParent(spec, lock, seen) {
   }
   if (spec.source) {
     const source = path12.resolve(spec.root, spec.source);
-    return existsSync7(source) ? { ready: true, reason: "declared source is present" } : { ready: false, reason: `declared source is missing: ${spec.source}` };
+    return existsSync8(source) ? { ready: true, reason: "declared source is present" } : { ready: false, reason: `declared source is missing: ${spec.source}` };
   }
   const entry = lock.entries[key];
   if (!entry) return { ready: false, reason: "parent is not in the lockfile" };
@@ -6002,7 +6006,7 @@ async function inspectParent(spec, lock, seen) {
   for (let index = 0; index < entry.outputs.length; index++) {
     const output = entry.outputs[index];
     const file = currentEntryOutputPath(entry, spec, index);
-    if (!existsSync7(file)) return { ready: false, reason: `parent output is missing: ${file}` };
+    if (!existsSync8(file)) return { ready: false, reason: `parent output is missing: ${file}` };
     if (await sha256File(file) !== output.sha256) {
       return { ready: false, reason: `parent output was modified: ${file}` };
     }
@@ -6057,7 +6061,7 @@ async function buildPlan(specs, lock, opts = {}) {
       state = "missing";
       reason = "--force";
     } else if (!entry && spec.source && spec.generator !== "frames") {
-      if (existsSync8(path13.resolve(spec.root, spec.source))) {
+      if (existsSync9(path13.resolve(spec.root, spec.source))) {
         state = "ok";
         reason = `placed from ${spec.source}; not generated`;
       } else {
@@ -6065,7 +6069,7 @@ async function buildPlan(specs, lock, opts = {}) {
         reason = `declared source is missing: ${spec.source}`;
       }
     } else if (!entry) {
-      if (existsSync8(spec.outFile)) {
+      if (existsSync9(spec.outFile)) {
         state = "untracked";
         reason = "file on disk, no provenance recorded";
       } else {
@@ -6097,9 +6101,9 @@ async function buildPlan(specs, lock, opts = {}) {
     } else if (entry.status !== "downloaded") {
       state = "in-flight";
       reason = `awaiting ${entry.status}`;
-    } else if (entry.outputs.length === 0 || entry.outputs.some((_output, index) => !existsSync8(currentEntryOutputPath(entry, spec, index)))) {
+    } else if (entry.outputs.length === 0 || entry.outputs.some((_output, index) => !existsSync9(currentEntryOutputPath(entry, spec, index)))) {
       state = "orphaned";
-      reason = entry.outputs.length === 0 ? "no recorded output files" : `missing on disk: ${entry.outputs.filter((_output, index) => !existsSync8(currentEntryOutputPath(entry, spec, index))).map((o) => o.role ?? "asset").join(", ")}`;
+      reason = entry.outputs.length === 0 ? "no recorded output files" : `missing on disk: ${entry.outputs.filter((_output, index) => !existsSync9(currentEntryOutputPath(entry, spec, index))).map((o) => o.role ?? "asset").join(", ")}`;
     } else if (await anyOutputModified(entry, spec)) {
       state = "orphaned";
       reason = "output modified since download";
@@ -6427,7 +6431,7 @@ async function poll(provider, lock, lockPath, opts = {}) {
 }
 
 // src/pipeline/fetch.ts
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import { mkdir as mkdir3, readFile as readFile7, rename as rename3, rm as rm4, writeFile as writeFile3 } from "fs/promises";
 import path14 from "path";
 
@@ -6483,7 +6487,7 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
     if (opts.refresh) return e.outputs.length > 0 && Boolean(e.sourceUrls?.length || e.sourceUrl);
     if (!opts.repair) return false;
     const spec = specByKey.get(key);
-    return e.outputs.length === 0 || !spec || e.outputs.some((output) => !existsSync9(resolveOutputPath(output.path, spec.root)));
+    return e.outputs.length === 0 || !spec || e.outputs.some((output) => !existsSync10(resolveOutputPath(output.path, spec.root)));
   });
   const concurrency = Math.min(Math.max(1, opts.concurrency ?? 8), Math.max(1, pending.length));
   let cursor = 0;
@@ -6531,7 +6535,7 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
               continue;
             }
           }
-          if (existsSync9(target)) {
+          if (existsSync10(target)) {
             const currentHash = await sha256File(target);
             if (recorded && currentHash === recorded.sha256) {
               if (!fresh) {
@@ -6642,7 +6646,7 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
 }
 async function readCachedMedia(cacheDir, hash, mediaType) {
   const file = path14.join(cacheDir, cacheFileName(hash, mediaType));
-  if (!existsSync9(file)) return null;
+  if (!existsSync10(file)) return null;
   try {
     const buf = await readFile7(file);
     if (sha256(buf) !== hash) return null;
@@ -6663,7 +6667,7 @@ async function cacheMedia(cacheDir, buf, mediaType, knownHash) {
   try {
     await rename3(tmp, file);
   } catch (err) {
-    if (!existsSync9(file)) throw err;
+    if (!existsSync10(file)) throw err;
   } finally {
     await rm4(tmp, { force: true });
   }
@@ -6696,7 +6700,7 @@ async function pushTags(provider, specs, lock, opts = {}) {
 }
 
 // src/pipeline/doctor.ts
-import { constants, existsSync as existsSync10 } from "fs";
+import { constants, existsSync as existsSync11 } from "fs";
 import { access, stat as stat2 } from "fs/promises";
 import path15 from "path";
 async function doctor(loaded, specs, lock, lockPath, opts = {}) {
@@ -6768,7 +6772,7 @@ async function doctor(loaded, specs, lock, lockPath, opts = {}) {
         cacheDir,
         cacheFileName(output.sha256, output.mediaType ?? MediaType.PNG)
       );
-      if (existsSync10(cached) && await sha256File(cached) === output.sha256) {
+      if (existsSync11(cached) && await sha256File(cached) === output.sha256) {
         hasCache = true;
         break;
       }
@@ -6871,13 +6875,13 @@ async function nearestExistingDirectory(start) {
 }
 
 // src/pipeline/adopt.ts
-import { existsSync as existsSync12 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import { readFile as readFile9, writeFile as writeFile5 } from "fs/promises";
 import path16 from "path";
 
 // src/cache.ts
 import { mkdir as mkdir4, readFile as readFile8, rename as rename4, rm as rm5, writeFile as writeFile4 } from "fs/promises";
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import pathModule from "path";
 import { z as z3 } from "zod";
 var HashCacheSchema = z3.object({
@@ -6893,7 +6897,7 @@ function parseCache(value) {
   return HashCacheSchema.parse(value);
 }
 async function loadCache(path31) {
-  if (!existsSync11(path31)) return { version: 1, hashes: {} };
+  if (!existsSync12(path31)) return { version: 1, hashes: {} };
   try {
     const parsed = HashCacheSchema.safeParse(JSON.parse(await readFile8(path31, "utf8")));
     if (!parsed.success) return { version: 1, hashes: {} };
@@ -6949,7 +6953,7 @@ async function adopt(provider, specs, lock, lockPath, opts = {}) {
   const localByHash = /* @__PURE__ */ new Map();
   const unmatchedLocal = [];
   for (const spec of specs) {
-    if (!existsSync12(spec.outFile)) {
+    if (!existsSync13(spec.outFile)) {
       unmatchedLocal.push(`${spec.styleId}/${spec.assetId} (no file at ${spec.outFile})`);
       continue;
     }
@@ -7106,12 +7110,12 @@ function formatUnmatchedRemote(objects, limit = 15) {
 }
 
 // src/pick/server.ts
-import { existsSync as existsSync14 } from "fs";
+import { existsSync as existsSync15 } from "fs";
 import { readFile as readFile12 } from "fs/promises";
 
 // src/pipeline/init.ts
 import { readdir, readFile as readFile10, writeFile as writeFile6 } from "fs/promises";
-import { existsSync as existsSync13 } from "fs";
+import { existsSync as existsSync14 } from "fs";
 import path17 from "path";
 function pngSize(buf) {
   if (buf.length < 24) return null;
@@ -7204,7 +7208,7 @@ function mode(values) {
   return [...counts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? 64;
 }
 async function writeManifestFile(target, manifest) {
-  if (existsSync13(target)) {
+  if (existsSync14(target)) {
     throw new Error(`${target} already exists \u2014 refusing to overwrite an existing manifest.`);
   }
   await writeFile6(target, JSON.stringify(manifest, null, 2) + "\n");
@@ -7690,7 +7694,7 @@ async function currentArt(entry, spec) {
   const previous = primaryOutput({ ...entry, outputs: entry.supersededOutputs });
   if (!previous) return null;
   const file = resolveOutputPath(previous.path, spec.root);
-  if (!existsSync14(file)) return null;
+  if (!existsSync15(file)) return null;
   const contentType = previous.mediaType ?? mediaTypeFromExtension(file);
   if (!contentType) return null;
   let width = entry.width;
@@ -7861,13 +7865,13 @@ async function runPicker(provider, lock, lockPath, opts = {}) {
 
 // src/gallery/snapshot.ts
 import { createHash as createHash3 } from "crypto";
-import { existsSync as existsSync17 } from "fs";
+import { existsSync as existsSync18 } from "fs";
 import { readFile as readFile16, stat as stat3 } from "fs/promises";
 import path22 from "path";
 
 // src/workspace.ts
 import { mkdir as mkdir5, readFile as readFile13, rename as rename5, rm as rm6, writeFile as writeFile7 } from "fs/promises";
-import { existsSync as existsSync15 } from "fs";
+import { existsSync as existsSync16 } from "fs";
 import path18 from "path";
 import { z as z4 } from "zod";
 var WorkspaceProjectSchema = z4.object({
@@ -7893,7 +7897,7 @@ ${parsed.error.issues.slice(0, 5).map((i) => `  ${i.path.join(".")}: ${i.message
   );
 }
 async function loadWorkspace(workspacePath) {
-  if (!existsSync15(workspacePath)) return { version: 1, projects: [] };
+  if (!existsSync16(workspacePath)) return { version: 1, projects: [] };
   let raw;
   try {
     raw = JSON.parse(await readFile13(workspacePath, "utf8"));
@@ -7945,14 +7949,14 @@ function validateWorkspace(ws, dir) {
         message: `project "${project.id}" stores an absolute path \u2014 the catalog will not resolve correctly if this tree is cloned or moved elsewhere`
       });
     }
-    if (!existsSync15(manifestPath)) {
+    if (!existsSync16(manifestPath)) {
       diagnostics.push({
         id: "missing-manifest",
         level: "error",
         message: `project "${project.id}" manifest not found: ${manifestPath}`
       });
     }
-    if (!existsSync15(lockPath)) {
+    if (!existsSync16(lockPath)) {
       diagnostics.push({
         id: "missing-lock",
         level: "error",
@@ -8253,7 +8257,7 @@ async function applyManifestEdit(manifestPath, edit) {
 
 // src/pipeline/hand-edit.ts
 import { spawn as spawn2 } from "child_process";
-import { existsSync as existsSync16 } from "fs";
+import { existsSync as existsSync17 } from "fs";
 import { copyFile, mkdir as mkdir6, readFile as readFile15, rename as rename7, rm as rm8, writeFile as writeFile9 } from "fs/promises";
 import path20 from "path";
 import { z as z6 } from "zod";
@@ -8269,7 +8273,7 @@ function handEditPath(loaded, spec) {
 function handEditBases(spec, lock) {
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
   if (entry) {
-    if (entry.outputs.length !== 1 && !isFrameSetEntry(entry)) return null;
+    if (entry.outputs.length !== 1 && !isMemberSetEntry(entry)) return null;
     const members = entry.outputs.map((output, index) => ({
       role: entry.outputs.length === 1 ? null : output.role ?? null,
       path: currentEntryOutputPath(entry, spec, index),
@@ -8277,15 +8281,15 @@ function handEditBases(spec, lock) {
     }));
     if (members.some((member) => member.mediaType && member.mediaType !== "image/png")) return null;
     if (entry.outputs.length === 1 && !primaryOutput(entry)) return null;
-    if (!members.every((member) => existsSync16(member.path))) return null;
+    if (!members.every((member) => existsSync17(member.path))) return null;
     return members.map(({ role, path: file }) => ({ role, path: file }));
   }
-  return existsSync16(spec.outFile) ? [{ role: null, path: spec.outFile }] : null;
+  return existsSync17(spec.outFile) ? [{ role: null, path: spec.outFile }] : null;
 }
 function handEditMembers(loaded, spec, lock, editPath) {
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
   const bases = handEditBases(spec, lock);
-  if (entry && isFrameSetEntry(entry)) {
+  if (entry && isMemberSetEntry(entry)) {
     return entry.outputs.map((output, index) => ({
       role: output.role ?? null,
       path: memberPath(editPath, output.role, index, entry.outputs.length, output.mediaType),
@@ -8296,9 +8300,14 @@ function handEditMembers(loaded, spec, lock, editPath) {
 }
 async function startHandEdit(loaded, lock, spec, opts = {}) {
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
-  if (entry && entry.outputs.length > 1 && !isFrameSetEntry(entry)) {
+  if (entry && entry.outputs.length > 1 && !isMemberSetEntry(entry)) {
     throw new ManifestEditError(
-      `${spec.styleId}/${spec.assetId} is a structural set of ${entry.outputs.length} outputs; hand edits cover single images and frame sets`
+      `${spec.styleId}/${spec.assetId} is a set of ${entry.outputs.length} outputs that are not all PNG; hand edits cover PNG images and sets of them`
+    );
+  }
+  if (entry && spec.source && isMemberSetEntry(entry) && !sourceIsStem(spec.source, entry, loaded.root)) {
+    throw new ManifestEditError(
+      `${spec.styleId}/${spec.assetId} declares ${spec.source}, one committed file placed for the whole set; clear that source (pixelkiln edit detach) to hand-edit the members one by one`
     );
   }
   const existing = spec.source ? path20.resolve(loaded.root, spec.source) : null;
@@ -8306,7 +8315,7 @@ async function startHandEdit(loaded, lock, spec, opts = {}) {
   const members = handEditMembers(loaded, spec, lock, editPath);
   let created = false;
   for (const member of members) {
-    if (existsSync16(member.path)) continue;
+    if (existsSync17(member.path)) continue;
     if (!member.base) {
       throw new ManifestEditError(
         `${spec.styleId}/${spec.assetId} has no generated PNG on disk to start from; generate or restore it first`
@@ -8404,18 +8413,18 @@ async function readHandEditCompanion(editPath) {
 var MAX_HAND_EDIT_BYTES = 16 * 1024 * 1024;
 async function saveHandEdit(loaded, lock, spec, input) {
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
-  const frameSet = entry ? isFrameSetEntry(entry) : false;
+  const memberSet = entry ? isMemberSetEntry(entry) : false;
   const incoming = input.frames ?? (input.png ? [{ role: null, png: input.png }] : []);
   if (!incoming.length) throw new ManifestEditError("the save carried no image");
   if (input.project && input.project.length > MAX_HAND_EDIT_BYTES) {
     throw new ManifestEditError(`the project file is ${input.project.length} bytes; the limit is ${MAX_HAND_EDIT_BYTES}`);
   }
-  if (frameSet) {
+  if (memberSet) {
     const expected = entry.outputs.map((output) => output.role ?? null);
     const got = incoming.map((frame) => frame.role);
     if (got.length !== expected.length || expected.some((role, index) => got[index] !== role)) {
       throw new ManifestEditError(
-        `${spec.styleId}/${spec.assetId} is a set of ${expected.length} frames (${expected.join(", ")}); the editor returned ${got.length} (${got.map((role) => role ?? "new").join(", ")}) \u2014 keep the frames it opened with`
+        `${spec.styleId}/${spec.assetId} is a set of ${expected.length} members (${expected.join(", ")}); the editor returned ${got.length} (${got.map((role) => role ?? "new").join(", ")}) \u2014 keep the frames it opened with`
       );
     }
   } else if (incoming.length !== 1) {
@@ -8429,7 +8438,7 @@ async function saveHandEdit(loaded, lock, spec, input) {
       validateMedia(frame.png, MediaType.PNG);
       return decodePng(frame.png);
     } catch (error) {
-      const which = frameSet ? `frame ${frame.role ?? index}` : "the edit";
+      const which = memberSet ? `member ${frame.role ?? index}` : "the edit";
       throw new ManifestEditError(`${which} is not a valid PNG: ${error instanceof Error ? error.message : String(error)}`);
     }
   });
@@ -8437,7 +8446,7 @@ async function saveHandEdit(loaded, lock, spec, input) {
   const expectedSize = bases?.[0] ? decodePng(await readFile15(bases[0].path)) : { width: spec.width, height: spec.height };
   for (const [index, image] of decoded.entries()) {
     if (image.width !== expectedSize.width || image.height !== expectedSize.height) {
-      const which = frameSet ? `frame ${incoming[index].role ?? index}` : "the edit";
+      const which = memberSet ? `member ${incoming[index].role ?? index}` : "the edit";
       throw new ManifestEditError(
         `${which} is ${image.width}\xD7${image.height}; ${spec.styleId}/${spec.assetId} is ${expectedSize.width}\xD7${expectedSize.height}`
       );
@@ -8671,7 +8680,7 @@ async function describeQuality(media, root, inspection) {
     outputPaths.map((file) => describeOutput(media, root, path22.resolve(root, file)))
   );
   const recordPath = path22.resolve(root, inspection.record);
-  const recordExists = existsSync17(recordPath);
+  const recordExists = existsSync18(recordPath);
   let options = null;
   let check = null;
   if (recordExists) {
@@ -8753,11 +8762,11 @@ async function buildGallerySnapshot(opts) {
       );
       if (spec.source) {
         const editPath = path22.resolve(root, spec.source);
-        const memberCount = isFrameSetEntry(entry) ? entry.outputs.length : 1;
+        const memberCount = sourceIsStem(spec.source, entry, root) ? entry.outputs.length : 1;
         const editShas = await Promise.all(
           Array.from({ length: memberCount }, async (_, index) => {
             const file = sourceOutputPath(spec.source, entry, index, root);
-            return { file, sha256: existsSync17(file) ? await sha256File(file) : null };
+            return { file, sha256: existsSync18(file) ? await sha256File(file) : null };
           })
         );
         edits = await Promise.all(editShas.map(({ file, sha256: editSha }) => describeOutput(media, root, file, { sha256: editSha })));
@@ -8765,7 +8774,7 @@ async function buildGallerySnapshot(opts) {
         const companion = await readHandEditCompanion(editPath);
         if (companion) {
           const projectPath = handEditProjectPath(editPath);
-          const project = companion.project && existsSync17(projectPath) ? await fileInfo(projectPath) : null;
+          const project = companion.project && existsSync18(projectPath) ? await fileInfo(projectPath) : null;
           let projectUrl = null;
           if (project) {
             const id = galleryMediaId(projectPath);
@@ -8802,7 +8811,7 @@ async function buildGallerySnapshot(opts) {
       }
     } else if (spec.source) {
       outputs = [await describeOutput(media, root, path22.resolve(root, spec.source))];
-    } else if (!entry && existsSync17(spec.outFile)) {
+    } else if (!entry && existsSync18(spec.outFile)) {
       outputs = [await describeOutput(media, root, spec.outFile)];
     } else {
       outputs = [];
@@ -9355,6 +9364,7 @@ function renderGallery(snapshot, opts = {}) {
   .sheet.editor-host { width:min(1400px, 96vw); grid-template-rows:auto 1fr; }
   .sheet.editor-host .rbar b { font:650 12.5px/1.4 var(--mono); color:var(--text); }
   .sheet.editor-host .rbar .acts { margin-left:auto; display:flex; gap:8px; align-items:center; }
+  .sheet.editor-host .rbar .chip { color:var(--dim); font-size:12.5px; display:inline-flex; align-items:center; gap:5px; margin-right:6px; }
   .sheet.editor-host .rbar .st { display:inline-flex; align-items:center; gap:6px; font:650 11.5px/1 var(--mono); }
   .sheet.editor-host .rbar .msg { color:var(--bad); font-size:12.5px; }
   .sheet.editor-host .stage { position:relative; min-height:0; }
@@ -9879,15 +9889,20 @@ function openEditorSheet(item) {
   const bar = el('div', 'rbar');
   const close = el('button', null, 'Close'); close.type = 'button';
   close.onclick = () => closeEditorSheet();
-  const title = el('b', null, (item.project ? item.project + ':' : '') + item.styleId + '/' + item.assetId + ' \xB7 ' + item.width + '\xD7' + item.height + (item.outputs.length > 1 ? ' \xB7 ' + item.outputs.length + ' frames' : ''));
+  const title = el('b', null, (item.project ? item.project + ':' : '') + item.styleId + '/' + item.assetId + ' \xB7 ' + item.width + '\xD7' + item.height + (item.outputs.length > 1 ? ' \xB7 ' + item.outputs.length + ' ' + memberNoun(item, item.outputs.length) : ''));
   const status = el('span', 'st');
   const acts = el('div', 'acts');
   const msg = el('span', 'msg');
+  const compare = el('label', 'chip'); compare.hidden = true;
+  compare.title = 'The generated art on a locked layer at 50%, for comparison; never part of the saved file';
+  const compareBox = el('input'); compareBox.type = 'checkbox'; compareBox.checked = true;
+  compareBox.onchange = () => showReference(compareBox.checked);
+  compare.append(compareBox, document.createTextNode(' show generated'));
   const save = el('button', 'primary', 'Save to project'); save.type = 'button';
   save.onclick = () => requestEditorSave(false);
   const saveClose = el('button', null, 'Save & close'); saveClose.type = 'button';
   saveClose.onclick = () => requestEditorSave(true);
-  acts.append(msg, save, saveClose);
+  acts.append(msg, compare, save, saveClose);
   bar.append(close, title, status, acts);
   const stage = el('div', 'stage');
   const frame = el('iframe');
@@ -9900,7 +9915,7 @@ function openEditorSheet(item) {
   stage.append(frame, loading);
   panel.append(bar, stage);
   host.append(scrim, panel);
-  SHEET = { item, frame, loading, status, msg, save, saveClose, dirty: false, opened: false, ready: null, pending: null, requests: 0, source: src, sentProject: false, roles: null };
+  SHEET = { item, frame, loading, status, msg, save, saveClose, compare, dirty: false, opened: false, ready: null, pending: null, requests: 0, source: src, sentProject: false, sentReference: false, reference: false, roles: null };
   sheetStatus('cool', 'loading');
   sheetButtons();
   close.focus({ preventScroll: true });
@@ -9916,11 +9931,15 @@ async function sendOpen() {
   const projectUrl = sources.fromEdit && item.editMeta && item.editMeta.projectUrl && SHEET.ready.version >= 2 ? item.editMeta.projectUrl : null;
   const set = sources.files.length > 1;
   if (set && SHEET.ready.version < 3) {
-    SHEET.msg.textContent = 'This editor build cannot open frame sets; reinstall it with pixelkiln tools install editor.';
+    SHEET.msg.textContent = 'This editor build cannot open sets; reinstall it with pixelkiln tools install editor.';
     sheetStatus('bad', 'unsupported');
     return;
   }
+  // When an edit is being opened, the generated art rides along as a
+  // reference layer: what the editor shows through at 50% for comparison.
+  const referenceFiles = sources.fromEdit && SHEET.ready.version >= 4 && item.outputs.every((o) => o.exists && o.url) ? item.outputs : null;
   const pngs = [];
+  const reference = [];
   let pxo = null;
   try {
     for (const file of sources.files) {
@@ -9932,6 +9951,10 @@ async function sendOpen() {
       const p = await fetch(projectUrl, { cache: 'no-store' });
       if (p.ok) pxo = await p.arrayBuffer();
     }
+    for (const file of referenceFiles || []) {
+      const res = await fetch(file.url, { cache: 'no-store' });
+      if (res.ok) reference.push({ role: file.role || null, png: await res.arrayBuffer() });
+    }
   } catch (err) {
     if (SHEET) { SHEET.msg.textContent = 'Could not load the image: ' + err.message; sheetStatus('bad', 'failed'); }
     return;
@@ -9948,16 +9971,26 @@ async function sendOpen() {
   const transfer = [pngs[0]];
   if (set) {
     message.frames = pngs.map((png, i) => ({ role: SHEET.roles[i], png }));
-    message.fps = item.fps || 12;
+    // A tile set is not an animation; a slow rate keeps its timeline still-ish.
+    message.fps = isFrameSet(item) ? (item.fps || 12) : 1;
     for (const png of pngs.slice(1)) transfer.push(png);
     // The first frame is both png (older editors) and frames[0]; copy it so both transfer.
     message.png = pngs[0].slice(0);
     transfer.push(message.png);
   }
   if (pxo) { message.pxo = pxo; transfer.push(pxo); }
+  if (reference.length === (referenceFiles || []).length && reference.length) {
+    message.reference = reference;
+    for (const r of reference) transfer.push(r.png);
+  }
+  SHEET.sentReference = !!message.reference;
   SHEET.frame.contentWindow.postMessage(message, location.origin, transfer);
   sheetStatus('cool', 'opening');
 }
+function showReference(visible) {
+  if (!SHEET || !SHEET.opened || !SHEET.reference) return;
+  SHEET.frame.contentWindow.postMessage({ type: 'pixelkiln:reference', visible }, location.origin);
+}
 function requestEditorSave(close) {
   if (!SHEET || !SHEET.opened || SHEET.pending) return;
   const request = 'save-' + (++SHEET.requests);
@@ -9981,10 +10014,13 @@ async function onEditorMessage(m) {
     case 'pixelkiln:opened':
       SHEET.opened = true;
       SHEET.loading.remove();
-      if (m.source === 'pxo') sheetStatus('ok', 'editing the edit file' + (m.frames > 1 ? 's' : '') + ' with ' + (m.layers === 1 ? 'the layer' : m.layers + ' layers') + (m.frames > 1 ? ' and ' + m.frames + ' frames' : '') + ' restored');
+      SHEET.reference = !!m.reference;
+      SHEET.compare.hidden = !SHEET.reference;
+      if (m.source === 'pxo') sheetStatus('ok', 'editing the edit file' + (m.frames > 1 ? 's' : '') + ' with ' + (m.layers === 1 ? 'the layer' : m.layers + ' layers') + (m.frames > 1 ? ' and ' + m.frames + ' ' + memberNoun(SHEET.item, m.frames) : '') + ' restored');
       else if (SHEET.sentProject) sheetStatus('warn', 'editing the flattened edit file' + (m.frames > 1 ? 's' : '') + '; the layer file could not be opened');
-      else if (m.source === 'frames') sheetStatus('ok', (SHEET.item.edits.length ? 'editing the edit files' : 'editing a copy of the generated frames') + ' as ' + m.frames + ' frames');
+      else if (m.source === 'frames') sheetStatus('ok', (SHEET.item.edits.length ? 'editing the edit files' : 'editing a copy of the generated ' + memberNoun(SHEET.item, m.frames)) + ' as ' + m.frames + ' frames' + (isFrameSet(SHEET.item) ? '' : ', one per ' + memberNoun(SHEET.item, 1)));
       else sheetStatus('ok', SHEET.item.edit && SHEET.item.edit.exists ? 'editing the edit file' : 'editing a copy of the generated art');
+      if (SHEET.reference) SHEET.status.append(document.createTextNode(' \xB7 generated art shown through at 50%'));
       sheetButtons();
       break;
     case 'pixelkiln:dirty':
@@ -10010,7 +10046,7 @@ async function onEditorMessage(m) {
         if (saved) SHEET.item = saved;
         SHEET.dirty = false;
         SHEET.pending = null;
-        ui.notice = { id: SHEET.item.id, text: 'Saved ' + (saved && saved.edits.length > 1 ? saved.edits.length + ' frames to ' + saved.source : saved && saved.edit ? saved.edit.path : 'the edit') + '. mount and pack place ' + (saved && saved.edits.length > 1 ? 'them' : 'it') + ' in place of the generated art.' };
+        ui.notice = { id: SHEET.item.id, text: 'Saved ' + (saved && saved.edits.length > 1 ? saved.edits.length + ' ' + memberNoun(saved, saved.edits.length) + ' to ' + saved.source : saved && saved.edit ? saved.edit.path : 'the edit') + '. mount and pack place ' + (saved && saved.edits.length > 1 ? 'them' : 'it') + ' in place of the generated art.' };
         render();
         if (pending.close) { closeEditorSheet(true); return; }
         sheetStatus('ok', 'saved');
@@ -10583,16 +10619,18 @@ async function postHandEdit(item, action, extra) {
   if (item.project) body.project = item.project;
   snap = await postEdit(body);
 }
-// A single PNG, or an ordered frame set: both are hand-editable, one file per
-// member. Structural sets (tiles, characters) are not.
-const editableOutputs = (item) => item.outputs.length && (item.outputs.length === 1 || isFrameSet(item)) &&
-  item.outputs.every((o) => o.exists && o.mediaType === 'image/png');
+// A single PNG or a set of them \u2014 frames, tiles \u2014 is hand-editable, one file
+// per member; a set with a GIF in it is not.
+const editableOutputs = (item) => item.outputs.length && item.outputs.every((o) => o.exists && o.mediaType === 'image/png');
+// What the members of a set are called: frames for an animation, tiles for a tile set.
+const memberNoun = (item, n) => isFrameSet(item) ? (n === 1 ? 'frame' : 'frames')
+  : item.outputs.every((o) => o.role && /^tile/i.test(o.role)) ? (n === 1 ? 'tile' : 'tiles') : (n === 1 ? 'member' : 'members');
 function handEditSection(item) {
   const canStart = EDITABLE && item.declared && item.asset && projectOf(item)?.manifestSha256 && editableOutputs(item);
   if (!item.edit && !canStart) return null;
   const set = item.edits.length > 1;
   const s = el('section', 'meta');
-  s.append(el('h3', null, set ? 'Hand edit (' + item.edits.length + ' frames)' : 'Hand edit'));
+  s.append(el('h3', null, set ? 'Hand edit (' + item.edits.length + ' ' + memberNoun(item, item.edits.length) + ')' : 'Hand edit'));
   if (item.edit) {
     const pair = el('div', 'pair');
     const shared = displayScale(item.width, item.height, 200, 160);
@@ -10608,7 +10646,7 @@ function handEditSection(item) {
     };
     // For a set, the member the preview is on; the strip there steps through them.
     const at = set ? Math.min(ui.member, item.edits.length - 1) : 0;
-    const which = set ? ' \xB7 ' + (item.outputs[at].role || 'frame ' + (at + 1)) : '';
+    const which = set ? ' \xB7 ' + (item.outputs[at].role || memberNoun(item, 1) + ' ' + (at + 1)) : '';
     pair.append(fig(item.outputs[at], 'generated' + which), fig(item.edits[at], 'edit' + which));
     s.append(pair);
     const dl = el('dl');
@@ -10617,9 +10655,9 @@ function handEditSection(item) {
     row(dl, 'status', st);
     row(dl, 'why', EDIT_STATUS_TEXT[item.editStatus] || '');
     if (set) {
-      row(dl, 'files', item.source + ' \u2014 one per frame: ' + item.edits.map((e) => e.path.split('/').pop()).join(', '), { mono: true, copy: item.edits.map((e) => e.absolutePath).join('\\n') });
+      row(dl, 'files', item.source + ' \u2014 one per ' + memberNoun(item, 1) + ': ' + item.edits.map((e) => e.path.split('/').pop()).join(', '), { mono: true, copy: item.edits.map((e) => e.absolutePath).join('\\n') });
       const differing = item.editChanged.filter(Boolean).length;
-      row(dl, 'changed', differing + ' of ' + item.edits.length + ' frames differ from the generated art' +
+      row(dl, 'changed', differing + ' of ' + item.edits.length + ' ' + memberNoun(item, item.edits.length) + ' differ from the generated art' +
         (differing ? ': ' + item.edits.filter((e, i) => item.editChanged[i]).map((e) => item.outputs[item.edits.indexOf(e)].role || e.path.split('/').pop()).join(', ') : ''));
     } else {
       row(dl, 'file', item.edit.path, { mono: true, copy: item.edit.absolutePath });
@@ -10633,8 +10671,8 @@ function handEditSection(item) {
     }
     s.append(dl);
   } else {
-    s.append(el('div', 'state-dim', isFrameSet(item)
-      ? 'Touch the frames up in your own editor or in the browser, where they open as one animation. The generated files stay untouched; the edit is one sibling file per frame that the manifest points at, and mount and pack place those instead.'
+    s.append(el('div', 'state-dim', item.outputs.length > 1
+      ? 'Touch the ' + memberNoun(item, 2) + ' up in your own editor or in the browser, where they open as ' + (isFrameSet(item) ? 'one animation' : 'the frames of one project') + '. The generated files stay untouched; the edit is one sibling file per ' + memberNoun(item, 1) + ' that the manifest points at, and mount, pack, and export place those instead.'
       : 'Touch it up in your own editor. The generated file stays untouched; the edit is a sibling file the manifest points at, and mount and pack place that instead.'));
   }
   if (EDITABLE && item.declared && projectOf(item)?.manifestSha256) {
@@ -10665,8 +10703,9 @@ function handEditSection(item) {
       go('Open in desktop editor', 'start-edit', { open: true }, 'Opened ' + item.edit.path + ' in your editor. Save there, then Refresh.');
       go('Detach edit', 'detach-edit', {}, 'Detached. The file' + (set ? 's are' : ' is') + ' still at ' + item.source + '; the generated art is placed again.');
     } else if (canStart) {
-      go('Edit by hand', 'start-edit', { open: true }, 'Created the edit file' + (isFrameSet(item) ? 's and opened the first frame' : ' and opened it') + ' in your editor. Save there, then Refresh to see it here.');
-      go('Create edit file' + (isFrameSet(item) ? 's' : '') + ' only', 'start-edit', { open: false }, 'Created the edit file' + (isFrameSet(item) ? 's' : '') + ' and declared ' + (isFrameSet(item) ? 'them' : 'it') + ' in the manifest.');
+      const many = item.outputs.length > 1;
+      go('Edit by hand', 'start-edit', { open: true }, 'Created the edit file' + (many ? 's and opened the first ' + memberNoun(item, 1) : ' and opened it') + ' in your editor. Save there, then Refresh to see it here.');
+      go('Create edit file' + (many ? 's' : '') + ' only', 'start-edit', { open: false }, 'Created the edit file' + (many ? 's' : '') + ' and declared ' + (many ? 'them' : 'it') + ' in the manifest.');
     }
     acts.append(msg);
     s.append(acts);
@@ -11969,7 +12008,7 @@ import path24 from "path";
 
 // src/editor/install.ts
 import { createHash as createHash4 } from "crypto";
-import { existsSync as existsSync18 } from "fs";
+import { existsSync as existsSync19 } from "fs";
 import { mkdir as mkdir7, readFile as readFile18, rename as rename8, rm as rm9, stat as stat4, writeFile as writeFile10 } from "fs/promises";
 import os2 from "os";
 import path23 from "path";
@@ -11979,8 +12018,8 @@ var pin_default = {
   pixelorama: "v1.2.2",
   godot: "4.7.2",
   extensionsApi: 9,
-  protocol: 3,
-  release: "editor-pixelorama-v1.2.2-pk.14",
+  protocol: 4,
+  release: "editor-pixelorama-v1.2.2-pk.18",
   files: {
     "index.apple-touch-icon.png": {
       sha256: "ee5434873e0fed91e9a888c3ea5a8b79beac25999308be7a6eb41bf4ce640d27",
@@ -11995,7 +12034,7 @@ var pin_default = {
       bytes: 7298
     },
     "index.html": {
-      sha256: "2974146c89f4df9f796e840947c334aaf3e4fa3dd18bcd7e08db2eabfd0f086e",
+      sha256: "d9adf06036660c4b76ef5386e872bc03dc0d5b0628fd6ac660d480893ee1f47a",
       bytes: 5442
     },
     "index.icon.png": {
@@ -12007,8 +12046,8 @@ var pin_default = {
       bytes: 279815
     },
     "index.pck": {
-      sha256: "736bd383c82fdadf31cc894caf08490b99c5df572aa20db683972c35c7a0465b",
-      bytes: 6429628
+      sha256: "a41d9c3a39aa99ea5ee49ddcedfeb8b092006aa75c0de67139f13297c17f42e4",
+      bytes: 6431692
     },
     "index.png": {
       sha256: "6e3ca3eb4a99e4c07bdd89ebc873b440ec0ffd66ce1955160da9e7ed80d538d7",
@@ -12068,7 +12107,7 @@ async function editorStatus(opts = {}) {
   for (const [name, expected] of Object.entries(pin.files)) {
     totalBytes += expected.bytes;
     const file = path23.join(dir, name);
-    const info = existsSync18(file) ? await stat4(file).catch(() => null) : null;
+    const info = existsSync19(file) ? await stat4(file).catch(() => null) : null;
     if (info && info.size === expected.bytes && await sha256Of(file) === expected.sha256) {
       installedBytes += expected.bytes;
     } else {
@@ -12263,7 +12302,7 @@ function createGalleryEditorHandlers(opts = {}) {
 
 // src/pipeline/salvage.ts
 import { readFile as readFile20 } from "fs/promises";
-import { existsSync as existsSync19 } from "fs";
+import { existsSync as existsSync20 } from "fs";
 import path25 from "path";
 function providerClaimId(provider, objectId) {
   return `${encodeURIComponent(provider)}:${encodeURIComponent(objectId)}`;
@@ -12271,7 +12310,7 @@ function providerClaimId(provider, objectId) {
 async function loadClaims(lockPaths, opts = {}) {
   const claimed = /* @__PURE__ */ new Set();
   for (const p of lockPaths) {
-    if (!existsSync19(p)) throw new Error(`Claim lockfile not found: ${p}`);
+    if (!existsSync20(p)) throw new Error(`Claim lockfile not found: ${p}`);
     let parsed;
     try {
       parsed = parseLock(JSON.parse(await readFile20(p, "utf8")));
@@ -12332,7 +12371,7 @@ async function loadSiblingManifests(ownManifestPath, workspaceManifestPaths, cla
   const siblings = [];
   for (const siblingManifestPath of siblingManifestPaths) {
     if (path25.resolve(siblingManifestPath) === own) continue;
-    if (!existsSync19(siblingManifestPath)) continue;
+    if (!existsSync20(siblingManifestPath)) continue;
     try {
       const { manifest } = await loadManifest(siblingManifestPath);
       siblings.push({ label: path25.basename(path25.dirname(siblingManifestPath)), manifest });
@@ -12554,11 +12593,11 @@ async function workspaceStatus(ws, dir) {
 }
 
 // src/pipeline/cache-health.ts
-import { existsSync as existsSync20 } from "fs";
+import { existsSync as existsSync21 } from "fs";
 import { readFile as readFile21, readdir as readdir2, rm as rm10 } from "fs/promises";
 import path26 from "path";
 async function inspectCaches(lock, lockPath, options = {}) {
-  if (options.prune && !existsSync20(lockPath)) {
+  if (options.prune && !existsSync21(lockPath)) {
     throw new Error(`Refusing to prune without an existing lockfile at ${path26.resolve(lockPath)}`);
   }
   const contentDir = path26.resolve(path26.dirname(lockPath), ".pixelkiln", "cache");
@@ -12603,7 +12642,7 @@ async function inspectCaches(lock, lockPath, options = {}) {
 async function inspectContentCache(contentDir, referenced) {
   const report = {
     path: contentDir,
-    exists: existsSync20(contentDir),
+    exists: existsSync21(contentDir),
     files: 0,
     bytes: 0,
     valid: 0,
@@ -12667,7 +12706,7 @@ async function inspectContentCache(contentDir, referenced) {
 async function inspectRemoteHashCache(remotePath) {
   const report = {
     path: remotePath,
-    exists: existsSync20(remotePath),
+    exists: existsSync21(remotePath),
     entries: 0,
     valid: 0,
     invalidIds: [],
@@ -12717,8 +12756,11 @@ function normalizeTileRules(raw) {
   };
 }
 function exportTileset(entry, spec, options) {
-  const outputs = resolveSpecEntryOutputs(entry, spec);
+  let outputs = resolveSpecEntryOutputs(entry, spec);
   if (!outputs.length) throw new Error(`${spec.styleId}/${spec.assetId} has no downloaded outputs`);
+  if (spec.source && sourceIsStem(spec.source, entry, options.manifestDir)) {
+    outputs = outputs.map((output) => ({ ...output, absolutePath: sourceOutputPath(spec.source, entry, output.index, options.manifestDir) }));
+  }
   const packed = packSprites(
     outputs.map((output) => ({
       id: output.role ?? fallbackOutputRole(output.index),
@@ -13212,7 +13254,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
 
 // src/recipes.ts
 import path28 from "path";
-import { existsSync as existsSync21 } from "fs";
+import { existsSync as existsSync22 } from "fs";
 import { readdir as readdir3, readFile as readFile23 } from "fs/promises";
 import { fileURLToPath } from "url";
 import { z as z9 } from "zod";
@@ -13415,7 +13457,7 @@ async function readRecipeFile(recipePath, bundled) {
   return { recipe: parsed.data, path: absolute, dir: path28.dirname(absolute), bundled };
 }
 async function walkRecipeFiles(root) {
-  if (!existsSync21(root)) return [];
+  if (!existsSync22(root)) return [];
   const out = [];
   for (const entry of await readdir3(root, { withFileTypes: true })) {
     const resolved = path28.join(root, entry.name);
@@ -13453,7 +13495,7 @@ function parseSelector(selector) {
 }
 async function resolveRecipe(target, bundledRoot = bundledRecipeRoot()) {
   const local = path28.resolve(target);
-  if (existsSync21(local)) {
+  if (existsSync22(local)) {
     const recipePath = path28.basename(local) === RECIPE_FILE ? local : path28.join(local, RECIPE_FILE);
     return readRecipeFile(recipePath, false);
   }
@@ -13469,7 +13511,7 @@ async function resolveRecipe(target, bundledRoot = bundledRecipeRoot()) {
 }
 async function verifyFile(root, file) {
   const absolute = path28.resolve(root, ...file.path.split("/"));
-  if (!existsSync21(absolute)) {
+  if (!existsSync22(absolute)) {
     return { path: file.path, expectedSha256: file.sha256, actualSha256: null, status: "missing" };
   }
   const actualSha256 = await sha256File(absolute);
@@ -13547,7 +13589,7 @@ async function installRecipe(target, options = {}) {
   })));
   if (!options.force) {
     for (const file of files) {
-      if (!existsSync21(file.path)) continue;
+      if (!existsSync22(file.path)) continue;
       const current = await readFile23(file.path);
       if (!current.equals(file.data)) {
         throw new Error(
@@ -13572,7 +13614,7 @@ async function installRecipe(target, options = {}) {
 
 // src/pipeline/quality-regression.ts
 import path29 from "path";
-import { existsSync as existsSync22 } from "fs";
+import { existsSync as existsSync23 } from "fs";
 import { readFile as readFile24 } from "fs/promises";
 import { z as z10 } from "zod";
 var SHA256_RE2 = /^[0-9a-f]{64}$/;
@@ -13815,7 +13857,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
     cases
   });
   const data = Buffer.from(JSON.stringify(baseline, null, 2) + "\n");
-  if (existsSync22(absolute) && !options.force) {
+  if (existsSync23(absolute) && !options.force) {
     const current = await readFile24(absolute);
     if (!current.equals(data)) {
       throw new Error(`Quality baseline already exists with different content: ${absolute}. Pass --force to replace it.`);
@@ -14056,7 +14098,7 @@ async function provenanceFile(id, file) {
   return {
     id,
     path: absolute,
-    sha256: existsSync23(absolute) ? await sha256File(absolute) : null,
+    sha256: existsSync24(absolute) ? await sha256File(absolute) : null,
     included: true
   };
 }
@@ -14696,7 +14738,7 @@ async function confirm(question, auto) {
   return answer === "y" || answer === "yes";
 }
 async function requireCompleteWorkspaceClaims(workspacePath) {
-  if (!existsSync23(workspacePath)) {
+  if (!existsSync24(workspacePath)) {
     throw new Error(`Workspace catalog not found: ${workspacePath}`);
   }
   const dir = path30.dirname(path30.resolve(workspacePath));
@@ -14955,7 +14997,7 @@ async function main() {
   if (args.command === "init") {
     if (!args.from) throw new Error("init needs --from <dir> pointing at your existing PNGs.");
     const root = path30.resolve(args.from);
-    if (!existsSync23(root)) throw new Error(`No directory at ${root}`);
+    if (!existsSync24(root)) throw new Error(`No directory at ${root}`);
     const generator = args.generator ?? "map";
     if (generator !== "1dir" && generator !== "map") {
       throw new Error(`--generator must be "1dir" or "map", got "${args.generator}".`);
@@ -15075,7 +15117,7 @@ async function main() {
       log(`  registered "${id}" in ${path30.relative(process.cwd(), workspacePath)}`);
       log(`    manifest: ${project.manifest}`);
       log(`    lock:     ${project.lock}`);
-      if (!existsSync23(lockPath)) {
+      if (!existsSync24(lockPath)) {
         log(
           `  warning: no lockfile there yet \u2014 this project contributes no claims until one is generated`
         );
@@ -15099,7 +15141,7 @@ async function main() {
       return;
     }
     if (args.subcommand === "list") {
-      if (!existsSync23(workspacePath)) {
+      if (!existsSync24(workspacePath)) {
         throw new Error(`Workspace catalog not found: ${workspacePath}`);
       }
       const ws = await loadWorkspace(workspacePath);
@@ -15119,7 +15161,7 @@ async function main() {
       return;
     }
     if (args.subcommand === "status") {
-      if (!existsSync23(workspacePath)) {
+      if (!existsSync24(workspacePath)) {
         throw new Error(`Workspace catalog not found: ${workspacePath}`);
       }
       const ws = await loadWorkspace(workspacePath);
@@ -15175,7 +15217,7 @@ async function main() {
   }
   if (args.command === "gallery" && args.workspace) {
     const workspacePath = path30.resolve(args.workspace);
-    if (!existsSync23(workspacePath)) {
+    if (!existsSync24(workspacePath)) {
       throw new Error(`Workspace catalog not found: ${workspacePath}`);
     }
     const filter = { styles: args.styles, assets: args.assets };
@@ -15210,7 +15252,7 @@ async function main() {
     });
     return;
   }
-  if (!existsSync23(path30.resolve(args.manifest))) {
+  if (!existsSync24(path30.resolve(args.manifest))) {
     throw new Error(
       `No manifest at ${path30.resolve(args.manifest)}. Pass --manifest, or run \`pixelkiln init --from <dir>\`.`
     );
@@ -15316,13 +15358,14 @@ async function main() {
     }
     const started = await startHandEdit(loaded, lock, spec);
     const set = started.members.length > 1;
-    log(`  ${started.created ? "created" : "found"} ${started.source}${set ? ` (${started.members.length} frames)` : ""}${started.declared ? " and declared it as the asset's source" : ""}`);
+    const kind = spec.generator === "frames" ? "frames" : "members";
+    log(`  ${started.created ? "created" : "found"} ${started.source}${set ? ` (${started.members.length} ${kind})` : ""}${started.declared ? " and declared it as the asset's source" : ""}`);
     if (set) for (const member of started.members) log(`    ${member.role ?? ""}  ${path30.relative(process.cwd(), member.path)}`);
     if (args.noOpen) {
       log(`  edit ${set ? "them" : "it"} with your own tool, then run pixelkiln plan; mount and pack place ${set ? "them" : "it"} in place of the generated art`);
     } else {
       const command = openInEditor(started.members[0].path);
-      log(`  opened ${set ? "the first frame " : ""}with: ${command}${process.env.PIXELKILN_EDITOR ? "" : " (set PIXELKILN_EDITOR to choose the program)"}`);
+      log(`  opened ${set ? `the first ${kind === "frames" ? "frame" : "member"} ` : ""}with: ${command}${process.env.PIXELKILN_EDITOR ? "" : " (set PIXELKILN_EDITOR to choose the program)"}`);
     }
     return;
   }
@@ -15458,7 +15501,7 @@ async function main() {
       let intact = true;
       for (const output of entry.outputs) {
         const file = resolveOutputPath(output.path, item.spec.root);
-        if (!existsSync23(file) || await sha256File(file) !== output.sha256) {
+        if (!existsSync24(file) || await sha256File(file) !== output.sha256) {
           intact = false;
           break;
         }
@@ -15840,7 +15883,7 @@ async function main() {
     const lockPaths = [
       .../* @__PURE__ */ new Set([
         ...workspaceLockPaths,
-        ...existsSync23(ownLock) ? [ownLock] : [],
+        ...existsSync24(ownLock) ? [ownLock] : [],
         ...args.claims.map((c) => path30.resolve(c))
       ])
     ];