pixelkiln 0.76.0 → 0.78.0

package/docs/CLI.md

@@ -458,6 +458,47 @@ 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.
+
+#### Families and selections
+
+- **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
+  family's members by state and has buttons for the family view and, with
+  `--budget`, for generating whatever is missing, stale or failed.
+- **Select**, or ctrl/⌘-click on any card, switches to picking cards instead
+  of opening them. The bar at the bottom acts on the selection:
+  - **Generate** runs whatever is missing, stale or failed, as one job;
+  - **Regenerate** replaces whatever is up to date;
+  - **Compare** opens up to four of them side by side;
+  - with `--edit`, **Add tag** and **Remove tag** change one tag on every
+    selected asset in a single manifest write.
+
+  Each action shows its count, and Generate and Regenerate show their
+  price. A loop split with `animation.directions` is tagged on its
+  shorthand. "Select all" appears on each style or family, and
+  <kbd>Esc</kbd> leaves select mode.
+
 #### `--json`: the snapshot as data
 
 `--json` prints the same snapshot to stdout without starting a server. It is

package/package.json

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