Breeder Player iOS handoff

Bundle id:
com.local.breeder.ios

Minimum iOS:
iOS 16.0

What is included:
- Shared Breeder web player and story runtime.
- In-app Stories shelf with .breeder.zip import.
- Linked story import through /app/?story=ENCODED_HTTPS_ZIP_URL.
- Touch playback for Breeder tasks and mini-game controls.
- Story tuning for page task, theme, loops, fit, tap, game, pan, and anime settings.
- Save-as-copy behavior so tuned stories do not overwrite the original import.
- iOS SwiftUI/WKWebView wrapper with document-open handoff.
- Portrait, landscape left, and landscape right orientation support.

Across-device handoff:
1. Windows creator PC: create or randomize the Breeder game, then export the finished story as .breeder.zip.
2. Cloudflare site: download Breeder-iOS-source.zip, test the browser player at /app/, or link a hosted story with /app/?story=ENCODED_HTTPS_ZIP_URL.
3. Mac build machine: unzip the source, open BreederIOS.xcodeproj in Xcode, set your Apple Team, then build to iPhone or export the IPA.
4. iPhone or iPad: install Breeder Player, tap Stories > Import, choose the .breeder.zip from Files, then preview, play, tune, and save copies as new stories.

Recommended iPhone import:
1. Export a .breeder.zip from Breeder.
2. Move it to iCloud Drive, AirDrop, or another Files-visible location.
3. Open Breeder Player.
4. Tap Stories, Import, then choose the .breeder.zip.
5. Play it or tune a page and save a new story copy.

Linked import:
Host the .breeder.zip on the same Cloudflare site, or any HTTPS host with CORS enabled, then open:
/app/?story=https%3A%2F%2Fexample.com%2Fstory.breeder.zip

Mac build:
cd BreederIOS
APPLE_TEAM_ID=YOURTEAMID ./build_ipa_on_mac.sh

If Xcode asks for signing:
- Open BreederIOS.xcodeproj.
- Pick target BreederIOS.
- Set Team under Signing & Capabilities.
- Product > Archive.
- Export as Development or Ad Hoc depending on how you sideload.

Important:
- A real signed .ipa needs macOS, Xcode, and Apple signing credentials.
- Windows cannot produce a valid signed iPhone archive. It can prepare and zip the source handoff only.
- Files/Share handoff is available for Breeder story zips, but very large video stories should use the in-app Import button.
- If you change the Windows/web Breeder app, run iOS/Sync Breeder Web To iOS.ps1 before building the iOS source zip.