Update

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: [isaac-udy]
+# patreon: # Replace with a single Patreon username
+# open_collective: # Replace with a single Open Collective username
+# ko_fi: # Replace with a single Ko-fi username
+# tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+# community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+# liberapay: # Replace with a single Liberapay username
+# issuehunt: # Replace with a single IssueHunt username
+# lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+# polar: # Replace with a single Polar username
+# buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+# thanks_dev: # Replace with a single thanks.dev username
+# custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/workflows/ci.yml

@@ -1,45 +1,85 @@
 name: CI
 on:
   push:
+    paths-ignore:
+      - '**.md'
     branches:
       - main
   pull_request:
     branches:
       - main
+  workflow_dispatch:
+
+# Superseded PR runs are wasted compute: when a new push lands on a PR, cancel
+# the in-flight run for the previous commit. Pushes to main are never
+# cancelled — every main commit keeps its complete CI record for bisecting.
+concurrency:
+  group: ci-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
 jobs:
-  run-ui-tests:
-    name: Run Tests
-    runs-on: macOS-latest
+  ci-linux:
+    name: CI / Linux (Android, Desktop, wasmJs)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Changes
+        uses: dorny/paths-filter@v3
+        id: changes
+        with:
+          filters: |
+            isCodeChange:
+              - '**/*.kt'
+              - '**/*.kts'
+              - '**/*.toml'
+
+      - name: Set up JDK 21
+        if: steps.changes.outputs.isCodeChange == 'true'
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: 21
+
+      - name: Setup gradle
+        if: steps.changes.outputs.isCodeChange == 'true'
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Run continuous integration
+        if: steps.changes.outputs.isCodeChange == 'true'
+        env:
+          EW_API_TOKEN: ${{ secrets.EW_API_TOKEN }}
+        run: ./gradlew continuousIntegration --continue
+
+  ci-macos:
+    name: CI / macOS (iOS)
+    runs-on: macos-latest
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-
-    - name: Set up JDK 11
-      uses: actions/setup-java@v2.5.0
-      with:
-        distribution: 'zulu'
-        java-version: 11
-
-    - name: Run Enro UI Tests
-      uses: reactivecircus/android-emulator-runner@v2
-      with:
-        api-level: 29
-        script: ./gradlew :enro:connectedCheck
-
-    - name: Run Enro UI Tests (Hilt)
-      uses: reactivecircus/android-emulator-runner@v2
-      with:
-        api-level: 29
-        script: ./gradlew :enro:hilt-test:connectedCheck
-
-    - name: Run Enro Unit Tests
-      uses: reactivecircus/android-emulator-runner@v2
-      with:
-        api-level: 29
-        script: ./gradlew :enro:testDebugUnitTest
-
-    - name: Run Modularised Example Tests
-      uses: reactivecircus/android-emulator-runner@v2
-      with:
-        api-level: 29
-        script: ./gradlew :modularised-example:app:testDebugUnitTest
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Changes
+        uses: dorny/paths-filter@v3
+        id: changes
+        with:
+          filters: |
+            isCodeChange:
+              - '**/*.kt'
+              - '**/*.kts'
+              - '**/*.toml'
+
+      - name: Set up JDK 21
+        if: steps.changes.outputs.isCodeChange == 'true'
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: 21
+
+      - name: Setup gradle
+        if: steps.changes.outputs.isCodeChange == 'true'
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Run continuous integration (macOS)
+        if: steps.changes.outputs.isCodeChange == 'true'
+        run: ./gradlew continuousIntegrationMacOs --continue

.github/workflows/deploy-docs.yml

