@loopress/cli 0.27.0 → 0.28.0

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 (75) hide show
  1. package/README.md +267 -175
  2. package/dist/commands/app/pull.js +17 -4
  3. package/dist/commands/app/push.d.ts +3 -0
  4. package/dist/commands/app/push.js +29 -5
  5. package/dist/commands/composer/push.js +1 -19
  6. package/dist/commands/diff.js +1 -1
  7. package/dist/commands/init.js +2 -0
  8. package/dist/commands/plugin/add.js +6 -3
  9. package/dist/commands/plugin/audit.js +4 -5
  10. package/dist/commands/plugin/pull.d.ts +3 -1
  11. package/dist/commands/plugin/pull.js +17 -9
  12. package/dist/commands/plugin/push.d.ts +5 -1
  13. package/dist/commands/plugin/push.js +90 -37
  14. package/dist/commands/plugin/status.d.ts +1 -0
  15. package/dist/commands/plugin/status.js +21 -2
  16. package/dist/commands/project/config.js +12 -8
  17. package/dist/commands/promote.d.ts +2 -0
  18. package/dist/commands/promote.js +69 -8
  19. package/dist/commands/pull.js +2 -2
  20. package/dist/commands/push.d.ts +1 -0
  21. package/dist/commands/push.js +37 -3
  22. package/dist/commands/template/diff.d.ts +10 -0
  23. package/dist/commands/template/diff.js +13 -0
  24. package/dist/commands/template/list.d.ts +13 -0
  25. package/dist/commands/template/list.js +23 -0
  26. package/dist/commands/template/push.d.ts +20 -0
  27. package/dist/commands/template/push.js +42 -0
  28. package/dist/commands/theme/pull.d.ts +3 -1
  29. package/dist/commands/theme/pull.js +10 -4
  30. package/dist/commands/theme/style/diff.d.ts +2 -0
  31. package/dist/commands/{theme-styles → theme/style}/diff.js +2 -1
  32. package/dist/commands/{theme-styles → theme/style}/pull.d.ts +1 -1
  33. package/dist/commands/{theme-styles → theme/style}/pull.js +3 -3
  34. package/dist/commands/{theme-styles → theme/style}/push.d.ts +1 -1
  35. package/dist/commands/{theme-styles → theme/style}/push.js +5 -5
  36. package/dist/commands/theme/style/rollback.d.ts +2 -0
  37. package/dist/commands/theme/style/rollback.js +6 -0
  38. package/dist/lib/api-client.js +3 -1
  39. package/dist/lib/app-build.d.ts +5 -0
  40. package/dist/lib/app-build.js +69 -0
  41. package/dist/lib/app-manifest.d.ts +4 -0
  42. package/dist/lib/app-manifest.js +8 -0
  43. package/dist/lib/base.js +11 -2
  44. package/dist/lib/bootstrap-full-install.js +45 -14
  45. package/dist/lib/dev-watch.d.ts +1 -1
  46. package/dist/lib/dev-watch.js +3 -1
  47. package/dist/lib/diff-command.d.ts +1 -0
  48. package/dist/lib/diff-command.js +6 -4
  49. package/dist/lib/resource-state.js +43 -1
  50. package/dist/lib/rollback-command.d.ts +1 -0
  51. package/dist/lib/rollback-command.js +8 -6
  52. package/dist/lib/rotate-app-password.js +2 -2
  53. package/dist/lib/validate-local.js +6 -0
  54. package/dist/lib/wp-client.d.ts +4 -1
  55. package/dist/lib/wp-client.js +25 -1
  56. package/dist/types/plugin.d.ts +8 -1
  57. package/dist/types/plugin.js +4 -1
  58. package/dist/types/project-config.generated.d.ts +19 -2
  59. package/dist/utils/composer.d.ts +14 -0
  60. package/dist/utils/composer.js +136 -0
  61. package/dist/utils/page-format.d.ts +8 -0
  62. package/dist/utils/page-format.js +34 -26
  63. package/dist/utils/plugins.d.ts +9 -4
  64. package/dist/utils/plugins.js +16 -7
  65. package/dist/utils/resource-dirs.d.ts +2 -0
  66. package/dist/utils/resource-dirs.js +4 -0
  67. package/dist/utils/seo-format.d.ts +2 -2
  68. package/dist/utils/template-format.d.ts +30 -0
  69. package/dist/utils/template-format.js +36 -0
  70. package/oclif.manifest.json +526 -324
  71. package/package.json +3 -2
  72. package/schemas/project-config.schema.json +25 -4
  73. package/dist/commands/theme-styles/diff.d.ts +0 -2
  74. package/dist/commands/theme-styles/rollback.d.ts +0 -2
  75. package/dist/commands/theme-styles/rollback.js +0 -5
package/README.md CHANGED
@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
21
21
  $ lps COMMAND
22
22
  running command...
23
23
  $ lps (--version)
24
- @loopress/cli/0.27.0 linux-x64 node-v24.21.0
24
+ @loopress/cli/0.28.0 linux-x64 node-v24.21.0
25
25
  $ lps --help [COMMAND]
26
26
  USAGE
27
27
  $ lps COMMAND
