269 lines
9.2 KiB
TypeScript
269 lines
9.2 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import { createSignController } from '@/journey/sign-controller';
|
|
import type { SignControllerSample } from '@/journey/types';
|
|
|
|
const sample = (
|
|
overrides: Partial<SignControllerSample> = {},
|
|
): SignControllerSample => ({
|
|
now: 0,
|
|
source: 'passive-scroll',
|
|
direction: 1,
|
|
acceleration: 0,
|
|
deltaY: 16,
|
|
viewportHeight: 800,
|
|
crossedBoundaries: 0,
|
|
candidateId: 'profile',
|
|
candidateDistanceVh: 1,
|
|
activeSectionId: 'start',
|
|
motionAllowed: true,
|
|
...overrides,
|
|
});
|
|
|
|
describe('clock-driven sign lifecycle', () => {
|
|
it('advances through exact anticipate, approach, dwell, depart, and cooldown timing', () => {
|
|
const controller = createSignController();
|
|
|
|
expect(controller.sample(sample())).toEqual({
|
|
targetId: 'profile',
|
|
phase: 'anticipate',
|
|
progress: 0,
|
|
opacity: 0,
|
|
});
|
|
expect(controller.needsFrame()).toBe(true);
|
|
expect(controller.sample(sample({ now: 299, direction: 0 }))).toMatchObject({
|
|
phase: 'anticipate',
|
|
progress: expect.closeTo(299 / 300, 10),
|
|
});
|
|
expect(controller.sample(sample({ now: 300, direction: 0 }))).toMatchObject({
|
|
phase: 'approach',
|
|
progress: 0,
|
|
});
|
|
expect(controller.sample(sample({ now: 1_200, direction: 0 }))).toMatchObject({
|
|
phase: 'dwell',
|
|
progress: 1,
|
|
opacity: 1,
|
|
});
|
|
expect(controller.sample(sample({ now: 2_599, direction: 0, activeSectionId: 'profile' }))).toMatchObject({
|
|
phase: 'dwell',
|
|
});
|
|
expect(controller.sample(sample({ now: 2_600, direction: 0, activeSectionId: 'profile' }))).toMatchObject({
|
|
phase: 'depart',
|
|
progress: 0,
|
|
opacity: 1,
|
|
});
|
|
expect(controller.sample(sample({ now: 3_299, direction: 0, activeSectionId: 'profile' }))).toMatchObject({
|
|
phase: 'depart',
|
|
progress: expect.closeTo(699 / 700, 10),
|
|
});
|
|
expect(controller.sample(sample({ now: 3_300, direction: 0, activeSectionId: 'profile' }))).toBeNull();
|
|
expect(controller.needsFrame()).toBe(false);
|
|
expect(controller.sample(sample({
|
|
now: 3_649,
|
|
candidateId: 'experience',
|
|
activeSectionId: 'profile',
|
|
}))).toBeNull();
|
|
expect(controller.sample(sample({
|
|
now: 3_650,
|
|
candidateId: 'experience',
|
|
activeSectionId: 'profile',
|
|
}))).toMatchObject({ targetId: 'experience', phase: 'anticipate' });
|
|
});
|
|
|
|
it('shortens approach continuously to 650ms at full acceleration', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample({ acceleration: 1 }));
|
|
|
|
expect(controller.sample(sample({ now: 300, direction: 0 }))).toMatchObject({
|
|
phase: 'approach',
|
|
progress: 0,
|
|
});
|
|
expect(controller.sample(sample({ now: 949, direction: 0 }))).toMatchObject({
|
|
phase: 'approach',
|
|
progress: expect.closeTo(649 / 650, 10),
|
|
});
|
|
expect(controller.sample(sample({ now: 950, direction: 0 }))).toMatchObject({
|
|
phase: 'dwell',
|
|
progress: 1,
|
|
});
|
|
});
|
|
|
|
it('holds a completed minimum dwell without scheduling idle frames until the target activates', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
controller.sample(sample({ now: 1_200, direction: 0 }));
|
|
|
|
expect(controller.sample(sample({ now: 2_600, direction: 0 }))).toMatchObject({ phase: 'dwell' });
|
|
expect(controller.needsFrame()).toBe(false);
|
|
expect(controller.sample(sample({ now: 4_000, activeSectionId: 'profile' }))).toMatchObject({
|
|
phase: 'depart',
|
|
progress: 0,
|
|
});
|
|
expect(controller.needsFrame()).toBe(true);
|
|
});
|
|
|
|
it('cancels a concealed sign on reverse and departs a visible approaching sign cleanly', () => {
|
|
const early = createSignController();
|
|
early.sample(sample());
|
|
expect(early.sample(sample({ now: 310, direction: -1, deltaY: -20 }))).toBeNull();
|
|
expect(early.needsFrame()).toBe(false);
|
|
|
|
const readable = createSignController();
|
|
readable.sample(sample());
|
|
expect(readable.sample(sample({ now: 700, direction: -1, deltaY: -20 }))).toMatchObject({
|
|
phase: 'depart',
|
|
progress: 0,
|
|
});
|
|
});
|
|
|
|
it('preserves the minimum readable dwell when reverse input requests departure', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
controller.sample(sample({ now: 1_200, direction: 0 }));
|
|
|
|
expect(controller.sample(sample({ now: 1_500, direction: -1, deltaY: -20 }))).toMatchObject({
|
|
phase: 'dwell',
|
|
});
|
|
expect(controller.sample(sample({ now: 2_599, direction: 0, deltaY: 0 }))).toMatchObject({
|
|
phase: 'dwell',
|
|
});
|
|
expect(controller.sample(sample({ now: 2_600, direction: 0, deltaY: 0 }))).toMatchObject({
|
|
phase: 'depart',
|
|
progress: 0,
|
|
});
|
|
});
|
|
|
|
it.each([
|
|
['explicit navigation', { source: 'explicit-navigation' as const }],
|
|
['history restoration', { source: 'history-restoration' as const }],
|
|
['initial positioning', { source: 'initial' as const }],
|
|
['disabled motion', { motionAllowed: false }],
|
|
])('suppresses or clears concealed signs for %s', (_label, overrides) => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
|
|
expect(controller.sample(sample({ now: 200, ...overrides }))).toBeNull();
|
|
expect(controller.needsFrame()).toBe(false);
|
|
});
|
|
|
|
it.each([
|
|
['multiple crossed sections', { crossedBoundaries: 2 }],
|
|
['a jump over 0.75 viewport heights', { deltaY: 601 }],
|
|
])('coalesces %s while preserving the readable dwell', (_label, overrides) => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
controller.sample(sample({ now: 1_200, direction: 0 }));
|
|
|
|
expect(controller.sample(sample({ now: 1_400, ...overrides }))).toMatchObject({
|
|
targetId: 'profile',
|
|
phase: 'dwell',
|
|
});
|
|
expect(controller.needsFrame()).toBe(true);
|
|
expect(controller.sample(sample({ now: 2_600, direction: 0, deltaY: 0 }))).toMatchObject({
|
|
targetId: 'profile',
|
|
phase: 'depart',
|
|
progress: 0,
|
|
opacity: 1,
|
|
});
|
|
});
|
|
|
|
it('departs when the authoritative section has already passed the latched target', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
|
|
expect(controller.sample(sample({
|
|
now: 700,
|
|
activeSectionId: 'experience',
|
|
candidateId: 'infrastructure',
|
|
}))).toMatchObject({
|
|
targetId: 'profile',
|
|
phase: 'depart',
|
|
progress: 0,
|
|
});
|
|
});
|
|
|
|
it('does not truncate dwell when the authoritative section passes the target', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
controller.sample(sample({ now: 1_200, direction: 0 }));
|
|
|
|
expect(controller.sample(sample({
|
|
now: 1_350,
|
|
direction: 1,
|
|
activeSectionId: 'experience',
|
|
candidateId: 'infrastructure',
|
|
}))).toMatchObject({ targetId: 'profile', phase: 'dwell' });
|
|
expect(controller.sample(sample({
|
|
now: 2_599,
|
|
direction: 0,
|
|
deltaY: 0,
|
|
activeSectionId: 'experience',
|
|
candidateId: 'infrastructure',
|
|
}))).toMatchObject({ phase: 'dwell' });
|
|
expect(controller.sample(sample({
|
|
now: 2_600,
|
|
direction: 0,
|
|
deltaY: 0,
|
|
activeSectionId: 'experience',
|
|
candidateId: 'infrastructure',
|
|
}))).toMatchObject({ phase: 'depart', progress: 0 });
|
|
});
|
|
|
|
it('retargets a changed far-away candidate only while the sign is concealed', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
|
|
expect(controller.sample(sample({
|
|
now: 100,
|
|
candidateId: 'experience',
|
|
}))).toMatchObject({
|
|
targetId: 'experience',
|
|
phase: 'anticipate',
|
|
progress: 0,
|
|
opacity: 0,
|
|
});
|
|
});
|
|
|
|
it('does not impose cooldown when an idle initial sample precedes real passive input', () => {
|
|
const controller = createSignController();
|
|
|
|
expect(controller.sample(sample({ source: 'initial' }))).toBeNull();
|
|
expect(controller.sample(sample({ now: 100 }))).toMatchObject({
|
|
targetId: 'profile',
|
|
phase: 'anticipate',
|
|
});
|
|
});
|
|
|
|
it.each([
|
|
['reverse input', { direction: -1 as const, deltaY: -1 }],
|
|
['stationary input', { direction: 0 as const, deltaY: 0 }],
|
|
['candidate before the approach window', { candidateDistanceVh: 1.200_001 }],
|
|
['candidate already passed', { candidateDistanceVh: 0 }],
|
|
['candidate is already active', { activeSectionId: 'profile' as const }],
|
|
['missing candidate', { candidateId: null }],
|
|
])('does not latch for %s', (_label, overrides) => {
|
|
const controller = createSignController();
|
|
expect(controller.sample(sample(overrides))).toBeNull();
|
|
});
|
|
|
|
it('keeps one target latched when the next candidate changes', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
|
|
expect(controller.sample(sample({
|
|
now: 600,
|
|
direction: 0,
|
|
candidateId: 'experience',
|
|
}))).toMatchObject({ targetId: 'profile', phase: 'approach' });
|
|
});
|
|
|
|
it('resets malformed samples to a finite idle state', () => {
|
|
const controller = createSignController();
|
|
controller.sample(sample());
|
|
|
|
expect(controller.sample(sample({ now: Number.NaN }))).toBeNull();
|
|
expect(controller.needsFrame()).toBe(false);
|
|
controller.reset();
|
|
expect(controller.sample(sample({ now: 100 }))).toMatchObject({ phase: 'anticipate' });
|
|
});
|
|
});
|