Merge branch 'v3-alpha' into v3-alpha

.all-contributorsrc

@@ -158,7 +158,7 @@
       ]
     },
     {
-      "login": "codydbentley",
+      "login": "sircodemane",
       "name": "Cody Bentley",
       "avatar_url": "https://avatars.githubusercontent.com/u/6968902?v=4",
       "profile": "https://codybentley.dev/",

.coderabbit.yaml

@@ -0,0 +1,71 @@
+language: en-US
+tone_instructions: ''
+early_access: false
+enable_free_tier: true
+reviews:
+  profile: chill
+  request_changes_workflow: false
+  high_level_summary: true
+  high_level_summary_placeholder: '@coderabbitai summary'
+  auto_title_placeholder: '@coderabbitai'
+  review_status: true
+  poem: true
+  collapse_walkthrough: false
+  sequence_diagrams: true
+  path_filters: []
+  path_instructions: []
+  abort_on_close: true
+  auto_review:
+    enabled: true
+    auto_incremental_review: true
+    ignore_title_keywords: []
+    labels: []
+    drafts: false
+    base_branches: ['v3-alpha', 'master']
+  tools:
+    shellcheck:
+      enabled: true
+    ruff:
+      enabled: true
+    markdownlint:
+      enabled: true
+    github-checks:
+      enabled: true
+      timeout_ms: 90000
+    languagetool:
+      enabled: true
+      enabled_only: false
+      level: default
+    biome:
+      enabled: true
+    hadolint:
+      enabled: true
+    swiftlint:
+      enabled: true
+    phpstan:
+      enabled: true
+      level: default
+    golangci-lint:
+      enabled: true
+    yamllint:
+      enabled: true
+    gitleaks:
+      enabled: true
+    checkov:
+      enabled: true
+    detekt:
+      enabled: true
+    eslint:
+      enabled: true
+chat:
+  auto_reply: true
+knowledge_base:
+  opt_out: false
+  learnings:
+    scope: auto
+  issues:
+    scope: auto
+  jira:
+    project_keys: []
+  linear:
+    team_keys: []

.github/pull_request_template.md

@@ -1,9 +1,19 @@
 
 <!--
-READ CAREFULLY: Before submitting your PR, please ensure you have created an issue for your PR.
-It is essential that you do this so that we can discuss the proposed changes before you spend time on them.
-If you do not create an issue, your PR may be rejected without review.
-If a relevant issue already exists, please reference it in your PR by including `Fixes #<issue number>` in your PR description.
+
+*********************************************************************
+*               PLEASE READ BEFORE SUBMITTING YOUR PR               *
+*     YOUR PR MAY BE REJECTED IF IT DOES NOT FOLLOW THESE STEPS     *
+*********************************************************************
+
+- *DO NOT* submit PRs for v3 alpha enhancements, unless you have opened a post on the discord channel.
+  All enhancements must be discussed first.
+  The feedback guide for v3 is here: https://v3alpha.wails.io/getting-started/feedback/
+
+- Before submitting your PR, please ensure you have created and linked the PR to an issue.
+- If a relevant issue already exists, please reference it in your PR by including `Fixes #<issue number>` in your PR description.
+- Please fill in the checklists.
+
 -->
 
 # Description
@@ -14,7 +24,7 @@ Fixes # (issue)
 
 ## Type of change
 
-Please delete options that are not relevant.
+Please select the option that is relevant.
 
 - [ ] Bug fix (non-breaking change which fixes an issue)
 - [ ] New feature (non-breaking change which adds functionality)
@@ -28,6 +38,8 @@ Please describe the tests that you ran to verify your changes. Provide instructi
 - [ ] Windows
 - [ ] macOS
 - [ ] Linux
+
+If you checked Linux, please specify the distro and version.
 
 ## Test Configuration
 

.github/workflows/build-and-test-alpha.yml

@@ -2,36 +2,40 @@ name: Build + Test v3 alpha
 
 on:
   push:
-    branches: [v3-alpha]
+    branches: [v3-alpha, v3/*, v3-*]
     paths-ignore:
       - 'mkdocs-website/**/*'
   workflow_dispatch:
 
 jobs:
   test_go:
     name: Run Go Tests
-    if: github.repository == 'wailsapp/wails'
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
         os: [windows-latest, macos-latest, ubuntu-latest]
-        go-version: [1.21]
+        go-version: [1.22]
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install linux dependencies
+        uses: awalsh128/cache-apt-pkgs-action@latest
         if: matrix.os == 'ubuntu-latest'
-        run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev javascriptcoregtk-4.1-dev build-essential pkg-config
+        with:
+          packages: libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+          version: 1.0
 
       - name: Setup Go
-        uses: actions/setup-go@v3
+        uses: actions/setup-go@v5
         with:
           go-version: ${{ matrix.go-version }}
+          cache-dependency-path: "v3/go.sum"
 
       - name: Install Task
-        uses: arduino/setup-task@v1
+        uses: arduino/setup-task@v2
         with:
           version: 3.x
           repo-token: ${{ secrets.GITHUB_TOKEN }}
@@ -54,18 +58,17 @@ jobs:
 
   test_js:
     name: Run JS Tests
-    if: github.repository == 'wailsapp/wails'
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [20.x]
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 
@@ -82,7 +85,7 @@ jobs:
     needs: test_go
     runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
         template:
@@ -100,18 +103,19 @@ jobs:
             vanilla,
             vanilla-ts,
           ]
-        go-version: [1.21]
+        go-version: [1.23]
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup Go
-        uses: actions/setup-go@v3
+        uses: actions/setup-go@v5
         with:
           go-version: ${{ matrix.go-version }}
+          cache-dependency-path: "v3/go.sum"
 
       - name: Setup Golang caches
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: |
             ~/.cache/go-build
@@ -121,8 +125,11 @@ jobs:
             ${{ runner.os }}-golang-
 
       - name: Install linux dependencies
+        uses: awalsh128/cache-apt-pkgs-action@latest
         if: matrix.os == 'ubuntu-latest'
-        run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev javascriptcoregtk-4.1-dev build-essential pkg-config
+        with:
+          packages: libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+          version: 1.0
 
       - name: Build Wails3 CLI
         run: |

.github/workflows/build-and-test.yml

@@ -12,16 +12,24 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-11]
-        go-version: ['1.20']
+        os: [ubuntu-22.04, ubuntu-24.04, windows-latest, macos-latest, macos-11]
+        go-version: ['1.21']
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Install linux dependencies
-        if: matrix.os == 'ubuntu-latest'
-        run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+      - uses: awalsh128/cache-apt-pkgs-action@latest
+        if: matrix.os == 'ubuntu-22.04'
+        with:
+          packages: libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          version: 1.0
+
+      - uses: awalsh128/cache-apt-pkgs-action@latest
+        if: matrix.os == 'ubuntu-24.04'
+        with:
+          packages: libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+          version: 1.0
 
       - name: Setup Go
         uses: actions/setup-go@v4
