@vibemancer/core 0.1.0

package/dist/index-browser.js

@@ -0,0 +1,407 @@
+import {
+  ALL_BOTS,
+  ARENA_HEIGHT,
+  ARENA_SIZE,
+  ARENA_WATER_BUFFER,
+  ARENA_WIDTH,
+  Archlich,
+  Archmage,
+  BLINK_CAST_TIME,
+  BLINK_COOLDOWN,
+  BLINK_MAX_COOLDOWN,
+  BLINK_MAX_RANGE,
+  BLINK_MIN_COOLDOWN,
+  BLINK_RANGE,
+  BOT_GROUPS,
+  Battlemage,
+  Bonemancer,
+  BrowserManualMatchSandbox,
+  BrowserMatchSandbox,
+  CASTING_MOVEMENT_MULT,
+  COLLISION_RADIUS,
+  Critter,
+  Doombringer,
+  ENGINE_VERSION,
+  FIGHT_SPAWN_DISTANCES,
+  Flamecaller,
+  GCD_DURATION,
+  Golem,
+  Hogger,
+  Infernalist,
+  Lich,
+  MATCH_DURATION,
+  MAX_HEALTH,
+  MISSILE_BASE_CAST,
+  MISSILE_BASE_RADIUS,
+  MISSILE_DAMAGE_POWER,
+  MISSILE_DAMAGE_RADIUS_SCALE,
+  MISSILE_DAMAGE_SCALE,
+  MISSILE_HOMING_COEFF,
+  MISSILE_MIN_CAST_TIME,
+  MISSILE_MIN_DAMAGE,
+  MISSILE_MIN_DURATION,
+  MISSILE_MIN_SPEED,
+  MISSILE_RADIUS_PER_DAMAGE,
+  MISSILE_SPEED_DURATION_BASELINE,
+  MISSILE_SPEED_DURATION_COEFF,
+  MISSILE_TURN_DURATION_COEFF,
+  MOVEMENT_SPEED,
+  MOVE_SPEED,
+  ManualMatch,
+  Nightblade,
+  Pyromancer,
+  Rookie,
+  SHIELD_CAST_TIME,
+  SHIELD_DECAY_PER_SECOND,
+  SHIELD_DECAY_RATE,
+  SHIELD_MAX_BLOCK,
+  SHIELD_MAX_STRENGTH,
+  SHIELD_MIN_BLOCK,
+  SHIELD_MIN_STRENGTH,
+  SPAWN_DISTANCE,
+  Sentinel,
+  Shadowblade,
+  Spellbinder,
+  Spellseeker,
+  Spellshot,
+  Spellspinner,
+  Spelltracer,
+  Spellweaver,
+  Stormcaller,
+  Stormchaser,
+  Stormforger,
+  TICKS_PER_SECOND,
+  TICK_DURATION_MS,
+  TargetDummy,
+  Turtle,
+  Voidblade,
+  WARMUP_DURATION_TOLERANCE,
+  WARMUP_MAX_BONUS,
+  WARMUP_MAX_PENALTY,
+  WARMUP_SPEED_TOLERANCE,
+  WARMUP_TURN_TOLERANCE,
+  WIZARD_HEALTH,
+  WIZARD_RADIUS,
+  Warmage,
+  analyzeThreats,
+  angleDiff,
+  angleInRange,
+  angleTo,
+  antiHomingMissile,
+  applyDamage,
+  blink,
+  browserSandboxFight,
+  browserSandboxSimulate,
+  calculateBlinkCooldown,
+  calculateMissileCastTime,
+  calculateMissileRadius,
+  calculateMissileSimilarity,
+  calculateShieldBlock,
+  calculateWarmupMultiplier,
+  cancel,
+  cancelCast,
+  clampPositionToArena,
+  clampToArena,
+  clearHooks,
+  clearParamValues,
+  completeCast,
+  createEntitySeed,
+  createInitialState,
+  createRandom,
+  createWorkerScript,
+  diagnoseTrace,
+  directionAway,
+  directionTo,
+  distanceTo,
+  effectiveTurnRateCost,
+  extractAction,
+  extractStats,
+  extractTraceEvents,
+  fight,
+  findInRange,
+  findNearest,
+  fitMissileToBudget,
+  formatDiagnosis,
+  formatStats,
+  formatTraceEvents,
+  formatTraceSummary,
+  generateCandidates,
+  generateCombos,
+  getAdaptiveMissileConfig,
+  getBotContext,
+  getEffectiveRange,
+  getLeadPosition,
+  getMissileCastTime,
+  getPlayerState,
+  hashCombine,
+  homingMissile,
+  idle,
+  inRange,
+  interceptAngle,
+  isNewStyleBot,
+  magnitude,
+  missile,
+  move,
+  moveInDirection,
+  moveProjectile,
+  moveWizard,
+  narrowRange,
+  nextRandom,
+  normalize,
+  normalizeAngle,
+  predictPosition,
+  resetAllHooks,
+  resolveWizardCollision,
+  runBotWithContext,
+  runWithHooks,
+  scoreFight,
+  scoreFightAsWizard2,
+  seekerMissile,
+  setParamValues,
+  shield,
+  simulate,
+  sortByDistance,
+  spiralMissile,
+  startCast,
+  startDiscovery,
+  stopDiscovery,
+  straightMissile,
+  summarizeTrace,
+  sweptCircleCollision,
+  testBot,
+  tick,
+  updateShield,
+  useArenaSize,
+  useBlinkCooldown,
+  useCastProgress,
+  useCastingSpell,
+  useClosestThreat,
+  useDamageDealt,
+  useDamageTaken,
+  useEffect,
+  useEnemy,
+  useHealth,
+  useLastHitTick,
+  useMemo,
+  useMyProjectiles,
+  useMyThreatsToEnemy,
+  useParam,
+  usePosition,
+  useRef,
+  useShieldStrength,
+  useState,
+  useStatus,
+  useThreats,
+  useTick,
+  useTicksUntilReady,
+  useVelocity,
+  validateHookCall,
+  validateMissileConfig,
+  withBotContext,
+  wrapNewBot,
+  wrapWithParams
+} from "./chunk-L7Z7OFXD.js";
+export {
+  ALL_BOTS,
+  ARENA_HEIGHT,
+  ARENA_SIZE,
+  ARENA_WATER_BUFFER,
+  ARENA_WIDTH,
+  Archlich,
+  Archmage,
+  BLINK_CAST_TIME,
+  BLINK_COOLDOWN,
+  BLINK_MAX_COOLDOWN,
+  BLINK_MAX_RANGE,
+  BLINK_MIN_COOLDOWN,
+  BLINK_RANGE,
+  BOT_GROUPS,
+  Battlemage,
+  Bonemancer,
+  BrowserManualMatchSandbox,
+  BrowserMatchSandbox,
+  CASTING_MOVEMENT_MULT,
+  COLLISION_RADIUS,
+  Critter,
+  Doombringer,
+  ENGINE_VERSION,
+  FIGHT_SPAWN_DISTANCES,
+  Flamecaller,
+  GCD_DURATION,
+  Golem,
+  Hogger,
+  Infernalist,
+  Lich,
+  MATCH_DURATION,
+  MAX_HEALTH,
+  MISSILE_BASE_CAST,
+  MISSILE_BASE_RADIUS,
+  MISSILE_DAMAGE_POWER,
+  MISSILE_DAMAGE_RADIUS_SCALE,
+  MISSILE_DAMAGE_SCALE,
+  MISSILE_HOMING_COEFF,
+  MISSILE_MIN_CAST_TIME,
+  MISSILE_MIN_DAMAGE,
+  MISSILE_MIN_DURATION,
+  MISSILE_MIN_SPEED,
+  MISSILE_RADIUS_PER_DAMAGE,
+  MISSILE_SPEED_DURATION_BASELINE,
+  MISSILE_SPEED_DURATION_COEFF,
+  MISSILE_TURN_DURATION_COEFF,
+  MOVEMENT_SPEED,
+  MOVE_SPEED,
+  ManualMatch,
+  Nightblade,
+  Pyromancer,
+  Rookie,
+  SHIELD_CAST_TIME,
+  SHIELD_DECAY_PER_SECOND,
+  SHIELD_DECAY_RATE,
+  SHIELD_MAX_BLOCK,
+  SHIELD_MAX_STRENGTH,
+  SHIELD_MIN_BLOCK,
+  SHIELD_MIN_STRENGTH,
+  SPAWN_DISTANCE,
+  Sentinel,
+  Shadowblade,
+  Spellbinder,
+  Spellseeker,
+  Spellshot,
+  Spellspinner,
+  Spelltracer,
+  Spellweaver,
+  Stormcaller,
+  Stormchaser,
+  Stormforger,
+  TICKS_PER_SECOND,
+  TICK_DURATION_MS,
+  TargetDummy,
+  Turtle,
+  Voidblade,
+  WARMUP_DURATION_TOLERANCE,
+  WARMUP_MAX_BONUS,
+  WARMUP_MAX_PENALTY,
+  WARMUP_SPEED_TOLERANCE,
+  WARMUP_TURN_TOLERANCE,
+  WIZARD_HEALTH,
+  WIZARD_RADIUS,
+  Warmage,
+  analyzeThreats,
+  angleDiff,
+  angleInRange,
+  angleTo,
+  antiHomingMissile,
+  applyDamage,
+  blink,
+  browserSandboxFight,
+  browserSandboxSimulate,
+  calculateBlinkCooldown,
+  calculateMissileCastTime,
+  calculateMissileRadius,
+  calculateMissileSimilarity,
+  calculateShieldBlock,
+  calculateWarmupMultiplier,
+  cancel,
+  cancelCast,
+  clampPositionToArena,
+  clampToArena,
+  clearHooks,
+  clearParamValues,
+  completeCast,
+  createEntitySeed,
+  createInitialState,
+  createRandom,
+  createWorkerScript,
+  diagnoseTrace,
+  directionAway,
+  directionTo,
+  distanceTo,
+  effectiveTurnRateCost,
+  extractAction,
+  extractStats,
+  extractTraceEvents,
+  fight,
+  findInRange,
+  findNearest,
+  fitMissileToBudget,
+  formatDiagnosis,
+  formatStats,
+  formatTraceEvents,
+  formatTraceSummary,
+  generateCandidates,
+  generateCombos,
+  getAdaptiveMissileConfig,
+  getBotContext,
+  getEffectiveRange,
+  getLeadPosition,
+  getMissileCastTime,
+  getPlayerState,
+  hashCombine,
+  homingMissile,
+  idle,
+  inRange,
+  interceptAngle,
+  isNewStyleBot,
+  magnitude,
+  missile,
+  move,
+  moveInDirection,
+  moveProjectile,
+  moveWizard,
+  narrowRange,
+  nextRandom,
+  normalize,
+  normalizeAngle,
+  predictPosition,
+  resetAllHooks,
+  resolveWizardCollision,
+  runBotWithContext,
+  runWithHooks,
+  scoreFight,
+  scoreFightAsWizard2,
+  seekerMissile,
+  setParamValues,
+  shield,
+  simulate,
+  sortByDistance,
+  spiralMissile,
+  startCast,
+  startDiscovery,
+  stopDiscovery,
+  straightMissile,
+  summarizeTrace,
+  sweptCircleCollision,
+  testBot,
+  tick,
+  updateShield,
+  useArenaSize,
+  useBlinkCooldown,
+  useCastProgress,
+  useCastingSpell,
+  useClosestThreat,
+  useDamageDealt,
+  useDamageTaken,
+  useEffect,
+  useEnemy,
+  useHealth,
+  useLastHitTick,
+  useMemo,
+  useMyProjectiles,
+  useMyThreatsToEnemy,
+  useParam,
+  usePosition,
+  useRef,
+  useShieldStrength,
+  useState,
+  useStatus,
+  useThreats,
+  useTick,
+  useTicksUntilReady,
+  useVelocity,
+  validateHookCall,
+  validateMissileConfig,
+  withBotContext,
+  wrapNewBot,
+  wrapWithParams
+};
+//# sourceMappingURL=index-browser.js.map