@@ -128,14 +128,17 @@ report.
128
128
  * [`lps status`](#lps-status)
129
129
  * [`lps telemetry disable`](#lps-telemetry-disable)
130
130
  * [`lps telemetry enable`](#lps-telemetry-enable)
131
- * [`lps theme-styles diff [PATH]`](#lps-theme-styles-diff-path)
132
- * [`lps theme-styles pull [PATH]`](#lps-theme-styles-pull-path)
133
- * [`lps theme-styles push [PATH]`](#lps-theme-styles-push-path)
134
- * [`lps theme-styles rollback [PATH]`](#lps-theme-styles-rollback-path)
131
+ * [`lps template diff`](#lps-template-diff)
132
+ * [`lps template list`](#lps-template-list)
133
+ * [`lps template push`](#lps-template-push)
135
134
  * [`lps theme add SLUG`](#lps-theme-add-slug)
136
135
  * [`lps theme pull`](#lps-theme-pull)
137
136
  * [`lps theme push`](#lps-theme-push)
138
137
  * [`lps theme status`](#lps-theme-status)
138
+ * [`lps theme style diff [PATH]`](#lps-theme-style-diff-path)
139
+ * [`lps theme style pull [PATH]`](#lps-theme-style-pull-path)
140
+ * [`lps theme style push [PATH]`](#lps-theme-style-push-path)
141
+ * [`lps theme style rollback [PATH]`](#lps-theme-style-rollback-path)
139
142
  * [`lps validate`](#lps-validate)
140
143
 
141
144
  ## `lps acf diff [PATH]`
@@ -168,7 +171,7 @@ EXAMPLES
168
171
  $ lps acf diff --env staging --against production
169
172
  ```
170
173
 
171
- _See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/diff.ts)_
174
+ _See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/acf/diff.ts)_
172
175
 
173
176
  ## `lps acf list`
174
177
 
@@ -195,7 +198,7 @@ EXAMPLES
195
198
  $ lps acf list --type field-groups
196
199
  ```
197
200
 
198
- _See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/list.ts)_
201
+ _See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/acf/list.ts)_
199
202
 
200
203
  ## `lps acf pull [PATH]`
201
204
 
@@ -224,7 +227,7 @@ EXAMPLES
224
227
  $ lps acf pull --type field-groups
225
228
  ```
226
229
 
227
- _See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/pull.ts)_
230
+ _See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/acf/pull.ts)_
228
231
 
229
232
  ## `lps acf push [PATH]`
230
233
 
@@ -253,7 +256,7 @@ EXAMPLES
253
256
  $ lps acf push --type field-groups
254
257
  ```
255
258
 
256
- _See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/push.ts)_
259
+ _See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/acf/push.ts)_
257
260
 
258
261
  ## `lps acf rollback [PATH]`
259
262
 
@@ -290,7 +293,7 @@ EXAMPLES
290
293
  $ lps acf rollback --dry-run
291
294
  ```
292
295
 
293
- _See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/acf/rollback.ts)_
296
+ _See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/acf/rollback.ts)_
294
297
 
295
298
  ## `lps api diff [PATH]`
296
299
 
@@ -322,7 +325,7 @@ EXAMPLES
322
325
  $ lps api diff --env staging --against production
323
326
  ```
324
327
 
325
- _See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/diff.ts)_
328
+ _See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/diff.ts)_
326
329
 
327
330
  ## `lps api list`
328
331
 
@@ -345,7 +348,7 @@ EXAMPLES
345
348
  $ lps api list
346
349
  ```
347
350
 
348
- _See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/list.ts)_
351
+ _See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/list.ts)_
349
352
 
350
353
  ## `lps api publish [PATH]`
351
354
 
@@ -368,7 +371,7 @@ EXAMPLES
368
371
  $ lps api publish --path ./api
369
372
  ```
370
373
 
371
- _See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/publish.ts)_
374
+ _See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/publish.ts)_
372
375
 
373
376
  ## `lps api pull [PATH]`
374
377
 
@@ -398,7 +401,7 @@ EXAMPLES
398
401
  $ lps api pull --path ./api
399
402
  ```
400
403
 
401
- _See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/pull.ts)_
404
+ _See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/pull.ts)_
402
405
 
403
406
  ## `lps api push [PATH]`
404
407
 
@@ -431,7 +434,7 @@ EXAMPLES
431
434
  $ lps api push --prune
432
435
  ```
433
436
 
434
- _See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/push.ts)_
437
+ _See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/push.ts)_
435
438
 
436
439
  ## `lps api rm FILENAME`
437
440
 
@@ -461,7 +464,7 @@ EXAMPLES
461
464
  $ lps api rm hello --yes
462
465
  ```
463
466
 
464
- _See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/rm.ts)_
467
+ _See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/rm.ts)_
465
468
 
466
469
  ## `lps api rollback [PATH]`
467
470
 
@@ -497,7 +500,7 @@ EXAMPLES
497
500
  $ lps api rollback --dry-run
498
501
  ```
499
502
 
500
- _See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/api/rollback.ts)_
503
+ _See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/api/rollback.ts)_
501
504
 
502
505
  ## `lps app list`
503
506
 
@@ -520,7 +523,7 @@ EXAMPLES
520
523
  $ lps app list
521
524
  ```
522
525
 
523
- _See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/list.ts)_
526
+ _See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/app/list.ts)_
524
527
 
525
528
  ## `lps app pull [PATH]`
526
529
 
@@ -548,15 +551,15 @@ EXAMPLES
548
551
  $ lps app pull
549
552
  ```
550
553
 
551
- _See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/pull.ts)_
554
+ _See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/app/pull.ts)_
552
555
 
553
556
  ## `lps app push [NAME]`
554
557
 
555
- Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a built dist/ folder. Only files whose content changed are uploaded.
558
+ Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use --no-build to skip it). Only files whose content changed are uploaded.
556
559
 
557
560
  ```
558
561
  USAGE
559
- $ lps app push [NAME] [--json] [--env <value>] [-d] [-y]
562
+ $ lps app push [NAME] [--json] [--env <value>] [--build] [-d] [-y]
560
563
 
561
564
  ARGUMENTS
562
565
  [NAME] Push only this app (defaults to every app in the directory)
@@ -564,22 +567,26 @@ ARGUMENTS
564
567
  FLAGS
565
568
  -d, --dry-run Show what would change without making changes
566
569
  -y, --yes Answer yes to confirmation prompts
570
+ --[no-]build Run the app's package.json build script before pushing
567
571
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
568
572
 
569
573
  GLOBAL FLAGS
570
574
  --json Format output as json.
571
575
 
572
576
  DESCRIPTION
573
- Push built single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a loopress.app.json
574
- and a built dist/ folder. Only files whose content changed are uploaded.
577
+ Build and push single-page app bundles to WordPress. Each app is an `apps/<name>/` directory holding a
578
+ loopress.app.json and a dist/ folder. When the app has a package.json with a `build` script, it runs first (use
579
+ --no-build to skip it). Only files whose content changed are uploaded.
575
580
 
576
581
  EXAMPLES
577
582
  $ lps app push
578
583
 
579
584
  $ lps app push search
585
+
586
+ $ lps app push --no-build
580
587
  ```
581
588
 
582
- _See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/push.ts)_
589
+ _See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/app/push.ts)_
583
590
 
584
591
  ## `lps app remove NAME`
585
592
 
@@ -608,7 +615,7 @@ EXAMPLES
608
615
  $ lps app remove search
609
616
  ```
610
617
 
611
- _See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/app/remove.ts)_
618
+ _See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/app/remove.ts)_
612
619
 
613
620
  ## `lps composer init`
614
621
 
@@ -631,7 +638,7 @@ EXAMPLES
631
638
  $ lps composer init --dry-run
632
639
  ```
633
640
 
634
- _See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/composer/init.ts)_
641
+ _See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/composer/init.ts)_
635
642
 
