test(front): add test suite frontend (WIP)

client/tests/unit/hooks/usePlaceSelection.test.ts

@@ -0,0 +1,63 @@
+import { describe, it, expect } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { usePlaceSelection } from '../../../src/hooks/usePlaceSelection';
+
+// FE-HOOK-SEL-001 onwards
+
+describe('usePlaceSelection', () => {
+  it('FE-HOOK-SEL-001: initially both IDs are null', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    expect(result.current.selectedPlaceId).toBeNull();
+    expect(result.current.selectedAssignmentId).toBeNull();
+  });
+
+  it('FE-HOOK-SEL-002: setSelectedPlaceId sets selectedPlaceId', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    act(() => { result.current.setSelectedPlaceId(42); });
+    expect(result.current.selectedPlaceId).toBe(42);
+  });
+
+  it('FE-HOOK-SEL-003: setSelectedPlaceId clears selectedAssignmentId', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    // First set an assignment via selectAssignment
+    act(() => { result.current.selectAssignment(99, 10); });
+    expect(result.current.selectedAssignmentId).toBe(99);
+
+    // Now change the place — assignment must be cleared
+    act(() => { result.current.setSelectedPlaceId(20); });
+    expect(result.current.selectedPlaceId).toBe(20);
+    expect(result.current.selectedAssignmentId).toBeNull();
+  });
+
+  it('FE-HOOK-SEL-004: selectAssignment sets both selectedAssignmentId and selectedPlaceId', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    act(() => { result.current.selectAssignment(7, 3); });
+    expect(result.current.selectedAssignmentId).toBe(7);
+    expect(result.current.selectedPlaceId).toBe(3);
+  });
+
+  it('FE-HOOK-SEL-005: setSelectedPlaceId(null) resets selectedPlaceId to null and clears assignment', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    act(() => { result.current.selectAssignment(5, 1); });
+    act(() => { result.current.setSelectedPlaceId(null); });
+    expect(result.current.selectedPlaceId).toBeNull();
+    expect(result.current.selectedAssignmentId).toBeNull();
+  });
+
+  it('FE-HOOK-SEL-006: selectAssignment(null, null) clears both IDs', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    act(() => { result.current.selectAssignment(5, 1); });
+    act(() => { result.current.selectAssignment(null, null); });
+    expect(result.current.selectedAssignmentId).toBeNull();
+    expect(result.current.selectedPlaceId).toBeNull();
+  });
+
+  it('FE-HOOK-SEL-007: selecting a different place after an assignment clears the assignment', () => {
+    const { result } = renderHook(() => usePlaceSelection());
+    act(() => { result.current.selectAssignment(11, 5); });
+    // Switch to a different place without going through selectAssignment
+    act(() => { result.current.setSelectedPlaceId(99); });
+    expect(result.current.selectedPlaceId).toBe(99);
+    expect(result.current.selectedAssignmentId).toBeNull();
+  });
+});

client/tests/unit/hooks/usePlannerHistory.test.ts

@@ -0,0 +1,92 @@
+import { describe, it, expect, vi } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { usePlannerHistory } from '../../../src/hooks/usePlannerHistory';
+
+// FE-HOOK-HIST-001 onwards
+
+describe('usePlannerHistory', () => {
+  it('FE-HOOK-HIST-001: starts with canUndo=false and lastActionLabel=null', () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    expect(result.current.canUndo).toBe(false);
+    expect(result.current.lastActionLabel).toBeNull();
+  });
+
+  it('FE-HOOK-HIST-002: pushing an entry sets canUndo=true and lastActionLabel', () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    act(() => {
+      result.current.pushUndo('Delete place', vi.fn());
+    });
+    expect(result.current.canUndo).toBe(true);
+    expect(result.current.lastActionLabel).toBe('Delete place');
+  });
+
+  it('FE-HOOK-HIST-003: calling undo fires the undo function and sets canUndo=false', async () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    const undoFn = vi.fn();
+    act(() => {
+      result.current.pushUndo('Add place', undoFn);
+    });
+    await act(async () => {
+      await result.current.undo();
+    });
+    expect(undoFn).toHaveBeenCalledOnce();
+    expect(result.current.canUndo).toBe(false);
+  });
+
+  it('FE-HOOK-HIST-004: multiple entries stack in LIFO order', () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    act(() => {
+      result.current.pushUndo('First', vi.fn());
+      result.current.pushUndo('Second', vi.fn());
+      result.current.pushUndo('Third', vi.fn());
+    });
+    expect(result.current.lastActionLabel).toBe('Third');
+  });
+
+  it('FE-HOOK-HIST-005: undo consumes entries in LIFO order', async () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    const fn1 = vi.fn();
+    const fn2 = vi.fn();
+    act(() => {
+      result.current.pushUndo('First', fn1);
+      result.current.pushUndo('Second', fn2);
+    });
+    await act(async () => { await result.current.undo(); });
+    expect(fn2).toHaveBeenCalledOnce();
+    expect(fn1).not.toHaveBeenCalled();
+    expect(result.current.lastActionLabel).toBe('First');
+
+    await act(async () => { await result.current.undo(); });
+    expect(fn1).toHaveBeenCalledOnce();
+    expect(result.current.canUndo).toBe(false);
+  });
+
+  it('FE-HOOK-HIST-006: caps history at 30 entries', () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    act(() => {
+      for (let i = 0; i < 31; i++) {
+        result.current.pushUndo(`Action ${i}`, vi.fn());
+      }
+    });
+    // After 31 pushes with cap=30, the oldest entry (Action 0) should be dropped.
+    // canUndo must be true and the stack should not exceed 30.
+    expect(result.current.canUndo).toBe(true);
+    expect(result.current.lastActionLabel).toBe('Action 30');
+  });
+
+  it('FE-HOOK-HIST-007: undo on an empty stack does not throw', async () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    await expect(
+      act(async () => { await result.current.undo(); })
+    ).resolves.not.toThrow();
+    expect(result.current.canUndo).toBe(false);
+  });
+
+  it('FE-HOOK-HIST-008: undo still sets canUndo=false after consuming the last entry', async () => {
+    const { result } = renderHook(() => usePlannerHistory());
+    act(() => { result.current.pushUndo('Only', vi.fn()); });
+    await act(async () => { await result.current.undo(); });
+    expect(result.current.canUndo).toBe(false);
+    expect(result.current.lastActionLabel).toBeNull();
+  });
+});