@loopress/cli 0.26.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 (87) hide show
  1. package/README.md +275 -177
  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 +7 -1
  8. package/dist/commands/page/push.js +2 -2
  9. package/dist/commands/plugin/add.d.ts +8 -1
  10. package/dist/commands/plugin/add.js +10 -5
  11. package/dist/commands/plugin/audit.js +4 -5
  12. package/dist/commands/plugin/pull.d.ts +3 -1
  13. package/dist/commands/plugin/pull.js +17 -9
  14. package/dist/commands/plugin/push.d.ts +5 -1
  15. package/dist/commands/plugin/push.js +90 -37
  16. package/dist/commands/plugin/status.d.ts +1 -0
  17. package/dist/commands/plugin/status.js +21 -2
  18. package/dist/commands/project/config.js +12 -8
  19. package/dist/commands/promote.d.ts +2 -0
  20. package/dist/commands/promote.js +70 -8
  21. package/dist/commands/pull.js +8 -4
  22. package/dist/commands/push.d.ts +1 -0
  23. package/dist/commands/push.js +42 -4
  24. package/dist/commands/template/diff.d.ts +10 -0
  25. package/dist/commands/template/diff.js +13 -0
  26. package/dist/commands/template/list.d.ts +13 -0
  27. package/dist/commands/template/list.js +23 -0
  28. package/dist/commands/template/push.d.ts +20 -0
  29. package/dist/commands/template/push.js +42 -0
  30. package/dist/commands/theme/add.d.ts +8 -1
  31. package/dist/commands/theme/add.js +4 -2
  32. package/dist/commands/theme/pull.d.ts +3 -1
  33. package/dist/commands/theme/pull.js +10 -4
  34. package/dist/commands/theme/style/diff.d.ts +2 -0
  35. package/dist/commands/{theme-styles → theme/style}/diff.js +2 -1
  36. package/dist/commands/{theme-styles → theme/style}/pull.d.ts +1 -1
  37. package/dist/commands/{theme-styles → theme/style}/pull.js +3 -3
  38. package/dist/commands/{theme-styles → theme/style}/push.d.ts +1 -1
  39. package/dist/commands/{theme-styles → theme/style}/push.js +5 -5
  40. package/dist/commands/theme/style/rollback.d.ts +2 -0
  41. package/dist/commands/theme/style/rollback.js +6 -0
  42. package/dist/lib/api-client.js +26 -1
  43. package/dist/lib/app-build.d.ts +5 -0
  44. package/dist/lib/app-build.js +69 -0
  45. package/dist/lib/app-manifest.d.ts +4 -0
  46. package/dist/lib/app-manifest.js +8 -0
  47. package/dist/lib/base.js +11 -2
  48. package/dist/lib/bootstrap-full-install.js +45 -14
  49. package/dist/lib/dev-watch.d.ts +1 -1
  50. package/dist/lib/dev-watch.js +4 -1
  51. package/dist/lib/diff-command.d.ts +1 -0
  52. package/dist/lib/diff-command.js +6 -4
  53. package/dist/lib/json-delegation.d.ts +1 -0
  54. package/dist/lib/json-delegation.js +18 -0
  55. package/dist/lib/load-snippets.js +1 -1
  56. package/dist/lib/php-files-command.js +4 -3
  57. package/dist/lib/readdir-tolerant.js +15 -5
  58. package/dist/lib/resource-state.js +43 -1
  59. package/dist/lib/rollback-command.d.ts +1 -0
  60. package/dist/lib/rollback-command.js +8 -6
  61. package/dist/lib/rotate-app-password.js +2 -2
  62. package/dist/lib/snapshot-store.js +14 -0
  63. package/dist/lib/validate-local.js +34 -7
  64. package/dist/lib/wp-client.d.ts +4 -1
  65. package/dist/lib/wp-client.js +56 -3
  66. package/dist/types/plugin.d.ts +8 -1
  67. package/dist/types/plugin.js +4 -1
  68. package/dist/types/project-config.generated.d.ts +19 -2
  69. package/dist/utils/composer.d.ts +14 -0
  70. package/dist/utils/composer.js +136 -0
  71. package/dist/utils/loopress-config.d.ts +1 -0
  72. package/dist/utils/loopress-config.js +14 -0
  73. package/dist/utils/page-format.d.ts +12 -0
  74. package/dist/utils/page-format.js +41 -26
  75. package/dist/utils/plugins.d.ts +9 -4
  76. package/dist/utils/plugins.js +16 -7
  77. package/dist/utils/resource-dirs.d.ts +2 -0
  78. package/dist/utils/resource-dirs.js +4 -0
  79. package/dist/utils/seo-format.d.ts +2 -2
  80. package/dist/utils/template-format.d.ts +30 -0
  81. package/dist/utils/template-format.js +36 -0
  82. package/oclif.manifest.json +536 -320
  83. package/package.json +7 -4
  84. package/schemas/project-config.schema.json +25 -4
  85. package/dist/commands/theme-styles/diff.d.ts +0 -2
  86. package/dist/commands/theme-styles/rollback.d.ts +0 -2
  87. 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.26.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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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, plugins
