Simplify CI matrix

Standardize the CI matrix around a category-based strategy (Category C:
macOS 15 + Swift 6.0, macOS 15 + Swift 6.2, macOS 26 + Swift 6.2).
Guard CoreLocation usage behind #if canImport(CoreLocation). Guard
String(localized:comment:) calls behind #if canImport(Darwin) with plain
string fallbacks.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: RISCfuture

.github/workflows/ci.yml

@@ -1,3 +1,13 @@
+# CI Matrix Policy
+#
+# Category A (tools-version 6.2 + macOS 26 min): macos-26 + Swift 6.2
+# Category B (tools-version 6.2 + older macOS):  macos-15 + 6.2, macos-26 + 6.2
+# Category C (tools-version 6.0):                macos-15 + 6.0, macos-15 + 6.2, macos-26 + 6.2
+# Linux (if viable):                             ubuntu + Swift 6.0, ubuntu + Swift 6.2
+#
+# When Swift 6.3 ships: bump 6.0→6.1 and 6.2→6.3 in Category C
+# When bumping tools-version to 6.2: drop 6.0/6.1, move to Category A or B
+
 name: CI
 
 on:
@@ -17,12 +27,12 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: macos-14
-            swift: "6.1"
           - os: macos-15
-            swift: "6.1"
+            swift: "6.0"
           - os: macos-15
             swift: "6.2"
+          - os: macos-26
+            swift: "6.2"
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
@@ -46,15 +56,9 @@ jobs:
       image: swift:latest
     steps:
       - uses: actions/checkout@v4
-      - name: Install dependencies
-        run: apt-get update && apt-get install -y wget
       - name: Download .swift-format config
-        run: wget -O .swift-format https://gist.githubusercontent.com/RISCfuture/e0c21afb7bd80a88d128a42bf40d2ecd/raw/.swift-format
-      - name: Install swift-format
         run: |
-          git clone https://github.com/swiftlang/swift-format.git
-          cd swift-format
-          swift build -c release
-          cp .build/release/swift-format /usr/local/bin/
+          apt-get update && apt-get install -y wget
+          wget -O .swift-format https://gist.githubusercontent.com/RISCfuture/e0c21afb7bd80a88d128a42bf40d2ecd/raw/.swift-format
       - name: Run swift-format lint
-        run: swift-format lint -r .
+        run: swift format lint -r .

.github/workflows/doc.yml

@@ -1,23 +1,20 @@
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
 name: Deploy Documentation
 
 on:
   push:
     branches: [master]
+  workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow one concurrent deployment
 concurrency:
   group: pages
   cancel-in-progress: true
 
 jobs:
-  # Build job
   build:
     name: Generate Documentation
     runs-on: macos-latest
@@ -57,7 +54,6 @@ jobs:
         with:
           path: "docs/"
 
-  # Deployment job
   deploy:
     environment:
       name: github-pages

Sources/SwiftNASR/Error.swift