636
643
  ## `lps composer pull`
637
644
 
@@ -657,7 +664,7 @@ EXAMPLES
657
664
  $ lps composer pull --dry-run
658
665
  ```
659
666
 
660
- _See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/composer/pull.ts)_
667
+ _See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/composer/pull.ts)_
661
668
 
662
669
  ## `lps composer push`
663
670
 
@@ -685,7 +692,7 @@ EXAMPLES
685
692
  $ lps composer push --dry-run
686
693
  ```
687
694
 
688
- _See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/composer/push.ts)_
695
+ _See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/composer/push.ts)_
689
696
 
690
697
  ## `lps dev`
691
698
 
@@ -696,8 +703,9 @@ USAGE
696
703
  $ lps dev [--only <value>] [--skip <value>]
697
704
 
698
705
  FLAGS
699
- --only=<value> Only watch these resource types (comma-separated): snippets, pages, api, hooks, plugins
700
- --skip=<value> Skip these resource types (comma-separated): snippets, pages, api, hooks, plugins
706
+ --only=<value> Only watch these resource types (comma-separated): snippets, templates, parts, pages, api, hooks,
707
+ plugins
708
+ --skip=<value> Skip these resource types (comma-separated): snippets, templates, parts, pages, api, hooks, plugins
701
709
 
702
710
  DESCRIPTION
703
711
  Watch project files and push changes to the local WordPress instance as they happen. Always targets the "local"
@@ -711,34 +719,34 @@ EXAMPLES
711
719
  $ lps dev --skip=plugins
712
720
  ```
713
721
 
714
- _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/dev.ts)_
722
+ _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/dev.ts)_
715
723
 
716
724
  ## `lps diff`
717
725
 
718
- Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, pages, SEO, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
726
+ Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
719
727
 
720
728
  ```
721
729
  USAGE
722
730
  $ lps diff [--json] [--env <value>] [--against <value>] [--only
723
- snippet|form|acf|api|hook|page|seo|menu|option|theme-styles|composer...] [--skip
724
- snippet|form|acf|api|hook|page|seo|menu|option|theme-styles|composer...]
731
+ snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer...] [--skip
732
+ snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer...]
725
733
 
726
734
  FLAGS
727
735
  --against=<value> Compare the primary environment against this second environment instead of against local files
728
736
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
729
737
  --only=<option>... Only compare these resources
730
- <options: snippet|form|acf|api|hook|page|seo|menu|option|theme-styles|composer>
738
+ <options: snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer>
731
739
  --skip=<option>... Compare every resource except these
732
- <options: snippet|form|acf|api|hook|page|seo|menu|option|theme-styles|composer>
740
+ <options: snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer>
733
741
 
734
742
  GLOBAL FLAGS
735
743
  --json Format output as json.
736
744
 
737
745
  DESCRIPTION
738
746
  Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers
739
- snippets, forms, ACF, API routes, Hooks, pages, SEO, Options, Menus, Theme styles, and Composer. Plugins and themes
740
- have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not
741
- be compared, so it doubles as a CI drift gate.
747
+ snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, and
748
+ Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on
749
+ drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
742
750
 
743
751
  EXAMPLES
744
752
  $ lps diff
@@ -752,7 +760,7 @@ EXAMPLES
752
760
  $ lps diff --skip composer
753
761
  ```
754
762
 
755
- _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/diff.ts)_
763
+ _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/diff.ts)_
756
764
 
757
765
  ## `lps doctor`
758
766
 
@@ -777,7 +785,7 @@ EXAMPLES
777
785
  $ lps doctor --env production
778
786
  ```
779
787
 
780
- _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/doctor.ts)_
788
+ _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/doctor.ts)_
781
789
 
782
790
  ## `lps form diff [PATH]`
783
791
 
@@ -808,7 +816,7 @@ EXAMPLES
808
816
  $ lps form diff --env staging --against production
809
817
  ```
810
818
 
811
- _See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/diff.ts)_
819
+ _See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/form/diff.ts)_
812
820
 
813
821
  ## `lps form list`
814
822
 
@@ -831,7 +839,7 @@ EXAMPLES
831
839
  $ lps form list
832
840
  ```
833
841
 
834
- _See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/list.ts)_
842
+ _See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/form/list.ts)_
835
843
 
836
844
  ## `lps form pull [PATH]`
837
845
 
@@ -856,7 +864,7 @@ EXAMPLES
856
864
  $ lps form pull
857
865
  ```
858
866
 
859
- _See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/pull.ts)_
867
+ _See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/form/pull.ts)_
860
868
 
861
869
  ## `lps form push [PATH]`
862
870
 
@@ -887,7 +895,7 @@ EXAMPLES
887
895
  $ lps form push --allow-notifications
888
896
  ```
889
897
 
890
- _See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/push.ts)_
898
+ _See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/form/push.ts)_
891
899
 
892
900
  ## `lps form rollback [PATH]`
893
901
 
@@ -923,7 +931,7 @@ EXAMPLES
923
931
  $ lps form rollback --dry-run
924
932
  ```
925
933
 
926
- _See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/form/rollback.ts)_
934
+ _See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/form/rollback.ts)_
927
935
 
928
936
  ## `lps help [COMMAND]`
929
937
 
@@ -974,7 +982,7 @@ EXAMPLES
974
982
  $ lps hook diff --env staging --against production
975
983
  ```
976
984
 
