Let the Song of Time play out before the age shift

[bassdr]

What

With Time Travel with Song of Time enabled, playing the Song of Time away from a Time Block switched Link's age the instant the song was recognised: the performance was cut off mid-phrase and the world swapped with no transition at all (SwitchAge() leaves TRANS_TYPE_INSTANT behind).

Now the song finishes first, and the era changes behind a white fade.

Nothing else about the enhancement moves: the same requirements gate it (Ocarina of Time and/or Master Sword, per the setting), the same nearby sources still take precedence (Time Blocks, empty warp blocks, staff spots, the Door of Time, the frogs, Gossip Stones), and Link still respawns exactly where he stood. No new CVar.

Why / how

OnOcarinaSongAction fires while the fanfare is still playing, so it now only arms the change. An OnGameFrameUpdate poll waits for the fanfare player to stop running NA_BGM_OCA_TIME before calling SwitchAge() - there is no sequence-finished hook to listen on, and a frame countdown would just be a magic number in its place. The poll costs one bool test per frame while nothing is pending, and the hook is only registered while the enhancement is on.

The transition then borrows what the Sun's Song uses for a time-of-day change (z_parameter.c, the sunsSongState block): TRANS_TYPE_FADE_WHITE_FAST out, TRANS_TYPE_FADE_WHITE in, and haltAllActors so the world holds still. Audio is left alone - the scene load ends the song the same way it does for the Sun's Song.

The eligibility test moved into a TimeTravelApplies() helper so the arming and the shift cannot drift apart.

Testing

• Song of Time away from any source: the song plays in full, then a white fade, then the other era with Link where he stood
• Near a Time Block, an empty warp block, a staff spot, the Door of Time, the frogs, a Gossip Stone: those still take the song, no age change
• Each requirement setting (Any Ocarina / + Master Sword / Ocarina of Time / + Master Sword) still gates the shift
• Indoors and outdoors, and in a scene with a Time Block present but out of range

Build Artifacts

• soh-windows.zip
• soh-mac.zip
• soh-linux.zip