SMW Level Pipeline — level number → tiles on screen

The full level-loading data path traced through banks 05 and 0D. Background for the level-decode sections of CONTRACT.md. Companion docs: SYSTEM_NOTES.md, SPRITE_ENGINE_NOTES.md (the sprite side of spawning).

A. Orchestration

B. Primary header — 5 bytes (CODE_0584E3)

Read via [$65],Y; $65 then advances by 5 to the object stream.

ByteBits→
10–4 (+1)screen count $5D
15–7BG palette $1930
20–4level mode $1925 (indexes every §C table)
25–7BG color $192F
30–3sprite GFX set $192B
34–6music, via LevelMusicTable $0584DB → $0DDA
37layer-3 priority $3E
40–2 / 3–5FG palette $192D / sprite palette $192E
46–7timer, via TimerTable $0584D7 (0/200/300/400) → $0F31+
50–3FG/BG GFX set (tileset) $1931/$1932
54–5H/V scroll $1412 (3 = no scroll)
56–7item memory $13BE

Sprite memory $1692 is NOT in this header — it's bits 0–5 of the sprite data's first byte (bits 6–7 = buoyancy $190E), read at CODE_05D8F9.

C. Level-mode tables (X = $1925, one byte per mode, $058417–$0584DB)

D. Level number → data pointers (CODE_05D8B7)

E. Object stream — 3 bytes per object (LoadLevelData $0585FF)

Bytes → $0A,$0B,$59; loop until the next byte is $FF.

byte1 $0A: N BB Y YYYY   N=new screen (INC $1928), BB=obj# bits 5-6... 
           bit7=new screen, bit4=high-coord bit (right/lower half),
           bits0-3 = Y, bits5-6 = object# high bits
byte2 $0B: XXXX NNNN     bits4-7 = object# low nibble, bits0-3 = X
byte3 $59: settings/size (standard) or extended-object number (when obj# == 0)

F. Object → Map16 tiles (bank 0D)

G. Layer 2

H. Layer 3

I. Sprite list (bank 07 data, parsed in bank 02)

J. Freespace in these banks

$FF filler: DATA_0581BB, DATA_058E19–$058FFC (bank 05); Empty0DA0A0–$0DA0FF (96 bytes, right before the object engine); bank 06 tail beyond ~$06F5xx.