kigumi 0.15.0 → 0.16.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.
package/README.md CHANGED
@@ -162,6 +162,25 @@ npx kigumi diff button card # Diff specific components
162
162
 
163
163
  Useful before running `--overwrite` to understand which files have local modifications.
164
164
 
165
+ ### `update` — Smart Component Updates
166
+
167
+ Three-way merge: applies template updates while preserving your local edits.
168
+
169
+ ```bash
170
+ npx kigumi update # Update all installed components
171
+ npx kigumi update button dialog # Update specific components
172
+ npx kigumi update --dry-run # Preview changes without writing
173
+ npx kigumi update --force # Overwrite without merge
174
+ ```
175
+
176
+ When you update Kigumi CLI and templates change, `update` compares three versions:
177
+
178
+ - **Base**: The original template output (stored in `.kigumi/snapshots/`)
179
+ - **Yours**: Your current file with local customizations
180
+ - **Theirs**: The freshly generated template from the new CLI version
181
+
182
+ If both you and the template changed the same lines, conflict markers are inserted for manual resolution.
183
+
165
184
  ### Version Pinning
166
185
 
167
186
  Kigumi tracks which CLI version generated your project in `kigumi.config.json`. This ensures you stay on a compatible version and don't accidentally upgrade Web Awesome.