977
- _See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/diff.ts)_
985
+ _See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/hook/diff.ts)_
978
986
 
979
987
  ## `lps hook list`
980
988
 
@@ -997,7 +1005,7 @@ EXAMPLES
997
1005
  $ lps hook list
998
1006
  ```
999
1007
 
1000
- _See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/list.ts)_
1008
+ _See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/hook/list.ts)_
1001
1009
 
1002
1010
  ## `lps hook pull [PATH]`
1003
1011
 
@@ -1027,7 +1035,7 @@ EXAMPLES
1027
1035
  $ lps hook pull --path ./hooks
1028
1036
  ```
1029
1037
 
1030
- _See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/pull.ts)_
1038
+ _See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/hook/pull.ts)_
1031
1039
 
1032
1040
  ## `lps hook push [PATH]`
1033
1041
 
@@ -1060,7 +1068,7 @@ EXAMPLES
1060
1068
  $ lps hook push --prune
1061
1069
  ```
1062
1070
 
1063
- _See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/push.ts)_
1071
+ _See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/hook/push.ts)_
1064
1072
 
1065
1073
  ## `lps hook rm FILENAME`
1066
1074
 
@@ -1090,7 +1098,7 @@ EXAMPLES
1090
1098
  $ lps hook rm hello --yes
1091
1099
  ```
1092
1100
 
1093
- _See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/rm.ts)_
1101
+ _See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/hook/rm.ts)_
1094
1102
 
1095
1103
  ## `lps hook rollback [PATH]`
1096
1104
 
@@ -1126,7 +1134,7 @@ EXAMPLES
1126
1134
  $ lps hook rollback --dry-run
1127
1135
  ```
1128
1136
 
1129
- _See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/hook/rollback.ts)_
1137
+ _See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/hook/rollback.ts)_
1130
1138
 
1131
1139
  ## `lps init`
1132
1140
 
@@ -1143,7 +1151,7 @@ EXAMPLES
1143
1151
  $ lps init
1144
1152
  ```
1145
1153
 
1146
- _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/init.ts)_
1154
+ _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/init.ts)_
1147
1155
 
1148
1156
  ## `lps login`
1149
1157
 
@@ -1160,7 +1168,7 @@ EXAMPLES
1160
1168
  $ lps login
1161
1169
  ```
1162
1170
 
1163
- _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/login.ts)_
1171
+ _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/login.ts)_
1164
1172
 
1165
1173
  ## `lps logout`
1166
1174
 
@@ -1177,7 +1185,7 @@ EXAMPLES
1177
1185
  $ lps logout
1178
1186
  ```
1179
1187
 
1180
- _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/logout.ts)_
1188
+ _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/logout.ts)_
1181
1189
 
1182
1190
  ## `lps menu diff [PATH]`
1183
1191
 
@@ -1209,7 +1217,7 @@ EXAMPLES
1209
1217
  $ lps menu diff --env staging --against production
1210
1218
  ```
1211
1219
 
1212
- _See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/diff.ts)_
1220
+ _See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/menu/diff.ts)_
1213
1221
 
1214
1222
  ## `lps menu list`
1215
1223
 
@@ -1232,7 +1240,7 @@ EXAMPLES
1232
1240
  $ lps menu list
1233
1241
  ```
1234
1242
 
1235
- _See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/list.ts)_
1243
+ _See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/menu/list.ts)_
1236
1244
 
1237
1245
  ## `lps menu pull [PATH]`
1238
1246
 
@@ -1257,7 +1265,7 @@ EXAMPLES
1257
1265
  $ lps menu pull
1258
1266
  ```
1259
1267
 
1260
- _See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/pull.ts)_
1268
+ _See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/menu/pull.ts)_
1261
1269
 
1262
1270
  ## `lps menu push [PATH]`
1263
1271
 
@@ -1284,7 +1292,7 @@ EXAMPLES
1284
1292
  $ lps menu push
1285
1293
  ```
1286
1294
 
1287
- _See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/push.ts)_
1295
+ _See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/menu/push.ts)_
1288
1296
 
1289
1297
  ## `lps menu rollback [PATH]`
1290
1298
 
@@ -1320,7 +1328,7 @@ EXAMPLES
1320
1328
  $ lps menu rollback --dry-run
1321
1329
  ```
1322
1330
 
1323
- _See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/menu/rollback.ts)_
1331
+ _See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/menu/rollback.ts)_
1324
1332
 
1325
1333
  ## `lps option add NAME`
1326
1334
 
@@ -1351,7 +1359,7 @@ EXAMPLES
1351
1359
  $ lps option add siteurl
1352
1360
  ```
1353
1361
 
1354
- _See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/add.ts)_
1362
+ _See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/add.ts)_
1355
1363
 
1356
1364
  ## `lps option diff [PATH]`
1357
1365
 
@@ -1383,7 +1391,7 @@ EXAMPLES
1383
1391
  $ lps option diff --env staging --against production
1384
1392
  ```
1385
1393
 
1386
- _See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/diff.ts)_
1394
+ _See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/diff.ts)_
1387
1395
 
1388
1396
  ## `lps option list`
1389
1397
 
@@ -1413,7 +1421,7 @@ EXAMPLES
1413
1421
  $ lps option list --no-core
1414
1422
  ```
1415
1423
 
1416
- _See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/list.ts)_
1424
+ _See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/list.ts)_
1417
1425
 
1418
1426
  ## `lps option pull [PATH]`
1419
1427
 
@@ -1442,7 +1450,7 @@ EXAMPLES
1442
1450
  $ lps option pull
1443
1451
  ```
1444
1452
 
1445
- _See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/pull.ts)_
1453
+ _See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/pull.ts)_
1446
1454
 
1447
1455
  ## `lps option push [PATH]`
1448
1456
 
@@ -1471,7 +1479,7 @@ EXAMPLES
1471
1479
  $ lps option push
1472
1480
  ```
1473
1481
 
1474
- _See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/push.ts)_
1482
+ _See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/push.ts)_
1475
1483
 
1476
1484
  ## `lps option remove NAME`
1477
1485
 
@@ -1504,7 +1512,7 @@ EXAMPLES
1504
1512
  $ lps option remove wpseo_titles --local-only
