Readium CSS v2 update

.github/workflows/checks.yml

@@ -7,14 +7,14 @@ on:
 
 env:
   platform: ${{ 'iOS Simulator' }}
-  device: ${{ 'iPhone SE (3rd generation)' }}
+  device: ${{ 'iPhone 16 Pro' }}
   commit_sha: ${{ github.sha }}
-  DEVELOPER_DIR: /Applications/Xcode_16.2.app/Contents/Developer
+  DEVELOPER_DIR: /Applications/Xcode_16.4.app/Contents/Developer
 
 jobs:
   build:
     name: Build
-    runs-on: macos-14
+    runs-on: macos-15
     if: ${{ !github.event.pull_request.draft }}
     env:
       scheme: ${{ 'Readium-Package' }}
@@ -26,11 +26,19 @@ jobs:
         run: |
           brew update
           brew install xcodegen
+          # Preload the list of simulator for xcodebuild. The workflow is flaky without it.
+          xcrun simctl list
       - name: Check Carthage project
         run: |
           # Check that the Carthage project is up to date.
           make carthage-project
           git diff --exit-code Support/Carthage/Readium.xcodeproj
+      - name: Check CocoaPods podspecs
+        run: |
+          # Check that the podspecs are up to date.
+          make podspecs
+          git diff --exit-code Support/CocoaPods/
+          if git ls-files --others --exclude-standard Support/CocoaPods/ | grep -q .; then echo "Untracked podspec files found. Run 'make podspecs' and commit the result."; exit 1; fi
       - name: Build
         run: |
           set -eo pipefail
@@ -39,10 +47,32 @@ jobs:
         run: |
           set -eo pipefail
           xcodebuild test-without-building -scheme "$scheme" -destination "platform=$platform,name=$device" | if command -v xcpretty &> /dev/null; then xcpretty; else cat; fi
+      - name: Print Swift package versions
+        run: |
+          jq -r '.pins[] | "\(.identity): \(.state.version)"' Package.resolved
+
+  # navigator-ui-tests:
+  #   name: Navigator UI Tests
+  #   runs-on: macos-15
+  #   if: ${{ !github.event.pull_request.draft }}
+  #   steps:
+  #     - name: Checkout
+  #       uses: actions/checkout@v3
+  #     - name: Install dependencies
+  #       run: |
+  #         brew update
+  #         brew install xcodegen
+  #         # Preload the list of simulator for xcodebuild. The workflow is flaky without it.
+  #         xcrun simctl list
+  #     - name: Test
+  #       run: |
+  #         set -eo pipefail
+  #         make navigator-ui-tests-project
+  #         xcodebuild test -project Tests/NavigatorTests/UITests/NavigatorUITests.xcodeproj -scheme NavigatorTestHost -destination "platform=$platform,name=$device" | if command -v xcpretty &> /dev/null; then xcpretty; else cat; fi
 
   lint:
     name: Lint
-    runs-on: macos-14
+    runs-on: macos-15
     if: ${{ !github.event.pull_request.draft }}
     env:
       scripts: ${{ 'Sources/Navigator/EPUB/Scripts' }}
@@ -76,7 +106,7 @@ jobs:
 
   int-dev:
     name: Integration (Local)
-    runs-on: macos-14
+    runs-on: macos-15
     if: ${{ !github.event.pull_request.draft }}
     defaults:
       run:
@@ -89,6 +119,8 @@ jobs:
         run: |
           brew update
           brew install xcodegen
+          # Preload the list of simulator for xcodebuild. The workflow is flaky without it.
+          xcrun simctl list
       - name: Generate project
         run: make dev lcp=${{ secrets.LCP_URL_SPM }}
       - name: Build
@@ -98,7 +130,7 @@ jobs:
 
   int-spm:
     name: Integration (Swift Package Manager)
-    runs-on: macos-14
+    runs-on: macos-15
     if: ${{ !github.event.pull_request.draft }}
     defaults:
       run:
@@ -117,6 +149,8 @@ jobs:
         run: |
           brew update
           brew install xcodegen
