Full shaders

.claude/skills/game-control/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: game-control
+description: Control a running Tiny game engine via HTTP. Send key presses, releases, and taps to interact with the game. Use when the user asks to play, control, test, or interact with a running game.
+allowed-tools: Bash(curl:*), Bash(sleep:*), Read, mcp__playwright__browser_take_screenshot, mcp__playwright__browser_navigate, mcp__playwright__browser_snapshot
+argument-hint: [action] [key or instructions]
+---
+
+# Game Control Skill
+
+You can control a running Tiny game engine by sending HTTP requests to the debug server.
+
+## Server
+
+The game debug server runs on `http://localhost:8081` by default (started with `tiny-cli run`).
+
+## Available Endpoints
+
+### List available keys
+```bash
+curl -s http://localhost:8081/control/keys
+```
+
+### Press a key (stays pressed until released)
+```bash
+curl -s -X POST "http://localhost:8081/control/press?key=KEY_NAME"
+```
+
+### Release a key
+```bash
+curl -s -X POST "http://localhost:8081/control/release?key=KEY_NAME"
+```
+
+### Tap a key (press + auto-release after ~50ms)
+```bash
+curl -s -X POST "http://localhost:8081/control/tap?key=KEY_NAME"
+```
+
+## Available Keys
+
+Direction: `ARROW_LEFT`, `ARROW_RIGHT`, `ARROW_UP`, `ARROW_DOWN`
+Action: `SPACE`, `ENTER`, `ESCAPE`, `TAB`, `BACKSPACE`, `DELETE`
+Letters: `A` through `Z`
+Numbers: `NUM0` through `NUM9`
+Modifiers: `SHIFT`, `CTRL`, `ALT`
+Function: `F1` through `F12`
+
+## Usage Patterns
+
+### Tap a key once (one-shot action like jump or shoot)
+```bash
+curl -s -X POST "http://localhost:8081/control/tap?key=SPACE"
+```
+
+### Hold a key for sustained movement
+```bash
+# Hold right for 500ms then release
+curl -s -X POST "http://localhost:8081/control/press?key=ARROW_RIGHT"
+sleep 0.5
+curl -s -X POST "http://localhost:8081/control/release?key=ARROW_RIGHT"
+```
+
+### Multiple rapid taps
+```bash
+for i in $(seq 1 5); do
+  curl -s -X POST "http://localhost:8081/control/tap?key=SPACE"
+  sleep 0.1
+done
+```
+
+### Simultaneous keys (e.g., diagonal movement)
+```bash
+curl -s -X POST "http://localhost:8081/control/press?key=ARROW_RIGHT"
+curl -s -X POST "http://localhost:8081/control/press?key=ARROW_UP"
+sleep 0.5
+curl -s -X POST "http://localhost:8081/control/release?key=ARROW_RIGHT"
+curl -s -X POST "http://localhost:8081/control/release?key=ARROW_UP"
+```
+
+## How to Use
+
+When the user provides `$ARGUMENTS`:
+
+1. **If arguments describe an action** (e.g., "move right", "jump", "press space 3 times"):
+   - Translate the instruction into the appropriate curl commands
+   - Execute them
+
+2. **If arguments are a key name** (e.g., "SPACE", "ARROW_LEFT"):
+   - Tap that key once
+
+3. **If no arguments or "help"**:
+   - List the available keys by calling `GET /control/keys`
+   - Show usage examples
+
+4. **If "play" or complex instructions** (e.g., "play the game", "explore the level"):
+   - Take a screenshot first to see the game state (if possible via the serve endpoint or playwright)
+   - Send appropriate inputs based on what you observe
+   - Iterate: act, observe, act again
+
+## Error Handling
+
+- If curl fails with connection refused, the game is not running. Tell the user to start it with `tiny-cli run`.
+- If the response contains `"error":"Engine not ready"`, the game is still loading. Wait a moment and retry.
+- If the response contains `"error":"Unknown key"`, check the key name against the available keys list.
+
+## Response Format
+
+All endpoints return JSON:
+- Success: `{"ok":true,"action":"press","key":"ARROW_LEFT"}`
+- Error: `{"error":"Missing 'key' query parameter"}`

.github/workflows/build.yml

@@ -32,12 +32,20 @@ jobs:
           files: |
             tiny-cli/build/distributions/tiny-cli-${{github.ref_name}}.zip
             tiny-cli/build/distributions/tiny-cli-${{github.ref_name}}.tar
+      - name: Install butler
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: jdno/setup-butler@v1
+      - name: Publish to itch.io
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          BUTLER_API_KEY: ${{ secrets.BUTLER_API_KEY }}
+        run: butler push tiny-cli/build/distributions/tiny-cli-${{github.ref_name}}.zip dwursteisen/tiny:tiny-cli --userversion ${{github.ref_name}}
       - name: Update documentation sample
         run: |
           unzip tiny-cli/build/distributions/tiny-cli-${{github.ref_name}}.zip
           tiny-cli-${{github.ref_name}}/bin/tiny-cli docs --output tiny-doc/src/docs/asciidoc/dependencies/tiny-cli-commands.adoc
