Add Android and iOS multiplatform support

.github/workflows/ci.yml

@@ -25,6 +25,8 @@ jobs:
           distribution: temurin
           java-version: ${{ matrix.java-version }}
 
+      - uses: android-actions/setup-android@v3
+
       - uses: gradle/actions/setup-gradle@v4
 
       - name: Build library
@@ -33,6 +35,10 @@ jobs:
       - name: Unit tests
         run: ./gradlew :compose2pdf:test
 
+      - name: iOS simulator tests (macOS)
+        if: runner.os == 'macOS' && matrix.java-version == 17
+        run: ./gradlew :compose2pdf:iosSimulatorArm64Test
+
       - name: Fidelity tests (Linux)
         if: runner.os == 'Linux' && matrix.java-version == 17
         run: xvfb-run ./gradlew :fidelity-test:test
@@ -50,5 +56,5 @@ jobs:
           if-no-files-found: ignore
 
       - name: Smoke test publishToMavenLocal
-        if: matrix.os == 'ubuntu-latest' && matrix.java-version == 17
+        if: matrix.os == 'macos-latest' && matrix.java-version == 17
         run: ./gradlew :compose2pdf:publishToMavenLocal

.github/workflows/release.yml

@@ -47,6 +47,8 @@ jobs:
           distribution: temurin
           java-version: 17
 
+      - uses: android-actions/setup-android@v3
+
       - uses: gradle/actions/setup-gradle@v4
 
       - name: Build library
@@ -73,7 +75,7 @@ jobs:
 
   publish:
     needs: test
-    runs-on: ubuntu-latest
+    runs-on: macos-latest
     steps:
       - uses: actions/checkout@v4
         with:
@@ -84,6 +86,8 @@ jobs:
           distribution: temurin
           java-version: 17
 
+      - uses: android-actions/setup-android@v3
+
       - uses: gradle/actions/setup-gradle@v4
 
       - name: Publish to Maven Central

.github/workflows/snapshot.yml

@@ -19,7 +19,7 @@ concurrency:
 
 jobs:
   snapshot:
-    runs-on: ubuntu-latest
+    runs-on: macos-latest
     steps:
       - uses: actions/checkout@v4
         with:
@@ -30,6 +30,8 @@ jobs:
           distribution: temurin
           java-version: 17
 
+      - uses: android-actions/setup-android@v3
+
       - uses: gradle/actions/setup-gradle@v4
 
       - name: Verify SNAPSHOT version
@@ -42,7 +44,7 @@ jobs:
           fi
 
       - name: Build and test
-        run: xvfb-run ./gradlew :compose2pdf:build :compose2pdf:test :fidelity-test:test
+        run: ./gradlew :compose2pdf:build :compose2pdf:test :fidelity-test:test
 
       - name: Publish snapshot
         env:

CLAUDE.md

@@ -2,36 +2,54 @@
 
 ## Project Overview
 
-**compose2pdf** is a Kotlin JVM library that renders Compose Desktop content to PDF.
+**compose2pdf** is a Kotlin Multiplatform library that renders Compose content to PDF on JVM/Desktop, Android, and iOS.
 
 ## Module Map
 
 ```
-├── compose2pdf/          # Library: public API + SVG→PDF converter + font resolver
-├── examples/             # Runnable examples (not published)
-├── fidelity-test/        # Visual regression tests (not published)
+├── compose2pdf/          # Library: multiplatform (commonMain, jvmMain, androidMain, iosMain)
+├── test-fixtures/        # Multiplatform test utilities shared across JVM, Android, iOS
+├── examples/             # Runnable JVM examples (not published)
+├── fidelity-test/        # Visual regression tests, JVM only (not published)
 └── docs/                 # Jekyll docs site (GitHub Pages, just-the-docs theme)
 ```
 
 ## Tech Stack
 
