Carleton Map (Beta): native iOS map view

[hawkrives]

Summary

Ports the carls-app/carls map view to AAO as a native iOS screen. Interim: renders Carleton's building data and Mapbox style. St. Olaf-specific data and a non-Mapbox SDK are tracked as follow-ups below.

• New source/views/map/ view with MapScreen, BuildingPicker, BuildingInfo, all built on @rnmapbox/maps and React Navigation 7's native form-sheet detents (no custom drag overlay).
• New carletonClient peer in @frogpond/api for calling carleton.api.frogpond.tech/v1 directly.
• Adds a "Carleton Map (Beta)" tile alongside (does not replace) the existing atlascms.com Campus Map URL tile.
• iOS user-location enabled with NSLocationWhenInUseUsageDescription + a precise-location entry in PrivacyInfo.xcprivacy.

Required before merge

• Replace MAPBOX_PUBLIC_TOKEN placeholder ('pk.TODO_REPLACE_BEFORE_MERGE') in source/lib/mapbox.ts with the real pk.… Mapbox public access token.
• Provision MAPBOX_DOWNLOADS_TOKEN as a GitHub Actions repository secret (Settings → Secrets and variables → Actions). The workflow steps to consume it are already added to check.yml and cocoapods.yml; they degrade with a ::warning:: if the secret is unset and let pod install fail downstream with its own clearer error. The same secret needs to land in Xcode Cloud's environment as well — ci_post_clone.sh already reads it from there.
• Regenerate ios/Podfile.lock on a Mac with the netrc credentials set, then commit. Once MAPBOX_DOWNLOADS_TOKEN is provisioned, the cocoapods.yml bot can do this automatically on the next push.

Architecture notes

• Three screens, one provider: Map, MapBuildingPicker, and MapBuildingInfo are wrapped in a single Stack.Group whose screenLayout injects MapSelectionProvider, so all three share selection state via MapSelectionContext.
• Sheet detents: [0.5, 1.0] (medium / large) with sheetLargestUndimmedDetentIndex: 'last' so the map stays interactive at the largest detent.
• Tap-to-select: MapView.onPress → lookupBuildingByCoordinates([lng, lat], features) (point-in-polygon via @turf/boolean-point-in-polygon) → selectBuilding(id) → navigation.replace('MapBuildingInfo', …).
• Sheet auto-presentation: MapScreen uses useFocusEffect (not useEffect) to navigate to MapBuildingPicker whenever the map regains focus — so closing BuildingInfo returns the user to the picker rather than a bare map.
• Search: fuzzyfind against ${name} ${nickname} (lowercased). When the search box is non-empty, the category picker hides.
• Accessibility: 44pt-min touch targets, accessibilityLabel/accessibilityRole on every interactive element that supports them. ListRow from @frogpond/lists doesn't accept accessibilityLabel directly — VoiceOver auto-derives from <Title> text children, consistent with all existing callers.

Code changes

• 34 files changed, ~1500 insertions net.
• 20 commits structured as one per task, with two style/fix follow-ups during execution and two fix(map): / ci: commits responding to final code review.
• +16 automated tests (parseLinkString, lookupBuildingByCoordinates, BuildingList, CategoryPicker, BuildingPicker). Total suite: 41 suites, 213 passed, 3 skipped.
• Two TODO(map): markers (Mapbox public token + St. Olaf style URL) — both intentional, both grep-able.

Cross-cutting infrastructure (small additions, all justified)

• jest/file-mock.js + moduleNameMapper in jest.config.ts — needed because @frogpond/lists transitively requires react-native-vector-icons font files.
• @rnmapbox/maps added to esmPackages in jest.config.ts — its setup-jest helper ships ESM.
• view.view as never cast in source/views/home/index.tsx — adding three names to RootViewsParamList exceeded TypeScript's overload-resolution limit on navigation.navigate.
• ~/.netrc write step added to check.yml and cocoapods.yml (matches the existing ci_post_clone.sh pattern for Xcode Cloud).

Manual test plan (iOS)

• Open Map from home → screen mounts; sheet auto-presents at medium detent.
• Drag sheet between medium / large detents → map remains interactive at large.
• Type in search → list filters by fuzzy match against name + nickname; clear search → categories visible again.
• Tap a category → list filters to that category.
• Tap a building row in the picker → sheet swaps to info; map zooms; gold marker drops.
• Close info → sheet returns to picker; marker clears.
• Tap a building outline directly on the map → same selection flow as tapping a row; closing info returns to map cleanly (no stale picker beneath).
• Pan/zoom map → no jank; user-location dot visible after granting permission.
• Cold-launch with airplane mode → banner: "Couldn't load building data. Pan around the map; some features won't work."
• Settings → Privacy → Location → confirm app is listed.
• Building info: tap address → opens in Apple Maps; tap a department/office/floor link → opens in browser; link items with no href render as plain text.

Follow-up issues to file

1. Migrate Map view off Mapbox (research MapLibre + open-source style hosting; Mapbox SDK requires a downloads token and a paid public token at scale).
2. Switch Map data source from Carleton (carleton.api.frogpond.tech) to St. Olaf, once a St. Olaf GeoJSON endpoint and Mapbox style exist.
3. Port the carls MapReporterView (the "report a building data issue" flow — deliberately skipped from this PR's scope).
4. Replace the atlascms.com Campus Map tile once the St. Olaf data lands and the Carleton Map view is repurposed.

https://claude.ai/code/session_01PMi93zZdHERYyHUZrv7sGz

---

Generated by Claude Code

[drewvolz]

Let's rename the *carleton* variables

[hawkrives]

Should probably be https

[hawkrives]

Let's figure out the right type here instead of allowing any

[hawkrives]

Probably can just inline this?