700
- --skip=<value> Skip these resource types (comma-separated): snippets, pages, api, 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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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/v0.26.0/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
 
@@ -1635,7 +1643,7 @@ Add a WordPress.org plugin to loopress.json
1635
1643
 
1636
1644
  ```
1637
1645
  USAGE
1638
- $ lps plugin add SLUG [--env <value>] [-d] [--version <value>]
1646
+ $ lps plugin add SLUG [--json] [--env <value>] [-d] [--version <value>]
1639
1647
 
1640
1648
  ARGUMENTS
1641
1649
  SLUG Plugin slug on WordPress.org
@@ -1645,6 +1653,9 @@ FLAGS
1645
1653
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1646
1654
  --version=<value> Exact version to pin (default: "latest", tracked on every push)
1647
1655
 
1656
+ GLOBAL FLAGS
1657
+ --json Format output as json.
1658
+
1648
1659
  DESCRIPTION
1649
1660
  Add a WordPress.org plugin to loopress.json
1650
1661
 
@@ -1656,7 +1667,7 @@ EXAMPLES
1656
1667
  $ lps plugin add contact-form-7 --dry-run
1657
1668
  ```
1658
1669
 
1659
- _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1660
1671
 
1661
1672
  ## `lps plugin audit`
1662
1673
 
@@ -1679,7 +1690,7 @@ EXAMPLES
1679
1690
  $ lps plugin audit
1680
1691
  ```
1681
1692
 
1682
- _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1683
1694
 
1684
1695
  ## `lps plugin pull`
1685
1696
 
@@ -1705,28 +1716,30 @@ EXAMPLES
1705
1716
  $ lps plugin pull --dry-run
1706
1717
  ```
1707
1718
 
1708
- _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1709
1720
 
1710
1721
  ## `lps plugin push`
1711
1722
 
1712
- 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
1713
1724
 
1714
1725
  ```
1715
1726
  USAGE
1716
- $ lps plugin push [--json] [--env <value>] [-d] [-y] [--force] [--prune]
1727
+ $ lps plugin push [--json] [--env <value>] [-d] [-y] [--activate] [--force] [--prune]
1717
1728
 
1718
1729
  FLAGS
1719
1730
  -d, --dry-run Show what would change without making changes
1720
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
1721
1734
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1722
1735
  --force Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
1723
- --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)
1724
1737
 
1725
1738
  GLOBAL FLAGS
1726
1739
  --json Format output as json.
1727
1740
 
1728
1741
  DESCRIPTION
1729
- 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
1730
1743
 
1731
1744
  EXAMPLES
1732
1745
  $ lps plugin push
@@ -1736,7 +1749,7 @@ EXAMPLES
1736
1749
  $ lps plugin push --force --prune
1737
1750
  ```
1738
1751
 
1739
- _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1740
1753
 
1741
1754
  ## `lps plugin status`
1742
1755
 
@@ -1759,7 +1772,7 @@ EXAMPLES
1759
1772
  $ lps plugin status
1760
1773
  ```
1761
1774
 
1762
- _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1763
1776
 
1764
1777
  ## `lps project config`
1765
1778
 
@@ -1777,7 +1790,7 @@ EXAMPLES
1777
1790
  $ lps project config
1778
1791
  ```
1779
1792
 
1780
- _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1781
1794
 
1782
1795
  ## `lps project list`
1783
1796
 
@@ -1797,7 +1810,7 @@ EXAMPLES
1797
1810
  $ lps project list
1798
1811
  ```
1799
1812
 
1800
- _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1801
1814
 
1802
1815
  ## `lps project pull`
1803
1816
 
@@ -1814,7 +1827,7 @@ EXAMPLES
1814
1827
  $ lps project pull
1815
1828
  ```
1816
1829
 
1817
- _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1818
1831
 
1819
1832
  ## `lps project push`
1820
1833
 
