Updating javadoc capacity

Author: mrhunsaker

.factorypath

@@ -0,0 +1,31 @@
+<factorypath>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-controls/21.0.2/javafx-controls-21.0.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-controls/21.0.2/javafx-controls-21.0.2-linux.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-graphics/21.0.2/javafx-graphics-21.0.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-graphics/21.0.2/javafx-graphics-21.0.2-linux.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-base/21.0.2/javafx-base-21.0.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-base/21.0.2/javafx-base-21.0.2-linux.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-fxml/21.0.2/javafx-fxml-21.0.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-fxml/21.0.2/javafx-fxml-21.0.2-linux.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-swing/21.0.2/javafx-swing-21.0.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/openjfx/javafx-swing/21.0.2/javafx-swing-21.0.2-linux.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/google/code/gson/gson/2.10.1/gson-2.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/apache/commons/commons-csv/1.10.0/commons-csv-1.10.0.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/imageio/imageio-core/3.10.1/imageio-core-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/common/common-lang/3.10.1/common-lang-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/common/common-io/3.10.1/common-io-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/common/common-image/3.10.1/common-image-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/imageio/imageio-tiff/3.10.1/imageio-tiff-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/imageio/imageio-webp/3.10.1/imageio-webp-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/twelvemonkeys/imageio/imageio-metadata/3.10.1/imageio-metadata-3.10.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/formdev/flatlaf/3.4.1/flatlaf-3.4.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/formdev/flatlaf-intellij-themes/3.4.1/flatlaf-intellij-themes-3.4.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/slf4j/slf4j-api/2.0.9/slf4j-api-2.0.9.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/apache/logging/log4j/log4j-api/2.23.1/log4j-api-2.23.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/apache/logging/log4j/log4j-core/2.23.1/log4j-core-2.23.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/org/apache/logging/log4j/log4j-slf4j2-impl/2.23.1/log4j-slf4j2-impl-2.23.1.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/lmax/disruptor/3.4.4/disruptor-3.4.4.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/fasterxml/jackson/core/jackson-databind/2.15.2/jackson-databind-2.15.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/fasterxml/jackson/core/jackson-annotations/2.15.2/jackson-annotations-2.15.2.jar" enabled="true" runInBatchMode="false"/>
+    <factorypathentry kind="VARJAR" id="M2_REPO/com/fasterxml/jackson/core/jackson-core/2.15.2/jackson-core-2.15.2.jar" enabled="true" runInBatchMode="false"/>
+</factorypath>

.github/workflows/deploy-javadocs.yml

@@ -1,35 +1,48 @@
-name: Deploy Maven Site (Javadocs)
+name: Deploy API Docs (Javadocs Only)
 
 on:
-  push:
-    branches: [ main, v2.0-beta ]
-  workflow_dispatch:
+    push:
+        branches: [main, v2.0-beta]
+    workflow_dispatch:
 
 jobs:
-  build-and-deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up JDK
-        uses: actions/setup-java@v4
-        with:
-          distribution: temurin
-          java-version: '21'
-
-      - name: Cache Maven repository
-        uses: actions/cache@v4
-        with:
-          path: ~/.m2/repository
-          key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
-          restore-keys: ${{ runner.os }}-m2-
-
-      - name: Build Maven site
-        run: mvn -B -DskipTests site
-
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./target/site
-          publish_branch: gh-pages
+    build-and-deploy:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Set up JDK
+              uses: actions/setup-java@v4
+              with:
+                  distribution: temurin
+                  java-version: "21"
+
+            - name: Cache Maven repository
+              uses: actions/cache@v4
+              with:
+                  path: ~/.m2/repository
+                  key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+                  restore-keys: ${{ runner.os }}-m2-
+
+            - name: Build Maven site (includes apidocs)
+              run: mvn -B -DskipTests site
+
+            - name: Determine project version
+              id: get-version
+              run: echo "version=$(mvn -q -DforceStdout help:evaluate -Dexpression=project.version)" >> $GITHUB_OUTPUT
+
+            - name: Prepare versioned Javadocs
+              run: |
+                  mkdir -p build/site-workdir
+                  cp -R target/site/apidocs build/site-workdir/apidocs-temp
+                  chmod +x scripts/generate-javadoc-index.sh
+                  scripts/generate-javadoc-index.sh --root build/site-workdir --version "${{ steps.get-version.outputs.version }}" --latest --project-url https://github.com/YOUR_USERNAME/YOUR_REPO_NAME --package com.digitizer.ui
+
+            - name: Deploy versioned Javadocs to GitHub Pages
+              uses: peaceiris/actions-gh-pages@v3
+              with:
+                  github_token: ${{ secrets.GITHUB_TOKEN }}
+                  publish_dir: build/site-workdir
+                  publish_branch: gh-pages
+                  force_orphan: true
+                  disable_nojekyll: true

