perf(P9): extend LOW presentation caps and cache native UI quads

.github/workflows/api3-contract.yml

@@ -0,0 +1,60 @@
+name: API 3 contracts
+on:
+  pull_request:
+    paths:
+      - '.github/workflows/api3-contract.yml'
+      - 'src/**'
+      - 'tests/api3_contract/**'
+      - 'tests/engine/api3_*.lua'
+      - 'tools/api3-contract-check/**'
+  push:
+    branches: [main, dev]
+    paths:
+      - '.github/workflows/api3-contract.yml'
+      - 'src/**'
+      - 'tests/api3_contract/**'
+      - 'tests/engine/api3_*.lua'
+      - 'tools/api3-contract-check/**'
+permissions:
+  contents: read
+concurrency:
+  group: api3-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  compare:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        reference: [79ea62f45fb2ea8f65d081a109431e4eb1bbdb36, 535a5ec088c1ae1bf4d91dd3e35a56f64cf46d91]
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          path: gen2
+          sparse-checkout: |
+            src
+            data
+            tests
+            tools/api3-contract-check
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: ${{ matrix.reference }}
+          path: gen1-reference
+          sparse-checkout: |
+            src
+            data
+            tests
+            assets/fonts
+      - name: install LuaJIT
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: identical mod contracts on both engines
+        run: >-
+          python3 gen2/tools/api3-contract-check/check.py
+          --gen1 gen1-reference --gen2 gen2
+          --report "${{ runner.temp }}/api3-report.json"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: api3-contract-report-${{ matrix.reference }}
+          path: ${{ runner.temp }}/api3-report.json
+          if-no-files-found: error

.github/workflows/async-get.yml

@@ -0,0 +1,38 @@
+name: Async mod HTTP and file downloads
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  transport:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.x'
+      - if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y love
+      - name: Exercise real worker requests against a local server
+        shell: python
+        run: |
+          import os, pathlib, shutil, subprocess, urllib.request, zipfile
+          host = os.environ['RUNNER_OS']
+          if host == 'Linux':
+              executable = shutil.which('love')
+          else:
+              suffix = 'macos' if host == 'macOS' else 'win64'
+              target = pathlib.Path(os.environ['RUNNER_TEMP']) / 'love-get-check'
+              target.mkdir()
+              archive = target / 'runtime.zip'
+              urllib.request.urlretrieve(f'https://github.com/love2d/love/releases/download/11.5/love-11.5-{suffix}.zip', archive)
+              with zipfile.ZipFile(archive) as z: z.extractall(target)
+              executable = next(target.rglob('love.app/Contents/MacOS/love')) if host == 'macOS' else next(target.rglob('lovec.exe'))
+              if host == 'macOS': executable.chmod(0o755)
+          subprocess.run(['python', 'tools/check_async_get.py', '--love', str(executable), '--tls'], check=True)

.github/workflows/battle-auxiliary-contract.yml

@@ -0,0 +1,50 @@
+name: portable battle.menu_auxiliary contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: battle-auxiliary-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check native auxiliary battle dispatch and SDK contracts
+        run: |
+          luajit tests/engine/battle_auxiliary.lua
+          luajit tests/engine/trainer_preparation.lua
+          luajit tests/engine/trainer_preparation_native.lua
+          luajit tests/engine/trainer_party_scope.lua
+      - name: Validate pinned native Gen1 auxiliary battle contracts
+        working-directory: .contract-reference/gen1
+        run: |
+          luajit tests/modkit/cases/unified_gen2_hooks.lua
+          luajit tests/modkit/cases/unified_gen3_hooks.lua
+      - name: Compare both engines in every SDK mode
+        run: |
+          mkdir -p /tmp/battle-auxiliary-contract
+          python3 tools/battle-auxiliary-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 1 --report /tmp/battle-auxiliary-contract/api1-native.json
+          python3 tools/battle-auxiliary-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/battle-auxiliary-contract/api2-native.json
+          python3 tools/battle-auxiliary-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/battle-auxiliary-contract/api2-unified.json
+          python3 tools/battle-auxiliary-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/battle-auxiliary-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: battle-auxiliary-contract
+          path: /tmp/battle-auxiliary-contract
+          if-no-files-found: ignore

.github/workflows/battle-bottom-ui-contract.yml

