pixelkiln 0.40.0 → 0.41.0

package/dist/client/gallery.css

@@ -93,6 +93,7 @@ main { width:min(100%,var(--content)); margin:0 auto; border-inline:1px solid va
 .aid { font:600 13px/1.3 var(--mono); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
 .cmeta { display:flex; gap:8px; align-items:center; color:var(--dim); font-size:11.5px;
   font-variant-numeric:tabular-nums; white-space:nowrap; overflow:hidden; }
+.family { font-size:11px; color:var(--dim); margin-top:2px; }
 .cmeta .st { display:inline-flex; align-items:center; gap:5px; }
 .empty { padding:64px 22px; color:var(--dim); text-align:center; }
 .empty p { margin:0 0 12px; }

package/dist/client/gallery.js

@@ -97,6 +97,14 @@ const ACTIVE_PHASES = new Set(['queued', 'submitting', 'polling', 'fetching', 'r
 const PHASE_TONE = { queued: 'cool', submitting: 'cool', polling: 'cool', fetching: 'cool', review: 'warn', done: 'ok', failed: 'bad' };
 // The job still working on this record, if any: what the drawer and its card
 // show while a regeneration, restore, or pull is in flight.
+/** "state of mira", "loop of mira.chair_spin, east": where a character family member sits. */
+const familyLabel = (item) => {
+  const c = item.character;
+  if (!c || c.kind === 'base') return null;
+  const parent = c.parentKey ? c.parentKey.split('/').slice(1).join('/') : null;
+  if (c.kind === 'state') return parent ? 'state of ' + parent : 'state';
+  return (parent ? 'loop of ' + parent : 'loop') + (c.direction ? ', ' + c.direction : '');
+};
 /** The style's palette rule as the manifest has it now, or null. */
 const paletteRuleOf = (item) => {
   const style = snap.styles.find((s) => s.id === item.styleId && s.project === item.project);
@@ -819,6 +827,8 @@ function card(item) {
   meta.append(st, el('span', null, item.width + '×' + item.height));
   if (item.cost) meta.append(el('span', null, fmtCost(item.costUnit, item.cost)));
   body.append(meta);
+  const family = familyLabel(item);
+  if (family) body.append(el('div', 'family', family));
   const cell = thumb(item);
   if (slot >= 0) cell.append(el('span', 'slot', String(slot + 1)));
   if (item.editStatus === 'edited' || item.editStatus === 'regenerated-since') {
@@ -899,6 +909,13 @@ function renderMain(items) {
         meta.append(sw);
       }
       if (s.quality) meta.append(el('span', null, 'quality profile'));
+      if (s.characters) {
+        const parts = [];
+        parts.push(s.characters.bases + (s.characters.bases === 1 ? ' character' : ' characters'));
+        if (s.characters.states) parts.push(s.characters.states + (s.characters.states === 1 ? ' state' : ' states'));
+        if (s.characters.animations) parts.push(s.characters.animations + (s.characters.animations === 1 ? ' loop' : ' loops'));
+        meta.append(el('span', null, parts.join(', ')));
+      }
       meta.append(el('span', null, sec.items.length + ' of ' + s.items + (s.items === 1 ? ' asset' : ' assets')));
       if (Object.keys(s.spendByUnit).length) meta.append(el('span', null, fmtSpend(s.spendByUnit)));
       head.append(meta);
@@ -1910,6 +1927,28 @@ function renderDrawer() {
   const versions = historySection(item);
   if (versions) body.append(versions);
 
+  if (item.character) {
+    const c = item.character;
+    const { s, dl } = section('Character');
+    row(dl, 'kind', c.kind === 'animation' ? 'animation' : c.kind === 'state' ? 'state (a pose or outfit of its parent)' : 'base');
+    if (c.parentKey) row(dl, 'parent', keyLink(item, c.parentKey));
+    row(dl, 'engine', c.mode);
+    if (c.kind === 'animation') row(dl, 'direction', c.direction || '—');
+    else row(dl, 'directions', String(c.directions));
+    if (c.characterId) row(dl, 'character id', c.characterId, { mono: true, copy: c.characterId });
+    const family = snap.items.filter((i) => i.character && i.character.parentKey === item.key && i.project === item.project);
+    if (family.length) {
+      const list = el('div');
+      for (const f of family) {
+        const line = el('div');
+        line.append(document.createTextNode((f.character.kind === 'state' ? 'state ' : 'loop ') + (f.character.direction ? f.character.direction + ' ' : '')), keyLink(item, f.key));
+        list.append(line);
+      }
+      row(dl, family.length === 1 ? 'depends on this' : family.length + ' depend on this', list);
+    }
+    body.append(s);
+  }
+
   if (item.revision || item.revisionParentKey) {
     const { s, dl } = section('Lineage');
     row(dl, 'mode', item.revision ? item.revision.mode : (item.asset && item.asset.revision && item.asset.revision.mode));

package/dist/index.cjs

@@ -2297,12 +2297,7 @@ var PixelLabProvider = class _PixelLabProvider {
     const character = await this.client.getCharacter(jobId);
     if (character.status === "failed") return { status: "failed", error: "character generation failed upstream" };
     if (character.status !== "completed" || !character.rotation_urls) return { status: "processing" };
-    const order = character.directions === 4 ? CHARACTER_DIRECTIONS_4 : CHARACTER_DIRECTIONS_8;
-    const sources = [];
-    for (const direction of order) {
-      const url = character.rotation_urls[direction];
-      if (url) sources.push({ url, role: direction });
-    }
+    const sources = rotationSources(character);
     if (!sources.length) return { status: "failed", error: "character completed with no rotation images" };
     return {
       status: "ready",
@@ -2594,6 +2589,27 @@ var PixelLabProvider = class _PixelLabProvider {
       })))
     };
   }
+  /**
+   * A character's rotation and frame URLs carry its last edit time as a
+   * cache-buster, so the record's URLs can name bytes a cache still holds
+   * after an edit in PixelLab's editor. Objects keep stable URLs.
+   */
+  async refreshSources(objectId, context) {
+    if (context.generator !== "character") return void 0;
+    const [characterId, groupId] = objectId.split("#");
+    const character = await this.client.getCharacter(characterId).catch((err) => {
+      if (err instanceof PixelLabError && err.status === 404) return null;
+      throw err;
+    });
+    if (!character) return null;
+    if (!groupId) return character.status === "completed" ? rotationSources(character) : void 0;
+    const recorded = context.metadata?.character ?? {};
+    const direction = recorded.direction ?? "south";
+    const group = character.animations.find((g) => g.animation_group_id === groupId);
+    const frames = group?.directions.find((d) => d.direction === direction && d.frames.length)?.frames ?? (recorded.animationName ? findAnimation(character, recorded.animationName, direction, recorded.animationId ?? null)?.frames : void 0);
+    if (!frames) return null;
+    return frames.map((url, index) => ({ url, role: `frame-${String(index).padStart(2, "0")}` }));
+  }
 };
 function remoteCharacter(character) {
   return {
@@ -2624,6 +2640,15 @@ function firstUrl(urls) {
   if (!urls) return null;
   return Object.values(urls).find((u) => typeof u === "string") ?? null;
 }
+function rotationSources(character) {
+  const order = character.directions === 4 ? CHARACTER_DIRECTIONS_4 : CHARACTER_DIRECTIONS_8;
+  const sources = [];
+  for (const direction of order) {
+    const url = character.rotation_urls?.[direction];
+    if (url) sources.push({ url, role: direction });
+  }
+  return sources;
+}
 function findAnimation(character, name, direction, animationId) {
   for (const group of character.animations) {
     const match = group.directions.find((d) => d.direction === direction && d.frames.length > 0);
@@ -4554,6 +4579,18 @@ var FakeProvider = class {
     if (!character) throw new Error(`fake provider has no character ${id}`);
     return character;
   }
+  /** Characters answer with whatever the store holds now; other objects keep their URLs. */
+  async refreshSources(objectId, context) {
+    if (context.generator !== "character") return void 0;
+    const [characterId, groupId] = objectId.split("#");
+    const character = this.characters.get(characterId);
+    if (!character) return null;
+    if (!groupId) return character.rotations;
+    const direction = context.metadata?.character?.direction ?? "south";
+    const animation = character.animations.find((a) => a.groupId === groupId && a.direction === direction);
+    if (!animation) return null;
+    return animation.frames.map((url, index) => ({ url, role: `frame-${String(index).padStart(2, "0")}` }));
+  }
   async delete(assetId) {
     this.deleted.push(assetId);
     this.assets.delete(assetId);
@@ -8232,7 +8269,40 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
         result.skipped++;
         continue;
       }
-      const sources = entry.sourceUrls?.length ? entry.sourceUrls : entry.sourceUrl ? [{ url: entry.sourceUrl }] : opts.repair && entry.outputs.length ? entry.outputs.map((o) => ({ url: "", role: o.role, mediaType: o.mediaType })) : [];
+      const recordedSources = entry.sourceUrls?.length ? entry.sourceUrls : entry.sourceUrl ? [{ url: entry.sourceUrl }] : opts.repair && entry.outputs.length ? entry.outputs.map((o) => ({ url: "", role: o.role, mediaType: o.mediaType })) : [];
+      let sources = recordedSources;
+      let rotated = false;
+      if (opts.refresh && entry.status === "downloaded" && entry.objectId && provider.refreshSources) {
+        let current;
+        try {
+          current = await provider.refreshSources(entry.objectId, {
+            generator: entry.generator,
+            metadata: entry.providerMetadata?.[provider.id],
+            sources: recordedSources
+          });
+        } catch (err) {
+          const message6 = err instanceof Error ? err.message : String(err);
+          upsert(lock, key, { status: "download-failed", error: `download failed: ${message6}` });
+          result.failed++;
+          log(`  FAILED  ${key}: ${message6}`);
+          await saveLock(lockPath, lock);
+          continue;
+        }
+        if (current === null) {
+          upsert(lock, key, { status: "download-failed", error: `download failed: ${entry.objectId} no longer exists upstream` });
+          result.failed++;
+          log(`  FAILED  ${key}: ${entry.objectId} no longer exists upstream`);
+          await saveLock(lockPath, lock);
+          continue;
+        }
+        if (current) {
+          sources = current.map((source) => ({
+            ...source,
+            mediaType: source.mediaType ?? recordedSources.find((r) => r.role === source.role)?.mediaType
+          }));
+          rotated = sources.length !== recordedSources.length || sources.some((source, index) => source.url !== recordedSources[index]?.url || source.role !== recordedSources[index]?.role);
+        }
+      }
       if (!sources.length) {
         upsert(lock, key, {
           status: "download-failed",
@@ -8361,6 +8431,10 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
           log(`  wrote   ${import_node_path17.default.relative(process.cwd(), target)}`);
         }
         if (opts.refresh && !wrote) {
+          if (rotated) {
+            const persistent = sources.filter((source) => shouldPersistSourceUrl(source.url));
+            upsert(lock, key, { sourceUrl: persistent[0]?.url ?? null, sourceUrls: persistent });
+          }
           result.unchanged = (result.unchanged ?? 0) + 1;
           continue;
         }
@@ -11509,6 +11583,32 @@ async function samePixels(a, b) {
   }
 }
 var metadataFps = (entry) => entry ? frameSetFps(entry) : null;
+function describeCharacter(spec, entry) {
+  const recorded = entry?.providerMetadata?.[entry.provider]?.character;
+  if (spec?.character) {
+    const character = spec.character;
+    return {
+      kind: character.kind,
+      parentKey: character.parentAssetId ? lockKey(spec.styleId, character.parentAssetId) : null,
+      mode: character.kind === "animation" ? character.animation.mode : character.mode,
+      directions: character.directions,
+      direction: character.animation?.direction ?? null,
+      characterId: recorded?.characterId ?? entry?.objectId?.split("#")[0] ?? null
+    };
+  }
+  if (entry?.generator === "character") {
+    const kind = recorded?.kind === "animation" || entry.outputs.some((o) => o.role?.startsWith("frame-")) ? "animation" : "base";
+    return {
+      kind,
+      parentKey: null,
+      mode: recorded?.mode ?? "standard",
+      directions: recorded?.directions ?? entry.outputs.length,
+      direction: recorded?.direction ?? null,
+      characterId: recorded?.characterId ?? entry.objectId?.split("#")[0] ?? null
+    };
+  }
+  return null;
+}
 async function fileInfo(absolutePath) {
   try {
     const info = await (0, import_promises20.stat)(absolutePath);
@@ -11717,6 +11817,7 @@ async function buildGallerySnapshot(opts) {
       currentSpecHash: spec.specHash,
       revision: entry?.revision ?? null,
       revisionParentKey: spec.revision ? lockKey(spec.styleId, spec.revision.sourceAssetId) : entry?.revision ? lockKey(spec.styleId, entry.revision.sourceAssetId) : null,
+      character: describeCharacter(spec, entry),
       outputs,
       quality,
       providerMetadata: entry?.providerMetadata ?? {},
@@ -11778,6 +11879,7 @@ async function buildGallerySnapshot(opts) {
       currentSpecHash: null,
       revision: entry.revision,
       revisionParentKey: entry.revision ? lockKey(entry.styleId, entry.revision.sourceAssetId) : null,
+      character: describeCharacter(void 0, entry),
       outputs,
       quality: null,
       providerMetadata: entry.providerMetadata ?? {},
@@ -11834,6 +11936,11 @@ async function buildGallerySnapshot(opts) {
       view: style?.view ?? null,
       noBackground: style?.noBackground ?? true,
       quality: Boolean(style?.quality),
+      characters: style?.generator === "character" ? {
+        bases: styleItems.filter((item) => item.character?.kind === "base").length,
+        states: styleItems.filter((item) => item.character?.kind === "state").length,
+        animations: styleItems.filter((item) => item.character?.kind === "animation").length
+      } : null,
       tags: style?.tags ?? [],
       extends: typeof rawStyle?.extends === "string" ? rawStyle.extends : null,
       ownFields: rawStyle ? Object.keys(rawStyle).filter((key) => key !== "extends") : [],