makefx 1.6.10 → 1.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +22 -6
  2. package/makefx.mjs +21377 -6459
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -19,18 +19,33 @@ makefx video generate "A slow push through the market" --name "Push" --type anim
19
19
  makefx audio sfx generate "Wooden coin pickup" --name "Pickup" -o pickup.wav
20
20
  ```
21
21
 
22
- Generate creates a new asset. Regenerate creates a sibling from the source
23
- variant's stored recipe and activates it on success by default:
22
+ Generate creates a new asset. Regenerate replays the source Variant's Recipe
23
+ unchanged; Vary applies explicit changes into a sibling. Both activate the new
24
+ Variant on success by default:
24
25
 
25
26
  ```bash
26
- makefx image regenerate IMAGE_VARIANT_REF "Warmer light"
27
- makefx video regenerate VIDEO_VARIANT_REF "Slower camera"
28
- makefx audio speech regenerate AUDIO_VARIANT_REF "Softer delivery"
27
+ makefx image regenerate IMAGE_VARIANT_REF
28
+ makefx image vary IMAGE_VARIANT_REF "Warmer light"
29
+ makefx video regenerate VIDEO_VARIANT_REF
30
+ makefx video vary VIDEO_VARIANT_REF "Slower camera"
31
+ makefx audio speech regenerate AUDIO_VARIANT_REF
32
+ makefx audio speech vary AUDIO_VARIANT_REF "Softer delivery"
29
33
  ```
30
34
 
31
35
  Use `--no-activate` to keep the current active variant. Retry a transiently
32
36
  failed attempt in place with `makefx variants retry VARIANT_REF`.
33
37
 
38
+ Derive generates a new Asset from exact Variant inputs. Fork replays one
39
+ Variant's editable Recipe into a new Asset. Copy reuses exact media without a
40
+ generation run:
41
+
42
+ ```bash
43
+ makefx image derive "Winter clothes" --refs VARIANT_REF --name "Winter hero" --type character -o winter.png
44
+ makefx variants fork VARIANT_REF --name "Hero branch" --changes "Softer expression" --wait
45
+ makefx variants copy VARIANT_REF --name "Hero copy" --type character
46
+ makefx variants history VARIANT_REF --direction connected --json
47
+ ```
48
+
34
49
  ## Manage assets
35
50
 
36
51
  ```bash
@@ -41,6 +56,7 @@ makefx assets download VARIANT_REF -o hero.png
41
56
  makefx assets delete ASSET_REF --yes
42
57
 
43
58
  makefx variants show VARIANT_REF --wait
59
+ makefx variants history VARIANT_REF
44
60
  makefx variants update VARIANT_REF --starred true --rating approved
45
61
  makefx variants activate VARIANT_REF
46
62
  makefx variants delete VARIANT_REF --yes
@@ -61,4 +77,4 @@ IDs, or runs. Retired commands and aliases are not redirected.
61
77
 
62
78
  Run `makefx --help` or `makefx <noun> --help` for current options.
63
79
 
64
- Version: 1.6.10
80
+ Version: 1.6.12