import { SkillId, SKILL_DEFINITIONS, ALL_SKILL_IDS, DEFAULT_PLAYER_SKILL_LEVELS } from "../definitions/skills.js"; import { combatLevelFromSkills } from "../combat/combatLevel.js"; import { maxTotalSkillXp, totalXpForLevel, xpProgress, MAX_SKILL_LEVEL } from "./progression.js"; import { skillXpMultiplier } from "../equipment/jewelryEffects.js"; /** Health starts at level 5; Stamina at 5; other skills at level 1. */ export const STARTING_HEALTH_XP = totalXpForLevel(DEFAULT_PLAYER_SKILL_LEVELS[SkillId.health] ?? 5); export function emptySkillXp () { const xp = {}; for (const skillId of ALL_SKILL_IDS) { xp[skillId] = 0; } return xp; } /** Raise any skill below its default starting level up to that floor. Returns whether XP changed. */ export function enforceMinimumSkillLevels (skillsComponent) { if (!skillsComponent?.xp) { return false; } let raised = false; for (const skillId of ALL_SKILL_IDS) { const minLevel = DEFAULT_PLAYER_SKILL_LEVELS[skillId] ?? 1; const minXp = totalXpForLevel(minLevel); const current = Math.max(0, Math.floor(Number(skillsComponent.xp[skillId]) || 0)); if (current < minXp) { skillsComponent.xp[skillId] = minXp; raised = true; } } return raised; } export function normalizeSkillXp (raw) { const xp = emptySkillXp(); if (raw && typeof raw === "object") { for (const skillId of ALL_SKILL_IDS) { const value = Math.max(0, Math.floor(Number(raw[skillId]) || 0)); xp[skillId] = Number.isSafeInteger(value) ? value : 0; } } enforceMinimumSkillLevels({ xp }); return xp; } export function normalizePlayerSkills (stored) { return { xp: normalizeSkillXp(stored?.xp ?? stored) }; } /** Starting skills for a new character (Health 5, Stamina 5, others 1). */ export function defaultPlayerSkills () { return normalizePlayerSkills({ [SkillId.health]: STARTING_HEALTH_XP, [SkillId.stamina]: totalXpForLevel(DEFAULT_PLAYER_SKILL_LEVELS[SkillId.stamina] ?? 5) }); } export function addSkillXp (skillsComponent, skillId, amount) { if (!skillsComponent?.xp) { return false; } const add = Math.max(0, Math.floor(Number(amount) || 0)); if (!add) { return false; } const current = skillsComponent.xp[skillId] ?? 0; if (xpProgress(current).level >= MAX_SKILL_LEVEL) { return false; } skillsComponent.xp[skillId] = Math.min(maxTotalSkillXp(), current + add); return skillsComponent.xp[skillId] !== current; } export function skillLevelUpPayload (skillId, level, previousLevel = null) { const def = SKILL_DEFINITIONS[skillId]; const prev = previousLevel == null ? Math.max(0, (level | 0) - 1) : previousLevel | 0; return { skillId, level, previousLevel: prev, displayName: def?.displayName ?? skillId, icon: `/assets/skills/${skillId}.svg` }; } /** Apply XP and report whether the skill leveled up. */ export function applySkillXp (skillsComponent, skillId, amount, equipment = null) { if (!skillsComponent?.xp) { return { changed: false, levelUp: null }; } const mult = skillXpMultiplier(equipment, skillsComponent, skillId); const adjusted = Math.max(0, Math.floor((Number(amount) || 0) * mult)); const before = skillsComponent.xp[skillId] ?? 0; const beforeLevel = xpProgress(before).level; const changed = addSkillXp(skillsComponent, skillId, adjusted); if (!changed) { return { changed: false, levelUp: null }; } const afterLevel = xpProgress(skillsComponent.xp[skillId] ?? 0).level; if (afterLevel <= beforeLevel) { return { changed: true, levelUp: null }; } return { changed: true, levelUp: skillLevelUpPayload(skillId, afterLevel, beforeLevel) }; } export function publicSkillsView (skillsComponent) { const xpMap = skillsComponent?.xp ?? null; if (!xpMap) { return []; } return ALL_SKILL_IDS.map((skillId) => { const def = SKILL_DEFINITIONS[skillId]; const progress = xpProgress(xpMap[skillId] ?? 0); return { skillId, displayName: def?.displayName ?? skillId, icon: `/assets/skills/${skillId}.svg`, level: progress.level, xp: progress.xpInLevel, xpToNext: progress.xpToNext }; }); } export function publicSkillsPayload (skillsComponent) { return { combatLevel: combatLevelFromSkills(skillsComponent), skills: publicSkillsView(skillsComponent) }; } export function storedSkillXp (skillsComponent) { return normalizeSkillXp(skillsComponent?.xp); }