@@ -120,121 +120,225 @@ extension Error: LocalizedError {
   public var errorDescription: String? {
     switch self {
       case .nullDistribution, .noSuchFilePrefix, .noSuchFile:
+        #if canImport(Darwin)
         return String(localized: "Couldn’t load distribution.", comment: "error description")
+        #else
+        return "Couldn’t load distribution."
+        #endif
       case .badResponse, .noData, .downloadFailed:
+        #if canImport(Darwin)
         return String(localized: "Couldn’t download distribution.", comment: "error description")
+        #else
+        return "Couldn’t download distribution."
+        #endif
       case .unknownARTCC, .unknownARTCCFrequency, .unknownFieldId,
         .unknownFrequencyFieldId, .invalidFrequency, .unknownFSS,
         .invalidRunwaySurface, .invalidPavementClassification,
         .invalidVGSI, .unknownNavaid, .invalidAltitudeFormat:
+        #if canImport(Darwin)
         return String(localized: "Couldn’t parse distribution data.", comment: "error description")
+        #else
+        return "Couldn’t parse distribution data."
+        #endif
       case .notYetLoaded:
+        #if canImport(Darwin)
         return String(localized: "This NASR has not been loaded yet.", comment: "error description")
+        #else
+        return "This NASR has not been loaded yet."
+        #endif
     }
   }
 
   public var failureReason: String? {
     switch self {
       case .nullDistribution:
+        #if canImport(Darwin)
         return String(
           localized: "Called .load() on a null distribution.",
           comment: "failure reason"
         )
+        #else
+        return "Called .load() on a null distribution."
+        #endif
       case .badResponse(let response):
+        #if canImport(Darwin)
         return String(
           localized: "Bad response: \(response.description).",
           comment: "failure reason"
         )
+        #else
+        return "Bad response: \(response.description)."
+        #endif
       case .downloadFailed(let reason):
+        #if canImport(Darwin)
         return String(localized: "Download failed: \(reason)", comment: "failure reason")
+        #else
+        return "Download failed: \(reason)"
+        #endif
       case .noSuchFilePrefix(let prefix):
+        #if canImport(Darwin)
         return String(
           localized: "Couldn’t find file in archive with prefix ‘\(prefix).’",
           comment: "failure reason"
         )
+        #else
+        return "Couldn’t find file in archive with prefix ‘\(prefix).’"
+        #endif
       case .noData:
+        #if canImport(Darwin)
         return String(localized: "No data was downloaded.", comment: "failure reason")
+        #else
+        return "No data was downloaded."
+        #endif
       case .unknownARTCC(let ID):
+        #if canImport(Darwin)
         return String(
           localized: "Referenced undefined ARTCC record with ID ‘\(ID)’.",
           comment: "failure reason"
         )
+        #else
+        return "Referenced undefined ARTCC record with ID ‘\(ID)’."
+        #endif
       case let .unknownARTCCFrequency(frequency, ARTCC):
+        #if canImport(Darwin)
         return String(
           localized: "Referenced undefined frequency ‘\(frequency)’ for ARTCC \(ARTCC.code).",
           comment: "failure reason"
         )
+        #else
+        return "Referenced undefined frequency ‘\(frequency)’ for ARTCC \(ARTCC.code)."
+        #endif
       case let .unknownFieldId(fieldId, ARTCC):
+        #if canImport(Darwin)
         return String(
           localized: "Unknown field ID ‘\(fieldId)’ at ‘\(ARTCC.code) \(ARTCC.locationName)’.",
           comment: "failure reason"
         )
+        #else
+        return "Unknown field ID ‘\(fieldId)’ at ‘\(ARTCC.code) \(ARTCC.locationName)’."
+        #endif
       case let .unknownFrequencyFieldId(fieldId, frequency, ARTCC):
+        #if canImport(Darwin)
         return String(
           localized:
             "Unknown field ID '\(fieldId)' for \(frequency.frequencyKHz) kHz at '\(ARTCC.code) \(ARTCC.locationName)'.",
           comment: "failure reason"
         )
+        #else
+        return "Unknown field ID '\(fieldId)' for \(frequency.frequencyKHz) kHz at '\(ARTCC.code) \(ARTCC.locationName)'."
+        #endif
       case .invalidFrequency(let string):
+        #if canImport(Darwin)
         return String(localized: "Invalid frequency ‘\(string)’.", comment: "failure reason")
+        #else
+        return "Invalid frequency ‘\(string)’."
+        #endif
       case .unknownFSS(let ID):
+        #if canImport(Darwin)
         return String(
           localized: "Continuation record references unknown FSS ‘\(ID)’.",
           comment: "failure reason"
         )
+        #else
+        return "Continuation record references unknown FSS ‘\(ID)’."
+        #endif
       case .notYetLoaded:
+        #if canImport(Darwin)
         return String(
           localized: "Attempted to access NASR data before .load() was called.",
           comment: "failure reason"
         )
+        #else
+        return "Attempted to access NASR data before .load() was called."
+        #endif
       case .noSuchFile(let path):
+        #if canImport(Darwin)
         return String(
           localized: "No such file in distribution: \(path).",
           comment: "failure reason"
         )
+        #else
+        return "No such file in distribution: \(path)."
+        #endif
       case .invalidRunwaySurface(let string):
+        #if canImport(Darwin)
         return String(localized: "Unknown runway surface ‘\(string)’.", comment: "failure reason")
+        #else
+        return "Unknown runway surface ‘\(string)’."
+        #endif
       case .invalidPavementClassification(let string):
+        #if canImport(Darwin)
         return String(
           localized: "Unknown pavement classification ‘\(string)’ for PCN.",
           comment: "failure reason"
         )
+        #else
+        return "Unknown pavement classification ‘\(string)’ for PCN."
+        #endif
       case .invalidVGSI(let string):
+        #if canImport(Darwin)
         return String(localized: "Unknown VGSI identifier ‘\(string)’.", comment: "failure reason")
+        #else
+        return "Unknown VGSI identifier ‘\(string)’."
+        #endif
       case .unknownNavaid(let string):
+        #if canImport(Darwin)
         return String(localized: "Unknown navaid ‘\(string)’.", comment: "failure reason")
+        #else
+        return "Unknown navaid ‘\(string)’."
+        #endif
       case .invalidAltitudeFormat(let string):
+        #if canImport(Darwin)
         return String(localized: "Invalid altitude format ‘\(string)’.", comment: "failure reason")
+        #else
+        return "Invalid altitude format ‘\(string)’."
+        #endif
     }
   }
 
   public var recoverySuggestion: String? {
     switch self {
       case .nullDistribution:
+        #if canImport(Darwin)
         return String(
           localized:
             "Do not call .load() on a NullDistribution. Use NullDistribution for distributions that were previously loaded and serialized to disk.",
           comment: "recovery suggestion"
         )
+        #else
+        return "Do not call .load() on a NullDistribution. Use NullDistribution for distributions that were previously loaded and serialized to disk."
+        #endif
       case .badResponse, .noData, .downloadFailed:
+        #if canImport(Darwin)
         return String(
           localized: "Verify that the URL to the distribution is correct and accessible.",
           comment: "recovery suggestion"
         )
+        #else
+        return "Verify that the URL to the distribution is correct and accessible."
+        #endif
       case .unknownARTCC, .unknownARTCCFrequency, .unknownFieldId,
         .unknownFrequencyFieldId, .invalidFrequency, .unknownFSS,
         .invalidRunwaySurface, .invalidPavementClassification,
         .invalidVGSI, .unknownNavaid, .noSuchFilePrefix, .noSuchFile,
         .invalidAltitudeFormat:
+        #if canImport(Darwin)
         return String(
           localized: "The NASR FADDS format may have changed, requiring an update to SwiftNASR.",
           comment: "recovery suggestion"
         )
+        #else
+        return "The NASR FADDS format may have changed, requiring an update to SwiftNASR."
+        #endif
       case .notYetLoaded:
+        #if canImport(Darwin)
         return String(
           localized: "Call .load() before accessing NASR data.",
           comment: "recovery suggestion"
         )
+        #else
+        return "Call .load() before accessing NASR data."
+        #endif
     }
   }
 }

