fix(release): strip semver prerelease suffix from framework CFBundleVersion

[dcalhoun]

What?

CFBundleVersion in the GutenbergKitResources framework Info.plist was stamped with the raw package.json version, so prerelease versions produced an invalid value.

Why?

Alpha releases of GutenbergKit break WordPress-iOS's TestFlight upload. altool rejects the build:

This bundle is invalid. The value for key CFBundleVersion [0.19.0-alpha.0] in the Info.plist file must be a period-separated list of at most three non-negative integers. (90058)

CFBundleVersion has a stricter grammar than CFBundleShortVersionString: at most three period-separated non-negative integers. make release VERSION_TYPE=prerelease produces -alpha.N versions routinely, so every alpha reproduces this.

The suffix cannot be reshaped to fit — SemVer prerelease identifiers are alphanumeric by spec, so 0.19.0.alpha.0 is equally invalid. It has to be dropped.

Failing build: https://buildkite.com/automattic/wordpress-ios/builds/33627

How?

• Derive BUNDLE_VERSION by stripping the prerelease (-…) and build-metadata (+…) suffixes, and stamp that into CFBundleVersion. CFBundleShortVersionString keeps the full version, which Apple accepts and which preserves the exact release in the shipped framework.
• Assert Apple's grammar in verify_framework_plist. The gate previously only checked the plist matched package.json, so an illegal-but-matching value passed here and failed three hops downstream — precisely what the gate exists to prevent.

Reusing a core version across an alpha and its final release is safe: artifacts are identified by git SHA (package_xcframework.sh) and resolved by CDN URL plus SwiftPM checksum (Package.swift), never by this key.

Testing Instructions

1. Set version in package.json to 0.19.0-alpha.0 (do not commit it — the artifact name is keyed on HEAD).
2. Run make build-resources-xcframework.
3. Confirm the build succeeds, then print the stamped values for every slice:

X=$(ls -d build/GutenbergKitResources-*.xcframework | head -1)
for s in "$X"/ios-*; do
  P="$s/GutenbergKitResources.framework/Info.plist"
  echo "$(basename "$s")"
  echo "  short:  $(plutil -extract CFBundleShortVersionString raw -o - "$P")"
  echo "  bundle: $(plutil -extract CFBundleVersion raw -o - "$P")"
done

Expected output — bundle drops the prerelease suffix, short keeps it:

ios-arm64
  short:  0.19.0-alpha.0
  bundle: 0.19.0
ios-arm64_x86_64-simulator
  short:  0.19.0-alpha.0
  bundle: 0.19.0

4. Restore package.json to 0.19.0, rebuild, and confirm a non-prerelease version stamps 0.19.0 for both keys.

Accessibility Testing Instructions

N/A — no user-facing UI change.

🤖 Generated with Claude Code

[wpmobilebot]

XCFramework Build

This PR's XCFramework is available for testing. Add the following to your Package.swift:

.package(url: "https://github.com/wordpress-mobile/GutenbergKit", branch: "pr-build/582")

_{Built from 7226134}