[WIP] Apply patch #1139 for 8.x branch

.editorconfig

@@ -7,19 +7,15 @@ indent_style = space
 insert_final_newline = true
 trim_trailing_whitespace = true
 
-[*.{groovy,java}]
-indent_size = 4
-
 [*.{kt,kts}]
 ij_kotlin_imports_layout = *
 ij_kotlin_allow_trailing_comma = true
 ij_kotlin_allow_trailing_comma_on_call_site = true
+ij_kotlin_continuation_indent_size = 2
 ij_kotlin_line_break_after_multiline_when_entry = false
-ij_kotlin_name_count_to_use_star_import = 999
-ij_kotlin_name_count_to_use_star_import_for_members = 999
+ij_kotlin_name_count_to_use_star_import = 2147483647
+ij_kotlin_name_count_to_use_star_import_for_members = 2147483647
 ij_kotlin_packages_to_use_import_on_demand = unset
-ktlint_code_style = intellij_idea
-ktlint_standard_function-expression-body = disabled
 
 [*.md]
 trim_trailing_whitespace = false

.gitattributes

@@ -1,4 +1,5 @@
 * text=auto eol=lf
 
-gradlew binary
-gradlew.bat binary
+*.bat text eol=crlf
+*.jar binary
+*.svg binary

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: Goooler

.github/pull_request_template.md

@@ -1,3 +1,3 @@
 ---
 
-- [ ] [CHANGELOG](https://github.com/GradleUp/shadow/blob/main/src/docs/changes/README.md)'s "Unreleased" section has been updated, if applicable.
+- [ ] [CHANGELOG](https://github.com/GradleUp/shadow/blob/main/docs/changes/README.md)'s "Unreleased" section has been updated, if applicable.

.github/renovate.json5

@@ -1,6 +1,38 @@
 {
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": [
-    "config:base",
-  ]
+  $schema: 'https://docs.renovatebot.com/renovate-schema.json',
+  extends: [
+    'config:recommended',
+  ],
+  labels: [
+    'dependencies',
+  ],
+  packageRules: [
+    {
+      groupName: 'Develocity',
+      matchPackageNames: [
+        'com.gradle:develocity-gradle-plugin',
+        'com.gradle.develocity:com.gradle.develocity.gradle.plugin',
+      ],
+    },
+  ],
+  ignorePresets: [
+    // Ensure we get the latest version and are not pinned to old versions.
+    'workarounds:javaLTSVersions',
+  ],
+  customManagers: [
+    // Update .java-version file with the latest JDK version.
+    {
+      customType: 'regex',
+      managerFilePatterns: [
+        '/\\.java-version$/',
+      ],
+      matchStrings: [
+        '(?<currentValue>.*)\\n',
+      ],
+      datasourceTemplate: 'java-version',
+      depNameTemplate: 'java',
+      // Only write the major version.
+      extractVersionTemplate: '^(?<version>\\d+)',
+    },
+  ],
 }

.github/workflows/.java-version

@@ -0,0 +1 @@
+25

.github/workflows/build.yml

@@ -0,0 +1,63 @@
+name: Build
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: OS=${{ matrix.os }}, Gradle=${{ matrix.gradle }}
+    strategy:
+      matrix:
+        os: [ ubuntu-24.04-arm, windows-latest ]
+        # Test on the minimum Gradle version and the latest.
+        gradle: [ 9.0.0, current ]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-java@v5
+        with:
+          distribution: 'zulu'
+          java-version-file: .github/workflows/.java-version
+      - uses: gradle/actions/setup-gradle@v5
+      - run: ./gradlew build "-PtestGradleVersion=${{ matrix.gradle }}" --stacktrace
+
+  # Status check that is required in branch protection rules.
+  build-status:
+    needs:
+      - build
+    runs-on: ubuntu-slim
+    if: always()
+    steps:
+      - name: Check
+        run: |
+          results=$(tr -d '\n' <<< '${{ toJSON(needs.*.result) }}')
+          if ! grep -q -v -E '(failure|cancelled)' <<< "$results"; then
+            echo "One or more required jobs failed"
+            exit 1
+          fi
+          echo "All required jobs completed successfully."
+
+  publish-snapshot:
+    needs: build-status
+    runs-on: ubuntu-24.04-arm
+    if: github.event.repository.fork == false && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-java@v5
+        with:
+          distribution: 'zulu'
+          java-version-file: .github/workflows/.java-version
+      - uses: gradle/actions/setup-gradle@v5
+        with:
+          cache-read-only: true
+          dependency-graph: 'generate-submit-and-upload'
+      - run: ./gradlew publishToMavenCentral
+        env:
+          ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.CENTRAL_PORTAL_USERNAME }}
+          ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.CENTRAL_PORTAL_PASSWORD }}
+          ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.GPG_KEY }}
+          ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.GPG_KEY_PASSWORD }}

.github/workflows/deploy.yml

