@vibemancer/core 0.1.4 → 0.1.5

package/src/bots/defensive/01_Turtle.ts

@@ -1,11 +1,13 @@
-import {WizardFunction} from '../../types.js';
+import type {FinalAction} from '../../hooks/index.js';
+import {usePosition, useEnemy, useStatus, useBlinkCooldown, useThreats, useLastMissileConfig, useCastingSpell, idle, missile, move, shield, blink, cancel, getMissileContext, turnToward, flyStraight} from '../../hooks/index.js';
 import {angleTo} from '../../utils/angles.js';
-import {GCD_DURATION, SHIELD_CAST_TIME} from '../../rules.js';
+import {RULES} from '../../rules.js';
 import {getMissileCastTime} from '../../utils/combat.js';
 import {
-	getThreats,
 	getMostUrgentThreat,
 	getBlinkToCenter,
+	keepOffWalls,
+	getLavaEvade,
 } from '../shared.js';
 import {useParam} from '../../engine/params-runtime.js';
 
@@ -44,9 +46,18 @@ import {useParam} from '../../engine/params-runtime.js';
 // Range = 5 × 180 = 900 units.
 const MISSILE_CONFIG = {damage: 12, speed: 5, turnRate: 1, duration: 180};
 
-export const Turtle: WizardFunction = ({state}) => 
+export function Turtle(): FinalAction
 {
-	const shieldBuffer = useParam('shieldBuffer', 3.1, {
+	const position = usePosition();
+	const enemy = useEnemy();
+	const status = useStatus();
+	const blinkCooldown = useBlinkCooldown();
+	const threats = useThreats();
+	const lastMissileConfig = useLastMissileConfig();
+	const castingSpell = useCastingSpell();
+
+
+	const shieldBuffer = useParam('shieldBuffer', 4.3, {
 		range: 5,
 		min: 0,
 		steps: 5,
@@ -56,21 +67,22 @@ export const Turtle: WizardFunction = ({state}) =>
 		min: 0,
 		steps: 5,
 	});
-	const ticksToReshield = SHIELD_CAST_TIME + shieldBuffer;
-
-	const enemy = state.enemies[0];
-	if (!enemy) return {move: {x: 0, y: 0}};
+	const ticksToReshield = RULES.SHIELD_CAST_TIME + shieldBuffer;
 
-	const threats = getThreats(state);
 	const urgentThreat = getMostUrgentThreat(threats);
 
+	// Lava-evade: a knockback-lethal hit near a wall must be dodged/blinked, not
+	// shielded — knockback ignores shields. Highest priority.
+	const lavaEvade = getLavaEvade(position, enemy.position, threats, blinkCooldown);
+	if (lavaEvade) return lavaEvade.action === 'blink' ? blink(lavaEvade.x, lavaEvade.y) : move(lavaEvade.x, lavaEvade.y);
+
 	const shouldStartShield =
 		urgentThreat !== null &&
-    urgentThreat.ticksToImpact <= SHIELD_CAST_TIME + shieldBuffer;
+    urgentThreat.ticksToImpact <= RULES.SHIELD_CAST_TIME + shieldBuffer;
 
 	// === CHANNELING SHIELD ===
 	// Hold shield until the imminent missile(s) have actually impacted.
-	if (state.state === 'channeling' && state.channelingSpell === 'shield') 
+	if (status === 'channeling' && 'shield' === 'shield') 
 	{
 		// Don't cancel while a missile is about to hit
 		const imminentThreat = threats.find(
@@ -78,74 +90,66 @@ export const Turtle: WizardFunction = ({state}) =>
 		);
 		if (imminentThreat) 
 		{
-			return {move: {x: 0, y: 0}};
+			{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
 		}
 
 		// Safe to cancel if no next threat, or next threat is far enough to reshield
 		const nextThreat = threats.find((t) => t.willHit);
 		if (!nextThreat || nextThreat.ticksToImpact > ticksToReshield) 
 		{
-			return {move: {x: 0, y: 0}, cancel: true};
+			return cancel();
 		}
 		// Next threat too soon — keep channeling
-		return {move: {x: 0, y: 0}};
+		{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
 	}
 
 	// === CASTING SHIELD: let it finish ===
-	if (state.state === 'casting' && state.castingSpell === 'shield') 
+	if (status === 'casting' && castingSpell === 'shield') 
 	{
-		return {move: {x: 0, y: 0}};
+		{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
 	}
 
 	// === NEED TO SHIELD NOW: cancel anything else ===
 	if (shouldStartShield) 
 	{
-		if (state.state === 'casting') 
+		if (status === 'casting') 
 		{
-			return {move: {x: 0, y: 0}, cancel: true};
+			return cancel();
 		}
-		if (state.state === 'idle') 
+		if (status === 'idle') 
 		{
-			return {move: {x: 0, y: 0}, startCast: {spell: 'shield'}};
+			return shield();
 		}
 	}
 
 	// === EMERGENCY BLINK: missile too close for shield, blink available ===
 	if (
-		state.state === 'idle' &&
+		status === 'idle' &&
     urgentThreat &&
-    urgentThreat.ticksToImpact < SHIELD_CAST_TIME + shieldBuffer &&
+    urgentThreat.ticksToImpact < RULES.SHIELD_CAST_TIME + shieldBuffer &&
     urgentThreat.ticksToImpact >= 10 &&
-    state.blinkCooldown === 0
+    blinkCooldown === 0
 	) 
 	{
-		return {
-			move: {x: 0, y: 0},
-			startCast: {spell: 'blink', target: getBlinkToCenter(state.position)},
-		};
+		return blink(getBlinkToCenter(position).x, getBlinkToCenter(position).y);
 	}
 
 	// === ATTACK: one missile if safe window exists ===
 	// Dynamic safe window: actual cast time (with warmup) + GCD + shield + buffer
-	const castTime = getMissileCastTime(MISSILE_CONFIG, state.lastMissileConfig);
-	const safeWindow = castTime + GCD_DURATION + SHIELD_CAST_TIME + shieldBuffer;
+	const castTime = getMissileCastTime(MISSILE_CONFIG, lastMissileConfig);
+	const safeWindow = castTime + RULES.GCD_DURATION + RULES.SHIELD_CAST_TIME + shieldBuffer;
 	if (
-		state.state === 'idle' &&
+		status === 'idle' &&
     (!urgentThreat || urgentThreat.ticksToImpact > safeWindow)
 	) 
 	{
-		return {
-			move: {x: 0, y: 0},
-			startCast: {
-				spell: 'missile',
-				config: MISSILE_CONFIG,
-				missileAI: ({worldState}) => ({
-					turnToward: worldState.enemies[0]?.position,
-				}),
-				direction: angleTo(state.position, enemy.position),
-			},
-		};
+		return missile(MISSILE_CONFIG, () => 
+		{
+			const ctx = getMissileContext();
+			const enemy = ctx.worldState.enemies[0];
+			return enemy ? turnToward(enemy.position.x, enemy.position.y) : flyStraight();
+		}, angleTo(position, enemy.position)).move(keepOffWalls(position).x, keepOffWalls(position).y);
 	}
 
-	return {move: {x: 0, y: 0}};
-};
+	{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
+}

package/src/bots/defensive/02_Sentinel.ts

@@ -1,11 +1,13 @@
-import {WizardFunction, MissileActions} from '../../types.js';
+import type {FinalAction} from '../../hooks/index.js';
+import {usePosition, useEnemy, useStatus, useBlinkCooldown, useThreats, useLastMissileConfig, useCastingSpell, idle, missile, move, shield, blink, cancel, getMissileContext, turnToward, flyStraight} from '../../hooks/index.js';
 import {angleTo} from '../../utils/angles.js';
-import {GCD_DURATION, SHIELD_CAST_TIME} from '../../rules.js';
+import {RULES} from '../../rules.js';
 import {getMissileCastTime} from '../../utils/combat.js';
 import {
-	getThreats,
 	getMostUrgentThreat,
 	getBlinkToCenter,
+	keepOffWalls,
+	getLavaEvade,
 } from '../shared.js';
 import {useParam} from '../../engine/params-runtime.js';
 
@@ -24,8 +26,17 @@ import {useParam} from '../../engine/params-runtime.js';
  *
  * TIER: 2 (enhanced Turtle)
  */
-export const Sentinel: WizardFunction = ({state}) =>
+export function Sentinel(): FinalAction
 {
+	const position = usePosition();
+	const enemy = useEnemy();
+	const status = useStatus();
+	const blinkCooldown = useBlinkCooldown();
+	const threats = useThreats();
+	const lastMissileConfig = useLastMissileConfig();
+	const castingSpell = useCastingSpell();
+
+
 	const shieldHoldTicks = useParam('shieldHoldTicks', 2, {
 		range: 5,
 		min: 0,
@@ -33,102 +44,95 @@ export const Sentinel: WizardFunction = ({state}) =>
 		steps: 5,
 	});
 
-	const enemy = state.enemies[0];
 
-	const threats = getThreats(state);
 	const urgentThreat = getMostUrgentThreat(threats);
 
 	const SHIELD_BUFFER = 3;
 	const shouldStartShield =
 		urgentThreat !== null &&
-    urgentThreat.ticksToImpact <= SHIELD_CAST_TIME + SHIELD_BUFFER;
+    urgentThreat.ticksToImpact <= RULES.SHIELD_CAST_TIME + SHIELD_BUFFER;
 
-	const TICKS_TO_RESHIELD = SHIELD_CAST_TIME + SHIELD_BUFFER;
+	const TICKS_TO_RESHIELD = RULES.SHIELD_CAST_TIME + SHIELD_BUFFER;
 	const nextThreat = threats.filter((t) => t.willHit)[1] ?? null;
 	const safeToCancel =
 		!nextThreat || nextThreat.ticksToImpact > TICKS_TO_RESHIELD;
 
-	if (state.state === 'channeling' && state.channelingSpell === 'shield')
+	// Lava-evade: a knockback-lethal hit near a wall must be dodged/blinked, not
+	// shielded — knockback ignores shields. Highest priority.
+	const lavaEvade = getLavaEvade(position, enemy.position, threats, blinkCooldown);
+	if (lavaEvade) return lavaEvade.action === 'blink' ? blink(lavaEvade.x, lavaEvade.y) : move(lavaEvade.x, lavaEvade.y);
+
+	if (status === 'channeling' && 'shield' === 'shield')
 	{
 		const imminentThreat = threats.find(
 			(t) => t.willHit && t.ticksToImpact <= shieldHoldTicks,
 		);
-		if (imminentThreat) return {move: {x: 0, y: 0}};
-		if (safeToCancel) return {move: {x: 0, y: 0}, cancel: true};
-		return {move: {x: 0, y: 0}};
+		if (imminentThreat) 
+		{
+			const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); 
+		}
+		if (safeToCancel) return cancel();
+		{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
 	}
 
-	if (state.state === 'casting' && state.castingSpell === 'shield')
+	if (status === 'casting' && castingSpell === 'shield')
 	{
-		return {move: {x: 0, y: 0}};
+		{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
 	}
 
 	if (shouldStartShield)
 	{
-		if (state.state === 'casting') return {move: {x: 0, y: 0}, cancel: true};
-		if (state.state === 'idle')
+		if (status === 'casting') return cancel();
+		if (status === 'idle')
 		{
-			return {move: {x: 0, y: 0}, startCast: {spell: 'shield'}};
+			return shield();
 		}
 	}
 
 	if (
-		state.state === 'idle' &&
+		status === 'idle' &&
     urgentThreat &&
-    urgentThreat.ticksToImpact < SHIELD_CAST_TIME + SHIELD_BUFFER &&
+    urgentThreat.ticksToImpact < RULES.SHIELD_CAST_TIME + SHIELD_BUFFER &&
     urgentThreat.ticksToImpact >= 10 &&
-    state.blinkCooldown === 0
+    blinkCooldown === 0
 	)
 	{
-		return {
-			move: {x: 0, y: 0},
-			startCast: {spell: 'blink', target: getBlinkToCenter(state.position)},
-		};
+		return blink(getBlinkToCenter(position).x, getBlinkToCenter(position).y);
 	}
 
 	// Two-tier offense: big missile when safe, fast missile otherwise.
 	// Same speed/turnRate/duration → no warmup switching penalty.
-	if (state.state === 'idle' && enemy)
+	if (status === 'idle' && enemy)
 	{
 		const FAST_MISSILE = {damage: 12, speed: 5, turnRate: 1, duration: 180};
 		const BIG_MISSILE = {damage: 20, speed: 5, turnRate: 1, duration: 180};
 
 		const nextThreatTime = urgentThreat?.ticksToImpact ?? Infinity;
 
-		const bigCast = getMissileCastTime(BIG_MISSILE, state.lastMissileConfig);
-		const bigWindow = bigCast + GCD_DURATION + SHIELD_CAST_TIME + SHIELD_BUFFER;
+		const bigCast = getMissileCastTime(BIG_MISSILE, lastMissileConfig);
+		const bigWindow = bigCast + RULES.GCD_DURATION + RULES.SHIELD_CAST_TIME + SHIELD_BUFFER;
 		if (!urgentThreat || nextThreatTime > bigWindow)
 		{
-			return {
-				move: {x: 0, y: 0},
-				startCast: {
-					spell: 'missile',
-					config: BIG_MISSILE,
-					missileAI: ({worldState}): MissileActions => ({
-						turnToward: worldState.enemies[0]?.position,
-					}),
-					direction: angleTo(state.position, enemy.position),
-				},
-			};
+			return missile(BIG_MISSILE, () => 
+			{
+				const ctx = getMissileContext();
+				const e = ctx.worldState.enemies[0];
+				return e ? turnToward(e.position.x, e.position.y) : flyStraight();
+			}, angleTo(position, enemy.position)).move(keepOffWalls(position).x, keepOffWalls(position).y);
 		}
 
-		const fastCast = getMissileCastTime(FAST_MISSILE, state.lastMissileConfig);
-		const fastWindow = fastCast + GCD_DURATION + SHIELD_CAST_TIME + SHIELD_BUFFER;
+		const fastCast = getMissileCastTime(FAST_MISSILE, lastMissileConfig);
+		const fastWindow = fastCast + RULES.GCD_DURATION + RULES.SHIELD_CAST_TIME + SHIELD_BUFFER;
 		if (!urgentThreat || nextThreatTime > fastWindow)
 		{
-			return {
-				move: {x: 0, y: 0},
-				startCast: {
-					spell: 'missile',
-					config: FAST_MISSILE,
-					missileAI: ({worldState}): MissileActions => ({
-						turnToward: worldState.enemies[0]?.position,
-					}),
-					direction: angleTo(state.position, enemy.position),
-				},
-			};
+			return missile(FAST_MISSILE, () => 
+			{
+				const ctx = getMissileContext();
+				const e = ctx.worldState.enemies[0];
+				return e ? turnToward(e.position.x, e.position.y) : flyStraight();
+			}, angleTo(position, enemy.position)).move(keepOffWalls(position).x, keepOffWalls(position).y);
 		}
 	}
 
-	return {move: {x: 0, y: 0}};
-};
+	{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
+}