json5-manifest-sync 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.3.4] - 2026-11-09
+
+### Changed
+
+- Simplified README installation guidance and removed repeated usage examples.
+
+## [0.3.3] - 2026-11-09
+
+### Changed
+
+- Clarified pnpm's manifest selection behavior and how synchronized manifests keep package values aligned.
+
 ## [0.3.2] - 2026-11-09
 
 ### Changed

package/README.md

@@ -20,7 +20,8 @@ npx json5-manifest-sync --source=package.json5
 
 The tool can also work in the other direction: by default, it updates `package.json5` from `package.json`, preserving mapped `//` comments where possible.
 
-pnpm supports `package.json5` natively, but other tools in a project’s scripts, CI/CD, publishing, or deployment workflows may still expect `package.json`. When both files exist, pnpm prefers `package.json`; it reads `package.json5` natively when `package.json` is absent. This tool bridges mixed toolchains by keeping both manifests synchronized in either direction.
+> [!NOTE]
+> pnpm supports `package.json5` natively, but when both files exist it prefers `package.json`. Keeping the manifests synchronized makes this trivial: pnpm reads `package.json`, whose values match `package.json5`. Other tools in your scripts, CI/CD, publishing, or deployment workflows may also expect `package.json`.
 
 ## Quick Start
 
@@ -50,6 +51,28 @@ Run it:
 npm run sync:json5
 ```
 
+## Alternative installation methods
+
+Global install (optional):
+
+```bash
+npm install -g json5-manifest-sync
+```
+
+Or with pnpm:
+
+```bash
+pnpm add --global json5-manifest-sync
+```
+
+### Install from GitHub (alternative)
+
+Use this if you want an unreleased branch or tag:
+
+```bash
+npm install github:BBaysinger/json5-manifest-sync#main
+```
+
 ## Why this exists
 
 `package.json` must be strict JSON, which means comments are invalid. That makes it hard to document complex scripts, dependency choices, or workspace settings directly in the manifest.
@@ -60,9 +83,6 @@ Some tooling does not treat `package.json5` as a package manifest source. While
 
 This is also why the long-running Yarn Berry discussion about comment-friendly manifests is relevant here: [yarnpkg/berry#241](https://github.com/yarnpkg/berry/issues/241) describes the same underlying need, along with the ecosystem compatibility constraints that make a companion `package.json5` approach useful today.
 
-> [!NOTE]
-> pnpm's native `package.json5` support is useful when pnpm controls the workflow, but it does not make `package.json5` universally recognized across npm, CI/CD, deployment, release, and other JavaScript tooling. This project keeps `package.json` available for compatibility while providing a documented companion file.
-
 The source of truth for this tool is configurable. By default:
 
 - `package.json` is authoritative for manifest values.
@@ -100,65 +120,7 @@ Repository: https://github.com/BBaysinger/json5-manifest-sync
 
 Package: https://www.npmjs.com/package/json5-manifest-sync
 
-## Author
-
-Bradley Baysinger ([@BBaysinger](https://github.com/BBaysinger))
-
-## Install from the npm registry (recommended)
-
-Use the package manager already used by your project so its lockfile stays consistent.
-
-With npm:
-
-```bash
-npm install --save-dev json5-manifest-sync
-```
-
-With pnpm:
-
-```bash
-pnpm add --save-dev json5-manifest-sync
-```
-
-Global install (optional):
-
-```bash
-npm install -g json5-manifest-sync
-```
-
-Or with pnpm:
-
-```bash
-pnpm add --global json5-manifest-sync
-```
-
-## Install from GitHub (alternative)
-
-Use this if you want an unreleased branch or tag:
-
-```bash
-npm install github:BBaysinger/json5-manifest-sync#main
-```
-
-## Use in a project
-
-Add a script in your consuming project's `package.json`:
-
-```json
-{
-  "scripts": {
-    "sync:json5": "json5-manifest-sync"
-  }
-}
-```
-
-Run it:
-
-```bash
-npm run sync:json5
-```
-
-### Options
+## Options
 
 By default, the tool runs with `--blank-comments=preserve`.
 
@@ -183,7 +145,7 @@ npx --yes --package=json5-manifest-sync json5-manifest-sync --source=package.jso
 
 You cannot use a local `npm run` script or install this tool as a local dev dependency until `package.json` exists. Once generated, npm and other strict-JSON tools can use it. Note that commands such as `npm install` update `package.json`; reconcile those changes back into `package.json5` with the default `--source=package.json` mode before regenerating JSON from the JSON5 source, or those updates could be overwritten.
 
-Because pnpm prefers `package.json` when both files exist, it will read the generated JSON copy in that setup; it reads `package.json5` directly only when `package.json` is absent.
+In this setup, pnpm reads the generated `package.json`; it reads `package.json5` directly only when `package.json` is absent.
 
 Choose a blank-comment mode with one of the following:
 
@@ -216,16 +178,10 @@ Example prompt:
 
 > "Complete empty `//` comment lines in `package.json5` with concise, field-specific comments."
 
-## Example dependency block in consumer
-
-```json
-{
-  "dependencies": {
-    "json5-manifest-sync": "^0.3.0"
-  }
-}
-```
-
 ## Changelog
 
 See `CHANGELOG.md` for full release history.
+
+## Author
+
+Bradley Baysinger ([@BBaysinger](https://github.com/BBaysinger))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json5-manifest-sync",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Sync package.json and package.json5 manifests in either direction, preserving JSON5 comments where possible.",
   "author": {
     "name": "Bradley Baysinger",