Merge branch 'develop'

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+
+github: "LeakyAbstractions"
+ko_fi: "guillermocalvo"
+custom: "buymeacoffee.com/result"

.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+
+updates:
+
+  # ================================
+  # UPDATE GRADLE DEPENDENCIES
+  # ================================
+  - package-ecosystem: gradle
+    directory: /
+    target-branch: develop
+    schedule:
+        interval: weekly
+
+  # ================================
+  # UPDATE GITHUB ACTIONS
+  # ================================
+  - package-ecosystem: github-actions
+    directory: /
+    target-branch: develop
+    schedule:
+        interval: weekly

.github/workflows/build.yml

@@ -0,0 +1,69 @@
+
+# Continuous Integration
+name: Build
+
+on:
+  push:
+    branches:
+    - '*'
+  pull_request:
+    branches:
+    - main
+    - develop
+
+jobs:
+  build:
+
+    name: Build on JDK${{ matrix.jdk }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        jdk: [ 17, 21 ]
+
+    steps:
+
+    # ================================
+    # SHALLOW CLONE
+    # ================================
+    - name: Shallow clone
+      uses: actions/checkout@v4
+
+    # ================================
+    # VALIDATE GRADLE WRAPPER
+    # ================================
+    - name: Validate Gradle Wrapper files
+      uses: gradle/actions/wrapper-validation@v3
+
+    # ================================
+    # SET UP JDK
+    # ================================
+    - name: Set up JDK
+      uses: actions/setup-java@v4
+      with:
+        distribution: 'zulu'
+        java-package: jdk
+        java-version: ${{ matrix.jdk }}
+
+    # ================================
+    # SET UP GRADLE
+    # ================================
+    - name: Set up Gradle
+      uses: gradle/actions/setup-gradle@v3
+      with:
+        build-scan-publish: true
+        build-scan-terms-of-use-url: "https://gradle.com/help/legal-terms-of-use"
+        build-scan-terms-of-use-agree: "yes"
+        cache-read-only: ${{ github.ref_name != 'main' && github.ref_name != 'develop' }}
+
+    # ================================
+    # BUILD
+    # ================================
+    - name: Build
+      run: ./gradlew build -x check
+
+    # ================================
+    # CHECK
+    # ================================
+    - name: Check
+      run: ./gradlew check

.github/workflows/codeql.yml

@@ -0,0 +1,49 @@
+
+# Discover vulnerabilities with CodeQL
+name: CodeQL
+
+on:
+  push:
+    branches:
+    - main
+    - develop
+  pull_request:
+    branches:
+    - main
+    - develop
+  schedule:
+    - cron: '0 8 * * 0'
+
+jobs:
+  analyze:
+
+    name: Analyze Java
+    runs-on: ubuntu-latest
+    timeout-minutes: 360
+    permissions:
+      security-events: write
+
+    steps:
+
+    # ================================
+    # SHALLOW CLONE
+    # ================================
+    - name: Shallow clone
+      uses: actions/checkout@v4
+
+    # ================================
+    # SET UP CODEQL
+    # ================================
+    - name: Set up CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: java-kotlin
+        build-mode: autobuild
+
+    # ================================
+    # ANALYZE
+    # ================================
+    - name: Analyze with CodeQL
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:java-kotlin"

.github/workflows/dependencies.yml

@@ -0,0 +1,41 @@
+
+# Submit dependencies
+name: Dependencies
+
+on:
+  push:
+    branches:
+    - main
+
+permissions:
+  contents: write
+
+jobs:
+  dependencies:
+
+    name: Submit dependencies
+    runs-on: ubuntu-latest
+
+    steps:
+
+    # ================================
+    # SHALLOW CLONE
+    # ================================
+    - name: Shallow clone
+      uses: actions/checkout@v4
+
+    # ================================
+    # SET UP JDK
+    # ================================
+    - name: Set up JDK
+      uses: actions/setup-java@v4
+      with:
+        distribution: 'zulu'
+        java-package: jdk
+        java-version: 21
+
+    # ================================
+    # SUBMIT DEPENDENCIES
+    # ================================
+    - name: Generate and submit dependency graph
+      uses: gradle/actions/dependency-submission@v3

.github/workflows/update-gradle-wrapper.yml

@@ -0,0 +1,32 @@
+
+# Schedule Gradle Wrapper updates
+name: Update Gradle Wrapper
+
+on:
+  schedule:
+    - cron: "0 8 * * *"
+  workflow_dispatch:
+
+jobs:
+  update-gradle-wrapper:
+
+    name: Update Gradle Wrapper
+    runs-on: ubuntu-latest
+
+    steps:
+
+    # ================================
+    # SHALLOW CLONE
+    # ================================
+    - name: Shallow clone
+      uses: actions/checkout@v4
+
+    # ================================
+    # UPDATE GRADLE WRAPPER
+    # ================================
+    - name: Update Gradle Wrapper
+      uses: gradle-update/update-gradle-wrapper-action@v1
+      with:
+        release-channel: stable
+        base-branch: develop
+        target-branch: develop

.gitignore

@@ -0,0 +1,37 @@
+HELP.md
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/