ark-stronghold-protocol/test/render/feedback2-enemy-attack-clip.test.js

// test/render/feedback2-enemy-attack-clip.test.js — GitHub #58, client side: an enemy plays its attack clip once per
// attack at the clip's own speed (faster only when the attacks come quicker than the clip) and then its resting clip —
// Move while the sim walks it again (server/sim/ai.js attackStand stands it for exactly that clip). It used to stretch
// the clip over the whole attack interval and loop it for 1.4 intervals, so a ranged enemy seemed to slide while it
// attacked. Operators retain rhythm scaling but stop after each attack (#506). Headless fake PIXI.

import { test, before, after } from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync } from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { installFakePixi, fakeViewCtx } from './fakepixi.js';
import { presetCamera } from '../../public/js/render/projection.js';
import { ANIM } from '../../shared/constants.js';

const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
const assets = JSON.parse(readFileSync(path.join(ROOT, 'data/assets.json'), 'utf8'));
const JSHOOT = 'enemy_1019_jshoot';   // 隐形弩手: Attack 1.0 s, strike at 0.533 s; attacks every 2.7 s

let fake, SpineActor, UnitView;
before(async () => {
  fake = installFakePixi();
  ({ SpineActor } = await import('../../public/js/render/spine.js'));
  ({ UnitView } = await import('../../public/js/render/units.js'));
});
after(() => fake.restore());

const entryOf = (id) => assets.enemies[id].spine;
const dataOf = (entry) => ({ animations: Object.keys(entry.animations).map((name) => ({ name })) });
function actor(id, perAttack) {
  const entry = entryOf(id);
  const a = new SpineActor(dataOf(entry), entry);
  a.clipPerAttack = perAttack;
  a.setBase('move');
  return a;
}
const track = (a) => a.spine.state.tracks[0];
const run = (a, s, dt = 1 / 60) => { for (let t = 0; t < s - 1e-9; t += dt) a.update(dt); };

test('an enemy: wound up before the strike, the Attack clip plays once at its own speed, then Move again — no stretching over the interval', () => {
  const a = actor(JSHOOT, true);
  assert.equal(a.current, 'Move');
  assert.ok(a.windUp(2.7, 0.2), 'winds up 0.2 s before the strike');
  assert.equal(a.current, 'Attack');
  assert.equal(track(a).loop, false, 'one clip per attack');
  run(a, 0.2);
  a.attack(2.7);
  assert.equal(track(a).timeScale, 1, 'its own speed (the 2.7 s interval used to slow it to 0.37)');
  run(a, 0.45);
  assert.equal(a.current, 'Attack', 'the clip plays to its end (0.467 s after the strike)');
  run(a, 0.05);
  assert.equal(a.current, 'Move', 'then walks on its Move clip (it used to hold the attack for 1.4 intervals: 3.8 s)');
  // the next attack starts the clip anew
  run(a, 1.5);
  assert.ok(a.windUp(2.7, 0.3));
  assert.equal(a.current, 'Attack');
  run(a, 0.3);
  a.attack(2.7);
  run(a, 0.5);
  assert.equal(a.current, 'Move');
});

test('an enemy attacking quicker than its clip plays it faster, one clip per attack; an attack seen late starts on the strike frame', () => {
  const a = actor(JSHOOT, true);
  a.attack(0.5);                                   // no wind-up seen: from the strike frame, at 1.0 / 0.5 = 2×
  assert.equal(a.current, 'Attack');
  assert.equal(track(a).loop, false);
  assert.equal(track(a).timeScale, 2);
  assert.ok(Math.abs(track(a).trackTime - 0.533) < 1e-9, 'on the strike frame');
  run(a, 0.25);
  assert.equal(a.current, 'Move', 'the rest of the clip at 2×: 0.23 s');
});

// #246 (by @TsangAsuna, accepted by the owner on 2026-10-07): seen late, an attack whose rhythm leaves room for the whole
// clip plays it complete from the wind-up — 重犯's iron ball lifts before the slam instead of the slam appearing alone
test('an attack seen late plays the whole clip from its wind-up when the rhythm leaves room for it (重犯), else from the strike frame', () => {
  const LIFBOS = 'enemy_1121_lifbos';   // 重犯: Attack_grey 2.333 s, strike at 1.0 s; attacks every 3 s
  const a = actor(LIFBOS, true);
  a.attack(3);
  assert.equal(a.current, 'Attack_grey');
  assert.equal(track(a).trackTime, 0, 'from the wind-up (the ball lifts), not the 1.0 s strike frame');
  assert.equal(track(a).timeScale, 1, 'at its own speed');
  run(a, 2.25);
  assert.equal(a.current, 'Attack_grey', 'the whole 2.333 s clip plays (it used to end 1.333 s after the strike frame)');
  run(a, 0.15);
  assert.equal(a.current, 'Move_grey', 'then the resting clip');
  const quick = actor(LIFBOS, true);
  quick.attack(2);                                 // quicker than the clip: no room for the wind-up
  assert.ok(Math.abs(track(quick).trackTime - 1) < 1e-9, 'from the strike frame');
  const op = actor(LIFBOS, false);
  op.attack(3);                                    // late operator events still start at the strike frame
  assert.ok(Math.abs(track(op).trackTime - 1) < 1e-9);
});