@@ -1834,7 +1847,7 @@ EXAMPLES
1834
1847
  $ lps project push
1835
1848
  ```
1836
1849
 
1837
- _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1838
1851
 
1839
1852
  ## `lps project remove`
1840
1853
 
@@ -1851,7 +1864,7 @@ EXAMPLES
1851
1864
  $ lps project remove
1852
1865
  ```
1853
1866
 
1854
- _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1855
1868
 
1856
1869
  ## `lps project rotate`
1857
1870
 
@@ -1873,7 +1886,7 @@ EXAMPLES
1873
1886
  $ lps project rotate --env staging
1874
1887
  ```
1875
1888
 
1876
- _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1877
1890
 
1878
1891
  ## `lps project switch`
1879
1892
 
@@ -1890,11 +1903,11 @@ EXAMPLES
1890
1903
  $ lps project switch
1891
1904
  ```
1892
1905
 
1893
- _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1894
1907
 
1895
1908
  ## `lps promote FROM TO`
1896
1909
 
1897
- 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.
1898
1911
 
1899
1912
  ```
1900
1913
  USAGE
@@ -1913,7 +1926,8 @@ GLOBAL FLAGS
1913
1926
 
1914
1927
  DESCRIPTION
1915
1928
  Copy every tracked resource from one environment to another by pulling from <from> then pushing to <to>. Local tracked
1916
- 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.
1917
1931
 
1918
1932
  EXAMPLES
1919
1933
  $ lps promote staging production
@@ -1921,7 +1935,7 @@ EXAMPLES
1921
1935
  $ lps promote production staging --dry-run
1922
1936
  ```
1923
1937
 
1924
- _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1925
1939
 
1926
1940
  ## `lps pull`
1927
1941
 
@@ -1951,11 +1965,11 @@ EXAMPLES
1951
1965
  $ lps pull --dry-run
1952
1966
  ```
1953
1967
 
1954
- _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1955
1969
 
1956
1970
  ## `lps push`
1957
1971
 
1958
- 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
1959
1973
 
1960
1974
  ```
1961
1975
  USAGE
@@ -1970,8 +1984,8 @@ GLOBAL FLAGS
1970
1984
  --json Format output as json.
1971
1985
 
1972
1986
  DESCRIPTION
1973
- Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, pages, SEO, menus, options, and
1974
- 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
1975
1989
 
1976
1990
  EXAMPLES
1977
1991
  $ lps push
@@ -1981,7 +1995,7 @@ EXAMPLES
1981
1995
  $ lps push --dry-run
1982
1996
  ```
1983
1997
 
1984
- _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
1985
1999
 
1986
2000
  ## `lps seo diff [PATH]`
1987
2001
 
@@ -2013,7 +2027,7 @@ EXAMPLES
2013
2027
  $ lps seo diff --env staging --against production
2014
2028
  ```
2015
2029
 
2016
- _See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2017
2031
 
2018
2032
  ## `lps seo list`
2019
2033
 
@@ -2039,7 +2053,7 @@ EXAMPLES
2039
2053
  $ lps seo list --post-type post
2040
2054
  ```
2041
2055
 
2042
- _See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2043
2057
 
2044
2058
  ## `lps seo pull [PATH]`
2045
2059
 
@@ -2067,7 +2081,7 @@ EXAMPLES
2067
2081
  $ lps seo pull --post-type post --post-type page
2068
2082
  ```
2069
2083
 
2070
- _See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2071
2085
 
2072
2086
  ## `lps seo push [PATH]`
2073
2087
 
@@ -2097,7 +2111,7 @@ EXAMPLES
2097
2111
  $ lps seo push --allow-external-redirects
2098
2112
  ```
2099
2113
 
2100
- _See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2101
2115
 
2102
2116
  ## `lps seo rollback [PATH]`
2103
2117
 
@@ -2133,7 +2147,7 @@ EXAMPLES
2133
2147
  $ lps seo rollback --dry-run
2134
2148
  ```
2135
2149
 