README.md

@@ -1,4 +1,5 @@
 # Graph Digitizer (Java 21 Edition)
+[![API Docs](https://img.shields.io/badge/API%20Docs-Latest-blue.svg)](https://YOUR_USERNAME.github.io/YOUR_REPO_NAME/)
 
 A modern Java 21 / JavaFX implementation of the Graph Digitizer tool for extracting numeric data points from raster images of graphs.
 
@@ -30,6 +31,12 @@ A modern Java 21 / JavaFX implementation of the Graph Digitizer tool for extract
 
 - **[Packaging Guide](packaging/README.md)** - AppImage, DEB, RPM, and native installers
 
+### API Documentation
+
+- **[Latest API (Javadoc)](https://YOUR_USERNAME.github.io/YOUR_REPO_NAME/)** – Generated from the current main branch
+- **Versioned Archives:** Each release will publish Javadocs under a subdirectory (e.g. `/1.1/`, `/1.2/`). Navigate directly to a version path to view older APIs.
+- If the badge link is not yet active, enable GitHub Pages (Settings → Pages → Branch: `gh-pages`).
+
 ## Quick Start
 
 ### Prerequisites
@@ -405,23 +412,41 @@ jpackage --type exe \
 Tip: Use `maven-jlink-plugin` and the `jpackage` Maven plugin to integrate
 this into your Maven lifecycle so OS-specific packages are reproducible.
 
-The repository includes a Maven profile named `native` that automates
-runtime image creation and packaging using `maven-jlink-plugin` and
-`org.panteleyev:jpackage-maven-plugin`. Example usages:
+The repository includes a unified Maven packaging setup driven by the `native` property. A single command now builds the shaded JAR, copies icons, gathers JavaFX modules for the current OS, creates the jpackage app-image, and then produces any OS-specific installers.
 
-```bash
+Unified build command (run this on your current OS):
+mvn clean package -Dnative
+
+Outputs per OS:
+Windows:
+- App image: target/jpackage/GraphDigitizer
+- MSI installer: target/jpackage-msi/GraphDigitizer-<version>.msi
 
-# On Windows (EXE installer)
+macOS:
+- App image: target/jpackage/GraphDigitizer.app
+- DMG installer: target/jpackage-dmg/GraphDigitizer-<version>.dmg
 
-mvn -Pnative -Djpackage.type=exe package
+Linux:
+- App image: target/jpackage/GraphDigitizer
+- DEB package: target/jpackage-deb/graphdigitizer_<version>_amd64.deb (name may vary by architecture)
+- RPM package: target/jpackage-rpm/graphdigitizer-<version>-1.x86_64.rpm (name may vary by architecture)
 
-# On macOS (DMG)
+Optional overrides (examples):
+- mvn clean package -Dnative -Dicon.win=build/icons/custom.ico
+- mvn clean package -Dnative -Dicon.mac=build/icons/custom.icns
+- mvn clean package -Dnative -Dicon.linux=build/icons/custom.png
+(Icon properties default to the copied files under build/icons.)
 
-mvn -Pnative -Djpackage.type=dmg package
+Skip tests if desired:
+mvn clean package -Dnative -DskipTests
 
-# On Linux (DEB)
+If you only want to adjust version or icon without rebuilding everything, you can reuse the previous target artifacts; however, the unified command is designed to be reproducible and idempotent.
+
+Advanced: You can still run jpackage manually for debugging; see the manual section below.
+
+```bash
 
-mvn -Pnative -Djpackage.type=deb package
+(Deprecated examples removed: previous per-OS -Pnative + -Djpackage.type usage has been replaced by the single -Dnative flow.)
 
 ```
 
@@ -432,8 +457,9 @@ Notes:
 
 #### Automated MSI via Maven
 
-The `native` profile now automates `jpackage` as part of `mvn -Pnative package`. On Windows, if
-you want an MSI installer the steps are:
+Windows MSI creation is automatic with:
+mvn clean package -Dnative
+(Previous instructions using -Pnative and -Djpackage.type are obsolete.)
 
 1. Install the WiX Toolset (v3.11 or v4+) and ensure `candle.exe`/`light.exe` (or equivalent WiX binaries) are on your `PATH`.