pixelkiln 0.74.0 → 0.76.0

package/docs/CHARACTERS.md

@@ -448,6 +448,20 @@ reference image change alone also makes it stale.
   new entry is generated, and `plan` reports it `blocked` until its parent
   is downloaded, same as one added by hand. `objectPro` families get the
   same two buttons; see [`objectPro`](./GENERATORS.md#objectpro).
+- **The family view.** Any family member's drawer has a **Family view**
+  button under **Character**. It opens one sheet for the whole family:
+  - A turntable shows the base, or any of its states, one rotation at a
+    time. Drag the sprite sideways, use ← and →, pick a point on the compass,
+    or let it spin.
+  - A grid below has one row per loop and one column per direction. Every
+    loop plays on one clock, and the column the turntable faces is
+    highlighted.
+  - Mirrors are marked ⇋. A loop that hasn't been generated shows its
+    parent's matching rotation, dimmed.
+  - Portraits and outfits sit in a strip underneath. Clicking any cell
+    opens its drawer.
+  - With `--budget`, **Generate** starts one job for every member that is
+    missing, stale, or failed.
 - **The character studio.** With `--edit`, "+ New character" in the
   gallery's header drafts a whole character in one sheet: a new character
   style (engine, size, directions, body, view, folder) or an existing one,
@@ -455,8 +469,11 @@ reference image change alone also makes it stale.
   only the rotations are billed), any number of loops (each a template
   posed by `skeleton-v3` by default, or a plain template, v3, or pro loop,
   in the directions you tick, mirrors added free), and a portrait. The
-  sheet prices the draft live, the way `plan` would, and warns when a new
-  style would also take in existing assets that name no styles. **Create**
+  sheet prices the draft live, the way `plan` would. Pro Flash bases are
+  priced by PixelLab's own quote (`/pro-flash/cost`, a free call) when the
+  project has a key; those rows are marked live, and the offline estimate
+  stands if the quote can't be had. The sheet also warns when a new
+  style would take in existing assets that name no styles. **Create**
   saves everything in one validated write; with `--budget`, **Create &
   generate** also starts one job for all of it, which generates the base
   first and the loops and portrait as soon as it lands.

package/docs/CLI.md

@@ -429,7 +429,9 @@ style, with its provenance one click away: the prompt actually sent, provider
 and generator, dimensions, recorded cost, lock status and plan state, submit
 and download times, job and object ids, every output with its path, SHA-256,
 size, and on-disk status, revision lineage, a character's parent and the
-states and loops that hang off it, the quality record (palette, native-grid
+states and loops that hang off it (with a family view that turns the base
+through its rotations and plays every loop by direction; see
+[Characters](./CHARACTERS.md#working-with-a-cast)), the quality record (palette, native-grid
 detection, audit, named approval), the manifest asset as declared, and raw
 provider metadata.
 

package/docs/GENERATORS.md

@@ -483,6 +483,9 @@ pixel-art image on the Pro Flash model, the same model the `character` and
 - **Cost:** 5 generations up to 96px on the longer side, 6 up to 208px, 9
   beyond, from PixelLab's own `/pro-flash/cost` quotes, which PixelLab calls
   provisional. The billed amount on the finished job is what the lock keeps.
+  `plan` and `gen` use these tiers offline. The gallery's price quote
+  (`--edit`) asks the endpoint itself when the project has a
+  `PIXELLAB_API_KEY`, and marks those rows live.
 
 The same model also edits and inpaints: `"engine": "pro-flash"` on an
 `image-to-image` or `inpaint` revision; see

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixelkiln",
-  "version": "0.74.0",
+  "version": "0.76.0",
   "description": "Manifest-driven pixel-art generation, review, recovery, and packaging with deterministic provenance.",
   "type": "module",
   "sideEffects": false,