[pull] master from plantuml:master

.github/actions/configure-workflow/action.yml

@@ -7,5 +7,5 @@ inputs:
     description: 'input description here'
     default: 'default value if applicable'
 runs:
-  using: 'node16'
+  using: 'node20'
   main: 'dist/index.js'

.github/actions/configure-workflow/package.json

@@ -28,7 +28,7 @@
   "license": "MIT",
   "dependencies": {
     "@actions/core": "^1.10.0",
-    "@actions/github": "^5.1.1"
+    "@actions/github": "^6.0.0"
   },
   "devDependencies": {
     "@octokit/webhooks-types": "^6.10.0",

.github/labeler.yml

@@ -7,7 +7,7 @@
 'm:docs':
 - changed-files:
   - any-glob-to-any-file:
-    - '*.md'
+    - '**.md'
     - 'docs/**/*'
 
 'm:workflow':
@@ -52,4 +52,5 @@
 'm:native':
 - changed-files:
   - any-glob-to-any-file:
-    - .github/workflows/native-image.yml
+    - .github/workflows/native-image-snapshot.yml
+    - .github/workflows/native-image-release.yml

.github/scripts/release-snapshot.sh

@@ -72,16 +72,16 @@ echo -n "${DATE_TIME_UTC}" > "github_release/plantuml-SNAPSHOT.timestamp"
 
 cat <<-EOF >notes.txt
   ## Version ~v${RELEASE_VERSION%-SNAPSHOT} of the ${DATE_TIME_UTC}
-  This is a pre-release of [the latest development work](https://github.com/plantuml/plantuml/commits/).
+  This is a [JAR](https://en.wikipedia.org/wiki/JAR_(file_format)) pre-release of [the latest development work](https://github.com/plantuml/plantuml/commits/).
   ⚠️  **It is not ready for general use** ⚠️
   ⏱  _Snapshot taken the ${DATE_TIME_UTC}_
 EOF
 
 gh release create \
   --prerelease \
   --target "${GITHUB_SHA}" \
-  --title "${TAG} (~v${RELEASE_VERSION%-SNAPSHOT})" \
+  --title "${TAG} - JAR (~v${RELEASE_VERSION%-SNAPSHOT})" \
   --notes-file notes.txt \
   "${TAG}" github_release/*
 
-echo "::notice title=release snapshot::Snapshot (~v${RELEASE_VERSION%-SNAPSHOT}) released at ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/${TAG} and taken the ${DATE_TIME_UTC}"
+echo "::notice title=release snapshot::snapshot - JAR (~v${RELEASE_VERSION%-SNAPSHOT}) released at ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/${TAG} and taken the ${DATE_TIME_UTC}"

.github/workflows/ci.yml

@@ -5,13 +5,13 @@ on:
   pull_request:
     types: [ opened, synchronize, reopened ]
     paths-ignore:
-      - '*.md'
+      - '**.md'
       - 'docs/**'
   push:
     branches:
       - master
     paths-ignore:
-      - '*.md'
+      - '**.md'
       - 'docs/**'
   workflow_dispatch:
 
@@ -204,7 +204,7 @@ jobs:
         run: gradle javadoc
 
       - name: Deploy Javadoc to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./build/docs/javadoc
@@ -329,7 +329,7 @@ jobs:
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
       - name: Build/push container image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           context: .
           push: true
@@ -338,3 +338,8 @@ jobs:
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
           platforms: linux/amd64,linux/arm64
+
+  create_native_image_release:
+    needs: [ workflow_config, upload ]
+    if: needs.workflow_config.outputs.do_release == 'true'
+    uses: ./.github/workflows/native-image-release.yml

.github/workflows/close-and-put-in-backlog.yml

@@ -25,7 +25,7 @@ jobs:
               body: welcomeMessage
             })
       - uses: peter-evans/close-issue@v3
-      - uses: actions/add-to-project@v0.5.0
+      - uses: actions/add-to-project@v1.0.2
         with:
           project-url: https://github.com/orgs/plantuml/projects/4
           github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}

.github/workflows/native-image-release.yml

@@ -0,0 +1,79 @@
+name: Native Image - Release
+
+on:
+  workflow_dispatch:
+  workflow_call:
+  release:
+    types: [released]
+
+jobs:
+  build_images:
+    name: 'Build Native Image ${{ matrix.platform }}'
+    strategy:
+      matrix:
+        os: [ macos-latest, windows-latest, ubuntu-latest ]
+        include:
+          - os: 'ubuntu-latest'
+            platform: 'linux-amd64'
+          - os: 'macos-latest'
+            platform: 'darwin-arm64'
+          - os: 'macos-13'
+            platform: 'darwin-amd64'
+          - os: 'windows-latest'
+            platform: 'win-amd64'
+    runs-on: ${{matrix.os}}
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4
+
+      - uses: graalvm/setup-graalvm@v1
+        with:
+          java-version: '21'
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          distribution: liberica
+          cache: gradle
+
+      - name: Set the release version
+        shell: bash
+        run: echo "VERSION=$(grep 'version =' gradle.properties | cut -d' ' -f 3)" >> $GITHUB_ENV
+
+      - name: Set the DateTime
+        shell: bash
+        run: echo "DATETIME=$(date -u +'%F at %T (UTC)')" >> $GITHUB_ENV
+
+      - name: Build GPLv2 native image
+        shell: bash
+        run: ./gradlew :plantuml-gplv2:nativeFullCompile :plantuml-gplv2:nativeHeadlessCompile -x test
+
+      - name: Archive Full Release
+        uses: thedoctor0/[email protected]
+        with:
+          type: 'zip'
+          filename: "plantuml-full-${{ matrix.platform }}-${{ env.VERSION }}.zip"
+          directory: plantuml-gplv2/build/native/nativeFullCompile/
+
+      - name: Archive Headless Release
+        uses: thedoctor0/[email protected]
+        with:
+          type: 'zip'
+          filename: "plantuml-headless-${{ matrix.platform }}-${{ env.VERSION }}.zip"
+          directory: plantuml-gplv2/build/native/nativeHeadlessCompile/
+
+      - name: Upload binaries to release
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: "plantuml-gplv2/build/native/native*/plantuml-*-${{ matrix.platform }}-${{ env.VERSION }}.zip"
+          file_glob: true
+          tag: v${{ env.VERSION }}-native
+          release_name: Release - Native Image (v${{ env.VERSION }})
+          overwrite: true
+          make_latest: false
+          prerelease: false
+          body: |
+              ## Version v${{ env.VERSION }} of the ${{ env.DATETIME }}
+              This is a [Native Image](https://www.graalvm.org/latest/reference-manual/native-image/) release of [the latest development work](https://github.com/plantuml/plantuml/commits/).
+              ## Credit or GitHub Action used
+              - [`graalvm/setup-graalvm`](https://github.com/graalvm/setup-graalvm)
+              - [`thedoctor0/zip-release`](https://github.com/TheDoctor0/zip-release)
+              - [`svenstaro/upload-release-action`](https://github.com/svenstaro/upload-release-action)

.github/workflows/native-image-snapshot.yml

@@ -0,0 +1,97 @@
+name: Native Image - Snapshot
+
+on:
+  workflow_dispatch:
+#  push:
+#    branches:
+#      - master
+#    paths-ignore:
+#      - '**.md'
+#      - 'docs/**'
+
+jobs:
+  clean_release:
+    name: 'Clean the snapshot-native pre-release'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4
+
+      - name: Clean release and tag
+        run: |
+          gh release delete snapshot-native --cleanup-tag -y || true
+          echo "::notice title=release snapshot-native::snapshot - Native Image at ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/snapshot-native"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  build_images:
+    name: 'Build Native Image ${{ matrix.platform }}'
+    needs: clean_release
+    strategy:
+      matrix:
+        os: [ macos-latest, windows-latest, ubuntu-latest ]
+        include:
+          - os: 'ubuntu-latest'
+            platform: 'linux-amd64'
+          - os: 'ubuntu-24.04-arm'
+            platform: 'linux-arm64'
+          - os: 'macos-latest'
+            platform: 'darwin-arm64'
+          - os: 'macos-13'
+            platform: 'darwin-amd64'
+          - os: 'windows-latest'
+            platform: 'win-amd64'
+    runs-on: ${{matrix.os}}
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4
+
+      - uses: graalvm/setup-graalvm@v1
+        with:
+          java-version: '21'
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          distribution: liberica
+          cache: gradle
+
+      - name: Set the release version
+        run: echo "VERSION=$(grep 'version =' gradle.properties | cut -d' ' -f 3)" >> $GITHUB_ENV
+        shell: bash
+
+      - name: Set the DateTime
+        shell: bash
+        run: echo "DATETIME=$(date -u +'%F at %T (UTC)')" >> $GITHUB_ENV
+
+      - name: Build GPLv2 native image
+        shell: bash
+        run: ./gradlew :plantuml-gplv2:nativeFullCompile :plantuml-gplv2:nativeHeadlessCompile -x test
+
+      - name: Archive Full Release
+        uses: thedoctor0/[email protected]
+        with:
+          type: 'zip'
+          filename: "plantuml-full-${{ matrix.platform }}-${{ env.VERSION }}.zip"
+          directory: plantuml-gplv2/build/native/nativeFullCompile/
+
+      - name: Archive Headless Release
+        uses: thedoctor0/[email protected]
+        with:
+          type: 'zip'
+          filename: "plantuml-headless-${{ matrix.platform }}-${{ env.VERSION }}.zip"
+          directory: plantuml-gplv2/build/native/nativeHeadlessCompile/
+
+      - name: Upload binaries to release
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: "plantuml-gplv2/build/native/native*/plantuml-*-${{ matrix. platform }}-${{ env.VERSION }}.zip"
+          file_glob: true
+          tag: snapshot-native
+          release_name: snapshot - Native Image (~v${{ env.VERSION }})
+          overwrite: true
+          make_latest: false
+          prerelease: true
+          body: |
+              ## Version ~v${{ env.VERSION }} of the ${{ env.DATETIME }}
+              This is a [Native Image](https://www.graalvm.org/latest/reference-manual/native-image/) pre-release of [the latest development work](https://github.com/plantuml/plantuml/commits/).
+              ⚠️  **It is not ready for general use** ⚠️
+              ⏱  _Snapshot taken the ${{ env.DATETIME }}_

.gitignore

@@ -6,9 +6,10 @@
 .idea
 *.iml
 out
-
+/bin
 #vscode files
 **/bin/
+/.vs
 
 # Ant result file
 plantuml.jar
@@ -27,3 +28,9 @@ build/
 
 # for jenv users
 .java-version
+
+# output of dev tests
+/outputdev
+
+*.patch
+**/*.class

BUILDING.md

@@ -76,6 +76,12 @@ To create a JAR file of the PlantUML project, run the following command:
 gradle jar
 ```
 
+To create a JAR file with PDF output support, run the following command:
+
+```sh
+gradle pdfJar
+```
+
 The JAR file will be created in the `build/libs` directory.
 
 ### Contributing