Fix Dmod_ReadModuleHeader to handle compressed DMFC files

[Copilot]

Dmod_ReadModuleHeader reads raw bytes from files, failing on compressed (.dmfc) modules where it reads compression headers instead of module headers. This breaks Dmod_ReadNextModule iteration over compressed modules.

Changes

• Read full file into buffer before header extraction to enable compression detection
• Decompress DMFC files using Dmod_IsDMFC() check and Dmod_FromDMFC() decompression
• Validate header size post-decompression since compressed files are smaller than header size
• Track allocation ownership with dmfDataNeedsFree flag to avoid double-free

// Before: direct read fails on DMFC
Dmod_FileRead(Header, sizeof(Dmod_ModuleHeader_t), 1, file);

// After: decompress if needed, then extract header
void* buffer = /* read entire file */;
if (Dmod_IsDMFC(buffer, fileSize)) {
    Dmod_FromDMFC(buffer, fileSize, &dmfData, &dmfSize);
    Dmod_Free(buffer);
    dmfDataNeedsFree = true;
}
memcpy(Header, dmfData, sizeof(Dmod_ModuleHeader_t));

Follows the same pattern as Dmod_LoadFile and Dmod_LoadFromPackage.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Dmod_ReadNextModule nie działa poprawnie dla modułów z paczek</issue_title>
<issue_description>Dmod_ReadNextModule jest niepoprawnie zaimplementowany, bo dla każdego modułu próbuje odczytać header jak z pliku, podczas gdy nie każdy moduł jest dostępny w systemie plików - paczki nie są dostępne, więc trzeba je odczytać podobnie jak robi to Dmod_LoadFromPackage</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Dmod_ReadNextModule nie działa poprawnie dla modułów z paczek #188

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.