pixelkiln 0.75.0 → 0.77.0

package/docs/CHARACTERS.md

@@ -469,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

@@ -458,6 +458,27 @@ provider, and never writes anything. Stop it with Ctrl+C. See the
 [Getting started guide](GETTING_STARTED.md#start-a-new-project) for a
 screenshot.
 
+#### Looking at sprites
+
+- **Loops on the grid:** a loop's card plays while the pointer is over it.
+  **play loops** in the header plays every loop in view at once.
+- **Backdrop:** the swatches in the header, and beside the zoom controls,
+  set what every sprite sits on. The choices are a transparency grid, dark,
+  light, or any colour you pick, so art can be judged against the game's own
+  background.
+- **Frame player:** a loop's record has one, with:
+  - ◀ and ▶, or <kbd>,</kbd> and <kbd>.</kbd>, to step a frame at a time;
+  - <kbd>space</kbd> to play or pause;
+  - a scrubber to drag through the frames;
+  - a speed setting, with the loop's own fps marked;
+  - **onion skin**, which shows the previous frame faintly under the
+    current one.
+- **Notifications:** with `--budget`, **notify** raises a system
+  notification when a job finishes, or stops for review, while the tab is in
+  the background.
+
+The page keeps these choices in the browser's local storage, per viewer.
+
 #### `--json`: the snapshot as data
 
 `--json` prints the same snapshot to stdout without starting a server. It is

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.75.0",
+  "version": "0.77.0",
   "description": "Manifest-driven pixel-art generation, review, recovery, and packaging with deterministic provenance.",
   "type": "module",
   "sideEffects": false,