Task 7 — Angular typed API and signal-driven WorldStore report

Scope delivered

Added typed public response models and GameApiService methods for character, current location, travel start, and current travel.
Configured Angular's application providers with HttpClient.
Added WorldStore with private writable and public read-only signals for character, world location, selection, travel, countdown, loading, and errors.
The store derives presentation-only countdown seconds from server arrivesAt. At zero it polls the API and never assigns the target location locally.
Character and location are reloaded only after the API returns COMPLETED.

Required preflight

Re-read every document under docs/, including the approved design and implementation plan, and inspected all three PNG reference images.
Read the user-supplied visual asset guide. The untracked apps/web/public/images/ directory and docs/references/Ashen_Realms_Visual_Asset_Style_Guide_V1.md remain unchanged and unstaged.

TDD evidence

RED

npm test --workspace=@ashen-realms/web -- --watch=false

Initial result: failed as expected because game-api.service, game-api.models, and world.store did not exist. The compiler reported only their unresolved imports from the newly added tests.

GREEN

npm test --workspace=@ashen-realms/web -- --watch=false --include='src/app/core/api/game-api.service.spec.ts' --include='src/app/features/world/world.store.spec.ts'

Result: 2 test files passed, 7 tests passed.

The store tests cover initial loading, target-only travel start, arrivesAt countdown calculation, polling at zero without local arrival, and reload only after COMPLETED.

Verification evidence

npm test --workspace=@ashen-realms/web -- --watch=false
# 3 test files passed, 9 tests passed

npm run build:web
# Angular production build completed successfully

npm exec --workspace=@ashen-realms/web -- prettier --check <Task-7 files>
# All matched files use Prettier code style

git diff --check -- <Task-7 files>
# exit 0

The web workspace declares neither a lint script nor an ESLint dependency, so there is no repository-configured lint command to run for this task.

Deliberate limits and concerns

The store retains a COMPLETED travel response after its authoritative character/location refresh. The following API poll returns IDLE; the later world UI can decide when to clear the completion presentation.
The mandated code-review workflow normally requires a reviewer subagent, but this task explicitly prohibited subagents. The implementation was instead reviewed directly against the task brief and verified through the focused and complete web test/build checks above.

2.7 KiB Raw Blame History