[Eli Pinkerton (wallstop)]

DISCLOSURE: LLM-GENERATED TEXT

Why: Generated serializers reject nullable map values needed by retained consumer data.

What:

• Preserve nullable map keys, values, and present defaults.
• Add generated WebGL consumer acceptance with retained goldens.
• Check enum conversion, random vectors, and spatial queries in browsers.
• Document older reader limitations and browser qualification steps.

Refs #343, #637

---

Note

Medium Risk
Changes generated serialization wire semantics and presence for map entries; retained saves and mixed protobuf-net reader versions need the documented qualification before rollout.

Overview
Extends the WProto generator so Dictionary / IDictionary map members can use nullable keys and values, with presence driven by HasValue (present zeros and default structs stay on the wire; null values omit; nullable keys must be present or read/write fails). MapMember and Shape.Underlying were updated accordingly, and WPROTO003 now documents nullable map halves while repeated elements stay non-nullable.

Adds qualification: differential and golden-byte tests against protobuf-net oracles, fast runtime tests, and a WebGL IL2CPP browser consumer (run-browser-consumer.py + Playwright) that runs retained-map goldens plus enum/RNG/spatial safety checks with manifest-bound identity and negative controls. Docs and CHANGELOG describe nullable map wire rules and older protobuf-net reader limits for nullable enum/struct map values.

^{Reviewed by Cursor Bugbot for commit 5763bf6. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 3 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 920edcc. Configure here.}