1505
1513
  ```
1506
1514
 
1507
- _See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/remove.ts)_
1515
+ _See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/remove.ts)_
1508
1516
 
1509
1517
  ## `lps option rollback [PATH]`
1510
1518
 
@@ -1540,7 +1548,7 @@ EXAMPLES
1540
1548
  $ lps option rollback --dry-run
1541
1549
  ```
1542
1550
 
1543
- _See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/option/rollback.ts)_
1551
+ _See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/option/rollback.ts)_
1544
1552
 
1545
1553
  ## `lps page diff [PATH]`
1546
1554
 
@@ -1571,7 +1579,7 @@ EXAMPLES
1571
1579
  $ lps page diff --env staging --against production
1572
1580
  ```
1573
1581
 
1574
- _See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/page/diff.ts)_
1582
+ _See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/page/diff.ts)_
1575
1583
 
1576
1584
  ## `lps page list`
1577
1585
 
@@ -1594,7 +1602,7 @@ EXAMPLES
1594
1602
  $ lps page list
1595
1603
  ```
1596
1604
 
1597
- _See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/page/list.ts)_
1605
+ _See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/page/list.ts)_
1598
1606
 
1599
1607
  ## `lps page push [SLUG]`
1600
1608
 
@@ -1627,7 +1635,7 @@ EXAMPLES
1627
1635
  $ lps page push --dry-run
1628
1636
  ```
1629
1637
 
1630
- _See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/page/push.ts)_
1638
+ _See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/page/push.ts)_
1631
1639
 
1632
1640
  ## `lps plugin add SLUG`
1633
1641
 
@@ -1659,7 +1667,7 @@ EXAMPLES
1659
1667
  $ lps plugin add contact-form-7 --dry-run
1660
1668
  ```
1661
1669
 
1662
- _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/add.ts)_
1670
+ _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/plugin/add.ts)_
1663
1671
 
1664
1672
  ## `lps plugin audit`
1665
1673
 
@@ -1682,7 +1690,7 @@ EXAMPLES
1682
1690
  $ lps plugin audit
1683
1691
  ```
1684
1692
 
1685
- _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/audit.ts)_
1693
+ _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/plugin/audit.ts)_
1686
1694
 
1687
1695
  ## `lps plugin pull`
1688
1696
 
@@ -1708,28 +1716,30 @@ EXAMPLES
1708
1716
  $ lps plugin pull --dry-run
1709
1717
  ```
1710
1718
 
1711
- _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/pull.ts)_
1719
+ _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/plugin/pull.ts)_
1712
1720
 
1713
1721
  ## `lps plugin push`
1714
1722
 
1715
- Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
1723
+ Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist
1716
1724
 
1717
1725
  ```
1718
1726
  USAGE
1719
- $ lps plugin push [--json] [--env <value>] [-d] [-y] [--force] [--prune]
1727
+ $ lps plugin push [--json] [--env <value>] [-d] [-y] [--activate] [--force] [--prune]
1720
1728
 
1721
1729
  FLAGS
1722
1730
  -d, --dry-run Show what would change without making changes
1723
1731
  -y, --yes Answer yes to confirmation prompts
1732
+ --activate composer.json projects only: activate every plugin it declares. Without it, plugins keep their
1733
+ current state and new ones stay inactive
1724
1734
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1725
1735
  --force Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
1726
- --prune Deactivate plugins that are active on the site but absent from loopress.json
1736
+ --prune Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)
1727
1737
 
1728
1738
  GLOBAL FLAGS
1729
1739
  --json Format output as json.
1730
1740
 
1731
1741
  DESCRIPTION
1732
- Install plugins on WordPress to match loopress.json, pinned via Composer + WPackagist
1742
+ Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist
1733
1743
 
1734
1744
  EXAMPLES
1735
1745
  $ lps plugin push
@@ -1739,7 +1749,7 @@ EXAMPLES
1739
1749
  $ lps plugin push --force --prune
1740
1750
  ```
1741
1751
 
1742
- _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/push.ts)_
1752
+ _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/plugin/push.ts)_
1743
1753
 
1744
1754
  ## `lps plugin status`
1745
1755
 
@@ -1762,7 +1772,7 @@ EXAMPLES
1762
1772
  $ lps plugin status
1763
1773
  ```
1764
1774
 
1765
- _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/plugin/status.ts)_
1775
+ _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/plugin/status.ts)_
1766
1776
 
1767
1777
  ## `lps project config`
1768
1778
 
@@ -1780,7 +1790,7 @@ EXAMPLES
1780
1790
  $ lps project config
1781
1791
  ```
1782
1792
 
1783
- _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/config.ts)_
1793
+ _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/config.ts)_
1784
1794
 
1785
1795
  ## `lps project list`
1786
1796
 
@@ -1800,7 +1810,7 @@ EXAMPLES
1800
1810
  $ lps project list
1801
1811
  ```
1802
1812
 
1803
- _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/list.ts)_
1813
+ _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/list.ts)_
1804
1814
 
1805
1815
  ## `lps project pull`
1806
1816
 
@@ -1817,7 +1827,7 @@ EXAMPLES
1817
1827
  $ lps project pull
1818
1828
  ```
1819
1829
 
1820
- _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/pull.ts)_
1830
+ _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/pull.ts)_
1821
1831
 
1822
1832
  ## `lps project push`
1823
1833
 
@@ -1837,7 +1847,7 @@ EXAMPLES
1837
1847
  $ lps project push
1838
1848
  ```
1839
1849
 
1840
- _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/push.ts)_
1850
+ _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/push.ts)_
1841
1851
 
1842
1852
  ## `lps project remove`
1843
1853
 
@@ -1854,7 +1864,7 @@ EXAMPLES
1854
1864
  $ lps project remove
1855
1865
  ```
1856
1866
 
1857
- _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/remove.ts)_
1867
+ _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/remove.ts)_
1858
1868
 
1859
1869
  ## `lps project rotate`
1860
1870
 
@@ -1876,7 +1886,7 @@ EXAMPLES
1876
1886
  $ lps project rotate --env staging
