Summary

This PR fixes custom user map loading on macOS for maps stored under ~/Library/Application Support/GeneralsX/GeneralsZH/Maps, including maps with special characters in folder/file names and maps that rely on local map.str metadata.

What Changed

• Made map path handling separator-agnostic (\\ and /) in shared map scanning and layout checks.
• Hardened map display-name extraction for cache/runtime flows to avoid Windows-only path assumptions.
• Fixed map.str path derivation to use the real map filepath context.
• Applied matching cache-parse separator hardening in both Zero Hour and Generals INIMapCache.cpp paths.
• Hardened QuotedPrintable ASCII encoding to use locale-independent ASCII checks for predictable special-character handling.

Files

• Core/GameEngine/Source/GameClient/MapUtil.cpp
• GeneralsMD/Code/GameEngine/Source/Common/INI/INIMapCache.cpp
• Generals/Code/GameEngine/Source/Common/INI/INIMapCache.cpp
• GeneralsMD/Code/GameEngine/Source/Common/System/QuotedPrintable.cpp
• Generals/Code/GameEngine/Source/Common/System/QuotedPrintable.cpp

Validation

• Confirmed custom map load from user path in runtime logs.
• Stress dataset created with names containing spaces, quotes, punctuation, and accented Unicode; successful runtime execution completed with exit code 0.
• No diagnostics errors in edited INI/QuotedPrintable files.

Docs

• Updated docs/DEV_BLOG/2026-04-DIARY.md.
• Updated docs/WORKDIR/lessons/2026-04-LESSONS.md.