-- **Kotlin** 2.3.20, JVM target only
-- **Compose Multiplatform** 1.10.3 (Desktop)
-- **Apache PDFBox** 3.0.7 (SVG→PDF conversion, image embedding, font subsetting)
+- **Kotlin** 2.3.20 — targets: JVM, Android (minSdk 24), iOS (arm64, x64, simulatorArm64)
+- **Compose Multiplatform** 1.10.3 (Desktop, Android, iOS)
+- **Android Gradle Plugin** 8.9.3
+- **Apache PDFBox** 3.0.7 — JVM only (SVG→PDF conversion, image embedding, font subsetting)
+- **android.graphics.pdf.PdfDocument** — Android native PDF (zero external dependencies)
+- **Core Graphics (CGPDFContext)** — iOS native PDF rendering
 - **Gradle** 8.14 — versions centralized in `gradle/libs.versions.toml`
 
 ## Build Commands
 
 ```bash
-./gradlew :compose2pdf:build           # Build library
-./gradlew :compose2pdf:test            # Run unit tests
-./gradlew :fidelity-test:test          # Run fidelity tests (vector + raster PDF)
+# JVM
+./gradlew :compose2pdf:build                 # Build all KMP targets
+./gradlew :compose2pdf:test                  # Run JVM unit tests
+./gradlew :compose2pdf:compileKotlin         # Quick compile check (no tests)
+./gradlew :fidelity-test:test                # Run fidelity tests (vector + raster PDF)
 ./gradlew :fidelity-test:test --rerun-tasks  # Force re-run (bypass Gradle cache)
-./gradlew :compose2pdf:publishToMavenLocal  # Publish to ~/.m2
-./gradlew :compose2pdf:compileKotlin        # Quick compile check (no tests)
-./gradlew :examples:run                     # Run examples, output to examples/build/output/
+./gradlew :examples:run                      # Run JVM examples, output to examples/build/output/
+
+# Android
+./gradlew :compose2pdf:pixel2api30atdDebugAndroidTest  # Run Android instrumented tests (managed device)
+
+# iOS
+./gradlew :compose2pdf:iosSimulatorArm64Test  # Run iOS simulator tests
+
+# Publishing
+./gradlew :compose2pdf:publishToMavenLocal   # Publish all targets to ~/.m2
+
+# Test fixtures
+./gradlew :test-fixtures:build               # Build shared test utilities
+
+# Docs
 open fidelity-test/build/reports/fidelity/index.html  # View fidelity report (macOS)
-cd docs && bundle exec jekyll serve             # Preview docs site locally (http://localhost:4000)
+cd docs && bundle exec jekyll serve                    # Preview docs site locally (http://localhost:4000)
 ```
 
 ## Fidelity Tests
@@ -43,36 +61,95 @@ Visual regression suite comparing Compose reference renders against rasterized P
 
 ## CI
 
-GitHub Actions (`.github/workflows/ci.yml`): build + unit tests + fidelity tests on ubuntu/macos, JDK 17. Uses `xvfb-run` for headless Compose on Linux.
+GitHub Actions (`.github/workflows/ci.yml`): build + unit tests + fidelity tests + iOS simulator tests on ubuntu/macos, JDK 17. Uses `xvfb-run` for headless Compose on Linux. Android SDK setup via `android-actions/setup-android@v3`.
 
 Compose Multiplatform compatibility matrix (`.github/workflows/compatibility.yml`): tests against the 3 most recent CMP versions (defined in `.github/compose-versions.json`). Auto-updated weekly by `.github/workflows/update-compose-versions.yml`.
 
 ## Public API
 
+### JVM (full-featured)
+
+```kotlin
+renderToPdf(config, density, mode, defaultFontFamily, pagination) { content } → ByteArray
+renderToPdf(outputStream, config, density, mode, defaultFontFamily, pagination) { content }
+renderToPdf(pages, config, density, mode, defaultFontFamily) { pageIndex → content } → ByteArray
+renderToPdf(outputStream, pages, config, density, mode, defaultFontFamily) { pageIndex → content }
+```
+
+### Android (suspend, requires Context)
+
+```kotlin
+suspend renderToPdf(context, config, density, defaultFontFamily, pagination) { content } → ByteArray
+suspend renderToPdf(context, outputStream, config, density, defaultFontFamily, pagination) { content }
+```
+
+### iOS (synchronous, ByteArray only)
+
+```kotlin
+renderToPdf(config, density, defaultFontFamily, pagination) { content } → ByteArray
+```
+
+### Common (all platforms)
+
 ```kotlin
-renderToPdf(config, density, mode, defaultFontFamily, pagination) { content } → ByteArray  // auto-paginates by default
-renderToPdf(outputStream, config, density, mode, defaultFontFamily, pagination) { content }  // streaming variant
-renderToPdf(pages, config, density, mode, defaultFontFamily) { pageIndex → content } → ByteArray  // manual pages
-renderToPdf(outputStream, pages, config, density, mode, defaultFontFamily) { pageIndex → content }  // streaming variant
 PdfLink(href) { content }
 PdfRoundedCornerShape(topStart, topEnd, bottomEnd, bottomStart)
 Shape.asPdfSafe()
 ```
 
