pcu 0.6.5 → 0.7.6

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 pnpm-catalog-updates
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
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)