[Vatsal2005]

What and why

The camera now follows the hero with up to 120px of directional look-ahead and smooth vertical follow. It clamps to the full four-direction chunk grid, retains fractional smoothing internally and sends only integer coordinates to Phaser. The renderer keeps the stage manifest's authored parallax factors and list order. Development inspection mode retains manual panning for annotation review.

Issue

Closes #32
Refs #29

Stack

• [16/16] feat: block frontal hits with the chair guard #149 [16/16] feat: block frontal hits with the chair guard
• [15/16] feat: add up attacks and pogo slams #146 [15/16] feat: add up attacks and pogo slams
• [14/16] feat: patrol and charge with autonomous rovers #145 [14/16] feat: patrol and charge with autonomous rovers
• [13/16] feat: save and refill at coffee machines #144 [13/16] feat: save and refill at coffee machines
• [12/16] feat: add alternating chair sweeps and contact hits #137 [12/16] feat: add alternating chair sweeps and contact hits
• [11/16] feat: add health damage and checkpoint respawn #135 [11/16] feat: add health damage and checkpoint respawn
• [10/16] feat: switch locomotion through authored bridge clips #132 [10/16] feat: switch locomotion through authored bridge clips
• [9/16] feat: follow the hero with directional camera lead #131 [9/16] feat: follow the hero with directional camera lead ← this PR
• [8/16] feat: add one-way decks and ladder climbing #126 [8/16] feat: add one-way decks and ladder climbing
• [7/16] feat: follow ground slopes and slide downhill #125 [7/16] feat: follow ground slopes and slide downhill
• [6/16] feat: add variable jumps and landing poses #123 [6/16] feat: add variable jumps and landing poses
• [5/16] feat: add weighted walking and running #122 [5/16] feat: add weighted walking and running
• [4/16] feat: load authored collision with a debug overlay #120 [4/16] feat: load authored collision with a debug overlay
• [3/16] feat: load exported stages and sprite atlases #116 [3/16] feat: load exported stages and sprite atlases
• [2/16] ci: check the game with node 22 on pull requests #111 [2/16] ci: check the game with node 22 on pull requests
• [1/4] chore(shared): scaffold the phaser game runtime #94 [1/16] chore(shared): scaffold the phaser game runtime — merged

Base: feature/30-platforms-and-ladders. Human merges bottom up; retarget the next PR to main and merge origin/main into every open branch, never rebase.

Acceptance criteria

• Directional look-ahead and smooth vertical follow
• Every layer retains its authored scroll factor from the accepted export contract
• Chunk-grid bounds and whole-pixel camera output

Verification

• Node 22: npm run typecheck, npm test (81 tests), npm run build; includes main integration at e8577ab
• py -3.13 scripts/check_docs.py — 614 files
• git diff --cached --check
• Camera tests: lead reversal, vertical smoothing, frame-rate independence, four-direction bounds, negative chunks and integer output
• Browser: anomaly route's first ladders and 39.3-degree slope, walk/run reversal and first chunk seam; the seam fix is in lower PR [7/16] feat: follow ground slopes and slide downhill #125 and merged upward
• Browser: crossed all three clean chunks to x=6458 and the right wall; camera clamps at the end, parallax remains continuous, no console errors
• Full anomaly route and manual 2× display review remain; current desktop viewport also exercised fractional fit, and existing viewport tests cover integer 1×/2× scaling
• Physical gamepad and Vercel preview: Vatsal2005 needs Vercel project access to create deployments

Contract note

docs/13 and #110 require the exported list order and scroll values. The current Creek export uses distance 0.2, near rails 1.1 and foliage 1.15, whereas docs/04 gives general layer roles from 0.1 to 1.2. This change follows the actual export; changing those art values belongs in lane A's config.

Screenshots

Captured in ignored tmp/verification/32-slope.png, 32-seam.png, 32-clean-end.png and shown in chat. The full clean traversal also confirms both authored chunk boundaries in the running game.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
wincs	Error		Oct 24, 2026 12:30am UTC

[vercel]

@Vatsal2005 must be a member of the arudaev's projects team on Vercel to deploy.
- Click here to add @Vatsal2005 to the team.
- If you initiated this build, request access.
- If you're already a member of the arudaev's projects team, make sure that your Vercel account is connected to your GitHub account.

Learn more about collaboration on Vercel and other options here.

[arudaev]

Lane A review: the stack is merge-ready except one gap – the hero never plays its approved idle/walk/run clips on the ground. Details and the requested change on #122. Merge order once fixed: #111 → #116 → #120 → #122 → #123 → #125 → #126 → #131.

[arudaev]

Next, after the animation fix – lane A's story work (#50, #51, #52, #54, #56, #58) needs two hooks from lane B, as contracts in core/events.ts / stage/:

1. Trigger events. When the hero's body enters/leaves a collision trigger box (docs/13 annotation layer), emit 'trigger-entered' / 'trigger-left' with { id, region, chunk, position }. Story listens (pond crossing [M3-S4] The crossing: damage sprite, THD.exe window, landing #51, coffee machine [M4-S4] Dexter waits at the coffee machine with the pocket computer #52, Jenny's bridge [M4-S1] Jenny rams you on the bridge and the creek turns #54, ending [M4-S7] Dexter absorbs Jenny and the slice ends #58).
2. Region swap. A call the story can make, e.g. swapRegion(scene, { region, state, spawn? }), that reloads stage + collision for another region/state and places the hero (the crossing lands you in Rusty Creek; Jenny's ram turns the creek clean → anomaly, [M4-S1] Jenny rams you on the bridge and the creek turns #54), then emits region-turned. Today Preload only reads ?region=&state= from the URL.

Plus Player exposing its body position read-only (it does: player.body) is enough for camera-relative story beats. A short Vitest per hook, like the others. Thanks – the rest of the stack looks good.