-Types: `PdfPageConfig` (A4/A4WithMargins/Letter/LetterWithMargins/A3/A3WithMargins + `landscape()`), `PdfMargins` (None/Narrow/Normal + `symmetric()`), `PdfPagination` (AUTO/SINGLE_PAGE), `Density`, `RenderMode` (VECTOR/RASTER), `InterFontFamily`, `Compose2PdfException`.
+### Platform availability
+
+| Feature | JVM | Android | iOS |
+|:--------|:---:|:-------:|:---:|
+| `RenderMode` (VECTOR/RASTER) | Yes | No (always vector) | No (always vector) |
+| `InterFontFamily` (bundled Inter) | Yes | No (system fonts) | No (system fonts) |
+| `OutputStream` streaming | Yes | Yes | No |
+| Multi-page manual API | Yes | No | No |
+| `PdfLink` annotations | Yes | No | No |
+| Auto-pagination | Yes | Yes | Yes |
+
+Types: `PdfPageConfig`, `PdfMargins`, `PdfPagination`, `Density`, `RenderMode` (JVM), `InterFontFamily` (JVM), `Compose2PdfException`.
 
 ## Key Files
 
-- `compose2pdf/src/main/kotlin/.../Compose2Pdf.kt` — Public API entry points
-- `compose2pdf/src/main/kotlin/.../internal/PdfRenderer.kt` — Rendering orchestrator (vector, raster, auto-pagination)
-- `compose2pdf/src/main/kotlin/.../internal/ComposeToSvg.kt` — Compose → SVG + measurement
-- `compose2pdf/src/main/kotlin/.../internal/SvgToPdfConverter.kt` — SVG → PDF pages
-- `compose2pdf/src/main/kotlin/.../internal/PaginatedColumn.kt` — Smart page-break layout
-- `compose2pdf/src/main/kotlin/.../internal/FontResolver.kt` — Font resolution + subsetting
-- `fidelity-test/src/test/.../FidelityFixtures.kt` — All fidelity test composables
+### commonMain
+- `compose2pdf/src/commonMain/.../PdfPageConfig.kt` — Page size and margin configuration
+- `compose2pdf/src/commonMain/.../PdfMargins.kt` — Margin presets
+- `compose2pdf/src/commonMain/.../PdfLink.kt` — Link annotation composable + collector
+- `compose2pdf/src/commonMain/.../internal/PaginatedColumn.kt` — Smart page-break layout
+- `compose2pdf/src/commonMain/.../internal/PageLayout.kt` — Page layout utilities
+
+### jvmMain
+- `compose2pdf/src/jvmMain/.../Compose2Pdf.kt` — JVM public API entry points
+- `compose2pdf/src/jvmMain/.../PdfFonts.kt` — InterFontFamily (bundled Inter fonts)
+- `compose2pdf/src/jvmMain/.../internal/PdfRenderer.kt` — Rendering orchestrator (vector, raster, auto-pagination)
+- `compose2pdf/src/jvmMain/.../internal/ComposeToSvg.kt` — Compose → SVG + measurement
+- `compose2pdf/src/jvmMain/.../internal/SvgToPdfConverter.kt` — SVG → PDF pages via PDFBox
+- `compose2pdf/src/jvmMain/.../internal/FontResolver.kt` — Font resolution + subsetting
+
+### androidMain
+- `compose2pdf/src/androidMain/.../Compose2Pdf.android.kt` — Android public API (suspend, Context)
+- `compose2pdf/src/androidMain/.../internal/AndroidPdfRenderer.kt` — Rendering via android.graphics.pdf.PdfDocument
+- `compose2pdf/src/androidMain/.../internal/OffScreenComposeRenderer.kt` — Headless Compose rendering via virtual display
+
+### iosMain
+- `compose2pdf/src/iosMain/.../Compose2Pdf.ios.kt` — iOS public API
+- `compose2pdf/src/iosMain/.../internal/IosPdfRenderer.kt` — Rendering orchestrator
+- `compose2pdf/src/iosMain/.../internal/ComposeToSvg.kt` — Compose → SVG via Skia (iOS)
+- `compose2pdf/src/iosMain/.../internal/CoreGraphicsPdfConverter.kt` — SVG → PDF via CGPDFContext
+- `compose2pdf/src/iosMain/.../internal/SvgDocument.kt` — SVG parsing via NSXMLParser
+- `compose2pdf/src/iosMain/.../internal/CoreGraphicsPathParser.kt` — SVG path → Core Graphics paths
+
+### Tests
+- `fidelity-test/src/test/.../FidelityFixtures.kt` — All fidelity test composables (JVM)
+- `compose2pdf/src/jvmTest/` — JVM unit tests
+- `compose2pdf/src/androidInstrumentedTest/` — Android instrumented tests
+- `compose2pdf/src/iosSimulatorArm64Test/` — iOS simulator tests
 
 ## Architecture
 
