Track: SPM Bundle.module doesn't work for macOS app bundles

[productdevbook]

Summary

This issue tracks a known Swift Package Manager limitation where Bundle.module accessor doesn't work correctly for macOS app bundles built via CLI.

Upstream Issue

• - swiftlang/swift-package-manager#4482

Problem

SPM generates Bundle.module accessor that:

1. Checks app root (Bundle.main.bundleURL) - ❌ macOS apps use Contents/Resources/
2. Checks hardcoded build path - ❌ Doesn't exist on user's machine

Current Workaround

We patch KeyboardShortcuts source in .build/checkouts/ during build:

• Add modulePatched that checks Bundle.main.resourceURL first
• Replace .localized → .localizedPatched

See: scripts/build-app.sh

Related

• Opening settings crashes app #36 - Original crash report
• Affects any SPM package with resources (KeyboardShortcuts, Defaults, etc.)

Resolution

This can be closed when:

1. SPM fixes the upstream issue, OR
2. We migrate to Xcode build (which handles this correctly)