Regenerate stale declarations, add shader-showcase audit backlog, fix release skill

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: jsvd

.claude/skills/release/SKILL.md

@@ -155,20 +155,30 @@ git push origin main --tags
 
 ### 10. Publish to crates.io
 
-Publish in dependency order, waiting for indexing between each:
+Publish in dependency order. Run each command **separately** — do not chain them with `&&`.
 
 ```bash
 # 1. Core library
 cargo publish -p arcane-core
+```
 
-# Wait ~60s for crates.io to index
+```bash
+# Wait for crates.io to index before publishing the CLI
 sleep 60
+```
 
+```bash
 # 2. CLI binary (--allow-dirty because cli/data/ is gitignored but included in crate)
 cargo publish -p arcane-engine --allow-dirty
 ```
 
-If the second publish fails with "arcane-core X.Y.Z not found", wait longer and retry.
+- If `arcane-engine` fails with **"arcane-core X.Y.Z not found"**: wait longer and retry the last command only.
+- If either publish fails with **"already exists on crates.io index"**: **do not assume success — investigate first**:
+  1. Run `cargo search arcane-core` / `cargo search arcane-engine` to confirm the published version matches X.Y.Z.
+  2. Check `gh release list` to see if a GitHub release for vX.Y.Z already exists.
+  3. If both match the intended version and all prior steps (CHANGELOG, git tag, CI) completed correctly, the duplicate was harmless — continue.
+  4. If the published version matches X.Y.Z but earlier steps (CHANGELOG, tag, CI) are incomplete, complete those steps before finishing.
+  5. If the published version is wrong (e.g. stale from a failed prior run), a new crates.io publish is impossible for that version — bump to a patch version (X.Y.Z+1), fix the root cause, and restart the release.
 
 ### 11. Create GitHub Release
 

docs/roadmap.md

@@ -388,6 +388,25 @@ GPU pipeline code (`renderer/mod.rs`, `sprite.rs`, `gpu.rs`, `texture.rs`, `shad
 | **Tier 1+2+3 done** | +5 more test files | TS coverage ~95%, Rust unchanged |
 | **Tier 4 done** | Rust test harness + integration tests | Rust coverage 60-70% (up from 41%) |
 
+### Shader Showcase Effects Audit
+
+**Status:** Open
+**Severity:** Medium — demo launches but multiple effects are visually broken
+
+Several effect presets in `demos/shader-showcase/` produce incorrect or no visual output. The demo structure is now fixed (correct `drawText` calls, `setBackgroundColor` object form) but the underlying shader/uniform wiring for individual effects needs investigation.
+
+**Known symptoms:**
+- Multiple effects appear broken or identical (likely uniform not being set correctly per-effect)
+
+**Suggested investigation:**
+- [ ] Run each of the 8 effect presets and note which produce expected output vs. no change
+- [ ] Check `runtime/rendering/effects.ts` — verify each preset sets the correct named uniforms via `setShaderUniform()`
+- [ ] Check `runtime/rendering/shader.ts` — verify `createShader()` and `setShaderUniform()` correctly map names to slots and flush per-frame
+- [ ] Check the demo's per-effect `animate()` callbacks pass correct uniform names and value ranges
+- [ ] Cross-reference with `demos/shader-showcase/main.ts` effect definitions
+
+---
+
 ### World Authoring DSL
 
 **Status:** Open (Design in docs/world-authoring.md, not yet implemented)

templates/default/types/rendering.d.ts

@@ -788,12 +788,14 @@ declare module "@arcane/runtime/rendering" {
    */
   export declare function playMusic(path: string, volume?: number): InstanceId;
   /**
-   * Stop a specific playing sound.
-   * No-op in headless mode.
+   * Stop a specific playing sound by sound ID.
+   * Deprecated: use stopInstance() with an instance ID returned by playSound() instead.
+   * This function is now a no-op; stop individual sounds using stopInstance().
    *
-   * @param id - Sound handle from loadSound().
+   * @param id - Sound handle from loadSound() (unused).
+   * @deprecated Use stopInstance() with the InstanceId from playSound().
    */
-  export declare function stopSound(id: SoundId): void;
+  export declare function stopSound(_id: SoundId): void;
   /**
    * Stop all currently playing sounds and music.
    * No-op in headless mode.