feat: add prestige system and skill upgrades with comprehensive documentation

src/lib/game/store/combatSlice.ts

@@ -5,7 +5,8 @@ import type { StateCreator } from 'zustand';
 import type { GameState, GameAction, SpellCost } from '../types';
 import { GUARDIANS, SPELLS_DEF, ELEMENTS, ELEMENT_OPPOSITES } from '../constants';
 import { getFloorMaxHP, getFloorElement, calcDamage, computePactMultiplier, canAffordSpellCost, deductSpellCost } from './computed';
-import { computeEffects, hasSpecial, SPECIAL_EFFECTS } from '../upgrade-effects';
+import { computeEffects } from '../upgrade-effects';
+import { hasSpecial, SPECIAL_EFFECTS } from '../special-effects';
 
 export interface CombatSlice {
   // State

src/lib/game/store/computed.ts

@@ -3,6 +3,8 @@
 import type { GameState } from '../types';
 import { ELEMENTS, GUARDIANS, SPELLS_DEF, SKILLS_DEF, PRESTIGE_DEF, ELEMENT_OPPOSITES } from '../constants';
 import { computeEffects } from '../upgrade-effects';
+import type { ComputedEffects } from '../upgrade-effects.types';
+import type { UnifiedEffects } from '../effects';
 import { getTierMultiplier } from '../skill-evolution';
 
 // Helper to get effective skill level accounting for tiers
@@ -40,20 +42,9 @@ export function computeMaxMana(
   return Math.floor((base + computedEffects.maxManaBonus) * computedEffects.maxManaMultiplier * heartMultiplier);
 }
 
-export function computeElementMax(
-  state: Pick<GameState, 'skills' | 'prestigeUpgrades' | 'skillUpgrades' | 'skillTiers'>,
-  effects?: ReturnType<typeof computeEffects>
-): number {
-  const pu = state.prestigeUpgrades;
-  const skillTiers = state.skillTiers || {};
-  const skillUpgrades = state.skillUpgrades || {};
-
-  const elemAttuneLevel = getEffectiveSkillLevel(state.skills, 'elemAttune', skillTiers);
-  const base = 10 + elemAttuneLevel.level * 50 * elemAttuneLevel.tierMultiplier + (pu.elementalAttune || 0) * 25;
-
-  const computedEffects = effects ?? computeEffects(skillUpgrades, skillTiers);
-  return Math.floor((base + computedEffects.elementCapBonus) * computedEffects.elementCapMultiplier);
-}
+// computeElementMax is now in ../store.ts with support for unlockedManaTypeUpgrades
+// This file no longer exports computeElementMax to avoid duplicate export issues
+// Import computeElementMax from '../store' instead
 
 export function computeRegen(
   state: Pick<GameState, 'skills' | 'prestigeUpgrades' | 'skillUpgrades' | 'skillTiers'>,

src/lib/game/store/manaSlice.ts

@@ -4,8 +4,10 @@
 import type { StateCreator } from 'zustand';
 import type { GameState, ElementState, SpellCost } from '../types';
 import { ELEMENTS, MANA_PER_ELEMENT, BASE_UNLOCKED_ELEMENTS } from '../constants';
-import { computeMaxMana, computeElementMax, computeClickMana, canAffordSpellCost, getMeditationBonus } from './computed';
-import { computeEffects, hasSpecial, SPECIAL_EFFECTS } from '../upgrade-effects';
+import { computeMaxMana, computeClickMana, canAffordSpellCost, getMeditationBonus } from './computed';
+import { computeElementMax } from '../store';
+import { computeEffects } from '../upgrade-effects';
+import { hasSpecial, SPECIAL_EFFECTS } from '../special-effects';
 
 export interface ManaSlice {
   // State