pixelkiln 0.72.0 → 0.74.0

package/docs/CHARACTERS.md

@@ -448,6 +448,18 @@ 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 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,
+  the base with an optional sprite of your own (uploaded into `refs/`, so
+  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**
+  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.
 - `pack --format godot` and `--format aseprite` write each direction as a
   still and each loop as a looping set at its fps; see
   [engine formats](./ARTIFACTS.md).

package/docs/CLI.md

@@ -525,7 +525,10 @@ job strip under the filters; each job keeps the log lines the CLI would have
 printed. Candidate sets stop in `review`: **Review** slides the `pick` sheet
 out over the gallery, **Apply selections** writes the lockfile and downloads
 the chosen art, and unchosen rows stay in review exactly as with `pick`. A
-regeneration's sheet shows the current art beside the candidates.
+regeneration's sheet shows the current art beside the candidates. A job
+runs in waves, as `gen` does: when a wave lands, anything the job was asked
+for that was waiting on it (a character's loops, a revision of the base)
+goes next, under what is left of the session budget.
 
 #### `--estimate-limit`: skeleton estimates from the page
 

package/docs/GENERATORS.md

@@ -274,7 +274,7 @@ and regenerating the parent makes the child stale.
 | Asset | PixelLab call | Cost |
 |---|---:|---:|
 | base, `mode: standard` | create-character-with-4/8-directions | 1 |
-| base, `mode: v3` | create-character-v3 | 1 + ceil(size² × 8 / 65536): 2 at 64px, 3 at 128px |
+| base, `mode: v3` | create-character-v3 | 1 + ceil(size² × 8 / 65536): 2 at 64px, 3 at 128px; from a `reference`, the rotations alone on its canvas: 1 at 64px |
 | base, `mode: pro` | create-character-pro | 20–40 by canvas |
 | base, `mode: pro-flash` | create-character-pro-flash | image tier (5 to 96px, 6 to 208px, 9 above) + ceil(size² × 8 / 65536): 6 at 64px, 8 at 128px, 17 at 256px; rotations only from a `reference` |
 | state | create-character-state | 20–40 by canvas |

package/docs/MANIFEST.md

@@ -56,7 +56,7 @@ not merely a label edit.
 
 | Field | Type/default | Meaning |
 |---|---|---|
-| `prompt` | string, required unless `mirror`, `portrait`, or `outfit` | The subject wording wrapped by the selected style's prompt prefix and suffix. |
+| `prompt` | string, required unless `mirror`, `portrait`, `outfit`, or a template loop (`animation.template`) | The subject wording wrapped by the selected style's prompt prefix and suffix. A template loop is described by its template; a v3 or pro loop still needs the motion in words. |
 | `width` / `height` | integer 16–8192 | Per-asset dimensions for generators that accept rectangular output. Provider limits may be lower. |
 | `size` | integer 16–8192 | Per-asset square size where the generator uses one dimension. |
 | `file` | string | Output path below the style's `outDir`; defaults to `<category>/<assetId>.png`. |

package/package.json

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