package/dist/index-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+import { FightResult, SimulateResult } from './index-browser.js';
+export { ALL_BOTS, ARENA_HEIGHT, ARENA_SIZE, ARENA_WATER_BUFFER, ARENA_WIDTH, ActionBuilder, AnalyzedThreat, AntiHomingParams, Archlich, Archmage, BLINK_CAST_TIME, BLINK_COOLDOWN, BLINK_MAX_COOLDOWN, BLINK_MAX_RANGE, BLINK_MIN_COOLDOWN, BLINK_RANGE, BOT_GROUPS, Battlemage, Bonemancer, BotContext, BotEntry, BotError, BotFunction, BotGroup, BrowserManualMatchSandbox, BrowserMatchSandbox, BrowserSandboxOptions, CASTING_MOVEMENT_MULT, COLLISION_RADIUS, Critter, Doombringer, ENGINE_VERSION, EnemyState, FIGHT_SPAWN_DISTANCES, FightStats, FightWinner, FinalAction, Flamecaller, GCD_DURATION, GameConfig, GameState, Golem, Hogger, HomingParams, HookState, Infernalist, InternalWizardState, Lich, MATCH_DURATION, MAX_HEALTH, MISSILE_BASE_CAST, MISSILE_BASE_RADIUS, MISSILE_DAMAGE_POWER, MISSILE_DAMAGE_RADIUS_SCALE, MISSILE_DAMAGE_SCALE, MISSILE_HOMING_COEFF, MISSILE_MIN_CAST_TIME, MISSILE_MIN_DAMAGE, MISSILE_MIN_DURATION, MISSILE_MIN_SPEED, MISSILE_RADIUS_PER_DAMAGE, MISSILE_SPEED_DURATION_BASELINE, MISSILE_SPEED_DURATION_COEFF, MISSILE_TURN_DURATION_COEFF, MOVEMENT_SPEED, MOVE_SPEED, ManualMatch, ManualMatchInitOptions, ManualMatchOptions, ManualMatchStepRequest, MatchWinner, MissileAIFunction, MissileActions, MissileConfig, MissileTemplate, Nightblade, ParamDeclaration, Position, ProjectileState, Pyromancer, RefObject, Rookie, SHIELD_CAST_TIME, SHIELD_DECAY_PER_SECOND, SHIELD_DECAY_RATE, SHIELD_MAX_BLOCK, SHIELD_MAX_STRENGTH, SHIELD_MIN_BLOCK, SHIELD_MIN_STRENGTH, SPAWN_DISTANCE, SeekerParams, Sentinel, Shadowblade, Spellbinder, Spellseeker, Spellshot, Spellspinner, Spelltracer, Spellweaver, SpiralParams, StepResult, Stormcaller, Stormchaser, Stormforger, StraightParams, TICKS_PER_SECOND, TICK_DURATION_MS, TargetDummy, TestBotBuilder, TestFightResult, TestSimulateResult, TraceBotSummary, TraceEvent, TraceEventType, TraceSummary, Turtle, Velocity, Voidblade, WARMUP_DURATION_TOLERANCE, WARMUP_MAX_BONUS, WARMUP_MAX_PENALTY, WARMUP_SPEED_TOLERANCE, WARMUP_TURN_TOLERANCE, WIZARD_HEALTH, WIZARD_RADIUS, Warmage, WizardActions, WizardFunction, WizardState, WorkerFactory, WorkerLike, analyzeThreats, angleDiff, angleInRange, angleTo, antiHomingMissile, applyDamage, blink, browserSandboxFight, browserSandboxSimulate, calculateBlinkCooldown, calculateMissileCastTime, calculateMissileRadius, calculateMissileSimilarity, calculateShieldBlock, calculateWarmupMultiplier, cancel, cancelCast, clampPositionToArena, clampToArena, clearHooks, clearParamValues, completeCast, createEntitySeed, createInitialState, createRandom, createWorkerScript, diagnoseTrace, directionAway, directionTo, distanceTo, effectiveTurnRateCost, extractAction, extractStats, extractTraceEvents, fight, findInRange, findNearest, fitMissileToBudget, formatDiagnosis, formatStats, formatTraceEvents, formatTraceSummary, generateCandidates, generateCombos, getAdaptiveMissileConfig, getBotContext, getEffectiveRange, getLeadPosition, getMissileCastTime, getPlayerState, hashCombine, homingMissile, idle, inRange, interceptAngle, isNewStyleBot, magnitude, missile, move, moveInDirection, moveProjectile, moveWizard, narrowRange, nextRandom, normalize, normalizeAngle, predictPosition, resetAllHooks, resolveWizardCollision, runBotWithContext, runWithHooks, scoreFight, scoreFightAsWizard2, seekerMissile, setParamValues, shield, simulate, sortByDistance, spiralMissile, startCast, startDiscovery, stopDiscovery, straightMissile, summarizeTrace, sweptCircleCollision, testBot, tick, updateShield, useArenaSize, useBlinkCooldown, useCastProgress, useCastingSpell, useClosestThreat, useDamageDealt, useDamageTaken, useEffect, useEnemy, useHealth, useLastHitTick, useMemo, useMyProjectiles, useMyThreatsToEnemy, useParam, usePosition, useRef, useShieldStrength, useState, useStatus, useThreats, useTick, useTicksUntilReady, useVelocity, validateHookCall, validateMissileConfig, withBotContext, wrapNewBot, wrapWithParams } from './index-browser.js';
+
+/**
+ * A compiled bot ready for sandboxed execution.
+ * Stores the source path and export name — actual compilation
+ * happens when creating a MatchSandbox or calling compileMatchBundle.
+ */
+declare class BotBundle {
+    readonly sourcePath: string;
+    readonly exportName: string;
+    constructor(sourcePath: string, exportName: string);
+}
+/**
+ * Options for esbuild compilation. Allows the caller to add esbuild
+ * aliases (e.g., resolving @vibemancer/core to the TypeScript source).
+ */
+interface CompileOptions {
+    /** Additional esbuild alias entries (e.g., {'@vibemancer/core': '/path/to/src/index.ts'}). */
+    alias?: Record<string, string>;
+    /** Additional modules to treat as external (not bundled). */
+    external?: string[];
+}
+/**
+ * Compile a match bundle using esbuild. Bundles both bots + simulation engine
+ * into a single self-contained IIFE with prototype freezing banner.
+ *
+ * No isolated-vm dependency — returns a plain JS string.
+ */
+declare function compileMatchBundle(bot1: BotBundle, bot2: BotBundle, options?: CompileOptions): Promise<string>;
+
+/**
+ * VIBEMANCER — SANDBOX
+ *
+ * Provides isolated-vm sandboxing for bot code execution. Both bots + the
+ * entire simulation engine run inside a single V8 isolate, so there is ZERO
+ * per-tick boundary crossing overhead. The only data crossing the boundary
+ * is fight/simulate options going in and results coming out.
+ *
+ * Architecture:
+ * - Host: creates isolate, loads compiled bundle, calls __fight/__simulate
+ * - Isolate: contains both bots + full simulation engine, runs fight/simulate
+ *
+ * Safety:
+ * - Memory limit (default 512 MB) catches memory bombs
+ * - Timeout (default 30s) catches infinite loops
+ * - Prototype freeze prevents cross-bot sabotage
+ * - platform: 'neutral' strips Node.js APIs (no fs/net/process)
+ */
+
+/**
+ * Options for sandbox creation.
+ */
+interface SandboxOptions {
+    /** Memory limit in MB for the isolate (default: 512). */
+    memoryLimitMB?: number;
+    /** Timeout in ms for fight/simulate calls (default: 30000). */
+    timeoutMs?: number;
+    /** Options passed to esbuild compilation (aliases, externals). */
+    compileOptions?: CompileOptions;
+}
+/**
+ * A sandboxed match runner. Both bots + the entire simulation engine run
+ * inside a single isolated-vm isolate.
+ *
+ * Usage:
+ * ```ts
+ * const sandbox = await MatchSandbox.create(botA, botB);
+ * const result = sandbox.fight({ seed: 42 });
+ * sandbox.dispose();
+ * ```
+ */
+declare class MatchSandbox {
+    private isolate;
+    private context;
+    private fightFn;
+    private simulateFn;
+    private timeout;
+    private disposed;
+    private constructor();
+    /**
+     * Create a sandbox with both bots loaded. Compiles the match bundle
+     * automatically using esbuild.
+     */
+    static create(bot1: BotBundle, bot2: BotBundle, options?: SandboxOptions): Promise<MatchSandbox>;
+    /**
+     * Create a sandbox from a pre-compiled bundle string.
+     * Useful for caching compiled bundles across multiple MatchSandbox instances.
+     */
+    static fromBundle(bundle: string, options?: SandboxOptions): Promise<MatchSandbox>;
+    /**
+     * Compile a match bundle without creating an isolate.
+     * Returns the compiled JS string for caching/reuse.
+     */
+    static compile(bot1: BotBundle, bot2: BotBundle, compileOptions?: CompileOptions): Promise<string>;
+    /**
+     * Run a full fight (10 matches: 5 spawn distances x 2 sides).
+     * Synchronous after isolate creation — runs entirely inside the isolate.
+     */
+    fight(options?: {
+        seed?: number;
+        maxTicks?: number;
+    }): FightResult;
+    /**
+     * Run a single simulation.
+     * Synchronous after isolate creation.
+     *
+     * @param options.params1 - useParam overrides for bot 1 (wizard-1)
+     * @param options.params2 - useParam overrides for bot 2 (wizard-2)
+     */
+    simulate(options?: {
+        seed?: number;
+        maxTicks?: number;
+        spawnDistance?: number;
+        skipHistory?: boolean;
+        params1?: Record<string, number>;
+        params2?: Record<string, number>;
+    }): SimulateResult;
+    /**
+     * Dispose the isolate and free all memory.
+     * The sandbox cannot be used after disposal.
+     */
+    dispose(): void;
+    /**
+     * Whether this sandbox has been disposed.
+     */
+    get isDisposed(): boolean;
+    private ensureNotDisposed;
+}
+/**
+ * One-shot sandboxed fight. Creates isolate, runs fight, disposes.
+ * Convenience wrapper for single-use scenarios.
+ */
+declare function sandboxFight(bot1: BotBundle, bot2: BotBundle, options?: {
+    seed?: number;
+    maxTicks?: number;
+} & SandboxOptions): Promise<FightResult>;
+/**
+ * One-shot sandboxed simulate. Creates isolate, runs simulate, disposes.
+ */
+declare function sandboxSimulate(bot1: BotBundle, bot2: BotBundle, options?: {
+    seed?: number;
+    maxTicks?: number;
+    spawnDistance?: number;
+    skipHistory?: boolean;
+    params1?: Record<string, number>;
+    params2?: Record<string, number>;
+} & SandboxOptions): Promise<SimulateResult>;
+
+export { BotBundle, type CompileOptions, FightResult, MatchSandbox, type SandboxOptions, SimulateResult, compileMatchBundle, sandboxFight, sandboxSimulate };