pixelkiln 0.80.0 → 0.82.0

package/docs/CHARACTERS.md

@@ -489,6 +489,13 @@ reference image change alone also makes it stale.
   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.
+
+  In the studio's loop rows, the template field suggests the templates
+  PixelLab documents and any this project already uses. A template the
+  project has already drawn plays beside the row, so you can see the motion
+  before choosing it. An unfinished draft is kept in the browser when the
+  sheet is closed, and comes back the next time it opens; **Start over**
+  discards it.
 - `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

@@ -473,9 +473,16 @@ between tabs once one has focus.
 
 #### Looking at sprites
 
+The header keeps search, **Select**, **+ New character**, **Refresh**, and
+**?** in one row. The **View** menu holds sort, grouping, card size (S, M,
+or L), the backdrop, and the playback, refresh, and notification switches.
+**?** (or the <kbd>?</kbd> key) lists every keyboard shortcut and pointer
+gesture the page answers to.
+
 - **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,
+  **Play every loop** in the View menu plays every loop in view at once.
+- **Card size:** S fits more on screen; L draws sprites bigger.
+- **Backdrop:** the swatches in the View menu, 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.
@@ -486,14 +493,24 @@ between tabs once one has focus.
   - 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
+- **Notifications:** with `--budget`, **Notify when a job finishes** 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.
 
+With `--edit`, every change the page writes to the manifest (a form, a
+tag, a new direction, a studio character) says what it saved and offers
+**Undo** (or ⌘Z / ctrl+Z). Undo steps back through this session's writes and
+puts the previous manifest back. It is refused when the file has changed
+outside the gallery since the gallery wrote it, so a hand edit is never
+thrown away.
+
 #### Families and selections
 
+- **Tags:** every tag the manifest declares on an asset becomes a filter
+  chip (`#forge`) beside the state, provider, and generator chips, and is
+  kept in the URL (`?tag=forge`).
 - **Group: by family** gives each character or `objectPro` object its own
   row inside its style. The base comes first, then its states, then each loop
   around the compass, then portraits and outfits. The row header counts the

package/package.json

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