pnpm-catalog-updates 0.6.5 → 0.7.8

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.
package/README.md ADDED
@@ -0,0 +1,137 @@
1
+ # pcu
2
+
3
+ [![npm version](https://img.shields.io/npm/v/pcu.svg)](https://www.npmjs.com/package/pcu)
4
+ [![npm downloads](https://img.shields.io/npm/dm/pcu.svg)](https://www.npmjs.com/package/pcu)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
+ [![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
7
+
8
+ A powerful CLI tool for managing pnpm workspace catalog dependencies with ease.
9
+
10
+ ## Quick Start
11
+
12
+ ### Installation
13
+
14
+ ```bash
15
+ # Install globally
16
+ npm install -g pcu
17
+
18
+ # Or use with pnpm
19
+ pnpm add -g pcu
20
+
21
+ # Or use legacy package name
22
+ npm install -g pnpm-catalog-updates
23
+ ```
24
+
25
+ ### Usage
26
+
27
+ ```bash
28
+ # Check for outdated catalog dependencies
29
+ pcu check
30
+ # or
31
+ pcu -c
32
+
33
+ # Update catalog dependencies interactively
34
+ pcu update --interactive
35
+ # or
36
+ pcu -i
37
+
38
+ # Update to latest versions
39
+ pcu update
40
+ # or
41
+ pcu -u
42
+
43
+ # Analyze impact of updates
44
+ pcu analyze
45
+ # or
46
+ pcu -a
47
+
48
+ # Show workspace information
49
+ pcu workspace
50
+ # or
51
+ pcu -s
52
+ ```
53
+
54
+ ![PCU Showcase](https://github.com/user-attachments/assets/f05a970e-c58c-44f1-b3f1-351ae30b4a35)
55
+
56
+ ## Commands
57
+
58
+ | Command | Shorthand | Description |
59
+ | --------------- | --------- | ----------------------------------------------- |
60
+ | `pcu check` | `pcu -c` | Check for outdated catalog dependencies |
61
+ | `pcu update` | `pcu -u` | Update catalog dependencies |
62
+ | `pcu analyze` | `pcu -a` | Analyze impact of dependency updates |
63
+ | `pcu workspace` | `pcu -s` | Show workspace information and validation |
64
+ | `pcu init` | | Initialize workspace with catalog configuration |
65
+ | `pcu help` | `pcu -h` | Display help information |
66
+
67
+ ## Common Examples
68
+
69
+ ```bash
70
+ # Interactive update with backup
71
+ pcu update --interactive --backup
72
+
73
+ # Update only minor versions
74
+ pcu update --target minor
75
+
76
+ # Check specific catalog
77
+ pcu check --catalog node18
78
+
79
+ # Analyze before updating
80
+ pcu analyze default react
81
+
82
+ # Validate workspace
83
+ pcu workspace --validate
84
+
85
+ # Dry run update
86
+ pcu update --dry-run
87
+ ```
88
+
89
+ ## Options
90
+
91
+ ### Global Options
92
+
93
+ - `--help, -h`: Show help
94
+ - `--version, -v`: Show version
95
+ - `--verbose`: Enable verbose logging
96
+ - `--quiet`: Suppress non-error output
97
+
98
+ ### Update Options
99
+
100
+ - `--interactive, -i`: Interactive mode
101
+ - `--dry-run, -d`: Show what would be updated without making changes
102
+ - `--backup, -b`: Create backup before updating
103
+ - `--target <level>`: Update target (patch|minor|major|latest)
104
+ - `--catalog <name>`: Target specific catalog
105
+
106
+ ## Configuration
107
+
108
+ Create a `.pcurc.json` file in your project root:
109
+
110
+ ```json
111
+ {
112
+ "catalogs": ["default", "node18", "dev"],
113
+ "updateTarget": "minor",
114
+ "backup": true,
115
+ "interactive": false
116
+ }
117
+ ```
118
+
119
+ ## Requirements
120
+
121
+ - Node.js >= 22.0.0
122
+ - pnpm workspace with catalog configuration
123
+ - pnpm-workspace.yaml with catalog entries
124
+
125
+ ## Documentation
126
+
127
+ For complete documentation, visit:
128
+ [pnpm-catalog-updates](https://github.com/houko/pnpm-catalog-updates#readme)
129
+
130
+ ## Contributing
131
+
132
+ Found a bug or want to contribute? Visit our
133
+ [GitHub repository](https://github.com/houko/pnpm-catalog-updates).
134
+
135
+ ## License
136
+
137
+ MIT © [Evan Hu](https://github.com/houko)