@@ -0,0 +1,31 @@
+name: Deploy
+
+on:
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-24.04-arm
+    if: github.event.repository.fork == false
+    environment:
+      name: github-pages
+    permissions:
+      id-token: write
+      pages: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: gradle/actions/setup-gradle@v5
+        with:
+          cache-read-only: true
+      - name: Prepare API documentation
+        run: ./gradlew dokkaGenerate
+      - name: Build Site
+        run: |
+          # Don't cache it to track updates.
+          pip install mkdocs-material
+          mkdocs build
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+      - uses: actions/deploy-pages@v4

.github/workflows/links.yml

@@ -0,0 +1,41 @@
+name: Links
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - docs/**
+      - README.md
+      - RELEASING.md
+      - .github/workflows/links.yml
+  pull_request:
+    paths:
+      - docs/**
+      - README.md
+      - RELEASING.md
+      - .github/workflows/links.yml
+  workflow_dispatch:
+
+jobs:
+  check-links:
+    runs-on: ubuntu-latest # TODO: https://github.com/UmbrellaDocs/linkspector/issues/149
+    if: github.event.repository.fork == false
+    steps:
+      - uses: actions/checkout@v6
+      - uses: gradle/actions/setup-gradle@v5
+        with:
+          cache-read-only: true
+      # This is required for action-linkspector to work with API links.
+      - run: ./gradlew dokkaGenerate
+      - name: Mkdocs build validation
+        run: |
+          # Don't cache it to track updates.
+          pip install mkdocs-material
+          mkdocs build --strict
+      - uses: umbrelladocs/action-linkspector@v1
+        with:
+          reporter: github-pr-check
+          fail_on_error: true
+          filter_mode: nofilter
+          fail_level: any

.github/workflows/release.yml

@@ -7,43 +7,39 @@ on:
 
 jobs:
   release:
-    runs-on: ubuntu-latest
-    if: github.repository == 'GradleUp/shadow'
+    runs-on: ubuntu-24.04-arm
+    if: github.event.repository.fork == false
+    environment:
+      name: maven-central
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-java@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-java@v5
         with:
           distribution: 'zulu'
-          java-version: 21
-      - uses: gradle/actions/setup-gradle@v4
+          java-version-file: .github/workflows/.java-version
+      - uses: gradle/actions/setup-gradle@v5
         with:
           cache-read-only: true
-      - uses: actions/setup-node@v4
-        with:
-          # Due to some limitations of https://github.com/node-gradle/gradle-node-plugin.
-          node-version: '16'
-      # Disable CC due to https://github.com/gradle/gradle/issues/22779
-      - run: ./gradlew release --no-configuration-cache
+      - run: ./gradlew publishToMavenCentral publishPlugins
         env:
           GRADLE_PUBLISH_KEY: ${{ secrets.GRADLE_KEY }}
           GRADLE_PUBLISH_SECRET: ${{ secrets.GRADLE_SECRET }}
-          # We must declare repository_owner as the user, workaround for https://github.com/ajoberstar/gradle-git-publish/issues/109.
-          GRGIT_USER: ${{ github.repository_owner }}
-          # https://ajoberstar.org/grgit/main/grgit-authentication.html#_environment_variables
-          GRGIT_PASS: ${{ secrets.GITHUB_TOKEN }}
-          ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.OSSRH_USER }}
-          ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.OSSRH_PASSWORD }}
+          ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.CENTRAL_PORTAL_USERNAME }}
+          ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.CENTRAL_PORTAL_PASSWORD }}
           ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.GPG_KEY }}
           ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.GPG_KEY_PASSWORD }}
       - name: Extract release notes
-        # TODO: replace this after https://github.com/ffurrer2/extract-release-notes/pull/355 is merged.
-        uses: Goooler/extract-release-notes@6e686e7a607d03716b7cff561371a82065b22c33
+        uses: ffurrer2/extract-release-notes@v3
         with:
-          changelog_file: src/docs/changes/README.md
+          changelog_file: docs/changes/README.md
           release_notes_file: RELEASE_NOTES.md
       - name: Create release
         run: gh release create ${{ github.ref_name }} --notes-file RELEASE_NOTES.md
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  deploy:
+    needs: release
+    uses: ./.github/workflows/deploy.yml

.gitignore

@@ -1,19 +1,25 @@
-*.un~
+.fleet
+.gradle
+.kotlin
+build
+
+### Android Studio ###
+local.properties
+
+### IntelliJ IDEA ###
+.idea
+*.iws
 *.iml
 *.ipr
-*.iws
-.idea
-build
-.gradle
-*.orig
 out
-.gradletasknamecache
-.gradle-test-kit
-classes/
-node_modules/
-yarn-error.log
-src/docs/.vuepress/dist/
+
+### VS Code ###
+.vscode
+bin
+
+### Mac OS ###
 .DS_Store
-jd-gui.cfg
-bin/
-.vscode/
+
+### MkDocs ###
+docs/api
+site

AGENTS.md

@@ -0,0 +1,9 @@
+# Agent Guidelines
+
+To understand how to contribute code, format commits, and run tests for this repository, 
+please refer to the [CONTRIBUTING.md](./CONTRIBUTING.md) file.
+
+**Instructions for AI Agents:**
+1. Read `CONTRIBUTING.md` before suggesting any code changes.
+2. Adhere to the coding standards and PR templates defined therein.
+3. Follow the environment setup steps to verify your proposed fixes.