memlnaut-nisps/tests/solidjs/joystick.spec.ts
monkey-w1n5t0n 3c4e45aa5d feat(solidjs): implement joystick component with pointer events, input store, and follow mode
Build touch/mouse joystick component that tracks drag position as [0,1]
coordinates. Implements:
- Input store (src/stores/input-store.ts) with joyX/joyY signals
- Joystick component (src/components/input/Joystick.tsx) with canvas
  rendering, pointer events, and follow mode toggle
- Input clamping for out-of-range values (NaN, Infinity, negative, >1)
- Follow mode badge with pulse animation
- 12 e2e tests covering VAL-JOY-001, VAL-JOY-002, VAL-JOY-005

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2026-04-07 17:51:05 +02:00

342 lines
10 KiB
TypeScript

/**
* e2e tests for f06-joystick-component.
* Validates:
* VAL-JOY-001: Drag moves joystick position (joyX/joyY in [0,1], dot follows pointer)
* VAL-JOY-002: Follow mode activation (double-tap toggles follow mode)
* VAL-JOY-005: Input clamping (values outside [0,1] are clamped)
*
* Also verifies:
* - Input store is wired to ML store setInputs
* - Joystick dot follows pointer position
* - Follow mode persists across interactions
*/
import { test, expect } from '@playwright/test';
import { loadSolidApp } from './helpers';
test.describe('Joystick Component', () => {
// ─── VAL-JOY-001: Drag moves joystick position ───
test('VAL-JOY-001a: joystick canvas exists in the DOM', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
await expect(joystick).toBeVisible();
});
test('VAL-JOY-001b: drag on joystick updates joyX/joyY in [0,1]', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
const box = await joystick.boundingBox();
expect(box).not.toBeNull();
const { x, y, width, height } = box!;
// Drag to the center of the joystick canvas
const targetX = x + width * 0.75;
const targetY = y + height * 0.25;
await page.mouse.move(targetX, targetY);
await page.mouse.down();
await page.mouse.move(targetX, targetY);
await page.mouse.up();
// Check that the input store values are in [0,1]
const inputState = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return {
joyX: store.joyX(),
joyY: store.joyY(),
};
});
expect(inputState.joyX).toBeGreaterThanOrEqual(0);
expect(inputState.joyX).toBeLessThanOrEqual(1);
expect(inputState.joyY).toBeGreaterThanOrEqual(0);
expect(inputState.joyY).toBeLessThanOrEqual(1);
});
test('VAL-JOY-001c: drag to different positions produces different values', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
const box = await joystick.boundingBox();
expect(box).not.toBeNull();
const { x, y, width, height } = box!;
// Drag to top-left
await page.mouse.move(x + width * 0.2, y + height * 0.2);
await page.mouse.down();
await page.mouse.move(x + width * 0.2, y + height * 0.2);
await page.mouse.up();
const topLeft = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return { joyX: store.joyX(), joyY: store.joyY() };
});
// Drag to bottom-right
await page.mouse.move(x + width * 0.8, y + height * 0.8);
await page.mouse.down();
await page.mouse.move(x + width * 0.8, y + height * 0.8);
await page.mouse.up();
const bottomRight = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return { joyX: store.joyX(), joyY: store.joyY() };
});
// X should be higher in bottom-right drag
expect(bottomRight.joyX).toBeGreaterThan(topLeft.joyX);
// Y should be higher in bottom-right drag
expect(bottomRight.joyY).toBeGreaterThan(topLeft.joyY);
});
test('VAL-JOY-001d: drag updates setInputs on ML store', async ({ page }) => {
await loadSolidApp(page);
// Set to known position first
await page.evaluate(() => {
(window as any).__nisps.setInputs(0.5, 0.5);
});
const outputsBefore = await page.evaluate(() => {
return (window as any).__nisps.getOutputs().slice(0, 5);
});
const joystick = page.locator('#joystick');
const box = await joystick.boundingBox();
expect(box).not.toBeNull();
const { x, y, width, height } = box!;
// Drag to a different position
await page.mouse.move(x + width * 0.8, y + height * 0.3);
await page.mouse.down();
await page.mouse.move(x + width * 0.8, y + height * 0.3);
await page.mouse.up();
const outputsAfter = await page.evaluate(() => {
return (window as any).__nisps.getOutputs().slice(0, 5);
});
// At least one output should have changed
const changed = outputsBefore.some((v: number, i: number) =>
Math.abs(v - outputsAfter[i]) > 0.001
);
expect(changed).toBe(true);
});
// ─── VAL-JOY-002: Follow mode activation ───
test('VAL-JOY-002a: double-click on joystick toggles follow mode', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
// Check initial follow mode state
const initialFollow = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return store.followMode();
});
expect(initialFollow).toBe(false);
// Double-click to toggle follow mode
await joystick.dblclick();
const afterDblClick = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return store.followMode();
});
expect(afterDblClick).toBe(true);
// Double-click again to toggle back
await joystick.dblclick();
const afterSecondDblClick = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return store.followMode();
});
expect(afterSecondDblClick).toBe(false);
});
test('VAL-JOY-002b: follow badge appears when follow mode is active', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
// Double-click to toggle follow mode on
await joystick.dblclick();
// Check that the follow badge is visible
const badge = joystick.locator('.follow-badge');
await expect(badge).toBeVisible();
// Double-click again to turn off
await joystick.dblclick();
await expect(badge).not.toBeVisible();
});
// ─── VAL-JOY-005: Input clamping ───
test('VAL-JOY-005a: extreme negative values are clamped to [0,1]', async ({ page }) => {
await loadSolidApp(page);
const result = await page.evaluate(() => {
const probe = (window as any).__nisps;
probe.setInputs(-5, -10);
const outputs = probe.getOutputs();
return {
allBounded: outputs.every((v: number) => v >= 0 && v <= 1),
allFinite: outputs.every((v: number) => Number.isFinite(v)),
};
});
expect(result.allBounded).toBe(true);
expect(result.allFinite).toBe(true);
});
test('VAL-JOY-005b: extreme positive values are clamped to [0,1]', async ({ page }) => {
await loadSolidApp(page);
const result = await page.evaluate(() => {
const probe = (window as any).__nisps;
probe.setInputs(99, 100);
const outputs = probe.getOutputs();
return {
allBounded: outputs.every((v: number) => v >= 0 && v <= 1),
allFinite: outputs.every((v: number) => Number.isFinite(v)),
};
});
expect(result.allBounded).toBe(true);
expect(result.allFinite).toBe(true);
});
test('VAL-JOY-005c: NaN and Infinity are clamped to safe values', async ({ page }) => {
await loadSolidApp(page);
const result = await page.evaluate(() => {
const probe = (window as any).__nisps;
probe.setInputs(NaN, Infinity);
probe.setInputs(-Infinity, NaN);
const outputs = probe.getOutputs();
return {
allBounded: outputs.every((v: number) => v >= 0 && v <= 1),
allFinite: outputs.every((v: number) => Number.isFinite(v)),
};
});
expect(result.allBounded).toBe(true);
expect(result.allFinite).toBe(true);
});
test('VAL-JOY-005d: normal values pass through via joystick position', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
const box = await joystick.boundingBox();
expect(box).not.toBeNull();
const { x, y, width, height } = box!;
// Drag to a specific known position (75% right, 25% down)
const targetX = x + width * 0.75;
const targetY = y + height * 0.25;
await page.mouse.move(targetX, targetY);
await page.mouse.down();
await page.mouse.move(targetX, targetY);
await page.mouse.up();
const result = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return {
joyX: store.joyX(),
joyY: store.joyY(),
};
});
// Values should be in [0,1] and reflect the drag position
expect(result.joyX).toBeGreaterThanOrEqual(0);
expect(result.joyX).toBeLessThanOrEqual(1);
expect(result.joyY).toBeGreaterThanOrEqual(0);
expect(result.joyY).toBeLessThanOrEqual(1);
// Position should be roughly where we dragged (not at center 0.5)
// X should be closer to 0.75, Y closer to 0.25
expect(result.joyX).toBeGreaterThan(0.5);
expect(result.joyY).toBeLessThan(0.5);
});
// ─── Pointer drag mechanics ───
test('dragging outside joystick bounds is clamped', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
const box = await joystick.boundingBox();
expect(box).not.toBeNull();
const { x, y, width, height } = box!;
// Start drag inside the joystick
await page.mouse.move(x + width * 0.5, y + height * 0.5);
await page.mouse.down();
// Move far outside to the left and up
await page.mouse.move(x - 100, y - 100);
await page.mouse.up();
const result = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return {
joyX: store.joyX(),
joyY: store.joyY(),
};
});
// Should be clamped to [0, 1]
expect(result.joyX).toBeGreaterThanOrEqual(0);
expect(result.joyX).toBeLessThanOrEqual(1);
expect(result.joyY).toBeGreaterThanOrEqual(0);
expect(result.joyY).toBeLessThanOrEqual(1);
});
test('dragging below-right of joystick is clamped', async ({ page }) => {
await loadSolidApp(page);
const joystick = page.locator('#joystick');
const box = await joystick.boundingBox();
expect(box).not.toBeNull();
const { x, y, width, height } = box!;
// Start drag inside the joystick
await page.mouse.move(x + width * 0.5, y + height * 0.5);
await page.mouse.down();
// Move far outside to the right and below
await page.mouse.move(x + width + 200, y + height + 200);
await page.mouse.up();
const result = await page.evaluate(() => {
const store = (window as any).__nispsInputStore;
return {
joyX: store.joyX(),
joyY: store.joyY(),
};
});
// Should be clamped to [0, 1]
expect(result.joyX).toBeGreaterThanOrEqual(0);
expect(result.joyX).toBeLessThanOrEqual(1);
expect(result.joyY).toBeGreaterThanOrEqual(0);
expect(result.joyY).toBeLessThanOrEqual(1);
});
});