Develop merge

.github/actions/commitlint/action.yml

@@ -0,0 +1,7 @@
+name: Lint commit messages
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/checkout@v4
+    - uses: wagoid/commitlint-github-action@v5

.github/actions/deploy-gh-pages/action.yml

@@ -0,0 +1,20 @@
+name: Deploy to Github Pages
+
+inputs:
+  publish_dir:
+    description: A source directory to deploy to GitHub Pages.
+    required: false
+  destination_dir:
+    description: A destination subdirectory on a publishing branch.
+    required: false
+
+runs:
+  using: composite    
+  steps:
+    uses: actions/checkout@v4
+    uses: peaceiris/actions-gh-pages@v4
+    with:
+      github_token: ${{ secrets.GITHUB_TOKEN }}
+      publish_dir: ${{ inputs.publish_dir }}
+      destination_dir: ${{ inputs.destination_dir }}
+      full_commit_message: "Build for ${{ github.sha }} ${{ github.event.head_commit.message }}"

.github/actions/publish-package/action.yml

@@ -0,0 +1,52 @@
+name: Publish package to npm
+
+inputs:
+  working_dir:
+    description: A source directory to deploy to GitHub Pages.
+    required: true
+
+runs:
+  defaults:
+    run:
+      working-directory: ${{ inputs.working_dir }}
+  using: composite    
+  steps:
+    uses: actions/checkout@v4
+    uses: actions/setup-node@v4
+    run: npm ci
+    run: npm test
+
+    run: |
+      git config --global user.name 'GitHub Actions'
+      git config --global user.email 'github-actions@localhost'
+
+    # Update the version in the package files
+    run: |
+      GIT_TAG="${{github.event.release.tag_name}}"
+      NEW_VERSION="${GIT_TAG/v/}"
+
+      npm version "$NEW_VERSION" --allow-same-version --git-tag-version=false
+      git add package* && git commit -m "Release $NEW_VERSION"
+
+    run: npm publish --access=public
+    env:
+      NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+
+    run: git show
+    run: |
+      git fetch origin master
+
+      TAG_NAME="${{github.event.release.tag_name}}"
+      LAST_COMMIT_ID="$(git rev-parse $TAG_NAME)"
+      MASTER_COMMIT_ID="$(git rev-parse origin/master)"
+
+      if [ "$LAST_COMMIT_ID" = "$MASTER_COMMIT_ID" ]; then
+        git push origin HEAD:master
+      else
+        echo "Not pushing to master because the tag we're operating on is behind"
+      fi
+
+    # See https://stackoverflow.com/a/24849501
+    run: |
+      git tag -f "${{github.event.release.tag_name}}" HEAD
+      git push -f origin "refs/tags/${{github.event.release.tag_name}}"

.github/workflows/ci-cd.yml

@@ -0,0 +1,80 @@
+name: CI/CD
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: "${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  changes:
+    name: Detect affected workspaces
+    runs-on: ubuntu-latest
+    outputs:
+      scratch-svg-renderer: ${{ steps.filter.outputs.scratch-svg-renderer }}
+      scratch-render: ${{ steps.filter.outputs.scratch-render }}
+      scratch-vm: ${{ steps.filter.outputs.scratch-vm }}
+      scratch-gui: ${{ steps.filter.outputs.scratch-gui }}
+    steps:
+      - uses: actions/checkout@v4 # TODO: skip this for PRs
+      - uses: dorny/paths-filter@v2
+        id: filter
+        with:
+          filters: |
+            any-workspace:
+              - ".github/workflows/workspace-*.yml"
+              - "workspaces/**"
+            scratch-svg-renderer:
+              - ".github/workflows/workspace-scratch-svg-renderer.yml"
+              - "workspaces/scratch-svg-renderer/**"
+            scratch-render:
+              - ".github/workflows/workspace-scratch-render.yml"
+              - "workspaces/scratch-render/**"
+              - "workspaces/scratch-svg-renderer/**"
+            scratch-vm:
+              - ".github/workflows/workspace-scratch-vm.yml"
+              - "workspaces/scratch-render/**"
+              - "workspaces/scratch-svg-renderer/**"
+              - "workspaces/scratch-vm/**"
+            scratch-gui:
+              - ".github/workflows/workspace-scratch-gui.yml"
+              - "workspaces/scratch-gui/**"
+              - "workspaces/scratch-render/**"
+              - "workspaces/scratch-svg-renderer/**"
+              - "workspaces/scratch-vm/**"
+      - if: ${{ steps.filter.outputs.any-workspace == 'true' }}
+        uses: actions/setup-node@v4
+        with:
+          cache: npm
+          node-version-file: .nvmrc
+      - if: ${{ steps.filter.outputs.any-workspace == 'true' }}
+        uses: ./.github/actions/install-dependencies
+  scratch-svg-renderer:
+    uses: ./.github/workflows/workspace-scratch-svg-renderer.yml
+    if: ${{ !failure() && !cancelled() && needs.changes.outputs.scratch-svg-renderer == 'true' }}
+    needs:
+      - changes
+  scratch-render:
+    uses: ./.github/workflows/workspace-scratch-render.yml
+    if: ${{ !failure() && !cancelled() && needs.changes.outputs.scratch-render == 'true' }}
+    needs:
+      - changes
+      - scratch-svg-renderer
+  scratch-vm:
+    uses: ./.github/workflows/workspace-scratch-vm.yml
+    if: ${{ !failure() && !cancelled() && needs.changes.outputs.scratch-vm == 'true' }}
+    needs:
+      - changes
+      - scratch-render
+      - scratch-svg-renderer
+  scratch-gui:
+    uses: ./.github/workflows/workspace-scratch-gui.yml
+    if: ${{ !failure() && !cancelled() && needs.changes.outputs.scratch-gui == 'true' }}
+    needs:
+      - changes
+      - scratch-render
+      - scratch-svg-renderer
+      - scratch-vm

