BlueGit

timfa questward

Files

questward / shared / skills / state.js

state.js

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