BlueGit

timfa questward

Files

questward / shared / skills / state.js

state.js

state.js 3.8 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, previousLevel = null)
79{
80 const def = SKILL_DEFINITIONS[skillId];
81 const prev = previousLevel == null ? Math.max(0, (level | 0) - 1) : previousLevel | 0;
82 return {
83 skillId,
84 level,
85 previousLevel: prev,
86 displayName: def?.displayName ?? skillId,
87 icon: `/assets/skills/${skillId}.svg`
88 };
89}
90
91/** Apply XP and report whether the skill leveled up. */
92export function applySkillXp (skillsComponent, skillId, amount)
93{
94 if (!skillsComponent?.xp)
95 { return { changed: false, levelUp: null }; }
96 const before = skillsComponent.xp[skillId] ?? 0;
97 const beforeLevel = xpProgress(before).level;
98 const changed = addSkillXp(skillsComponent, skillId, amount);
99 if (!changed)
100 { return { changed: false, levelUp: null }; }
101 const afterLevel = xpProgress(skillsComponent.xp[skillId] ?? 0).level;
102 if (afterLevel <= beforeLevel)
103 { return { changed: true, levelUp: null }; }
104 return {
105 changed: true,
106 levelUp: skillLevelUpPayload(skillId, afterLevel, beforeLevel)
107 };
108}
109
110export function publicSkillsView (skillsComponent)
111{
112 const xpMap = skillsComponent?.xp ?? null;
113 if (!xpMap)
114 { return []; }
115 return ALL_SKILL_IDS.map((skillId) =>
116 {
117 const def = SKILL_DEFINITIONS[skillId];
118 const progress = xpProgress(xpMap[skillId] ?? 0);
119 return {
120 skillId,
121 displayName: def?.displayName ?? skillId,
122 icon: `/assets/skills/${skillId}.svg`,
123 level: progress.level,
124 xp: progress.xpInLevel,
125 xpToNext: progress.xpToNext
126 };
127 });
128}
129
130export function storedSkillXp (skillsComponent)
131{
132 return normalizeSkillXp(skillsComponent?.xp);
133}