@@ -0,0 +1,49 @@
+name: portable battle.bottom_ui_visible contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: battle-bottom-ui-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check bottom UI, inherited overlays and native battle composition
+        run: |
+          luajit tests/engine/battle_bottom_ui.lua
+          luajit tests/engine/battle_bottom_ui_routing.lua
+          luajit tests/engine/battle_bottom_ui_composition.lua
+      - name: Validate pinned native Gen1 GBA battle UI
+        working-directory: .contract-reference/gen1
+        run: luajit tests/modkit/cases/unified_gen3_battle_hooks.lua
+      - name: Compare native API 1 and 2
+        run: |
+          mkdir -p /tmp/battle-bottom-ui-contract
+          python3 tools/battle-bottom-ui-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 1 --report /tmp/battle-bottom-ui-contract/api1-native.json
+          python3 tools/battle-bottom-ui-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/battle-bottom-ui-contract/api2-native.json
+      - name: Compare unified callbacks and API 3
+        run: |
+          python3 tools/battle-bottom-ui-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/battle-bottom-ui-contract/api2-unified.json
+          python3 tools/battle-bottom-ui-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/battle-bottom-ui-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: battle-bottom-ui-contract
+          path: /tmp/battle-bottom-ui-contract
+          if-no-files-found: ignore

.github/workflows/battle-grid-contract.yml

@@ -0,0 +1,51 @@
+name: portable battle.move_grid_navigation contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: battle-grid-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check native move navigation dispatch and SDK contracts
+        run: |
+          luajit tests/engine/battle_grid_navigation.lua
+          luajit tests/engine/battle_auxiliary.lua
+          luajit tests/engine/trainer_preparation.lua
+          luajit tests/engine/trainer_preparation_native.lua
+          luajit tests/engine/trainer_party_scope.lua
+      - name: Validate pinned native Gen1 move navigation contracts
+        working-directory: .contract-reference/gen1
+        run: |
+          luajit tests/modkit/cases/unified_gen2_hooks.lua
+          luajit tests/modkit/cases/unified_gen3_hooks.lua
+      - name: Compare both engines in every SDK mode
+        run: |
+          mkdir -p /tmp/battle-grid-contract
+          python3 tools/battle-grid-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 1 --report /tmp/battle-grid-contract/api1-native.json
+          python3 tools/battle-grid-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/battle-grid-contract/api2-native.json
+          python3 tools/battle-grid-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/battle-grid-contract/api2-unified.json
+          python3 tools/battle-grid-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/battle-grid-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: battle-grid-contract
+          path: /tmp/battle-grid-contract
+          if-no-files-found: ignore

.github/workflows/core-update-contract.yml

@@ -0,0 +1,43 @@
+name: portable core.update contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: core-update-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check frame dispatch and native host routing
+        run: |
+          luajit tests/engine/core_update.lua
+          luajit tests/engine/core_update_routing.lua
+      - name: Compare both native engines through the same mod
+        run: |
+          mkdir -p /tmp/core-update-contract
+          python3 tools/core-update-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/core-update-contract/api2-native.json
+      - name: Check unified callback and API-3 integration
+        run: |
+          python3 tools/core-update-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/core-update-contract/api2-unified.json
+          python3 tools/core-update-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/core-update-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: core-update-contract
+          path: /tmp/core-update-contract
+          if-no-files-found: ignore

.github/workflows/follower-contract.yml

@@ -0,0 +1,45 @@
+name: portable follower predicate contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: follower-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check native followers and compatibility
+        run: |
+          luajit tests/engine/follower_spawn.lua
+          luajit tests/engine/gen2_follower_predicate.lua
+          luajit tests/engine/api3_compat.lua
+          luajit tests/engine/unified_mod_callbacks.lua
+      - name: Compare both engines in every SDK mode
+        run: |
+          mkdir -p /tmp/follower-contract
+          python3 tools/follower-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 1 --format native --report /tmp/follower-contract/api1-native.json
+          python3 tools/follower-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 2 --format native --report /tmp/follower-contract/api2-native.json
+          python3 tools/follower-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 2 --format unified --report /tmp/follower-contract/api2-unified.json
+          python3 tools/follower-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/follower-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: follower-contract
+          path: /tmp/follower-contract
+          if-no-files-found: ignore

.github/workflows/input-hook-contract.yml

@@ -0,0 +1,43 @@
+name: portable input hook contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: input-hook-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check native input and host routing
+        run: |
+          luajit tests/engine/portable_input_hooks.lua
+          luajit tests/engine/portable_input_routing.lua
+      - name: Compare both native engines through the same mod
+        run: |
+          mkdir -p /tmp/input-hook-contract
+          python3 tools/input-hook-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/input-hook-contract/api2-native.json
+      - name: Check unified callback and API-3 integration
+        run: |
+          python3 tools/input-hook-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/input-hook-contract/api2-unified.json
+          python3 tools/input-hook-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/input-hook-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: input-hook-contract
+          path: /tmp/input-hook-contract
+          if-no-files-found: ignore