.github/workflows/daily-tx-pull.yml

@@ -0,0 +1,40 @@
+name: Daily Traslation Update
+on:
+  workflow_dispatch: # Allows you to run this workflow manually from the Actions tab
+  schedule:
+    - cron: 0 0 * * * # daily at midnight UTC = 7-8pm US Eastern
+concurrency:
+  group: '${{ github.workflow }}'
+  cancel-in-progress: true
+permissions:
+  contents: write
+jobs:
+  daily-tx-pull:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: "./workspaces/scratch-gui"
+    steps:
+      - uses: actions/checkout@v4
+        with:
+            ref: 'develop'
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Info
+        run: |
+          cat <<EOF
+          Node version: $(node --version)
+          NPM version: $(npm --version)
+          GitHub ref: ${{ github.ref }}
+          GitHub head ref: ${{ github.head_ref }}
+          EOF
+      - name: Setup
+        run: npm --production=false ci
+      - name: Extract translations
+        run: npm run i18n:src
+      - name: Push translations
+        env:
+          TX_TOKEN: ${{ secrets.TX_TOKEN }}
+        run: npm run i18n:push

.github/workflows/publish.yml

@@ -0,0 +1,64 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  scratch-svg-renderer:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Publish package to npm
+        use: "./.github/actions/publish-package"
+        with:
+          working-directory: "./workspaces/scratch-svg-renderer"
+  scratch-render:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Publish package to npm
+        use: "./.github/actions/publish-package"
+        with:
+          working-directory: "./workspaces/scratch-render"
+      - needs:
+        - scratch-svg-renderer
+  scratch-vm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Publish package to npm
+        use: "./.github/actions/publish-package"
+        with:
+          working-directory: "./workspaces/vm"
+      - needs:
+        - scratch-svg-renderer
+        - scratch-render
+  scratch-gui:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Publish package to npm
+        use: "./.github/actions/publish-package"
+        with:
+          working-directory: "./workspaces/gui"
+      - needs:
+        - scratch-svg-renderer
+        - scratch-render
+        - scratch-gui

.github/workflows/update-i18n.yml

@@ -0,0 +1,42 @@
+name: Update i18n
+
+on:
+  workflow_dispatch: # Allows you to run this workflow manually from the Actions tab
+  schedule:
+    - cron: 0 0 * * * # daily at midnight UTC = 7-8pm US Eastern
+
+concurrency:
+  group: '${{ github.workflow }}'
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  update-i18n:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: "./workspaces/scratch-vm"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Info
+        run: |
+          cat <<EOF
+          Node version: $(node --version)
+          NPM version: $(npm --version)
+          GitHub ref: ${{ github.ref }}
+          GitHub head ref: ${{ github.head_ref }}
+          EOF
+      - name: Setup
+        run: npm ci
+      - name: Extract translations
+        run: npm run i18n:src
+      - name: Push translations
+        env:
+          TX_TOKEN: ${{ secrets.TX_TOKEN }}
+        run: npm run i18n:push

.github/workflows/workspace-scratch-gui.yml

@@ -0,0 +1,70 @@
+name: "Workspace: scratch-gui"
+
+on:
+  workflow_call:
+  workflow_dispatch:
+
+concurrency:
+  group: 'scratch-gui @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}'
+
+permissions:
+  contents: write # publish a GitHub release
+  pages: write # deploy to GitHub Pages
+  issues: write # comment on released issues
+  pull-requests: write # comment on released pull requests
+
+jobs:
+  ci-cd:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: "./workspaces/scratch-gui"
+    environment: >-
+      ${{
+        (
+          (
+            (github.ref == 'refs/heads/main') ||
+            (github.ref == 'refs/heads/master')
+          ) && 'production'
+        ) ||
+        (
+          (
+            (github.ref == 'refs/heads/beta') ||
+            (github.ref == 'refs/heads/develop') ||
+            startsWith(github.ref, 'refs/heads/hotfix/') ||
+            startsWith(github.ref, 'refs/heads/release/')
+          ) && 'staging'
+        ) ||
+        ''
+      }}
+    env:
+      SCRATCH_SHOULD_DEPLOY: ${{ vars.SCRATCH_ENV != '' }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Debug info
+        run: |
+          cat <<EOF
+          Scratch environment: ${{ vars.SCRATCH_ENV || '<none>' }}
+          Node version: $(node --version)
+          NPM version: $(npm --version)
+          GitHub ref: ${{ github.ref }}
+          GitHub head ref: ${{ github.head_ref }}
+          Working directory: $(pwd)
+          EOF
+      - uses: ./.github/actions/install-dependencies
+      - name: Commitlint
+        use: "./.github/actions/commitlint"
+      - name: Build
+        run: npm run build
+      - name: Test
+        run: npm run test
+      - name: Deploy to GH Pages
+        if: ${{ env.SCRATCH_SHOULD_DEPLOY == 'true' }}
+        use: "./.github/actions/deploy-gh-pages"
+        with:
+          publish_dir: "./build"
+          destination_dir: "scratch-gui"