1877
1887
  ```
1878
1888
 
1879
- _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/rotate.ts)_
1889
+ _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/rotate.ts)_
1880
1890
 
1881
1891
  ## `lps project switch`
1882
1892
 
@@ -1893,11 +1903,11 @@ EXAMPLES
1893
1903
  $ lps project switch
1894
1904
  ```
1895
1905
 
1896
- _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/project/switch.ts)_
1906
+ _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/project/switch.ts)_
1897
1907
 
1898
1908
  ## `lps promote FROM TO`
1899
1909
 
1900
- Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process.
1910
+ Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked files are overwritten with <from> in the process. With --dry-run, <from> is pulled into a throwaway copy of the project instead, and the push is only previewed.
1901
1911
 
1902
1912
  ```
1903
1913
  USAGE
@@ -1916,7 +1926,8 @@ GLOBAL FLAGS
1916
1926
 
1917
1927
  DESCRIPTION
1918
1928
  Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked
1919
- files are overwritten with <from> in the process.
1929
+ files are overwritten with <from> in the process. With --dry-run, <from> is pulled into a throwaway copy of the
1930
+ project instead, and the push is only previewed.
1920
1931
 
1921
1932
  EXAMPLES
1922
1933
  $ lps promote staging production
@@ -1924,7 +1935,7 @@ EXAMPLES
1924
1935
  $ lps promote production staging --dry-run
1925
1936
  ```
1926
1937
 
1927
- _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/promote.ts)_
1938
+ _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/promote.ts)_
1928
1939
 
1929
1940
  ## `lps pull`
1930
1941
 
@@ -1954,11 +1965,11 @@ EXAMPLES
1954
1965
  $ lps pull --dry-run
1955
1966
  ```
1956
1967
 
1957
- _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/pull.ts)_
1968
+ _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/pull.ts)_
1958
1969
 
1959
1970
  ## `lps push`
1960
1971
 
1961
- Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, pages, SEO, menus, options, and snippets, to WordPress
1972
+ Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus, options, and snippets, to WordPress
1962
1973
 
1963
1974
  ```
1964
1975
  USAGE
@@ -1973,8 +1984,8 @@ GLOBAL FLAGS
1973
1984
  --json Format output as json.
1974
1985
 
1975
1986
  DESCRIPTION
1976
- Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, pages, SEO, menus, options, and
1977
- snippets, to WordPress
1987
+ Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus,
1988
+ options, and snippets, to WordPress
1978
1989
 
1979
1990
  EXAMPLES
1980
1991
  $ lps push
@@ -1984,7 +1995,7 @@ EXAMPLES
1984
1995
  $ lps push --dry-run
1985
1996
  ```
1986
1997
 
1987
- _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/push.ts)_
1998
+ _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/push.ts)_
1988
1999
 
1989
2000
  ## `lps seo diff [PATH]`
1990
2001
 
@@ -2016,7 +2027,7 @@ EXAMPLES
2016
2027
  $ lps seo diff --env staging --against production
2017
2028
  ```
2018
2029
 
2019
- _See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/diff.ts)_
2030
+ _See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/seo/diff.ts)_
2020
2031
 
2021
2032
  ## `lps seo list`
2022
2033
 
@@ -2042,7 +2053,7 @@ EXAMPLES
2042
2053
  $ lps seo list --post-type post
2043
2054
  ```
2044
2055
 
2045
- _See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/list.ts)_
2056
+ _See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/seo/list.ts)_
2046
2057
 
2047
2058
  ## `lps seo pull [PATH]`
2048
2059
 
@@ -2070,7 +2081,7 @@ EXAMPLES
2070
2081
  $ lps seo pull --post-type post --post-type page
2071
2082
  ```
2072
2083
 
2073
- _See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/pull.ts)_
2084
+ _See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/seo/pull.ts)_
2074
2085
 
2075
2086
  ## `lps seo push [PATH]`
2076
2087
 
@@ -2100,7 +2111,7 @@ EXAMPLES
2100
2111
  $ lps seo push --allow-external-redirects
2101
2112
  ```
2102
2113
 
2103
- _See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/push.ts)_
2114
+ _See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/seo/push.ts)_
2104
2115
 
2105
2116
  ## `lps seo rollback [PATH]`
2106
2117
 
@@ -2136,7 +2147,7 @@ EXAMPLES
2136
2147
  $ lps seo rollback --dry-run
2137
2148
  ```
2138
2149
 
2139
- _See code: [src/commands/seo/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/seo/rollback.ts)_
2150
+ _See code: [src/commands/seo/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/seo/rollback.ts)_
2140
2151
 
2141
2152
  ## `lps snippet diff [PATH]`
2142
2153
 
@@ -2167,7 +2178,7 @@ EXAMPLES
2167
2178
  $ lps snippet diff --env staging --against production
2168
2179
  ```
2169
2180
 
2170
- _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/diff.ts)_
2181
+ _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/snippet/diff.ts)_
2171
2182
 
2172
2183
  ## `lps snippet list`
2173
2184
 
@@ -2190,7 +2201,7 @@ EXAMPLES
2190
2201
  $ lps snippet list
2191
2202
  ```
2192
2203
 
2193
- _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/list.ts)_
2204
+ _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/snippet/list.ts)_
2194
2205
 
2195
2206
  ## `lps snippet publish [PATH]`
2196
2207
 
@@ -2213,7 +2224,7 @@ EXAMPLES
2213
2224
  $ lps snippet publish --path ./snippets
2214
2225
  ```
2215
2226
 
2216
- _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/publish.ts)_
2227
+ _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/snippet/publish.ts)_
2217
2228
 
2218
2229
  ## `lps snippet pull [PATH]`
2219
2230
 
@@ -2243,7 +2254,7 @@ EXAMPLES
2243
2254
  $ lps snippet pull --path ./snippets
2244
2255
  ```
2245
2256
 
2246
- _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/pull.ts)_
2257
+ _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/snippet/pull.ts)_
2247
2258
 
2248
2259
  ## `lps snippet push [PATH]`
2249
2260
 
@@ -2274,7 +2285,7 @@ EXAMPLES
2274
2285
  $ lps snippet push --path ./snippets
