Update to Swift 6.2, Xcode 26, and expand platform support (#37)

Author: leogdion

.github/workflows/RadiantKit.yml

@@ -14,22 +14,26 @@ jobs:
     if: "!contains(github.event.head_commit.message, 'ci skip')"
     strategy:
       matrix:
-        image-name: ["swift:6.0", "swift:6.1", "swiftlang/swift:nightly-6.2-noble"]
+        include:
+          - image-name: "swift:6.2"
+            swift-label: "6.2"
+          - image-name: "swiftlang/swift:nightly-6.3-noble"
+            swift-label: "nightly-6.3"
 
     container:
       image: ${{ matrix.image-name }}
     steps:
       - uses: actions/checkout@v4
-      - uses: brightdigit/swift-build@v1.1.1
+      - uses: brightdigit/swift-build@v1.4.2
       - uses: sersoft-gmbh/swift-coverage-action@v4
         id: coverage-files
         with:
           fail-on-empty-output: true
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4       
+        uses: codecov/codecov-action@v4
         with:
           fail_ci_if_error: true
-          flags: swift-${{ matrix.image-name }},ubuntu
+          flags: ${{ matrix.swift-label }},ubuntu
           verbose: true        
           token: ${{ secrets.CODECOV_TOKEN }}  
           files: ${{ join(fromJSON(steps.coverage-files.outputs.files), ',') }}         
@@ -42,63 +46,80 @@ jobs:
       matrix:
         include:
           # SPM Build Matrix
-          - runs-on: macos-15
-            xcode: "/Applications/Xcode_16.1.app"
           - runs-on: macos-15
             xcode: "/Applications/Xcode_16.4.app"
+          - runs-on: macos-26
+            xcode: "/Applications/Xcode_26.2.app"
 
+          # macOS Build Matrix
           - type: macos
             runs-on: macos-15
             xcode: "/Applications/Xcode_16.4.app"
-          
+          - type: macos
+            runs-on: macos-26
+            xcode: "/Applications/Xcode_26.2.app"
+
           # iOS Build Matrix
           - type: ios
             runs-on: macos-15
             xcode: "/Applications/Xcode_16.1.app"
             deviceName: "iPhone 16"
             osVersion: "18.1"
+            download-platform: true
           - type: ios
             runs-on: macos-15
             xcode: "/Applications/Xcode_16.4.app"
             deviceName: "iPhone 16 Pro"
-            osVersion: "18.2"
-  
+            osVersion: "18.6"
+          - type: ios
+            runs-on: macos-26
+            xcode: "/Applications/Xcode_26.2.app"
+            deviceName: "iPhone 17 Pro"
+            osVersion: "26.2"
+
           # watchOS Build Matrix
           - type: watchos
             runs-on: macos-15
             xcode: "/Applications/Xcode_16.1.app"
             deviceName: "Apple Watch Ultra 2 (49mm)"
-            osVersion: "11.1"
+            osVersion: "11.2"
+            download-platform: true
           - type: watchos
             runs-on: macos-15
             xcode: "/Applications/Xcode_16.4.app"
             deviceName: "Apple Watch Ultra 2 (49mm)"
-            osVersion: "11.2"
+            osVersion: "11.5"
+          - type: watchos
+            runs-on: macos-26
+            xcode: "/Applications/Xcode_26.2.app"
+            deviceName: "Apple Watch Ultra 3 (49mm)"
+            osVersion: "26.2"
 
           # visionOS Build Matrix
           - type: visionos
-            runs-on: macos-15
-            xcode: "/Applications/Xcode_16.4.app"
+            runs-on: macos-26
+            xcode: "/Applications/Xcode_26.2.app"
             deviceName: "Apple Vision Pro"
-            osVersion: "2.1"
-    
+            osVersion: "26.2"
+
           # tvOS Build Matrix
           - type: tvos
-            runs-on: macos-15
-            xcode: "/Applications/Xcode_16.4.app"
+            runs-on: macos-26
+            xcode: "/Applications/Xcode_26.2.app"
             deviceName: "Apple TV 4K (3rd generation)"
-            osVersion: "18.2"
+            osVersion: "26.2"
     steps:
       - uses: actions/checkout@v4
 
       - name: Build and Test
-        uses: brightdigit/swift-build@v1.1.1
+        uses: brightdigit/swift-build@v1.4.2
         with:
           scheme: ${{ env.PACKAGE_NAME }}-Package
           type: ${{ matrix.type }}
           xcode: ${{ matrix.xcode }}
           deviceName: ${{ matrix.deviceName }}
           osVersion: ${{ matrix.osVersion }}
+          download-platform: ${{ matrix.download-platform }}
 
       # Common Coverage Steps
       - name: Process Coverage
@@ -115,11 +136,65 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           flags: ${{ matrix.type && format('{0}{1}', matrix.type, matrix.osVersion) || 'spm' }}
+
+  build-windows:
+    name: Build on Windows
+    runs-on: ${{ matrix.runs-on }}
+    if: "!contains(github.event.head_commit.message, 'ci skip')"
+    strategy:
+      fail-fast: false
+      matrix:
+        runs-on: [windows-2022, windows-2025]
+        swift:
+        - version: swift-6.2-release
+          build: 6.2-RELEASE
+    steps:
+      - uses: actions/checkout@v4
+      - uses: brightdigit/swift-build@v1.4.2
+        with:
+          scheme: ${{ env.PACKAGE_NAME }}-Package
+          windows-swift-version: ${{ matrix.swift.version }}
+          windows-swift-build: ${{ matrix.swift.build }}
+
+  build-android:
+    name: Build on Android
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, 'ci skip')"
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - android-swift-version: "6.1"
+            android-api-level: "28"
+          - android-swift-version: "6.2"
+            android-api-level: "33"
+          - android-swift-version: "nightly-main"
+            android-api-level: "34"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Free disk space
+        uses: jlumbroso/free-disk-space@main
+        with:
+          tool-cache: false
+          android: false
+          dotnet: true
+          haskell: true
+          large-packages: true
+          docker-images: true
+          swap-storage: true
+
+      - uses: brightdigit/swift-build@v1.4.2
+        with:
+          scheme: ${{ env.PACKAGE_NAME }}-Package
+          android-swift-version: ${{ matrix.android-swift-version }}
+          android-api-level: ${{ matrix.android-api-level }}
+
   lint:
     name: Linting