2136
- _See code: [src/commands/seo/rollback.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2137
2151
 
2138
2152
  ## `lps snippet diff [PATH]`
2139
2153
 
@@ -2164,7 +2178,7 @@ EXAMPLES
2164
2178
  $ lps snippet diff --env staging --against production
2165
2179
  ```
2166
2180
 
2167
- _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2168
2182
 
2169
2183
  ## `lps snippet list`
2170
2184
 
@@ -2187,7 +2201,7 @@ EXAMPLES
2187
2201
  $ lps snippet list
2188
2202
  ```
2189
2203
 
2190
- _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2191
2205
 
2192
2206
  ## `lps snippet publish [PATH]`
2193
2207
 
@@ -2210,7 +2224,7 @@ EXAMPLES
2210
2224
  $ lps snippet publish --path ./snippets
2211
2225
  ```
2212
2226
 
2213
- _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2214
2228
 
2215
2229
  ## `lps snippet pull [PATH]`
2216
2230
 
@@ -2240,7 +2254,7 @@ EXAMPLES
2240
2254
  $ lps snippet pull --path ./snippets
2241
2255
  ```
2242
2256
 
2243
- _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2244
2258
 
2245
2259
  ## `lps snippet push [PATH]`
2246
2260
 
@@ -2271,7 +2285,7 @@ EXAMPLES
2271
2285
  $ lps snippet push --path ./snippets
2272
2286
  ```
2273
2287
 
2274
- _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2275
2289
 
2276
2290
  ## `lps snippet rollback [PATH]`
2277
2291
 
@@ -2307,7 +2321,7 @@ EXAMPLES
2307
2321
  $ lps snippet rollback --dry-run
2308
2322
  ```
2309
2323
 
2310
- _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2311
2325
 
2312
2326
  ## `lps status`
2313
2327
 
@@ -2332,7 +2346,7 @@ EXAMPLES
2332
2346
  $ lps status --env staging
2333
2347
  ```
2334
2348
 
2335
- _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2336
2350
 
2337
2351
  ## `lps telemetry disable`
2338
2352
 
@@ -2349,7 +2363,7 @@ EXAMPLES
2349
2363
  $ lps telemetry disable
2350
2364
  ```
2351
2365
 
2352
- _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2353
2367
 
2354
2368
  ## `lps telemetry enable`
2355
2369
 
@@ -2366,18 +2380,15 @@ EXAMPLES
2366
2380
  $ lps telemetry enable
2367
2381
  ```
2368
2382
 
2369
- _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2370
2384
 
2371
- ## `lps theme-styles diff [PATH]`
2385
+ ## `lps template diff`
2372
2386
 
2373
- 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.
2374
2388
 
2375
2389
  ```
2376
2390
  USAGE
2377
- $ lps theme-styles diff [PATH] [--json] [--env <value>] [--against <value>]
2378
-
2379
- ARGUMENTS
2380
- [PATH] Path to theme styles directory (overrides project config)
2391
+ $ lps template diff [--json] [--env <value>] [--against <value>]
2381
2392
 
2382
2393
  FLAGS
2383
2394
  --against=<value> Compare the primary environment against this second environment instead of against local files
@@ -2387,102 +2398,70 @@ GLOBAL FLAGS
2387
2398
  --json Format output as json.
2388
2399
 
2389
2400
  DESCRIPTION
2390
- Show what differs in the active block theme's Global Styles (Site Editor > Styles) between your local file and a
2391
- 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.
2392
2403
 
2393
2404
  EXAMPLES
2394
- $ lps theme-styles diff
2405
+ $ lps template diff
2395
2406
 
2396
- $ lps theme-styles diff --env staging
2407
+ $ lps template diff --env staging
2397
2408
 
2398
- $ lps theme-styles diff --env staging --against production
2409
+ $ lps template diff --env staging --against production
2399
2410
  ```
2400
2411
 
2401
- _See code: [src/commands/theme-styles/diff.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2402
2413
 
2403
- ## `lps theme-styles pull [PATH]`
2414
+ ## `lps template list`
2404
2415
 
2405
- 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
2406
2417
 
2407
2418
  ```
2408
2419
  USAGE
2409
- $ lps theme-styles pull [PATH] [--env <value>] [-d]
2410
-
2411
- ARGUMENTS
2412
- [PATH] Path to theme styles directory (overrides project config)
2420
+ $ lps template list [--json] [--env <value>]
2413
2421
 
2414
2422
  FLAGS
2415
- -d, --dry-run Show what would change without making changes
2416
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2417
-
2418
- DESCRIPTION
2419
- Pull the active block theme's Global Styles customizations (Site Editor > Styles) from WordPress into a local file
2420
-
2421
- EXAMPLES
2422
- $ lps theme-styles pull
2423
- ```
2424
-
2425
- _See code: [src/commands/theme-styles/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/src/commands/theme-styles/pull.ts)_
2426
-
2427
- ## `lps theme-styles push [PATH]`
2428
-
2429
- Push the local Global Styles file to the active block theme's Site Editor > Styles on WordPress
2430
-
2431
- ```
2432
- USAGE
2433
- $ lps theme-styles push [PATH] [--env <value>] [-d]
2434
-
2435
- ARGUMENTS
2436
- [PATH] Path to theme styles directory (overrides project config)
2423
+ --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2437
2424
 
2438
- FLAGS
2439
- -d, --dry-run Show what would change without making changes
2440
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2425
+ GLOBAL FLAGS
2426
+ --json Format output as json.
2441
2427
 
2442
2428
  DESCRIPTION
2443
- 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
2444
2430
 
2445
2431
  EXAMPLES
2446
- $ lps theme-styles push
2432
+ $ lps template list
2447
2433
  ```
2448
2434
 
2449
- _See code: [src/commands/theme-styles/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2450
2436
 
2451
- ## `lps theme-styles rollback [PATH]`
2437
+ ## `lps template push`
2452
2438
 
2453
- 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.
2454
2440
 
2455
2441
  ```
2456
2442
  USAGE
2457
- $ lps theme-styles rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
2458
-
2459
- ARGUMENTS
2460
- [PATH] Path to theme styles directory (overrides project config)
2443
+ $ lps template push [--json] [--env <value>] [-d] [-y]
2461
2444
 
2462
2445
  FLAGS
2463
2446
  -d, --dry-run Show what would change without making changes
2464
2447
  -y, --yes Answer yes to confirmation prompts
2465
2448
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2466
- --list List available snapshots instead of rolling back
2467
- --to=<value> Roll back to this snapshot id instead of the most recent one
2468
2449
 
2469
2450
  GLOBAL FLAGS
2470
2451
  --json Format output as json.
2471
2452
 
2472
2453
  DESCRIPTION
2473
- 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.
2474
2457
 
2475
2458
  EXAMPLES
2476
- $ lps theme-styles rollback
2477
-
2478
- $ lps theme-styles rollback --list
2459
+ $ lps template push
2479
2460
 
2480
- $ lps theme-styles rollback --to 1732000000000
2481
-
2482
- $ lps theme-styles rollback --dry-run
2461
+ $ lps template push --dry-run
2483
2462
  ```
2484
2463
 
2485
- _See code: [src/commands/theme-styles/rollback.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2486
2465
 
2487
2466
  ## `lps theme add SLUG`
2488
2467
 
@@ -2490,7 +2469,7 @@ Add a WordPress.org theme to loopress.json
2490
2469
 
2491
2470
  ```
2492
2471
  USAGE
2493
- $ lps theme add SLUG [--env <value>] [-d] [--version <value>]
2472
+ $ lps theme add SLUG [--json] [--env <value>] [-d] [--version <value>]
2494
2473
 
2495
2474
  ARGUMENTS
2496
2475
  SLUG Theme slug on WordPress.org
@@ -2500,6 +2479,9 @@ FLAGS
2500
2479
  --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2501
2480
  --version=<value> Exact version to pin (default: "latest")
2502
2481
 
2482
+ GLOBAL FLAGS
2483
+ --json Format output as json.
2484
+
2503
2485
  DESCRIPTION
2504
2486
  Add a WordPress.org theme to loopress.json
2505
2487
 
@@ -2509,7 +2491,7 @@ EXAMPLES
2509
2491
  $ lps theme add generatepress --version 3.4.0
2510
2492
  ```
2511
2493
 
2512
- _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2513
2495
 
2514
2496
  ## `lps theme pull`
2515
2497
 
@@ -2533,7 +2515,7 @@ EXAMPLES
2533
2515
  $ lps theme pull
2534
2516
  ```
2535
2517
 
2536
- _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2537
2519
 
2538
2520
  ## `lps theme push`
2539
2521
 
@@ -2561,7 +2543,7 @@ EXAMPLES
2561
2543
  $ lps theme push --force
2562
2544
  ```
2563
2545
 
2564
- _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2565
2547
 
2566
2548
  ## `lps theme status`
2567
2549
 
@@ -2584,7 +2566,123 @@ EXAMPLES
2584
2566
  $ lps theme status
2585
2567
  ```
2586
2568
 
2587
- _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2588
2686
 
2589
2687
  ## `lps validate`
2590
2688
 
@@ -2604,5 +2702,5 @@ EXAMPLES
2604
2702
  $ lps validate
2605
2703
  ```
2606
2704
 
2607
- _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/v0.26.0/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)_
2608
2706
  <!-- commandsstop -->