2275
2286
  ```
2276
2287
 
2277
- _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/push.ts)_
2288
+ _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/snippet/push.ts)_
2278
2289
 
2279
2290
  ## `lps snippet rollback [PATH]`
2280
2291
 
@@ -2310,7 +2321,7 @@ EXAMPLES
2310
2321
  $ lps snippet rollback --dry-run
2311
2322
  ```
2312
2323
 
2313
- _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/snippet/rollback.ts)_
2324
+ _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/snippet/rollback.ts)_
2314
2325
 
2315
2326
  ## `lps status`
2316
2327
 
@@ -2335,7 +2346,7 @@ EXAMPLES
2335
2346
  $ lps status --env staging
2336
2347
  ```
2337
2348
 
2338
- _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/status.ts)_
2349
+ _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/status.ts)_
2339
2350
 
2340
2351
  ## `lps telemetry disable`
2341
2352
 
@@ -2352,7 +2363,7 @@ EXAMPLES
2352
2363
  $ lps telemetry disable
2353
2364
  ```
2354
2365
 
2355
- _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/telemetry/disable.ts)_
2366
+ _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/telemetry/disable.ts)_
2356
2367
 
2357
2368
  ## `lps telemetry enable`
2358
2369
 
@@ -2369,18 +2380,15 @@ EXAMPLES
2369
2380
  $ lps telemetry enable
2370
2381
  ```
2371
2382
 
2372
- _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/telemetry/enable.ts)_
2383
+ _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/telemetry/enable.ts)_
2373
2384
 
2374
- ## `lps theme-styles diff [PATH]`
2385
+ ## `lps template diff`
2375
2386
 
2376
- Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a WordPress environment, or between two environments
2387
+ Show what differs in block templates and parts between your local files and a WordPress environment, or between two environments. Templates and parts edited in the Site Editor show up too.
2377
2388
 
2378
2389
  ```
2379
2390
  USAGE
2380
- $ lps theme-styles diff [PATH] [--json] [--env <value>] [--against <value>]
2381
-
2382
- ARGUMENTS
2383
- [PATH] Path to theme styles directory (overrides project config)
2391
+ $ lps template diff [--json] [--env <value>] [--against <value>]
2384
2392
 
2385
2393
  FLAGS
2386
2394
  --against=<value> Compare the primary environment against this second environment instead of against local files
@@ -2390,102 +2398,70 @@ GLOBAL FLAGS
2390
2398
  --json Format output as json.
2391
2399
 
2392
2400
  DESCRIPTION
2393
- Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a
2394
- WordPress environment, or between two environments
2401
+ Show what differs in block templates and parts between your local files and a WordPress environment, or between two
2402
+ environments. Templates and parts edited in the Site Editor show up too.
2395
2403
 
2396
2404
  EXAMPLES
2397
- $ lps theme-styles diff
2405
+ $ lps template diff
2398
2406
 
2399
- $ lps theme-styles diff --env staging
2407
+ $ lps template diff --env staging
2400
2408
 
2401
- $ lps theme-styles diff --env staging --against production
2409
+ $ lps template diff --env staging --against production
2402
2410
  ```
2403
2411
 
2404
- _See code: [src/commands/theme-styles/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/diff.ts)_
2412
+ _See code: [src/commands/template/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/template/diff.ts)_
2405
2413
 
2406
- ## `lps theme-styles pull [PATH]`
2414
+ ## `lps template list`
2407
2415
 
2408
- Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
2416
+ Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor
2409
2417
 
2410
2418
  ```
2411
2419
  USAGE
2412
- $ lps theme-styles pull [PATH] [--env <value>] [-d]
2413
-
2414
- ARGUMENTS
2415
- [PATH] Path to theme styles directory (overrides project config)
2420
+ $ lps template list [--json] [--env <value>]
2416
2421
 
2417
2422
  FLAGS
2418
- -d, --dry-run Show what would change without making changes
2419
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2420
-
2421
- DESCRIPTION
2422
- Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
2423
-
2424
- EXAMPLES
2425
- $ lps theme-styles pull
2426
- ```
2427
-
2428
- _See code: [src/commands/theme-styles/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/pull.ts)_
2429
-
2430
- ## `lps theme-styles push [PATH]`
2431
-
2432
- Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
2433
-
2434
- ```
2435
- USAGE
2436
- $ lps theme-styles push [PATH] [--env <value>] [-d]
2437
-
2438
- ARGUMENTS
2439
- [PATH] Path to theme styles directory (overrides project config)
2423
+ --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2440
2424
 
2441
- FLAGS
2442
- -d, --dry-run Show what would change without making changes
2443
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2425
+ GLOBAL FLAGS
2426
+ --json Format output as json.
2444
2427
 
2445
2428
  DESCRIPTION
2446
- Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
2429
+ Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor
2447
2430
 
2448
2431
  EXAMPLES
2449
- $ lps theme-styles push
2432
+ $ lps template list
2450
2433
  ```
2451
2434
 
2452
- _See code: [src/commands/theme-styles/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/push.ts)_
2435
+ _See code: [src/commands/template/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/template/list.ts)_
2453
2436
 
2454
- ## `lps theme-styles rollback [PATH]`
2437
+ ## `lps template push`
2455
2438
 
2456
- Restore the active theme’s Global Styles to a snapshot taken automatically before an earlier `lps theme-styles push`
2439
+ Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.
2457
2440
 
2458
2441
  ```
2459
2442
  USAGE
2460
- $ lps theme-styles rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
2461
-
2462
- ARGUMENTS
2463
- [PATH] Path to theme styles directory (overrides project config)
2443
+ $ lps template push [--json] [--env <value>] [-d] [-y]
2464
2444
 
2465
2445
  FLAGS
2466
2446
  -d, --dry-run Show what would change without making changes
2467
2447
  -y, --yes Answer yes to confirmation prompts
2468
2448
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2469
- --list List available snapshots instead of rolling back
2470
- --to=<value> Roll back to this snapshot id instead of the most recent one
2471
2449
 
2472
2450
  GLOBAL FLAGS
2473
2451
  --json Format output as json.
2474
2452
 
2475
2453
  DESCRIPTION
2476
- Restore the active theme’s Global Styles to a snapshot taken automatically before an earlier `lps theme-styles push`
2454
+ Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of
2455
+ the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it.
2456
+ It is never activated for you.
2477
2457
 