+### JVM Pipeline
+
 ```
 Compose content → ComposeToSvg.render() → SVG string
   → SvgToPdfConverter (orchestrator)
@@ -92,19 +169,55 @@ Auto-pagination: PaginatedColumn (smart page breaks)
   → SvgToPdfConverter.addAutoPages() (clip + offset per page)
 ```
 
+### Android Pipeline
+
+```
+Compose content → OffScreenComposeRenderer (headless virtual display)
+  → View.draw() → android.graphics.pdf.PdfDocument Canvas (Skia-backed)
+  → PDF bytes
+
+Always vector output. PdfDocument's Canvas is backed by Skia, producing
+resolution-independent paths and selectable text.
+```
+
+### iOS Pipeline
+
+```
+Compose content → CanvasLayersComposeScene → Skia SVGCanvas → SVG string
+  → NSXMLParser → SvgElement tree
+  → CoreGraphicsPdfConverter (CGPDFContext)
+    ├── CoreGraphicsPathParser (SVG path → CGPath)
+    └── CTFontDrawGlyphs (per-glyph text rendering)
+  → PDF bytes (NSMutableData)
+```
+
 ## Gotchas
 
 ### Docs Site
 - **URL structure** — standalone pages (`getting-started.md`) produce `/page.html` URLs; directory index pages (`usage/index.md`) produce `/directory/` URLs. Don't use trailing slashes for standalone pages.
 
-### Rendering
+### Rendering (JVM)
 - **`@InternalComposeUiApi` opt-in required** — `CanvasLayersComposeScene` is internal Compose API
 - **Variable fonts excluded** — `FontResolver.isVariableFont()` skips fonts with `fvar` table
 - **SVGCanvas bezier approximation** — non-uniform rounded rects become complex bezier paths; use `PdfRoundedCornerShape`
 - **Bundled fonts loaded from classpath** — `FontResolver` loads Inter fonts directly from `InputStream`, no temp files
 - **`Compose2PdfException` wraps rendering errors** — `IllegalArgumentException` (precondition failures) passes through unwrapped
 - **OutputStream overloads don't close the stream** — caller owns the stream lifecycle; `PDDocument.use { it.save(outputStream) }` is called internally
 
