fix: update raw.ksy with verified field names, v<32 support, missing color_a

Changes verified against Ghidra RE of ReadNewTerrainFormat, RAWReadHeightmap,
RAWReadColorandLightMaps, RAWReadFlairData, RAWReadSceneMap, RAWReadMeshData,
and FUN_0103aaf0 (blend map reader) in legouniverse.exe 1.10.64. Validated
against all 309 .raw files across multiple client versions (v31 and v32).

- Rename density → scale (matches client field name)
- Rename diffuse_res → color_map_resolution, diffuse_res_pixels → color_map_pixels
- Rename bits → blend_channel_mask
- Add color_a (u1) to flair_attributes (was missing, 35 vs 36 byte mismatch)
- Remove size: 36 override on flairs (struct is now correctly 36 bytes)
- Add version >= 32 and vert_size != 0 guards on mesh data (matches client)
- Replace unknown1/unknown2 catch-alls with proper v<32 field definitions:
  - color_map_pixels_legacy: width*width*4 bytes (BGRA per-pixel swizzle)
  - scene_map_v31: width*width bytes (v==31 per-cell read with border skip)
  - scene_map_skip: 1 byte (v<31 zero-fill)
  - No diffuse DDS, blend_channel_mask, or blend DDS for v<32
  - No mesh data for v<32
- Add doc annotations throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: aronwk-aaron

files/raw.ksy

@@ -9,6 +9,7 @@ seq:
     type: u2
   - id: dev
     type: u1
+    doc: Must be 0 for valid terrain data; non-zero aborts loading
   - id: num_chunks
     type: u4
     if: dev == 0
@@ -43,73 +44,92 @@ types:
         type: u4
         repeat: expr
         repeat-expr: 4
-      - id: density
+      - id: scale
         type: f4
+        doc: Heightmap scale factor, used to transform grid coords to world coords
       - id: height_map
         type: f4
         repeat: expr
         repeat-expr: width * height
-      - id: diffuse_res
+      - id: color_map_resolution
         type: u4
         if: _root.version >= 32
-      - id: diffuse_res_pixels
-        size: diffuse_res * diffuse_res * 4
+        doc: Resolution of the color/diffuse map
+      - id: color_map_pixels
+        size: color_map_resolution * color_map_resolution * 4
         if: _root.version >= 32
-        doc: RGBA
-      - id: unknown1
-        type: u1
-        repeat: eos
+        doc: RGBA color map pixels (raw block)
+      - id: color_map_pixels_legacy
+        size: width * width * 4
         if: _root.version < 32
-        doc: todo
+        doc: >
+          v<32 color map. Client reads width*width pixels (4 bytes each)
+          with per-pixel BGRA byte swizzle. colorMapResolution = width - 1;
+          only the inner (width-1)^2 pixels are used.
       - id: diffuse_map_dds_size
         type: u4
         if: _root.version >= 32
       - id: diffuse_map_dds
         size: diffuse_map_dds_size
         if: _root.version >= 32
+        doc: DDS texture data for diffuse/light map
       - id: blend_res
         type: u4
       - id: blend_pixels
         size: blend_res * blend_res * 4
-      - id: bits
+        doc: >
+          Blend/texture map pixels. v>=32 reads as raw RGBA block;
+          v<32 reads per-pixel as B,G,R,A (byte-swizzled).
+      - id: blend_channel_mask
         type: u1
         if: _root.version >= 32
+        doc: Bitmask of active detail textures (bits 0-3)
       - id: blend_map_dds_size
         type: u4
         if: _root.version >= 32
       - id: blend_map_dds
         size: blend_map_dds_size
         if: _root.version >= 32
+        doc: DDS texture data for blend map (DXT5)
       - id: num_flairs
         type: u4
       - id: flairs
         type: flair_attributes
-        size: 36
         repeat: expr
         repeat-expr: num_flairs
       - id: scene_map
-        size: diffuse_res * diffuse_res
+        size: color_map_resolution * color_map_resolution
         if: _root.version >= 32
-      - id: unknown2
-        type: u1
-        repeat: eos
-        if: _root.version < 32
-        doc: todo
+        doc: Per-pixel scene ID assignment, indexes into LUZ scene list
+      - id: scene_map_v31
+        size: width * width
+        if: _root.version == 31
+        doc: >
+          v31 scene map. Allocates (colorMapRes+1)^2 where colorMapRes=width-1.
+          Client reads (colorMapRes+1)^2 cells; inner colorMapRes^2 cells
+          contain scene IDs, border cells are skipped/discarded.
+      - id: scene_map_skip
+        size: 1
+        if: _root.version < 31
+        doc: v<31 skips 1 byte; scene map is zero-filled by client
       - id: vert_size
         type: u4
         if: _root.version >= 32
       - id: mesh_vert_usage
         type: u2
         repeat: expr
         repeat-expr: vert_size
+        if: _root.version >= 32 and vert_size != 0
       - id: mesh_vert_size
         type: u2
         repeat: expr
         repeat-expr: 16
+        if: _root.version >= 32 and vert_size != 0
       - id: mesh_tri
         type: mesh_tri
         repeat: expr
         repeat-expr: 16
+        if: _root.version >= 32 and vert_size != 0
 
   flair_attributes:
     seq:
@@ -127,6 +147,8 @@ types:
         type: u1
       - id: color_b
         type: u1
+      - id: color_a
+        type: u1
   mesh_tri:
     seq:
       - id: mesh_tri_list_size