@@ -0,0 +1,65 @@
+name: Deploy docs to gh-pages
+
+# Manual deploy of docs/ghpages/ from main to the gh-pages branch.
+#
+# What it does:
+#   1. Check out main.
+#   2. Check out gh-pages alongside, as a git worktree.
+#   3. On gh-pages: delete index.md, assets/, and docs/ at the root.
+#      (Anything else on gh-pages — CNAME, _config.yml, .nojekyll, etc. —
+#      is preserved.)
+#   4. Copy main's docs/ghpages/{index.md, assets, docs} into the gh-pages
+#      worktree's root.
+#   5. Commit and push if anything changed.
+#
+# Trigger this from the Actions tab → "Deploy docs to gh-pages" → Run
+# workflow.
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    name: Deploy docs/ghpages to the gh-pages branch
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Add gh-pages as a worktree
+        run: |
+          git fetch origin gh-pages
+          git worktree add gh-pages-deploy gh-pages
+
+      - name: Replace docs content on gh-pages
+        run: |
+          cd gh-pages-deploy
+          # Remove only the three paths we manage. Other files on
+          # gh-pages (CNAME, _config.yml, .nojekyll, etc.) are preserved.
+          rm -f index.md
+          rm -rf assets docs
+          # Copy main's docs/ghpages/* into the worktree root. The
+          # `./.` syntax includes hidden files alongside the regular
+          # ones.
+          cp -r ../docs/ghpages/. .
+
+      - name: Commit and push
+        working-directory: gh-pages-deploy
+        run: |
+          git add -A index.md assets docs
+          if git diff --cached --quiet; then
+            echo "No changes to deploy."
+            exit 0
+          fi
+          git commit -m "Deploy docs from main (${GITHUB_SHA::7})"
+          git push origin gh-pages

.github/workflows/release.yml

@@ -6,47 +6,26 @@ on:
         description: 'Version Name'
         required: true
         default: ''
-      changes:
-        description: 'Release notes'
-        required: true
-        default: ''
 jobs:
   release:
     name: Release
     runs-on: macos-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
-
-      - name: Set up JDK 11
-        uses: actions/setup-java@v2.5.0
-        with:
-          distribution: 'zulu'
-          java-version: 11
-
-      - name: Run Enro UI Tests
-        uses: reactivecircus/android-emulator-runner@v2
+        uses: actions/checkout@v4
         with:
-          api-level: 29
-          script: ./gradlew :enro:connectedCheck
+          # add-and-commit pushes the release commit using the checkout
+          # credentials, so check out with the publish token.
+          token: ${{ secrets.PUBLISH_GITHUB_TOKEN }}
 
-      - name: Run Enro UI Tests (Hilt)
-        uses: reactivecircus/android-emulator-runner@v2
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
         with:
-          api-level: 29
-          script: ./gradlew :enro:hilt-test:connectedCheck
-
-      - name: Run Enro Unit Tests
-        uses: reactivecircus/android-emulator-runner@v2
-        with:
-          api-level: 29
-          script: ./gradlew :enro:testDebugUnitTest
+          distribution: 'zulu'
+          java-version: 21
 
-      - name: Run Modularised Example Tests
-        uses: reactivecircus/android-emulator-runner@v2
-        with:
-          api-level: 29
-          script: ./gradlew :modularised-example:app:testDebugUnitTest
+      - name: Setup gradle
+        uses: gradle/actions/setup-gradle@v4
 
       - name: Install gpg secret key
         run: cat <(echo -e "${{ secrets.PUBLISH_SIGNING_KEY_LITERAL }}") | gpg --batch --import
@@ -57,8 +36,13 @@ jobs:
       - name: Export gpg secret key
         run: sudo gpg --export-secret-keys --pinentry-mode loopback --passphrase=${{ secrets.PUBLISH_SIGNING_KEY_PASSWORD }} ${{ secrets.PUBLISH_SIGNING_KEY_ID }} > ${{ secrets.PUBLISH_SIGNING_KEY_LOCATION }}
 
-      - name: Update Version Name
-        run: ./gradlew updateVersion -PversionName=${{ github.event.inputs.versionname }}
+      # Stamps version.properties AND the changelog: the standing
+      # "## Unreleased" section becomes "## <version> (<date>)", a fresh empty
+      # "## Unreleased" is inserted above it, and the released section's body
+      # is written to build/release-notes.md for the Create Release step.
+      # Fails (before writing anything) if the Unreleased section is empty.
+      - name: Update Version Name + Changelog
+        run: ./gradlew updateVersion -PversionName=${{ inputs.versionname }}
 
       - name: Publish Release
         env:
@@ -69,24 +53,18 @@ jobs:
           PUBLISH_SIGNING_KEY_ID: ${{ secrets.PUBLISH_SIGNING_KEY_ID }}
           PUBLISH_SIGNING_KEY_PASSWORD: ${{ secrets.PUBLISH_SIGNING_KEY_PASSWORD }}
           PUBLISH_SIGNING_KEY_LOCATION: ${{ secrets.PUBLISH_SIGNING_KEY_LOCATION }}
-        run: ./gradlew publishAllPublicationsToSonatypeRepository --no-parallel # publishAllPublicationsToGitHubPackagesRepository
+        run: ./gradlew publishAllPublicationsToMavenCentralRepository -PmavenCentralUsername="${{ secrets.PUBLISH_SONATYPE_USER }}" -PmavenCentralPassword="${{ secrets.PUBLISH_SONATYPE_PASSWORD }}" --no-parallel --stacktrace --continue --exclude-task :enro-common:publishJsPublicationToMavenCentralRepository
 
       - name: Update Repo
-        uses: EndBug/add-and-commit@v5
-        env:
-          GITHUB_TOKEN: ${{ secrets.PUBLISH_GITHUB_TOKEN }}
+        uses: EndBug/add-and-commit@v9
         with:
-          add: "./version.properties"
-          message: ${{ format('Released {0}', github.event.inputs.versionname) }}
+          add: |
+            version.properties
+            CHANGELOG.md
+          message: ${{ format('Released {0}', inputs.versionname) }}
           push: true
 
       - name: Create Release
-        uses: actions/create-release@v1
         env:
-          GITHUB_TOKEN: ${{ secrets.PUBLISH_GITHUB_TOKEN }}
-        with:
-          tag_name: ${{ github.event.inputs.versionname }}
-          release_name: Release ${{ github.event.inputs.versionname }}
-          body: ${{  github.event.inputs.changes }}
-          draft: false
-          prerelease: false
+          GH_TOKEN: ${{ secrets.PUBLISH_GITHUB_TOKEN }}
+        run: gh release create "${{ inputs.versionname }}" --title "Release ${{ inputs.versionname }}" --notes-file build/release-notes.md

.gitignore

@@ -1,3 +1,4 @@
+.DS_Store
 # Built application files
 *.apk
 *.aar
@@ -74,3 +75,26 @@ lint/outputs/
 lint/tmp/
 # lint/reports/
 private.properties
+/.kotlin/
+
+/.codebuddy/
+
+### Xcode ###
+*.xcodeproj/*
+!*.xcodeproj/project.pbxproj
+!*.xcodeproj/xcshareddata/
+!*.xcworkspace/contents.xcworkspacedata/
+/*.gcno
+**/xcshareddata/WorkspaceSettings.xcsettings
+**/*.xcuserstate
+*.xcscheme
+*.xcworkspace
+xcuserdata/
+
+# CocoaPods
+Pods/
+
+## iOS App packaging
+*.ipa
+*.dSYM.zip
+*.dSYM

.run/Enro [_enro-core_desktopTest].run.xml

@@ -0,0 +1,26 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Enro [:enro-runtime:desktopTest]" type="GradleRunConfiguration" factoryName="Gradle">
+    <ExternalSystemSettings>
+      <option name="executionName" />
+      <option name="externalProjectPath" value="$PROJECT_DIR$" />
+      <option name="externalSystemIdString" value="GRADLE" />
+      <option name="scriptParameters" value="" />
+      <option name="taskDescriptions">
+        <list />
+      </option>
+      <option name="taskNames">
+        <list>
+          <option value=":enro-runtime:cleanDesktopTest" />
+          <option value=":enro-runtime:desktopTest" />
+          <option value="--rerun" />
+        </list>
+      </option>
+      <option name="vmOptions" />
+    </ExternalSystemSettings>
+    <ExternalSystemDebugServerProcess>true</ExternalSystemDebugServerProcess>
+    <ExternalSystemReattachDebugProcess>true</ExternalSystemReattachDebugProcess>
+    <DebugAllEnabled>false</DebugAllEnabled>
+    <RunAsTest>false</RunAsTest>
+    <method v="2" />
+  </configuration>
+</component>