test('an operator keeps rhythm scaling but stops after this attack recovery instead of swinging twice', () => {
  const a = actor(JSHOOT, false);
  a.attack(2.7);
  assert.equal(track(a).loop, false);
  assert.ok(Math.abs(track(a).timeScale - 1 / 2.7) < 1e-9);
  run(a, 2);
  assert.equal(a.current, 'Move', 'no second swing without a second actual attack');
  assert.ok(a.windUp(2.7, 0.2)); run(a, 0.2); const prepared = track(a);
  a.attack(2.7); assert.equal(track(a), prepared, 'consume the prepared attack without replaying it');
  assert.equal(track(a).loop, false); run(a, 2); assert.equal(a.current, 'Move');
});

test('operator attacks with no look-ahead restart once each, including attacks faster than recovery', () => {
  const a = actor(JSHOOT, false);
  a.attack(0.08); const first = track(a); run(a, 0.08);
  a.attack(0.08); assert.notEqual(track(a), first, 'the next real attack starts a new clip');
  assert.equal(track(a).loop, false); run(a, 0.4); assert.equal(a.current, 'Move');
  a.windUp(0.08, 0.02); run(a, 0.02); a.attack(0.08); run(a, 0.02);
  assert.ok(a.windUp(0.08, 0.02), 'the next queued attack can interrupt the preceding recovery');
});

test('Provence: one real attack has one visual clip across slow/fast rhythms; late events keep the strike frame', () => {
  const entry = assets.chars.char_145_prove.spine.front;
  for (const interval of [0.08, 1.6, 8]) {
    const a = new SpineActor(dataOf(entry), entry);
    const clip = entry.anims.attack.loop, hit = entry.hits[clip][0];
    a.attack(interval);
    assert.equal(track(a).loop, false); assert.equal(track(a).trackTime, hit);
    run(a, interval + 4); assert.notEqual(a.current, clip, 'no extra swing without an attack');
    assert.ok(a.windUp(interval, 0.1)); run(a, 0.1); const prepared = track(a);
    a.attack(interval); assert.equal(track(a), prepared); assert.equal(track(a).loop, false);
    run(a, interval + 4); assert.notEqual(a.current, clip);
    a.destroy();
  }
});

test('real Spine timeline: batched wind-up updates retain operator hit-phase correction', async () => {
  const { AnimationState, AnimationStateData, SkeletonData, Skeleton, Animation } = await import('@pixi-spine/runtime-3.8');
  const FakeSpine = fake.P.spine.Spine;
  fake.P.spine.Spine = class extends FakeSpine {
    constructor(data) { super(data); this.skeleton = new Skeleton(data); this.stateData = new AnimationStateData(data); this.state = new AnimationState(this.stateData); }
    update(dt) { this.state.update(dt); this.state.apply(this.skeleton); }
  };
  try {
    const entry = assets.chars.char_145_prove.spine.front;
    for (const dt of [1 / 60, 1 / 15, 0.1, 0.2]) {
      const data = new SkeletonData(); data.animations = Object.entries(entry.animations).map(([name, duration]) => new Animation(name, [], duration));
      const a = new SpineActor(data, entry);
      assert.ok(a.windUp(1.6, 0.2)); run(a, 0.2, dt); const prepared = track(a);
      a.attack(1.6);
      const hit = entry.hits[entry.anims.attack.loop][0];
      assert.ok(Math.abs(hit - track(a).trackTime) / track(a).timeScale <= 0.065, `dt ${dt}: the prepared strike must stay near the real attack`);
      assert.equal(track(a), prepared); assert.equal(track(a).loop, false);
      run(a, 3); assert.notEqual(a.current, entry.anims.attack.loop); a.destroy();
    }
  } finally { fake.P.spine.Spine = FakeSpine; }
});

test('UnitView: enemy models retain clipPerAttack speed rules; operators retain rhythm scaling', async () => {
  const entry = entryOf(JSHOOT);
  const store = { picture: () => null, image: async () => null, spineEntry: () => entry, spine: { acquire: async () => dataOf(entry), release() {} } };
  const cam = () => presetCamera('normal', { width: 1280, height: 720 });
  const tick = () => new Promise((r) => setImmediate(r));
  const make = async (side) => {
    const v = new UnitView(fakeViewCtx(fake.P, { assets: store, cam }), { id: side === 'enemy' ? 7 : 8, side, kind: side === 'enemy' ? 'enemy' : 'op', defId: JSHOOT, spine: JSHOOT, tier: 1, x: 8, y: 9, maxHp: 1000, facing: -1 });
    await tick(); await tick();
    assert.ok(v.actor, 'model built');
    return v;
  };
  const e = await make('enemy');
  assert.equal(e.actor.clipPerAttack, true);
  e.sync({ x: 8, y: 9, hp: 1000, maxHp: 1000, sp: 0, spMax: 0, flags: 0, anim: ANIM.MOVE, vx: 0 }, 1);
  e.onAttack(null, 1);
  assert.equal(e.actor.current, 'Attack');
  assert.equal(e.actor.spine.state.tracks[0].loop, false);
  const o = await make('ally');
  assert.equal(o.actor.clipPerAttack, false);
});