Add structured talent mechanics

src/routes/admin/talents/+page.server.ts

@@ -108,15 +108,26 @@ const displayValue = (value: number, unit: unknown) => {
 	return normalizedUnit === 'Shots' ? `${value} ${normalizedUnit}` : `${value}${normalizedUnit}`;
 };
 
+const optionalPositiveNumber = (form: FormData, name: string) => {
+	const raw = String(form.get(name) ?? '').trim();
+	return raw ? Number(raw) : null;
+};
+
+const renderMechanicValue = (value: number, singular: string, plural = `${singular}s`) =>
+	`${value} ${value === 1 ? singular : plural}`;
+
 const renderDescription = (
 	template: string,
 	effects: SharedEffect[],
 	units: Map<string, unknown>,
-	tier: 'I' | 'II'
-) => template.replace(/\{(\d+)\}/g, (placeholder, rawIndex) => {
-	const effect = effects[Number(rawIndex) - 1];
-	if (!effect) return placeholder;
-	return displayValue(tier === 'I' ? effect.valueI : effect.valueII, units.get(effect.statId));
+	tier: 'I' | 'II',
+	durationSeconds: number | null,
+	maxStacks: number | null
+) => template.replace(/\{(\d+|duration|max_stacks)\}/g, (placeholder, expression) => {
+	if (expression === 'duration') return durationSeconds === null ? placeholder : renderMechanicValue(durationSeconds, 'second');
+	if (expression === 'max_stacks') return maxStacks === null ? placeholder : renderMechanicValue(maxStacks, 'stack');
+	const effect = effects[Number(expression) - 1];
+	return effect ? displayValue(tier === 'I' ? effect.valueI : effect.valueII, units.get(effect.statId)) : placeholder;
 });
 
 export const actions: Actions = {
@@ -144,15 +155,22 @@ export const actions: Actions = {
 		catch (error) { if (error instanceof GameDataIconValidationError) return fail(400, { talentError: error.message }); throw error; }
 		const id = String(form.get('id') ?? ''), name = String(form.get('name') ?? '').trim(), category = String(form.get('category') ?? '');
 		const descriptionTemplate = String(form.get('descriptionTemplate') ?? '').trim();
+		const cooldownSeconds = optionalPositiveNumber(form, 'cooldownSeconds');
+		const durationSeconds = optionalPositiveNumber(form, 'durationSeconds');
+		const maxStacks = optionalPositiveNumber(form, 'maxStacks');
 		const triggerIds = [...new Set(form.getAll('triggerIds').map(String))];
 		let sharedEffects: SharedEffect[];
 		try { sharedEffects = parseEffects(form.get('effects')); } catch { return fail(400, { talentError: 'Effects could not be read.' }); }
 		if (name.length < 2 || !['Weapon Talent 1', 'Weapon Talent 2', 'Backpack', 'Body Armor'].includes(category)) return fail(400, { talentError: 'Provide a valid talent name and category. Exotic talents are managed from their owning weapon.' });
 		if (!descriptionTemplate || !triggerIds.length || !sharedEffects.length) return fail(400, { talentError: 'A description template, trigger, and at least one effect are required.' });
+		if ([cooldownSeconds, durationSeconds].some((value) => value !== null && (!Number.isFinite(value) || value <= 0))) return fail(400, { talentError: 'Cooldown and duration must be positive numbers when defined.' });
+		if (maxStacks !== null && (!Number.isInteger(maxStacks) || maxStacks <= 0)) return fail(400, { talentError: 'Maximum stacks must be a positive whole number when defined.' });
 		if (sharedEffects.some((effect) => !effect.statId || !Number.isFinite(effect.valueI) || !Number.isFinite(effect.valueII))) return fail(400, { talentError: 'Every effect needs valid Tier I and Tier II values.' });
 		if (new Set(sharedEffects.map((effect) => effect.statId)).size !== sharedEffects.length) return fail(400, { talentError: 'Each affected attribute can only be selected once.' });
 		const placeholders = [...descriptionTemplate.matchAll(/\{(\d+)\}/g)].map((match) => Number(match[1]));
 		if (placeholders.some((index) => index < 1 || index > sharedEffects.length)) return fail(400, { talentError: 'Description placeholders must reference an existing effect.' });
+		if (descriptionTemplate.includes('{duration}') && durationSeconds === null) return fail(400, { talentError: 'The description uses {duration}, but no duration is defined.' });
+		if (descriptionTemplate.includes('{max_stacks}') && maxStacks === null) return fail(400, { talentError: 'The description uses {max_stacks}, but no maximum stack count is defined.' });
 		const storedCategory = category === 'Body Armor' ? 'Vest' : category.startsWith('Weapon Talent') ? 'Weapon' : category;
 		const db = await getDatabase();
 		if (await (await db.prepare('SELECT id FROM talents WHERE name=? COLLATE NOCASE AND category=? AND id<>?')).get(name, storedCategory, id || 'new')) return fail(409, { talentError: 'That talent already exists in this category.' });
@@ -161,8 +179,8 @@ export const actions: Actions = {
 		const units = new Map(statRows.map((stat) => [String(stat.id), stat.unit]));
 		const talentId = id || String(form.get('_proposedEntityId') ?? '') || randomUUID(), now = new Date().toISOString();
 		const before = id ? { record: await auditRecord('talents', id), icon: await gameDataIconMetadata(db, 'talent', id), template: await (await db.prepare('SELECT template FROM talent_description_templates WHERE talent_id=?')).get(id), tiers: await (await db.prepare('SELECT tier,description FROM talent_tiers WHERE talent_id=? ORDER BY tier')).all(id) } : null;
-		if (id) await (await db.prepare('UPDATE talents SET name=?,category=?,updated_at=? WHERE id=?')).run(name, storedCategory, now, id);
-		else await (await db.prepare('INSERT INTO talents(id,name,category,created_at,updated_at) VALUES(?,?,?,?,?)')).run(talentId, name, storedCategory, now, now);
+		if (id) await (await db.prepare('UPDATE talents SET name=?,category=?,cooldown_seconds=?,duration_seconds=?,max_stacks=?,updated_at=? WHERE id=?')).run(name, storedCategory, cooldownSeconds, durationSeconds, maxStacks, now, id);
+		else await (await db.prepare('INSERT INTO talents(id,name,category,cooldown_seconds,duration_seconds,max_stacks,created_at,updated_at) VALUES(?,?,?,?,?,?,?,?)')).run(talentId, name, storedCategory, cooldownSeconds, durationSeconds, maxStacks, now, now);
 		if (storedCategory === 'Weapon') {
 			await (await db.prepare(`INSERT INTO talent_weapon_scopes(talent_id,scope) VALUES(?,?)
 				ON CONFLICT(talent_id) DO UPDATE SET scope=excluded.scope`))
@@ -177,7 +195,7 @@ export const actions: Actions = {
 		await (await db.prepare(`INSERT INTO talent_description_templates(talent_id,template,updated_at) VALUES(?,?,?)
 			ON CONFLICT(talent_id) DO UPDATE SET template=excluded.template,updated_at=excluded.updated_at`)).run(talentId, descriptionTemplate, now);
 		for (const tier of ['I', 'II'] as const) {
-			const description = renderDescription(descriptionTemplate, sharedEffects, units, tier);
+			const description = renderDescription(descriptionTemplate, sharedEffects, units, tier, durationSeconds, maxStacks);
 			await (await db.prepare(`INSERT INTO talent_tiers(id,talent_id,tier,description,trigger_text,effect_text,created_at,updated_at) VALUES(?,?,?,?,?,?,?,?)
 				ON CONFLICT(talent_id,tier) DO UPDATE SET description=excluded.description,updated_at=excluded.updated_at`)).run(randomUUID(), talentId, tier, description, '', '', now, now);
 			const tierRow = await (await db.prepare('SELECT id FROM talent_tiers WHERE talent_id=? AND tier=?')).get(talentId, tier);