nx_gamehud.nx

nx_gamehud.nx -- certified composable game part: UI/MENUS/HUD (gamebench capability 18). A HUD is BOUND VALUES rendered fresh every frame (never cached text), and a menu is a MODAL, DETERMINISTIC state machine whose selection CAUSES the game action (not decoration painted after the fact). This part owns both, game-agnostically: - HUD slots: caller binds integer values (hp/depth/kills/...) each turn; labels are passed at RENDER time only, so serialized state is PURE i64 values (pointers never enter a save file). - Menu: open(n items) -> move (wraps BOTH directions) -> sel returns the cursor item's id and closes (modal select-close). Cursor/items live in state; a replay reproduces every selection. - Render: composites over a caller RGB24 framebuffer (w*h*3, like nx_png_write_rgb) with the sovereign nx_font8x8 glyphs; per-pixel clipped so off-screen text can NEVER write out of bounds. - Serialization: gh state words [0..GH_NSV) are plain i64s -> ride nx_gamesave like every other certified part (rpgstats T8 / entity T9 pattern). LIB, no main (ecosystem convention, cf. nx_swgpu.nx). license_tier: ORIGINAL