2478
2458
  EXAMPLES
2479
- $ lps theme-styles rollback
2480
-
2481
- $ lps theme-styles rollback --list
2482
-
2483
- $ lps theme-styles rollback --to 1732000000000
2459
+ $ lps template push
2484
2460
 
2485
- $ lps theme-styles rollback --dry-run
2461
+ $ lps template push --dry-run
2486
2462
  ```
2487
2463
 
2488
- _See code: [src/commands/theme-styles/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme-styles/rollback.ts)_
2464
+ _See code: [src/commands/template/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/template/push.ts)_
2489
2465
 
2490
2466
  ## `lps theme add SLUG`
2491
2467
 
@@ -2515,7 +2491,7 @@ EXAMPLES
2515
2491
  $ lps theme add generatepress --version 3.4.0
2516
2492
  ```
2517
2493
 
2518
- _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/add.ts)_
2494
+ _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/add.ts)_
2519
2495
 
2520
2496
  ## `lps theme pull`
2521
2497
 
@@ -2539,7 +2515,7 @@ EXAMPLES
2539
2515
  $ lps theme pull
2540
2516
  ```
2541
2517
 
2542
- _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/pull.ts)_
2518
+ _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/pull.ts)_
2543
2519
 
2544
2520
  ## `lps theme push`
2545
2521
 
@@ -2567,7 +2543,7 @@ EXAMPLES
2567
2543
  $ lps theme push --force
2568
2544
  ```
2569
2545
 
2570
- _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/push.ts)_
2546
+ _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/push.ts)_
2571
2547
 
2572
2548
  ## `lps theme status`
2573
2549
 
@@ -2590,7 +2566,123 @@ EXAMPLES
2590
2566
  $ lps theme status
2591
2567
  ```
2592
2568
 
2593
- _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/theme/status.ts)_
2569
+ _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/status.ts)_
2570
+
2571
+ ## `lps theme style diff [PATH]`
2572
+
2573
+ Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a WordPress environment, or between two environments
2574
+
2575
+ ```
2576
+ USAGE
2577
+ $ lps theme style diff [PATH] [--json] [--env <value>] [--against <value>]
2578
+
2579
+ ARGUMENTS
2580
+ [PATH] Path to theme styles directory (overrides project config)
2581
+
2582
+ FLAGS
2583
+ --against=<value> Compare the primary environment against this second environment instead of against local files
2584
+ --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2585
+
2586
+ GLOBAL FLAGS
2587
+ --json Format output as json.
2588
+
2589
+ DESCRIPTION
2590
+ Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a
2591
+ WordPress environment, or between two environments
2592
+
2593
+ EXAMPLES
2594
+ $ lps theme style diff
2595
+
2596
+ $ lps theme style diff --env staging
2597
+
2598
+ $ lps theme style diff --env staging --against production
2599
+ ```
2600
+
2601
+ _See code: [src/commands/theme/style/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/style/diff.ts)_
2602
+
2603
+ ## `lps theme style pull [PATH]`
2604
+
2605
+ Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
2606
+
2607
+ ```
2608
+ USAGE
2609
+ $ lps theme style pull [PATH] [--env <value>] [-d]
2610
+
2611
+ ARGUMENTS
2612
+ [PATH] Path to theme styles directory (overrides project config)
2613
+
2614
+ FLAGS
2615
+ -d, --dry-run Show what would change without making changes
2616
+ --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2617
+
2618
+ DESCRIPTION
2619
+ Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
2620
+
2621
+ EXAMPLES
2622
+ $ lps theme style pull
2623
+ ```
2624
+
2625
+ _See code: [src/commands/theme/style/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/style/pull.ts)_
2626
+
2627
+ ## `lps theme style push [PATH]`
2628
+
2629
+ Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
2630
+
2631
+ ```
2632
+ USAGE
2633
+ $ lps theme style push [PATH] [--env <value>] [-d]
2634
+
2635
+ ARGUMENTS
2636
+ [PATH] Path to theme styles directory (overrides project config)
2637
+
2638
+ FLAGS
2639
+ -d, --dry-run Show what would change without making changes
2640
+ --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2641
+
2642
+ DESCRIPTION
2643
+ Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
2644
+
2645
+ EXAMPLES
2646
+ $ lps theme style push
2647
+ ```
2648
+
2649
+ _See code: [src/commands/theme/style/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/style/push.ts)_
2650
+
2651
+ ## `lps theme style rollback [PATH]`
2652
+
2653
+ Restore the active theme's Global Styles to a snapshot taken automatically before an earlier `lps theme style push`
2654
+
2655
+ ```
2656
+ USAGE
2657
+ $ lps theme style rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
2658
+
2659
+ ARGUMENTS
2660
+ [PATH] Path to theme styles directory (overrides project config)
2661
+
2662
+ FLAGS
2663
+ -d, --dry-run Show what would change without making changes
2664
+ -y, --yes Answer yes to confirmation prompts
2665
+ --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2666
+ --list List available snapshots instead of rolling back
2667
+ --to=<value> Roll back to this snapshot id instead of the most recent one
2668
+
2669
+ GLOBAL FLAGS
2670
+ --json Format output as json.
2671
+
2672
+ DESCRIPTION
2673
+ Restore the active theme's Global Styles to a snapshot taken automatically before an earlier `lps theme style push`
2674
+
2675
+ EXAMPLES
2676
+ $ lps theme style rollback
2677
+
2678
+ $ lps theme style rollback --list
2679
+
2680
+ $ lps theme style rollback --to 1732000000000
2681
+
2682
+ $ lps theme style rollback --dry-run
2683
+ ```
2684
+
2685
+ _See code: [src/commands/theme/style/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/theme/style/rollback.ts)_
2594
2686
 
2595
2687
  ## `lps validate`
2596
2688
 
@@ -2610,5 +2702,5 @@ EXAMPLES
2610
2702
  $ lps validate
2611
2703
  ```
2612
2704
 
2613
- _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.27.0/cli/src/commands/validate.ts)_
2705
+ _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.28.0/cli/src/commands/validate.ts)_
2614
2706
  <!-- commandsstop -->