Make the bare command a check and require --write

[friederbluemle]

The bare command no longer writes. It compares the native files with the package.json version and prints one table; --write applies the update, in the spirit of Prettier and Biome.

$ rn-version-sync
PLATFORM  APP ID           VERSION        STATUS
js        example-app      1.2.3
android   com.example.app  1.2.3 (10203)  ok
ios       com.example.app  1.2.2 (10202)  outdated
Run with --write to update the native files.
$ echo $?
1

$ rn-version-sync --write
PLATFORM  APP ID           VERSION        STATUS
js        example-app      1.2.3
android   com.example.app  1.2.3 (10203)  unchanged
ios       com.example.app  1.2.3 (10203)  updated

• Every row shows what its file says. The js row is package.json (name and version), the native rows show app id, version name and code as written. When --version-name or --version-code replace the package.json values, the js row's status names the target, e.g. overridden 2.0.0 (20000); --reserve-builds alone is derived and not marked.
• The check exits 1 when a platform is outdated, so it doubles as a CI step. It also protects existing npm version hooks that are not updated to --write: at hook time the native files lag behind package.json, so the old hook fails loudly with the hint instead of silently committing a bump that never reached the native files.
• --write prints the same table read back after writing, marking each platform updated or unchanged.
• A platform whose file is not found gets a row (not found, pass --skip-ios to ignore) instead of a warning on stderr; skipped platforms are omitted. With --configuration Staging the iOS row is labeled ios (Staging).
• --dry-run and --verbose are removed. The check shows what --dry-run did and more, and the table after --write replaces the verbose log. The --print* flags stay as they are for scripting.
• Library: checkVersions is new and syncVersions returns the same per-platform status (values read back after writing, plus an updated flag) instead of bare paths, along with packageName, packageVersion, overridden and missing. The updaters lose their verbose parameter and console output. SyncOptions extends ReadOptions.
• README documents the check-first flow, the CI use, and the --write hook.

One consequence to be aware of: both modes read the app id for the table, so a project where it cannot be resolved (Android flavors with their own applicationId, or a variable bundle identifier) now fails in --write too, where the old sync worked. That matches the earlier decision to treat such projects as out of scope for now.

This changes what the bare command does, so it should go out as 0.8.0 with a prominent release note.

[github-actions]

🎉 Released in v0.8.0