feat: upgrade Angular 19→21, extract inline templates, add charcoal/amber theme, restructure home page

.github/workflows/maven-build-installer-windows.yml

@@ -1,68 +1,61 @@
-# This workflow will build a Java project with Maven
-# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
+# Build native executables with GraalVM and publish a pre-release
+# Replaces the old Spring Boot/JavaFX MSI pipeline now that the app is a Quarkus native image.
 
-name: Build Windows Installer
+name: Build Native Image
 env:
-  JAVA_VERSION: 25
+  JAVA_VERSION: '25'        # GraalVM CE 25 — Java 25 source/target and runtime; Quarkus 3.34.1 supports Java 25
 
 on:
   push:
     branches:
       - main
       - releases/**
   workflow_dispatch:
+
 jobs:
   buildWindows:
     runs-on: windows-latest
     steps:
-      - name: Download Wix
-        uses: i3h/download-release-asset@v1
-        with:
-          owner: wixtoolset
-          repo: wix3
-          tag: wix3112rtm
-          file: wix311-binaries.zip
-          token: ${{ secrets.GITHUB_TOKEN }}
-      - name: Decompress Wix
-        run: 7z x wix311-binaries.zip "-o./target/wix"
-      - name: Add Wix to Path
-        run: echo "$HOME/target/wix" >> $GITHUB_PATH
-      - uses: actions/checkout@v6
-      - name: Set up JDK
-        uses: actions/setup-java@v5
+      - uses: actions/checkout@v4
+
+      - name: Set up GraalVM CE
+        uses: graalvm/setup-graalvm@v1
         with:
           java-version: ${{ env.JAVA_VERSION }}
-          distribution: 'liberica'
-          java-package: jdk+fx
+          distribution: 'graalvm-community'
+          native-image-job-reports: 'true'
           cache: 'maven'
-      - name: Build with Maven
-        run: mvn -B clean install --file pom.xml
+
+      - name: Build native image (Windows)
+        run: mvn -B package -Pnative --file pom.xml
+
       - name: Store artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v4
         with:
-          name: windows-installer
-          path: ./target/*.msi
+          name: windows-native
+          path: ./target/*-runner.exe
 
   buildLinux:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
-      - name: Set up JDK
-        uses: actions/setup-java@v5
+      - uses: actions/checkout@v4
+
+      - name: Set up GraalVM CE
+        uses: graalvm/setup-graalvm@v1
         with:
           java-version: ${{ env.JAVA_VERSION }}
-          distribution: 'liberica'
-          java-package: jdk+fx
+          distribution: 'graalvm-community'
+          native-image-job-reports: 'true'
           cache: 'maven'
-      - name: Build with Maven
-        run: mvn -B clean install --file pom.xml
+
+      - name: Build native image (Linux)
+        run: mvn -B package -Pnative --file pom.xml
+
       - name: Store artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v4
         with:
-          name: linux-installer
-          path: |
-            ./target/*.deb
-            ./target/*.jar
+          name: linux-native
+          path: ./target/*-runner
 
   preRelease:
     name: Pre-release
@@ -71,30 +64,27 @@ jobs:
       - buildLinux
     runs-on: ubuntu-latest
     steps:
-      # Check out current repository
       - name: Fetch Sources
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4
 
       - name: Extract Maven project version
         run: echo "version=$(mvn -q -Dexec.executable=echo -Dexec.args='${project.version}' --non-recursive exec:exec)" >> $GITHUB_OUTPUT
         id: project
 
       - name: Compute tag name
-        # Compute a branch-specific, filesystem-friendly tag name and export to job env
         run: |
-          # Strip refs/heads/ prefix and replace non-alphanumeric characters with '-'
           branch="${GITHUB_REF#refs/heads/}"
           safe_branch=$(echo "$branch" | sed 's/[^A-Za-z0-9._-]/-/g')
-          echo "TAG_NAME=latest-windows-$safe_branch" >> $GITHUB_ENV
+          echo "TAG_NAME=latest-$safe_branch" >> $GITHUB_ENV
 
-      # Remove old pre-releases
       - name: Remove Old Pre-release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           gh api repos/{owner}/{repo}/releases \
             --jq '.[] | select(.prerelease == true) | .id' \
             | xargs -I '{}' gh api -X DELETE repos/{owner}/{repo}/releases/{}
+
       - name: Remove previous tag
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -106,7 +96,6 @@ jobs:
             echo "Tag $TAG_NAME does not exist; skipping delete"
           fi
 
-      # Create new pre-release
       - name: Create Pre-release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -117,17 +106,16 @@ jobs:
             --title "v${{ steps.project.outputs.version }} Pre-Release (${{ env.GITHUB_RUN_NUMBER }})" \
             --notes "$(sed '/##/Q' CHANGELOG.md)"
 
-      # Only now download the artifacts so that there is a delay between creating the pre-release and adding the artifacts
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v4
         with:
-          name: windows-installer
+          name: windows-native
           path: target
-      - uses: actions/download-artifact@v7
+
+      - uses: actions/download-artifact@v4
         with:
-          name: linux-installer
+          name: linux-native
           path: target
 
-      # Upload artifact as a release asset
       - name: Upload Release Asset
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -19,3 +19,4 @@ target/
 # Application files
 /SndCtrl.dll
 /src/main/resources/application-default.properties
+/.idea/JunieProjectTechnologies.xml

.mvn/jvm.config

@@ -0,0 +1,10 @@
+--add-opens=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED
+--add-opens=jdk.compiler/com.sun.tools.javac.jvm=ALL-UNNAMED

CONTRIBUTING.md

@@ -55,3 +55,10 @@ The SndCtrlTest project is there because Access Violations within JNI just close
 Running it with the Test code might actually show the error.
 
 An `EnableFullDump.reg` registry file is included to enable full dumps when the application crashes. This can be used to debug the native code.
+
+## Native build stuff
+
+```shell
+java.exe -agentlib:native-image-agent=config-output-dir=native-image
+         -jar target/pcpanel-1.8-SNAPSHOT-native-image-source-jar/pcpanel-1.8-SNAPSHOT-runner.jar
+```

README.md

@@ -45,5 +45,13 @@ manually copy the settings file:
 to
 `%userprofile%\.pcpanel\profiles.json`
 
+# Generate reachability metadata
+
+```shell
+mvn test "-DargLine=-agentlib:native-image-agent=config-output-dir=src/main/resources/META-INF/native-image/ -Djava.awt.headless=false"
+mvn test "-DargLine=-Dnative -Dquarkus.native.agent-configuration-apply" -Dnative -Dquarkus.native.agent-configuration-apply
+```
+
+
 ---
 Build template from [wiverson](https://github.com/wiverson/maven-jpackage-template)

generate-native-configs.cmd

@@ -0,0 +1,154 @@
+@echo off
+setlocal enabledelayedexpansion
+
+:: ============================================================================
+::  generate-native-configs.cmd
+::
+::  Runs the native-image coverage tests under the GraalVM tracing agent and
+::  merges the resulting JSON config files into the project's hand-maintained
+::  native-image directory so they can be committed alongside source code.
+::
+::  Prerequisites
+::  -------------
+::  * GraalVM JDK installed and GRAALVM_HOME set  (or JAVA_HOME pointing to it)
+::  * Maven wrapper (mvnw.cmd) present at the project root
+::  * SndCtrl.dll available on PATH or in target/ (for the JNI tests)
+::
+::  Usage
+::  -----
+::    generate-native-configs.cmd
+::
+::  Output
+::  ------
+::  Generated JSON files are written to:
+::    target\native-agent-output\
+::
+::  Then MERGED into (existing entries preserved, new ones appended):
+::    src\main\resources\META-INF\native-image\com.getpcpanel\pcpanel\
+::  ============================================================================
+
+:: ── Locate project root (directory that contains this script) ────────────────
+set "PROJECT_ROOT=%~dp0"
+if "%PROJECT_ROOT:~-1%" == "\" set "PROJECT_ROOT=%PROJECT_ROOT:~0,-1%"
+
+:: ── Resolve GraalVM home ─────────────────────────────────────────────────────
+if not defined GRAALVM_HOME (
+    if defined JAVA_HOME (
+        set "GRAALVM_HOME=%JAVA_HOME%"
+        echo INFO: GRAALVM_HOME not set; falling back to JAVA_HOME=%JAVA_HOME%
+    ) else (
+        echo ERROR: Neither GRAALVM_HOME nor JAVA_HOME is set.
+        echo        Install GraalVM and set GRAALVM_HOME, or set JAVA_HOME to the GraalVM JDK.
+        exit /b 1
+    )
+)
+
+:: Ensure Maven uses the GraalVM JDK (not whatever JAVA_HOME the shell inherited)
+set "JAVA_HOME=%GRAALVM_HOME%"
+set "PATH=%JAVA_HOME%\bin;%PATH%"
+
+:: Verify the tracing agent JAR / native-image-agent library is available
+if not exist "%GRAALVM_HOME%\lib\svm\bin\native-image.cmd" (
+    if not exist "%GRAALVM_HOME%\bin\native-image.cmd" (
+        echo WARNING: native-image executable not found under GRAALVM_HOME=%GRAALVM_HOME%
+        echo          Make sure GraalVM Native Image component is installed:
+        echo            gu install native-image
+        echo          Continuing anyway – the agent JVM flag may still work.
+    )
+)
+
+:: ── Paths ────────────────────────────────────────────────────────────────────
+set "AGENT_OUTPUT_DIR=%PROJECT_ROOT%\target\native-agent-output"
+set "CONFIG_DEST=%PROJECT_ROOT%\src\main\resources\META-INF\native-image\com.getpcpanel\pcpanel"
+set "MVNW=%PROJECT_ROOT%\mvnw.cmd"
+
+:: ── Clean previous agent output ──────────────────────────────────────────────
+echo.
+echo [1/4] Cleaning previous agent output directory...
+if exist "%AGENT_OUTPUT_DIR%" (
+    rmdir /s /q "%AGENT_OUTPUT_DIR%"
+)
+mkdir "%AGENT_OUTPUT_DIR%"
+
+:: ── Compile the project (tests + main) ──────────────────────────────────────
+echo.
+echo [2/4] Compiling project (test-compile)...
+call "%MVNW%" test-compile -q
+if %ERRORLEVEL% neq 0 (
+    echo ERROR: Compilation failed.  Fix build errors before regenerating configs.
+    exit /b %ERRORLEVEL%
+)
+
+:: ── Run coverage tests with tracing agent ────────────────────────────────────
+echo.
+echo [3/4] Running native-image coverage tests with tracing agent...
+echo       Agent output  : %AGENT_OUTPUT_DIR%
+echo       Tests         : SndCtrlNativeConfigTest, VolumeOverlayNativeTest
+echo.
+
+::  -Dtest selects only the four coverage tests so unrelated tests don't pollute
+::  the config.  maven.test.failure.ignore=true lets the script continue even if
+::  a test fails (e.g. on a headless CI machine without a display).
+call "%MVNW%" test "-DargLine=-agentlib:native-image-agent=config-output-dir=%AGENT_OUTPUT_DIR% -Djava.awt.headless=false"
+
+echo.
+echo [3/4] Tests finished (failures are non-fatal for config generation).
+
+:: ── Merge generated files into the hand-maintained config directory ───────────
+echo.
+echo [4/4] Merging generated configs into %CONFIG_DEST%
+echo.
+
+if not exist "%CONFIG_DEST%" mkdir "%CONFIG_DEST%"
+
+set FILES_UPDATED=0
+
+:: GraalVM 23+ generates a unified reachability-metadata.json that replaces all of the
+:: old individual files (jni-config.json, reflect-config.json, proxy-config.json, etc.).
+::
+:: The following files are intentionally hand-maintained and must NOT be overwritten:
+::   jni-config.json   -- 4 project classes SndCtrl.dll calls back into via JNI (C->Java).
+::                        Cannot be auto-generated because unit tests never load the native DLL.
+::   proxy-config.json -- JNA dynamic proxy interfaces (Shell32Extra, VoicemeeterInstance, …).
+::                        Cannot be auto-generated without loading the native libraries.
+::
+:: Only reachability-metadata.json (and future agent-only files) are copied here.
+
+call "%MVNW%" verify "-DargLine=-Dnative -Dquarkus.native.agent-configuration-apply" -Dnative -Dquarkus.native.agent-configuration-apply
+
+
+@REM for %%F in (reachability-metadata.json) do (
+@REM     if exist "%AGENT_OUTPUT_DIR%\%%F" (
+@REM         copy /y "%AGENT_OUTPUT_DIR%\%%F" "%CONFIG_DEST%\%%F" > nul
+@REM         echo   Updated : %%F
+@REM         set /a FILES_UPDATED=FILES_UPDATED+1
+@REM     ) else (
+@REM         echo   Skipped : %%F  ^(not generated^)
+@REM     )
+@REM )
+
+:: ── Summary ──────────────────────────────────────────────────────────────────
+echo.
+if %FILES_UPDATED% gtr 0 (
+    echo SUCCESS: %FILES_UPDATED% config file^(s^) updated.
+    echo.
+    echo Next steps:
+    echo   1. Review the changes in %CONFIG_DEST%
+    echo   2. Diff against the previous version to understand what changed
+    echo   3. Remove spurious entries captured from test infrastructure
+    echo      ^(look for class names ending in Test, or JUnit internals^)
+    echo   4. Commit the updated files
+) else (
+    echo WARNING: No config files were generated.
+    echo          Check that:
+    echo            * The tests compiled and ran ^(see target\surefire-reports\^)
+    echo            * GRAALVM_HOME points to a GraalVM JDK ^(not a regular JDK^)
+    echo            * The native-image-agent is installed:  gu install native-image
+)
+
+echo.
+echo Raw agent output is preserved in:
+echo   %AGENT_OUTPUT_DIR%
+echo.
+
+endlocal