feat(debris): modelo INTACTO→MENGUANDO→0 (sin pop, fade-out por tamaño)

source/game/effects/debris.hpp

@@ -24,16 +24,17 @@ namespace Effects {
         float velocitat_rot;         // Velocidad de rotación de TRAYECTORIA (rad/s)
         float velocitat_rot_visual;  // Velocidad de rotación VISUAL del segment (rad/s)
 
-        // Estat de vida
-        // Política: viu sempre durant min_lifetime, després mor quan
-        // |velocity| < MIN_SPEED_TO_DIE (definit en Defaults). Així els
-        // fragments ràpids no "popen" en moviment.
-        float temps_vida;    // Temps transcorregut (segons)
-        float min_lifetime;  // Temps mínim garantit (segons)
-        bool active;         // Està actiu?
-
-        // Shrinking (reducció de distancia entre points)
-        float factor_shrink;  // Factor de reducció per segon (0.0-1.0)
+        // Estat de vida en dos fases:
+        // 1. INTACTE (shrinking=false): size_factor=1.0 durant intact_time segons,
+        //    o fins que la velocity cau per sota de SHRINK_SPEED_THRESHOLD.
+        // 2. MENGUANT (shrinking=true): size_factor decreix a shrink_rate/s fins
+        //    arribar a 0 → mor. Mai pop visual: sempre fade-out.
+        float temps_vida;   // Temps transcorregut (segons)
+        float intact_time;  // Temps en fase INTACTE (segons)
+        bool shrinking;     // false=intacte, true=menguant
+        float size_factor;  // Mida actual (1.0=ple, 0.0=mort)
+        float shrink_rate;  // Velocity de menguada (per segon)
+        bool active;        // Està actiu?
 
         // Rendering
         float brightness;   // Factor de brightness (0.0-1.0, heretat de l'objecte original)