+          # Preload the list of simulator for xcodebuild. The workflow is flaky without it.
+          xcrun simctl list
       - name: Generate project
         run: make spm lcp=${{ secrets.LCP_URL_SPM }} commit=$commit_sha
       - name: Build
@@ -126,7 +160,7 @@ jobs:
 
   int-carthage:
     name: Integration (Carthage)
-    runs-on: macos-14
+    runs-on: macos-15
     if: ${{ !github.event.pull_request.draft && github.ref == 'refs/heads/main' }}
     defaults:
       run:
@@ -145,6 +179,8 @@ jobs:
         run: |
           brew update
           brew install xcodegen
+          # Preload the list of simulator for xcodebuild. The workflow is flaky without it.
+          xcrun simctl list
       - name: Generate project
         run: make carthage lcp=${{ secrets.LCP_URL_CARTHAGE }} commit=$commit_sha
       - name: Build

.github/workflows/docs.yml

@@ -0,0 +1,78 @@
+name: Documentation
+
+on:
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build-and-deploy:
+    runs-on: macos-15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Determine Version
+        id: versioning
+        run: |
+          git fetch --tags --force
+          VERSION=$(git describe --tag --match "[0-9]*" --abbrev=0)
+          echo "READIUM_VERSION=$VERSION" >> $GITHUB_OUTPUT
+          if [[ $GITHUB_REF == refs/tags/* ]]; then
+             echo "folder=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+          else
+             echo "folder=latest" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Generate Documentation
+        run: |
+          chmod +x BuildTools/Scripts/generate-docs.sh
+          ./BuildTools/Scripts/generate-docs.sh ${{ steps.versioning.outputs.READIUM_VERSION }}
+          ./BuildTools/Scripts/generate-docs.sh latest
+
+      - name: Setup Root Redirect
+        run: |
+          cat <<EOF > docs-site/swift-toolkit/index.html
+          <!DOCTYPE html>
+          <html>
+            <head>
+                <meta charset="utf-8">
+                <meta http-equiv="refresh" content="0; url=./latest/documentation/readium">
+                <script>window.location.replace("./latest/documentation/readium");</script>
+            </head>
+            <body><p>Redirecting to <a href="./latest/documentation/readium">latest documentation</a>...</p></body>
+          </html>
+          EOF
+
+      - name: Deploy Versioned Folder 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: docs-site/swift-toolkit/${{ steps.versioning.outputs.READIUM_VERSION }}
+          target-folder: ${{ steps.versioning.outputs.READIUM_VERSION }}
+          clean: true
+
+      - name: Deploy Latest Folder 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: docs-site/swift-toolkit/latest
+          target-folder: latest
+          clean: true
+
+      - name: Deploy Root Redirect 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: docs-site/swift-toolkit
+          target-folder: .
+          clean: false

.gitignore

@@ -56,3 +56,10 @@ playground.xcworkspace
 ## IntelliJ
 out/
 
+## Claude Code
+.claude
+CLAUDE.md
+
+# DocC generation
+.build-docs
+docs-site

BuildTools/Empty.swift

@@ -1,5 +1,5 @@
 //
-//  Copyright 2025 Readium Foundation. All rights reserved.
+//  Copyright 2026 Readium Foundation. All rights reserved.
 //  Use of this source code is governed by the BSD-style license
 //  available in the top-level LICENSE file of the project.
 //

BuildTools/Package.swift

@@ -11,7 +11,13 @@ let package = Package(
     name: "BuildTools",
     platforms: [.macOS(.v10_11)],
     dependencies: [
-        .package(url: "https://github.com/nicklockwood/SwiftFormat", from: "0.51.6"),
+        .package(url: "https://github.com/nicklockwood/SwiftFormat", from: "0.59.1"),
     ],
-    targets: [.target(name: "BuildTools", path: "")]
+    targets: [
+        .target(name: "BuildTools", path: "", exclude: ["Sources"]),
+        .target(
+            name: "GeneratePodspecs",
+            path: "Sources/GeneratePodspecs"
+        ),
+    ]
 )