Sources/SwiftNASR/Models/Types+Measurement.swift

@@ -1,6 +1,9 @@
-import CoreLocation
 import Foundation
 
+#if canImport(CoreLocation)
+  import CoreLocation
+#endif
+
 // MARK: - Location
 
 public extension Location {
@@ -18,29 +21,33 @@ public extension Location {
   var elevation: Measurement<UnitLength>? {
     elevationFtMSL.map { Measurement(value: Double($0), unit: .feet) }
   }
+}
 
-  /// The coordinate as a CoreLocation coordinate.
-  var coordinate: CLLocationCoordinate2D {
-    CLLocationCoordinate2D(
-      latitude: latitude.converted(to: .degrees).value,
-      longitude: longitude.converted(to: .degrees).value
-    )
-  }
-
-  /// The location as a CoreLocation location, including altitude if available.
-  var location: CLLocation {
-    if let elevation {
-      return CLLocation(
-        coordinate: coordinate,
-        altitude: elevation.converted(to: .meters).value,
-        horizontalAccuracy: -1,
-        verticalAccuracy: -1,
-        timestamp: .distantPast
+#if canImport(CoreLocation)
+  public extension Location {
+    /// The coordinate as a CoreLocation coordinate.
+    var coordinate: CLLocationCoordinate2D {
+      CLLocationCoordinate2D(
+        latitude: latitude.converted(to: .degrees).value,
+        longitude: longitude.converted(to: .degrees).value
       )
     }
-    return CLLocation(latitude: coordinate.latitude, longitude: coordinate.longitude)
+
+    /// The location as a CoreLocation location, including altitude if available.
+    var location: CLLocation {
+      if let elevation {
+        return CLLocation(
+          coordinate: coordinate,
+          altitude: elevation.converted(to: .meters).value,
+          horizontalAccuracy: -1,
+          verticalAccuracy: -1,
+          timestamp: .distantPast
+        )
+      }
+      return CLLocation(latitude: coordinate.latitude, longitude: coordinate.longitude)
+    }
   }
-}
+#endif
 
 // MARK: - Bearing