skins: SkinManager + hot-swap (F7), classic/nes a data/skins/

CLAUDE.md

@@ -84,14 +84,19 @@ Pipeline SDL3 GPU portat de `coffee_crisis_arcade_edition`. El canvas 256×192 e
   - `videoGpuPreferredDriver` (string, buit = auto)
   - `videoShaderEnabled` (bool)
   - `videoShaderType` (0=POSTFX, 1=CRTPI)
-- **Hotkeys** (provisionals fins que hi hagi menú d'opcions): `F4` activa/desactiva post-procesado · `F5` alterna POSTFX ↔ CRTPI (només si està actiu) · `F6` següent preset (només si està actiu). No hi ha tecla per a preset anterior.
+- **Hotkeys** (provisionals fins que hi hagi menú d'opcions): `F4` activa/desactiva post-procesado · `F5` alterna POSTFX ↔ CRTPI (només si està actiu) · `F6` següent preset (només si està actiu) · `F7` següent skin. No hi ha tecla per a preset anterior.
 - **API** a `Screen`: `setGpuAcceleration`/`toggleGpuAcceleration`/`isGpuAccelerated`, `setShaderEnabled`/`toggleShaderEnabled`/`isShaderEnabled`, `setActiveShader`/`toggleActiveShader`/`getActiveShader`.
 
 Presets PostFX/CrtPi i cicle de presets encara **no** estan implementats — arribaran amb la migració a YAML. Per ara, valors per defecte hardcoded.
 
+### Skins
+
+Els gràfics viuen sota `data/skins/<id>/gfx/`. Cada skin té un `skin.yaml` (id, display_name, gfx_dir). `SkinManager` (`core/resources/skin_manager.*`) escaneja manifests al boot, recorda l'skin activa (`Options::settings.skin`) i composa paths per a `Asset::addSkinAware()`. El canvi en calent (F7) és lliure: `Resource::reloadForSkin()` recorre el cache de Texture* i .ani fent `reLoadFromPath`/re-parse, mantenint stable pointer identity perquè els Sprites no s'invaliden. Les skins han de mantenir paritat de basenames i dimensions (recoloreds purs). De moment només es varia el contingut gràfic; logo, fades i altres comportaments són comuns.
+
 ## Data Directory
 
-- `data/gfx/` — PNG spritesheets and `.ani` animation definition files
+- `data/skins/<id>/gfx/` — PNG spritesheets and `.ani` animation definition files per skin (`classic`, `nes`, ...)
+- `data/skins/<id>/skin.yaml` — manifest de la skin (id, display_name, gfx_dir)
 - `data/font/` — bitmap font files
 - `data/music/` and `data/sound/` — audio assets
 - `data/lang/` — language files (es_ES, ba_BA, en_UK)

data/lang/ba_BA.txt

@@ -302,4 +302,7 @@ Shader
 Preset
 
 ## 101 - NOTIFICACIO HOTKEY
-Torna a premer ESC per a eixir
+Torna a premer ESC per a eixir
+
+## 102 - NOTIFICACIO HOTKEY
+Skin

data/lang/en_UK.txt

@@ -302,4 +302,7 @@ Shader
 Preset
 
 ## 101 - HOTKEY NOTIFICATION
-Press ESC again to quit
+Press ESC again to quit
+
+## 102 - HOTKEY NOTIFICATION
+Skin

data/lang/es_ES.txt

@@ -302,4 +302,7 @@ Shader
 Preset
 
 ## 101 - NOTIFICACION HOTKEY
-Vuelve a pulsar ESC para salir
+Vuelve a pulsar ESC para salir
+
+## 102 - NOTIFICACION HOTKEY
+Skin

data/skins/classic/skin.yaml

@@ -0,0 +1,4 @@
+# Coffee Crisis - Classic skin manifest
+name: classic
+display_name: "Classic"
+gfx_dir: gfx

data/skins/nes/gfx/balloon1.ani

@@ -0,0 +1,37 @@
+frameWidth=8
+frameHeight=8
+
+[animation]
+name=orange
+speed=10
+loop=0
+frames=0,1,2,3,4,5,6,7,8,9
+[/animation]
+
+[animation]
+name=blue
+speed=20
+loop=0
+frames=12,13,14,15,16,17,18,19,20,21
+[/animation]
+
+[animation]
+name=green
+speed=10
+loop=0
+frames=24,25,26,27,28,29,30,31,32,33
+[/animation]
+
+[animation]
+name=red
+speed=20
+loop=0
+frames=36,37,38,39,40,41,42,43,44,45
+[/animation]
+
+[animation]
+name=pop
+speed=5
+loop=-1
+frames=48,49,50,51,52,53,54,55,56,57,58,59
+[/animation]

data/skins/nes/gfx/balloon2.ani

@@ -0,0 +1,37 @@
+frameWidth=13
+frameHeight=13
+
+[animation]
+name=orange
+speed=10
+loop=0
+frames=0,1,2,3,4,5,6,7,8,9
+[/animation]
+
+[animation]
+name=blue
+speed=20
+loop=0
+frames=12,13,14,15,16,17,18,19,20,21
+[/animation]
+
+[animation]
+name=green
+speed=10
+loop=0
+frames=24,25,26,27,28,29,30,31,32,33
+[/animation]
+
+[animation]
+name=red
+speed=20
+loop=0
+frames=36,37,38,39,40,41,42,43,44,45
+[/animation]
+
+[animation]
+name=pop
+speed=5
+loop=-1
+frames=48,49,50,51,52,53,54,55,56,57,58,59
+[/animation]

data/skins/nes/gfx/balloon3.ani

@@ -0,0 +1,37 @@
+frameWidth=21
+frameHeight=21
+
+[animation]
+name=orange
+speed=10
+loop=0
+frames=0,1,2,3,4,5,6,7,8,9
+[/animation]
+
+[animation]
+name=blue
+speed=20
+loop=0
+frames=12,13,14,15,16,17,18,19,20,21
+[/animation]
+
+[animation]
+name=green
+speed=10
+loop=0
+frames=24,25,26,27,28,29,30,31,32,33
+[/animation]
+
+[animation]
+name=red
+speed=20
+loop=0
+frames=36,37,38,39,40,41,42,43,44,45
+[/animation]
+
+[animation]
+name=pop
+speed=5
+loop=-1
+frames=48,49,50,51,52,53,54,55,56,57,58,59
+[/animation]

data/skins/nes/gfx/balloon4.ani

@@ -0,0 +1,44 @@
+frameWidth=37
+frameHeight=37
+
+[animation]
+name=orange
+speed=10
+loop=0
+frames=0,1,2,3,4,5,6,7,8,9
+[/animation]
+
+[animation]
+name=blue
+speed=20
+loop=0
+frames=12,13,14,15,16,17,18,19,20,21
+[/animation]
+
+[animation]
+name=green
+speed=10
+loop=0
+frames=24,25,26,27,28,29,30,31,32,33
+[/animation]
+
+[animation]
+name=red
+speed=20
+loop=0
+frames=36,37,38,39,40,41,42,43,44,45
+[/animation]
+
+[animation]
+name=powerball
+speed=10
+loop=0
+frames=10
+[/animation]
+
+[animation]
+name=pop
+speed=5
+loop=-1
+frames=48,49,50,51,52,53,54,55,56,57,58,59
+[/animation]

data/skins/nes/gfx/item_clock.ani

@@ -0,0 +1,9 @@
+frameWidth=16
+frameHeight=16
+
+[animation]
+name=default
+speed=10
+loop=0
+frames=0,1
+[/animation]

data/skins/nes/gfx/item_coffee.ani

@@ -0,0 +1,9 @@
+frameWidth=16
+frameHeight=16
+
+[animation]
+name=default
+speed=10
+loop=0
+frames=0,1
+[/animation]

data/skins/nes/gfx/item_coffee_machine.ani

@@ -0,0 +1,9 @@
+frameWidth=23
+frameHeight=29
+
+[animation]
+name=default
+speed=10
+loop=0
+frames=0,1,2,3
+[/animation]

data/skins/nes/gfx/item_points1_disk.ani

@@ -0,0 +1,9 @@
+frameWidth=16
+frameHeight=16
+
+[animation]
+name=default
+speed=10
+loop=0
+frames=0,1
+[/animation]

data/skins/nes/gfx/item_points2_gavina.ani

@@ -0,0 +1,9 @@
+frameWidth=16
+frameHeight=16
+
+[animation]
+name=default
+speed=10
+loop=0
+frames=0,1
+[/animation]

data/skins/nes/gfx/item_points3_pacmar.ani

@@ -0,0 +1,9 @@
+frameWidth=16
+frameHeight=16
+
+[animation]
+name=default
+speed=10
+loop=0
+frames=0,1
+[/animation]

data/skins/nes/gfx/player_body.ani

@@ -0,0 +1,176 @@
+frameWidth=24
+frameHeight=24
+
+[animation]
+name=walk
+speed=5
+loop=0
+frames=0,1,2,3
+[/animation]
+
+[animation]
+name=stand
+speed=10
+loop=0
+frames=4,5,6,7
+[/animation]
+
+[animation]
+name=walk_1C
+speed=5
+loop=0
+frames=8,9,10,11
+[/animation]
+
+[animation]
+name=stand_1C
+speed=10
+loop=0
+frames=12,13,14,15
+[/animation]
+
+[animation]
+name=walk_2C
+speed=5
+loop=0
+frames=16,17,18,19
+[/animation]
+
+[animation]
+name=stand_2C
+speed=10
+loop=0
+frames=20,21,22,23
+[/animation]
+
+
+
+[animation]
+name=sideshoot
+speed=5
+loop=0
+frames=24,25,26,27
+[/animation]
+
+[animation]
+name=centershoot
+speed=5
+loop=0
+frames=28,29,30,31
+[/animation]
+
+[animation]
+name=sideshoot_1C
+speed=5
+loop=0
+frames=32,33,34,35
+[/animation]
+
+[animation]
+name=centershoot_1C
+speed=5
+loop=0
+frames=36,37,38,39
+[/animation]
+
+[animation]
+name=sideshoot_2C
+speed=5
+loop=0
+frames=40,41,42,43
+[/animation]
+
+[animation]
+name=centershoot_2C
+speed=5
+loop=0
+frames=44,45,46,47
+[/animation]
+
+
+
+[animation]
+name=walk_pwr
+speed=3
+loop=0
+frames=0,1,2,3
+[/animation]
+
+[animation]
+name=stand_pwr
+speed=5
+loop=0
+frames=4,5,6,7
+[/animation]
+
+[animation]
+name=walk_1C_pwr
+speed=3
+loop=0
+frames=8,9,10,11
+[/animation]
+
+[animation]
+name=stand_1C_pwr
+speed=5
+loop=0
+frames=12,13,14,15
+[/animation]
+
+[animation]
+name=walk_2C_pwr
+speed=3
+loop=0
+frames=16,17,18,19
+[/animation]
+
+[animation]
+name=stand_2C_pwr
+speed=5
+loop=0
+frames=20,21,22,23
+[/animation]
+
+
+
+[animation]
+name=sideshoot_pwr
+speed=2
+loop=0
+frames=24,25,26,27
+[/animation]
+
+[animation]
+name=centershoot_pwr
+speed=2
+loop=0
+frames=28,29,30,31
+[/animation]
+
+[animation]
+name=sideshoot_1C_pwr
+speed=2
+loop=0
+frames=32,33,34,35
+[/animation]
+
+[animation]
+name=centershoot_1C_pwr
+speed=2
+loop=0
+frames=36,37,38,39
+[/animation]
+
+[animation]
+name=sideshoot_2C_pwr
+speed=2
+loop=0
+frames=40,41,42,43
+[/animation]
+
+[animation]
+name=centershoot_2C_pwr
+speed=2
+loop=0
+frames=44,45,46,47
+[/animation]

data/skins/nes/gfx/player_death.ani

@@ -0,0 +1,9 @@
+frameWidth=24
+frameHeight=24
+
+[animation]
+name=default
+speed=5
+loop=0
+frames=0,1,2,3
+[/animation]