-    if: ${{ !contains(github.event.head_commit.message, 'ci skip') }}  
+    if: ${{ !contains(github.event.head_commit.message, 'ci skip') }}
     runs-on: ubuntu-latest
-    needs: [build-ubuntu, build-macos]
+    needs: [build-ubuntu, build-macos, build-windows, build-android]
     env:
       MINT_PATH: .mint/lib
       MINT_LINK_PATH: .mint/bin

CLAUDE.md

@@ -0,0 +1,199 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+RadiantKit is a Swift Package Manager library providing SwiftUI utilities across Apple platforms (iOS 18+, macOS 15+, tvOS 18+, watchOS 11+, visionOS 2+). The package contains four distinct modules with clear separation of concerns.
+
+## Common Commands
+
+### Building and Testing
+```bash
+# Build the package (Swift 6.0+ required)
+swift build
+
+# Run tests
+swift test
+
+# Build for specific platform (requires Xcode)
+xcodebuild -scheme RadiantKit-Package -destination 'platform=iOS Simulator,name=iPhone 16'
+
+# Run single test
+swift test --filter RadiantKitTests.<TestClassName>/<testMethodName>
+```
+
+### Linting and Formatting
+```bash
+# Run full lint (formats code, adds headers, then validates)
+./Scripts/lint.sh
+
+# Format only (skip validation)
+FORMAT_ONLY=1 ./Scripts/lint.sh
+
+# Strict mode (treats warnings as errors)
+LINT_MODE=STRICT ./Scripts/lint.sh
+
+# Skip linting entirely
+LINT_MODE=NONE ./Scripts/lint.sh
+```
+
+The lint script uses Mint for dependency management and runs:
+- swift-format (formatting and linting)
+- swiftlint (Swift style validation)
+- header.sh (copyright header management)
+
+### Documentation Generation
+```bash
+# Generate Swift-DocC documentation
+./Scripts/swift-doc.sh
+
+# Watch mode for documentation development
+./Scripts/watch-docc.sh
+```
+
+### Development Tools
+```bash
+# Install Mint dependencies
+mint bootstrap -m Mintfile
+
+# Run periphery (dead code detection)
+mint run periphery scan
+```
+
+## Architecture
+
+### Module Structure
+
+**RadiantKit** (Core Foundation)
+- Property wrappers: `@AppStored`, `@DefaultWrapped` for persistent storage patterns
+- View utilities: `IdentifiableView`, `IdentifiableViewBuilder` for collection-based navigation
+- `Binding.map()`: Type-safe binding transformations
+- Platform adapters: NSWindowDelegate wrappers for macOS
+- Custom views: GuidedLabeledContent, SliderStepperView, Video, ValueTextBubble
+
+**RadiantDocs** (depends on RadiantKit)
+- Document management for SwiftUI apps
+- Core protocols: `CodablePackage`, `FileTypeSpecification`, `InitializablePackage`
+- `DocumentFile<FileType>`: Generic, type-safe file wrapper
+- `CodablePackageDocument<T>`: FileDocument implementation for package files
+- File panel abstractions and UTType integration
+
+**RadiantPaging** (depends on RadiantKit)
+- Page-based navigation UI patterns
+- `PageView`: Main component for sequential page display
+- Environment-based actions: `NextPageAction`, `PreviousPageAction`, `CancelPageAction`
+- `PageNavigationAvailability`: Controls which navigation buttons appear
+- Integrates with `IdentifiableView` from RadiantKit
+
+**RadiantProgress** (independent, depends on swift-log for Linux)
+- Progress tracking for file operations and downloads
+- `ProgressOperation<ValueType>`: Protocol for any progress-reporting operation
+- `DownloadOperation`: Observable implementation with URLSession integration
+- `FileOperationProgress`: SwiftUI-friendly wrapper for any ProgressOperation
+- `ObservableDownloader`: Combines Observation and Combine patterns
+
+### Key Architectural Patterns
+
+**Property Wrappers**
+- `AppStored` protocol defines key-based storage contracts
+- `DefaultWrapped` extends AppStored with default value support
+- UserDefaults extensions provide type-safe retrieval
+
+**Generic Type Systems**
+- `DocumentFile<FileType: FileTypeSpecification>`: Type-safe file handling
+- `ProgressOperation<ValueType: BinaryInteger & Sendable>`: Flexible progress reporting
+- Extensive use of generics to prevent runtime errors
+
+**Observable/Reactive**
+- `@Observable` macro for iOS 17+ reactive state
+- MainActor isolation throughout for UI thread safety
+- Sendable conformance for cross-actor communication
+
+**Protocol-Based Design**
+- Interface segregation (small, focused protocols)
+- Protocol extensions for shared functionality
+- Generic constraints for type safety
+
+**SwiftUI Environment Integration**
+- Page navigation actions injected via environment
+- Custom environment keys for cross-view communication
+
+### Module Dependencies
+
+```
+RadiantKit (foundation)
+   ↑         ↑
+   |         |
+   |         |
+RadiantDocs  RadiantPaging
+
+RadiantProgress (independent)
+```
+
+## Swift 6 & Experimental Features
+
+This project uses Swift 6.0 with multiple experimental features enabled:
+- AccessLevelOnImport
+- BitwiseCopyable
+- IsolatedAny
+- MoveOnlyPartialConsumption
+- NestedProtocols
+- NoncopyableGenerics
+- TransferringArgsAndResults
+- VariadicGenerics
+- FullTypedThrows (upcoming)
+- InternalImportsByDefault (upcoming)
+
+Code must be compatible with strict concurrency checking and Sendable requirements.
+
+## Code Style
+
+### Formatting
+- Uses swift-format (v600.0.0) with configuration in `.swift-format`
+- SwiftLint (v0.58.0) with rules in `.swiftlint.yml`
+- All source files require copyright headers (managed by `Scripts/header.sh`)
+
+### Concurrency
+- All UI components are `@MainActor` isolated
+- Closures crossing actor boundaries must be `@Sendable`
+- Use `nonisolated` sparingly and only when necessary
+
+### Naming Conventions
+- Protocols use descriptive nouns (CodablePackage, ProgressOperation)
+- Generic type parameters use full words (FileType, ValueType)
+- Environment keys follow pattern: `<Action>Key` (NextPageKey, PreviousPageKey)
+
+## Testing
+
+Tests are located in `Tests/RadiantKitTests/`. The CI pipeline runs tests across:
+- Ubuntu (Swift 6.2, nightly 6.3)
+- Windows (Swift 6.2)
+- Android (Swift 6.1, 6.2, nightly-main)
+- macOS/iOS/tvOS/watchOS/visionOS simulators with Xcode 16.1, 16.4, and 26.2
+
+When adding features:
+1. Add tests to RadiantKitTests targeting the appropriate module
+2. Ensure tests pass on both macOS and Linux (note: RadiantProgress uses swift-log on Linux)
+3. CI enforces strict code coverage requirements via Codecov
+
+## Platform Support
+
+Minimum deployment targets:
+- iOS 18.0 / iPadOS 18.0
+- macOS 15.0
+- tvOS 18.0
+- watchOS 11.0
+- visionOS 2.0
+- Mac Catalyst 18.0
+
+Platform-specific code should use `#if canImport()` or `#if os()` directives.
+
+## Adding New Modules
+
+If creating a new target:
+1. Add to `Package.swift` products and targets arrays
+2. Apply `swiftSettings` for experimental features
+3. Update module dependency graph (RadiantKit as foundation, others can depend on it)
+4. Add corresponding test target
+5. Update `.github/workflows/RadiantKit.yml` if platform-specific testing needed