BlueGit

timfa questward

Files

questward / shared / skills / state.js

state.js

state.js 3.6 KiB Download Raw
1import { SkillId, SKILL_DEFINITIONS, ALL_SKILL_IDS, DEFAULT_PLAYER_SKILL_LEVELS } from "../definitions/skills.js";
2import { maxTotalSkillXp, totalXpForLevel, xpProgress, MAX_SKILL_LEVEL } from "./progression.js";
3
4/** Health starts at level 10; Stamina at 5; other skills at level 1. */
5export const STARTING_HEALTH_XP = totalXpForLevel(DEFAULT_PLAYER_SKILL_LEVELS[SkillId.health] ?? 10);
6
7export function emptySkillXp ()
8{
9 const xp = {};
10 for (const skillId of ALL_SKILL_IDS)
11 { xp[skillId] = 0; }
12 return xp;
13}
14
15/** Raise any skill below its default starting level up to that floor. Returns whether XP changed. */
16export function enforceMinimumSkillLevels (skillsComponent)
17{
18 if (!skillsComponent?.xp)
19 { return false; }
20 let raised = false;
21 for (const skillId of ALL_SKILL_IDS)
22 {
23 const minLevel = DEFAULT_PLAYER_SKILL_LEVELS[skillId] ?? 1;
24 const minXp = totalXpForLevel(minLevel);
25 const current = Math.max(0, Math.floor(Number(skillsComponent.xp[skillId]) || 0));
26 if (current < minXp)
27 {
28 skillsComponent.xp[skillId] = minXp;
29 raised = true;
30 }
31 }
32 return raised;
33}
34
35export function normalizeSkillXp (raw)
36{
37 const xp = emptySkillXp();
38 if (raw && typeof raw === "object")
39 {
40 for (const skillId of ALL_SKILL_IDS)
41 {
42 const value = Math.max(0, Math.floor(Number(raw[skillId]) || 0));
43 xp[skillId] = Number.isSafeInteger(value) ? value : 0;
44 }
45 }
46 enforceMinimumSkillLevels({ xp });
47 return xp;
48}
49
50export function normalizePlayerSkills (stored)
51{
52 return { xp: normalizeSkillXp(stored?.xp ?? stored) };
53}
54
55/** Starting skills for a new character (Health 10, Stamina 5, others 1). */
56export function defaultPlayerSkills ()
57{
58 return normalizePlayerSkills({
59 [SkillId.health]: STARTING_HEALTH_XP,
60 [SkillId.stamina]: totalXpForLevel(DEFAULT_PLAYER_SKILL_LEVELS[SkillId.stamina] ?? 5)
61 });
62}
63
64export function addSkillXp (skillsComponent, skillId, amount)
65{
66 if (!skillsComponent?.xp)
67 { return false; }
68 const add = Math.max(0, Math.floor(Number(amount) || 0));
69 if (!add)
70 { return false; }
71 const current = skillsComponent.xp[skillId] ?? 0;
72 if (xpProgress(current).level >= MAX_SKILL_LEVEL)
73 { return false; }
74 skillsComponent.xp[skillId] = Math.min(maxTotalSkillXp(), current + add);
75 return skillsComponent.xp[skillId] !== current;
76}
77
78export function skillLevelUpPayload (skillId, level)
79{
80 const def = SKILL_DEFINITIONS[skillId];
81 return {
82 skillId,
83 level,
84 displayName: def?.displayName ?? skillId,
85 icon: `/assets/skills/${skillId}.svg`
86 };
87}
88
89/** Apply XP and report whether the skill leveled up. */
90export function applySkillXp (skillsComponent, skillId, amount)
91{
92 if (!skillsComponent?.xp)
93 { return { changed: false, levelUp: null }; }
94 const before = skillsComponent.xp[skillId] ?? 0;
95 const beforeLevel = xpProgress(before).level;
96 const changed = addSkillXp(skillsComponent, skillId, amount);
97 if (!changed)
98 { return { changed: false, levelUp: null }; }
99 const afterLevel = xpProgress(skillsComponent.xp[skillId] ?? 0).level;
100 if (afterLevel <= beforeLevel)
101 { return { changed: true, levelUp: null }; }
102 return {
103 changed: true,
104 levelUp: skillLevelUpPayload(skillId, afterLevel)
105 };
106}
107
108export function publicSkillsView (skillsComponent)
109{
110 const xpMap = skillsComponent?.xp ?? null;
111 if (!xpMap)
112 { return []; }
113 return ALL_SKILL_IDS.map((skillId) =>
114 {
115 const def = SKILL_DEFINITIONS[skillId];
116 const progress = xpProgress(xpMap[skillId] ?? 0);
117 return {
118 skillId,
119 displayName: def?.displayName ?? skillId,
120 icon: `/assets/skills/${skillId}.svg`,
121 level: progress.level,
122 xp: progress.xpInLevel,
123 xpToNext: progress.xpToNext
124 };
125 });
126}
127
128export function storedSkillXp (skillsComponent)
129{
130 return normalizeSkillXp(skillsComponent?.xp);
131}