-          tiny-cli-${{github.ref_name}}/bin/tiny-cli export tiny-sample
-          unzip -o -d tiny-doc/src/docs/asciidoc/sample/game-example tiny-sample/tiny-export.zip
+          tiny-cli-${{github.ref_name}}/bin/tiny-cli export tiny-samples/breakout
+          unzip -o -d tiny-doc/src/docs/asciidoc/sample/game-example tiny-samples/breakout/tiny-export.zip
           tiny-cli-${{github.ref_name}}/bin/tiny-cli export tiny-cli/src/main/resources/sfx
           unzip -o -d tiny-doc/src/docs/asciidoc/sample/sfx-editor tiny-cli/src/main/resources/sfx/tiny-export.zip
       - name: Build examples and generate Asciidoctor HTML pages
@@ -48,6 +56,76 @@ jobs:
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./tiny-doc/build/docs/asciidoc
+      - name: Upload CLI distribution
+        uses: actions/upload-artifact@v4
+        with:
+          name: tiny-cli-dist
+          path: tiny-cli/build/distributions/tiny-cli-${{github.ref_name}}.zip
+          retention-days: 1
+
+  test-export:
+    needs: build
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - name: Checkout the repo
+        uses: actions/checkout@v3
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: 17
+          distribution: 'zulu'
+      - name: Download CLI distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: tiny-cli-dist
+      - name: Extract CLI distribution (Unix)
+        if: runner.os != 'Windows'
+        run: unzip tiny-cli-${{github.ref_name}}.zip
+      - name: Extract CLI distribution (Windows)
+        if: runner.os == 'Windows'
+        run: Expand-Archive -Path tiny-cli-${{github.ref_name}}.zip -DestinationPath .
+      - name: Test web export (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          tiny-cli-${{github.ref_name}}/bin/tiny-cli export tiny-samples/breakout
+          test -f tiny-samples/breakout/tiny-export.zip
+      - name: Test web export (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          tiny-cli-${{github.ref_name}}\bin\tiny-cli.bat export tiny-samples\breakout
+          if (-Not (Test-Path tiny-samples\breakout\tiny-export.zip)) { exit 1 }
+      - name: Test desktop export (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          tiny-cli-${{github.ref_name}}/bin/tiny-cli export tiny-samples/breakout -p desktop --exclude-jdk
+          test -d exported-game
+          ls exported-game/*.jar
+      - name: Test desktop export (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          tiny-cli-${{github.ref_name}}\bin\tiny-cli.bat export tiny-samples\breakout -p desktop --exclude-jdk
+          if (-Not (Test-Path exported-game)) { exit 1 }
+          if (-Not (Get-ChildItem exported-game\*.jar)) { exit 1 }
+      - name: Test desktop export with JDK (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          tiny-cli-${{github.ref_name}}/bin/tiny-cli export tiny-samples/breakout -p desktop --include-jdk -o exported-game-jdk
+          test -d exported-game-jdk
+          if [ "$(uname -s)" = "Linux" ]; then
+            ls exported-game-jdk/*.deb
+          elif [ "$(uname -s)" = "Darwin" ]; then
+            ls exported-game-jdk/*.dmg
+          fi
+      - name: Test desktop export with JDK (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          tiny-cli-${{github.ref_name}}\bin\tiny-cli.bat export tiny-samples\breakout -p desktop --include-jdk -o exported-game-jdk
+          if (-Not (Test-Path exported-game-jdk)) { exit 1 }
+          if (-Not (Get-ChildItem exported-game-jdk\*.exe)) { exit 1 }
 
 env:
   GRADLE_OPTS: -Dorg.gradle.configureondemand=true -Dorg.gradle.parallel=true -Dkotlin.incremental=false -Dorg.gradle.jvmargs="-Xmx3g -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8"

.gitignore

@@ -8,8 +8,7 @@ build/
 .test/
 
 ### IntelliJ IDEA ###
-.idea/**
-.idea/
+.idea
 *.iws
 *.iml
 *.ipr
@@ -44,5 +43,9 @@ bin/
 /tiny-doc/src/docs/asciidoc/dependencies/
 /tiny-doc/src/docs/asciidoc/sample/game-example
 /tiny-doc/src/docs/asciidoc/sample/sfx-editor
+/tiny-doc/src/docs/asciidoc/sample/home
+
+**/tiny-export.zip
+
 
 .kotlin

CLAUDE.md

@@ -12,7 +12,7 @@ Tiny is a Kotlin Multiplatform game engine with Lua scripting support that compi
 - **tiny-doc-annotations**: Annotations for documentation generation
 - **tiny-doc-generator**: KSP-based documentation processor
 - **tiny-web-editor**: Web-based editor interface
-- **tiny-sample**: Sample games and examples
+- **tiny-samples**: Sample games and examples
 
 ## Key Technologies