pixelkiln 0.77.0 → 0.79.0

package/docs/CHARACTERS.md

@@ -460,6 +460,18 @@ reference image change alone also makes it stale.
     parent's matching rotation, dimmed.
   - Portraits and outfits sit in a strip underneath. Clicking any cell
     opens its drawer.
+  - With `--edit`, an empty direction the parent can face shows a **+**
+    that adds that direction to the loop. The panel prices the change
+    before anything is written:
+    - A loop written with `animation.directions` gains the direction in
+      its list, and the direction's flip comes free as a mirror when the
+      loop doesn't have it yet.
+    - A loop written out per direction gains an asset: a free mirror of its
+      flip when that is drawn, or a copy of a drawn sibling facing the new
+      way.
+
+    **Add** saves the change. With `--budget`, **Add & generate** also
+    starts the job.
   - With `--budget`, **Generate** starts one job for every member that is
     missing, stale, or failed.
 - **The character studio.** With `--edit`, "+ New character" in the

package/docs/CLI.md

@@ -479,6 +479,26 @@ screenshot.
 
 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.77.0",
+  "version": "0.79.0",
   "description": "Manifest-driven pixel-art generation, review, recovery, and packaging with deterministic provenance.",
   "type": "module",
   "sideEffects": false,