@@ -37,17 +45,22 @@ jobs:
         run: go test -v ./...
 
       - name: Run tests (!mac)
-        if: matrix.os != 'macos-latest' && matrix.os != 'macos-11'
+        if: matrix.os != 'macos-latest' && matrix.os != 'macos-11' && matrix.os != 'ubuntu-24.04'
         working-directory: ./v2
         run: go test -v ./...
 
+      - name: Run tests (Ubuntu 24.04)
+        if: matrix.os == 'ubuntu-24.04'
+        working-directory: ./v2
+        run: go test -v -tags webkit2_41 ./...
+
   test_js:
     name: Run JS Tests
     if: github.repository == 'wailsapp/wails'
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [20.x]
 
     steps:
       - name: Checkout code
@@ -73,7 +86,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        os: [ubuntu-22.04, windows-latest, macos-latest, ubuntu-24.04, macos-11]
         template:
           [
             svelte,
@@ -90,7 +103,7 @@ jobs:
             vanilla-ts,
             plain,
           ]
-        go-version: ['1.20']
+        go-version: ['1.21']
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -107,14 +120,29 @@ jobs:
           go install
           wails -help
 
-      - name: Install linux dependencies
-        if: matrix.os == 'ubuntu-latest'
+      - name: Install linux dependencies ( 22.04 )
+        if: matrix.os == 'ubuntu-22.04'
         run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
 
-      - name: Generate template '${{ matrix.template }}'
+      - name: Install linux dependencies ( 24.04 )
+        if: matrix.os == 'ubuntu-24.04'
+        run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+
+      - name: Generate & Build template '${{ matrix.template }}'
+        if: matrix.os != 'ubuntu-24.04'
         run: |
           mkdir -p ./test-${{ matrix.template }}
           cd ./test-${{ matrix.template }}
           wails init -n ${{ matrix.template }} -t ${{ matrix.template }} -ci
           cd ${{ matrix.template }}
           wails build -v 2
+
+      - name: Generate & Build template '${{ matrix.template }}' (ubuntu-24.04)
+        if: matrix.os == 'ubuntu-24.04'
+        run: |
+          mkdir -p ./test-${{ matrix.template }}
+          cd ./test-${{ matrix.template }}
+          wails init -n ${{ matrix.template }} -t ${{ matrix.template }} -ci
+          cd ${{ matrix.template }}
+          wails build -v 2 -tags webkit2_41
+

.github/workflows/generate-sponsor-image.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Set Node
         uses: actions/setup-node@v2
         with:
-          node-version: 16.x
+          node-version: 20.x
 
       - name: Update Sponsors
         run: cd scripts/sponsors && chmod 755 ./generate-sponsor-image.sh && ./generate-sponsor-image.sh