+### Rendering (Android)
+- **`renderToPdf` is suspend-only** — requires main thread for off-screen Compose rendering via virtual display
+- **Requires `Context` parameter** — any Context works, not just Activity
+- **No `PdfLink` support** — `android.graphics.pdf.PdfDocument` has no annotation API; `PdfLink` is a no-op
+- **No `RenderMode` parameter** — always produces vector output via PdfDocument's Skia-backed Canvas
+- **No `InterFontFamily`** — uses Android's system font stack
+
+### Rendering (iOS)
+- **Uses `NSXMLParser` for SVG parsing** — not javax.xml (that's JVM-only)
+- **`CTFontDrawGlyphs` for per-glyph text rendering** — fixes spacing issues with Core Text
+- **ByteArray return only** — no `OutputStream` streaming overload
+- **No multi-page manual API** — only auto-pagination
+- **No `PdfLink` annotation support** — Core Graphics PDF context doesn't write link annotations
+
 ### Auto-pagination
 - **Measures in tall scene** — `PdfRenderer` uses a 200K px max scene height for measurement; Compose `Constraints` limit is ~262K px
 - **Falls back for single-page content** — If measured height ≤ page height or ≥ max height (fillMaxHeight detected), falls back to original single-page rendering path for identical output
@@ -113,15 +226,29 @@ Auto-pagination: PaginatedColumn (smart page breaks)
 ### Testing
 - **Fidelity tests assume identical render path** — Changing `renderToPdf` default behavior (e.g., wrapping content in extra layout layers or using a taller scene) can break fidelity comparisons; single-page content must fall back to the original render path
 - **Compose `Placeable` is not fakeable** — `width`/`height` are final; test layout logic with raw `List<Int>` heights instead of mock `Placeable` objects
+- **Android tests use `androidInstrumentedTest`** — requires AndroidX test runner and a managed device or emulator
+- **iOS tests use `iosSimulatorArm64Test`** — runs on macOS only (requires Xcode simulator)
 
 ## Code Conventions
 
 - Package: `com.chrisjenx.compose2pdf`
 - Internal implementation in `com.chrisjenx.compose2pdf.internal`
 - `internal` visibility by default for implementation classes
-- Public API: `renderToPdf()`, `PdfLink()`, `PdfPageConfig`, `PdfMargins`, `PdfPagination`, `RenderMode`, `Density`, `InterFontFamily`, `PdfRoundedCornerShape`, `Shape.asPdfSafe()`, `Compose2PdfException` — everything else is `internal`
+- Platform-specific implementations use file-level platform suffixes (e.g., `Compose2Pdf.android.kt`, `Compose2Pdf.ios.kt`)
+- Public API (JVM): `renderToPdf()`, `PdfLink()`, `PdfPageConfig`, `PdfMargins`, `PdfPagination`, `RenderMode`, `Density`, `InterFontFamily`, `PdfRoundedCornerShape`, `Shape.asPdfSafe()`, `Compose2PdfException` — everything else is `internal`
+- Public API (Android/iOS): `renderToPdf()`, `PdfLink()`, `PdfPageConfig`, `PdfMargins`, `PdfPagination`, `Density`, `PdfRoundedCornerShape`, `Shape.asPdfSafe()`, `Compose2PdfException`
 - Tests use `kotlin-test`
 
 ## Publishing
 
-Maven Central via Sonatype (`s01.oss.sonatype.org`), group ID `com.chrisjenx`. Requires `ossrhUsername`, `ossrhPassword`, and `signing.keyId` in `local.properties` or environment variables.
+Maven Central via Vanniktech Maven Publish plugin (`publishToMavenCentral()` + `signAllPublications()`), group ID `com.chrisjenx`.
+
+KMP produces these artifacts:
+- `com.chrisjenx:compose2pdf` — root metadata module (Gradle Module Metadata)
+- `com.chrisjenx:compose2pdf-jvm` — JVM JAR
+- `com.chrisjenx:compose2pdf-android` — Android AAR (release variant via `publishLibraryVariants("release")`)
+- `com.chrisjenx:compose2pdf-iosarm64` / `iosx64` / `iossimulatorarm64` — iOS klibs
+
+Existing consumers using `implementation("com.chrisjenx:compose2pdf:X.X.X")` continue to work via Gradle Module Metadata (Gradle 6.0+ automatically resolves to the correct platform artifact).
+
+Requires `mavenCentralUsername`, `mavenCentralPassword`, and `signingInMemoryKey*` in environment variables or GitHub secrets. Release and snapshot workflows run on `macos-latest` to build all targets (iOS requires macOS).