Rename exp -> v3

Fix linting issues
Add README.md

.all-contributorsrc

@@ -1,7 +1,5 @@
 {
   "files": [
-    "README.md",
-    "README.zh-Hans.md",
     "website/src/pages/credits.mdx"
   ],
   "imageSize": 75,
@@ -657,7 +655,6 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/14013111?v=4",
       "profile": "https://github.com/GargantuaX",
       "contributions": [
-        "doc",
         "financial"
       ]
     },
@@ -1303,6 +1300,54 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "MyNameIsAres",
+      "name": "MyNameIsAres",
+      "avatar_url": "https://avatars.githubusercontent.com/u/32432637?v=4",
+      "profile": "https://github.com/MyNameIsAres",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "Maicarons2022",
+      "name": "Maicarons J",
+      "avatar_url": "https://avatars.githubusercontent.com/u/101958587?v=4",
+      "profile": "http://mai.car.ons",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "KiddoV",
+      "name": "kiddov",
+      "avatar_url": "https://avatars.githubusercontent.com/u/28552977?v=4",
+      "profile": "https://github.com/KiddoV",
+      "contributions": [
+        "doc",
+        "financial",
+        "test",
+        "ideas"
+      ]
+    },
+    {
+      "login": "Ilshidur",
+      "name": "Nicolas Coutin",
+      "avatar_url": "https://avatars.githubusercontent.com/u/6564012?v=4",
+      "profile": "https://nicolas-coutin.com/",
+      "contributions": [
+        "financial"
+      ]
+    },
+    {
+      "login": "ParvinEyvazov",
+      "name": "Parvin Eyvazov",
+      "avatar_url": "https://avatars.githubusercontent.com/u/32189770?v=4",
+      "profile": "https://github.com/ParvinEyvazov",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 8,

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,7 +1,7 @@
 name: Bug Report
 description: Create a report to help us improve
 # title: ""
-labels: ["bug"]
+labels: ["Bug"]
 
 body:
   - type: markdown
@@ -14,6 +14,10 @@ body:
         - Search the issue tracker using [this link](https://github.com/wailsapp/wails/issues?q=is%3Aissue+).
         - Search the [discussion forums](https://github.com/wailsapp/wails/discussions?discussions_q=type+your+issue+here).
         - Read the [Troubleshooting Guide](https://wails.io/docs/next/guides/troubleshooting).
+        - Create a [Minimal Reproducible Example](https://stackoverflow.com/help/minimal-reproducible-example) and link to it in the issue.
+        - If your issue is related to TypeScript generation, please open a ticket and create a PR with a failing test case.
+        TS tests can be found [here](https://github.com/wailsapp/wails/tree/master/v2/internal/binding/binding_test). Remember to add
+        your test to the `binding_test.go` file.
         - Try to fix it yourself. Keep a list of things you have done to fix the problem.   
 
         If after doing all the above, the problem remains, please continue with this ticket providing *all* the information requested.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: false
+blank_issues_enabled: true
 contact_links:
   - name: GitHub Community Discussions
     url: https://github.com/wailsapp/wails/discussions

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,40 @@
+name: Documentation
+description: Report an issue related to documentation.
+# title: ""
+labels: ["Documentation"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template is only used for documentation related requests, including:
+
+        - Log undocumented APIs
+        - Update link
+        - Documentation other than non-project code
+        - Add new language
+
+        If you followed the documentation but things don't work, take some time to consider if it's the documentation or the code that's wrong. In the latter, prefer using the "[Bug Report](https://github.com/wailsapp/wails/issues/new?assignees=&labels=bug&template=bug_report.yml)" template.
+
+  - type: checkboxes
+    attributes:
+      label: Have you read the Documentation Contribution Guidelines?
+      options:
+        - label: I have read the [Documentation Contribution Guidelines](https://wails.io/community-guide#ways-of-contributing).
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: A clear and concise description of what the issue is.
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Self-service
+      description: |
+        If you feel like you could contribute to this issue, please check the box below. This would tell us and other people looking for contributions that someone's working on it.
+        If you do check this box, please send a pull request within 7 days so we can still delegate this to someone else.
+      options:
+        - label: I'd be willing to address this documentation request myself.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,7 +1,7 @@
 name: Feature request
 description: Suggest an idea for this project
 # title: ""
-labels: ["enhancement"]
+labels: ["Enhancement"]
 
 body:
   - type: markdown

.github/stale.yml

@@ -10,7 +10,7 @@ exemptLabels:
   - inprogress
   - "Selected For Development"
 # Label to use when marking an issue as stale
-staleLabel: wontfix
+staleLabel: "Wont Fix"
 # Comment to post when marking an issue as stale. Set to `false` to disable
 markComment: >
   This issue has been automatically marked as stale because it has not had

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

@@ -0,0 +1,118 @@
+name: Build + Test
+
+on:
+  push:
+    branches: [release/*, master]
+  workflow_dispatch:
+
+jobs:
+  test_go:
+    name: Run Go Tests
+    if: github.repository == 'wailsapp/wails'
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        go-version: [1.18, 1.19]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - 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
+
+      - name: Setup Go
+        uses: actions/setup-go@v3
+        with:
+          go-version: ${{ matrix.go-version }}
+
+      - name: Run tests (mac)
+        if: matrix.os == 'macos-latest'
+        env:
+          CGO_LDFLAGS: -framework UniformTypeIdentifiers -mmacosx-version-min=10.13
+        working-directory: ./v2
+        run: go test -v ./...
+
+      - name: Run tests (!mac)
+        if: matrix.os != 'macos-latest'
+        working-directory: ./v2
+        run: go test -v ./...
+
+  test_js:
+    name: Run JS Tests
+    if: github.repository == 'wailsapp/wails'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [16.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install dependencies
+        run: npm install
+        working-directory: v2/internal/frontend/runtime
+
+      - name: Run tests
+        run: npm test
+        working-directory: v2/internal/frontend/runtime
+
+  test_templates:
+    name: Test Templates
+    needs: test_go
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: true
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        template:
+          [
+            svelte,
+            svelte-ts,
+            vue,
+            vue-ts,
+            react,
+            react-ts,
+            preact,
+            preact-ts,
+            lit,
+            lit-ts,
+            vanilla,
+            vanilla-ts,
+            plain,
+          ]
+        go-version: [1.18, 1.19]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Go
+        uses: actions/setup-go@v3
+        with:
+          go-version: ${{ matrix.go-version }}
+
+      - name: Build Wails CLI
+        run: |
+          cd ./v2/cmd/wails
+          go install
+          wails -help
+
+      - 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
+
+      - name: Generate template '${{ matrix.template }}'
+        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

.github/workflows/deploy-website-to-wails.top-mirror.yml

@@ -1,50 +0,0 @@
-name: Sync upstream branch and deploy mirror | 同步上游分支并部署镜像
-
-on:
-  schedule:
-    - cron: "0 8,20 * * *"
-  workflow_dispatch:
-
-jobs:
-  build-and-deploy:
-    name: Automatic deployment | 自动部署
-    runs-on: ubuntu-latest
-    if: github.repository == 'misitebao/wails'
-
-    steps:
-      - name: Checkout | 切换到部署分支
-        uses: actions/checkout@v2
-        with:
-          ref: "master"
-          submodules: true
-          fetch-depth: 0
-
-      - name: Setup Git | 设置Git
-        run: |
-          git config --local user.email "i@misitebao.com"
-          git config --local user.name "misitebao"
-
-      - name: Add remote upstream repository and sync | 添加远程上游仓库并同步
-        run: |
-          git remote add upstream https://github.com/wailsapp/wails
-          git pull -v --progress --no-rebase "upstream" master
-
-      - name: Push | 推送
-        uses: ad-m/github-push-action@master
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          branch: ${{ github.ref }}
-
-      - name: Build Site | 构建网站
-        run: |
-          cd website &&
-          npm install && npm run build
-
-      - name: Deploy to Server | 部署到服务器
-        uses: hengkx/ssh-deploy@v1.0.1
-        with:
-          HOST: ${{ secrets.DEPLOY_HOST }}
-          USERNAME: ${{ secrets.DEPLOY_HOST_USER }}
-          PASSWORD: ${{ secrets.DEPLOY_HOST_PASSWORD }}
-          SOURCE: "website/build"
-          TARGET: "/www/wwwroot/wails.top"

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

@@ -0,0 +1,35 @@
+name: Generate Sponsor Image
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 0 * * *"
+
+jobs:
+  update-sponsors:
+    name: Update Sponsors
+    runs-on: ubuntu-latest
+    if: github.repository == 'wailsapp/wails'
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16.x
+
+      - name: Update Sponsors
+        run: cd scripts/sponsors && chmod 755 ./generate-sponsor-image.sh && ./generate-sponsor-image.sh
+        env:
+          SPONSORKIT_GITHUB_TOKEN: ${{ secrets.SPONSORS_TOKEN }}
+          SPONSORKIT_GITHUB_LOGIN: wailsapp
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: "chore: update sponsors.svg"
+          add-paths: "website/static/img/sponsors.svg"
+          title: Update Sponsor Image
+          body: Generated new image
+          branch: update-sponsors
+          delete-branch: true

.github/workflows/label-sponsors.yml

@@ -0,0 +1,15 @@
+name: Label sponsors
+on:
+  pull_request:
+    types: [ opened ]
+  issues:
+    types: [ opened ]
+jobs:
+  build:
+    name: is-sponsor-label
+    if: github.repository == 'wailsapp/wails'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: JasonEtco/is-sponsor-label-action@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/latest-pre.yml

@@ -1,34 +0,0 @@
-name: latest pre-release
-on:
-  push:
-    branches:
-      - develop
-    tags:
-      - '**-pre**'
-jobs:
-
-  build:
-    name: Test Build Latest Pre-Release
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, windows-latest, macOS-latest]
-    steps:
-
-    - name: Set up Go 1.16
-      uses: actions/setup-go@v1
-      with:
-        go-version: 1.16
-      id: go
-
-    - name: Check out code into the Go module directory
-      uses: actions/checkout@v1
-
-    - name: Get dependencies
-      run: |
-        go get -v -d ./...
-    - name: Build
-      run: go build -v ./cmd/wails
-
-    - name: Test
-      run: ./wails version

.github/workflows/pr.yml

@@ -1,32 +1,61 @@
-name: pr
+name: PR Checks
+
 on:
   pull_request:
-    branches:
-    - develop
-jobs:
+  pull_request_review:
+    types: [submitted]
 
-  build:
-    name: Test Build PR
+jobs:
+  check_docs:
+    name: Check Docs
+    if: ${{github.repository == 'wailsapp/wails' && contains(github.head_ref,'feature/')}}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Verify Changed files
+        uses: tj-actions/verify-changed-files@v11.1
+        id: verify-changed-files
+        with:
+          files: |
+            website/**/*.mdx
+            website/**/*.md
+
+      - name: Run step only when files change.
+        if: steps.verify-changed-files.outputs.files_changed != 'true'
+        run: |
+          echo "::warning::Feature branch does not contain any changes to the website."
+
+  test_go:
+    name: Run Go Tests
     runs-on: ${{ matrix.os }}
+    if: github.event.review.state == 'approved'
     strategy:
       matrix:
-        os: [ubuntu-latest, windows-latest, macOS-latest]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        go-version: [1.18, 1.19]
+
     steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
 
-    - name: Set up Go 1.16
-      uses: actions/setup-go@v1
-      with:
-        go-version: 1.16
-      id: go
+      - 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
 
-    - name: Check out code into the Go module directory
-      uses: actions/checkout@v1
+      - name: Setup Go
+        uses: actions/setup-go@v3
+        with:
+          go-version: ${{ matrix.go-version }}
 
-    - name: Get dependencies
-      run: |
-        go get -v -d ./...
-    - name: Build
-      run: go build -v ./cmd/wails
+      - name: Run tests (mac)
+        if: matrix.os == 'macos-latest'
+        env:
+          CGO_LDFLAGS: -framework UniformTypeIdentifiers -mmacosx-version-min=10.13
+        working-directory: ./v2
+        run: go test -v ./...
 
-    - name: Test
-      run: ./wails version
+      - name: Run tests (!mac)
+        if: matrix.os != 'macos-latest'
+        working-directory: ./v2
+        run: go test -v ./...

.github/workflows/projects.yml

@@ -0,0 +1,17 @@
+name: Update Project
+
+on:
+  project_card:
+    types: [ moved ]
+
+jobs:
+  projectcardautolabel_job:
+    runs-on: ubuntu-latest
+    if: github.repository == 'wailsapp/wails'
+    steps:
+      - name: Run ProjectCard AutoLabel
+        id: runprojectcardautolabel
+        uses: Matticusau/projectcard-autolabel@v1.0.0
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          autolabel-config: '[{"column": "TODO", "add_labels":["TODO"], "remove_labels":["In Progress", "Ready For Testing"]},{"column":"In progress", "add_labels":["In Progress"], "remove_labels":["TODO", "Ready For Testing"]},{"column":"In review", "add_labels":["Ready For Testing"], "remove_labels":["TODO", "In Progress"]}, {"column":"Done", "add_labels":["Done"], "remove_labels":["TODO", "In Progress", "Ready For Testing"]}]'

.github/workflows/push.yml

@@ -0,0 +1,37 @@
+name: Push Checks
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  push_files_to_crowdin:
+    name: Push files to Crowdin
+    if: github.repository == 'wailsapp/wails'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Verify Changed files
+        uses: tj-actions/verify-changed-files@v11.1
+        id: verify-changed-files
+        with:
+          files: |
+            website/**/*.mdx
+            website/**/*.md
+            website/**/*.json
+
+      - name: Set node
+        if: steps.verify-changed-files.outputs.files_changed != 'true'
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16.x
+
+      - name: Push files
+        env:
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+        run: |
+          cd website
+          corepack enable
+          pnpm install
+          pnpm run crowdin push -b master

.github/workflows/release.yml

@@ -1,34 +0,0 @@
-name: release
-on:
-  push:
-    branches:
-    - master
-    tags:
-    - '!**pre**'
-jobs:
-
-  build:
-    name: Test Build Latest Release
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, windows-latest, macOS-latest]
-    steps:
-
-    - name: Set up Go 1.16
-      uses: actions/setup-go@v1
-      with:
-        go-version: 1.16
-      id: go
-
-    - name: Check out code into the Go module directory
-      uses: actions/checkout@v1
-
-    - name: Get dependencies
-      run: |
-        go get -v -d ./...
-    - name: Build
-      run: go build -v ./cmd/wails
-
-    - name: Test
-      run: ./wails version

.github/workflows/runtime.yml

@@ -10,7 +10,7 @@ jobs:
     name: Rebuild the runtime
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - uses: actions/setup-node@v2
         with:
           node-version: 14.17.6

.github/workflows/sync-translated-documents.yml

@@ -0,0 +1,31 @@
+name: Sync Translated Documents
+
+on:
+  workflow_dispatch:
+
+jobs:
+  sync-translated-documents:
+    runs-on: ubuntu-latest
+    if: github.repository == 'wailsapp/wails'
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set node
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16.x
+
+      - name: Sync Translated Documents
+        run: cd scripts && chmod 755 ./sync-translated-documents.sh && ./sync-translated-documents.sh
+        env:
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: "docs: sync documents"
+          title: "docs: sync documents"
+          body: "- [x] Sync translated documents"
+          branch: feature/documents
+          delete-branch: true
+          draft: true

.gitignore

@@ -27,8 +27,10 @@ v2/pkg/parser/testproject/frontend/wails
 v2/test/kitchensink/frontend/public
 v2/test/kitchensink/build/darwin/desktop/kitchensink
 v2/test/kitchensink/frontend/package.json.md5
-/v2/internal/ffenestri/windows/test/cmake-build-debug/
-!v2/internal/ffenestri/windows/x64/webview2.dll
-!v2/internal/ffenestri/windows/x64/WebView2Loader.dll
 .idea/
 v2/cmd/wails/internal/commands/initialise/templates/testtemplates/
+.env
+/website/static/img/.cache.json
+
+/v3/.task
+/v3/examples/build/bin/testapp

.vscode/launch.json

@@ -1,48 +0,0 @@
-{
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "name": "Test cmd package",
-      "type": "go",
-      "request": "launch",
-      "mode": "test",
-      "program": "${workspaceFolder}/cmd/"
-    },
-    {
-      "name": "Wails Init",
-      "type": "go",
-      "request": "launch",
-      "mode": "auto",
-      "program": "${workspaceFolder}/cmd/wails/main.go",
-      "env": {},
-      "cwd": "/tmp",
-      "args": [
-        "init",
-        "-name",
-        "runtime",
-        "-dir",
-        "runtime",
-        "-output",
-        "runtime",
-        "-template",
-        "vuebasic"
-      ]
-    },
-    {
-      "name": "Wails Update Pre",
-      "type": "go",
-      "request": "launch",
-      "mode": "auto",
-      "program": "${workspaceFolder}/cmd/wails/main.go",
-      "env": {},
-      "cwd": "/tmp",
-      "args": [
-        "update",
-        "-pre"
-      ]
-    }
-  ]
-}

.vscode/settings.json

@@ -1,8 +0,0 @@
-{
-  "go.formatTool": "goimports",
-  "eslint.alwaysShowStatus": true,
-  "files.associations": {
-    "__locale": "c",
-    "ios": "c"
-  }
-}