refactor: reorganize pxl8 into client/src/ module structure

- core/: main entry, types, logging, I/O, RNG
- asset/: ase loader, cart, save, embed
- gfx/: graphics, animation, atlas, fonts, tilemap, transitions
- sfx/: audio
- script/: lua/fennel runtime, REPL
- hal/: platform abstraction (SDL3)
- world/: BSP, world, procedural gen
- math/: math utilities
- game/: GUI, replay
- lua/: Lua API modules

client/src/gfx/pxl8_gfx.h

@@ -0,0 +1,48 @@
+#pragma once
+
+#include "pxl8_gfx2d.h"
+#include "pxl8_gfx3d.h"
+#include "pxl8_hal.h"
+#include "pxl8_palette.h"
+#include "pxl8_types.h"
+
+typedef struct pxl8_gfx pxl8_gfx;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+pxl8_gfx* pxl8_gfx_create(const pxl8_hal* hal, void* platform_data, pxl8_pixel_mode mode, pxl8_resolution resolution);
+void pxl8_gfx_destroy(pxl8_gfx* gfx);
+
+void pxl8_gfx_present(pxl8_gfx* gfx);
+void pxl8_gfx_update(pxl8_gfx* gfx, f32 dt);
+void pxl8_gfx_upload_framebuffer(pxl8_gfx* gfx);
+
+u8 pxl8_gfx_find_color(pxl8_gfx* gfx, u32 color);
+
+pxl8_bounds pxl8_gfx_get_bounds(pxl8_gfx* gfx);
+u8* pxl8_gfx_get_framebuffer_indexed(pxl8_gfx* gfx);
+u16* pxl8_gfx_get_framebuffer_hicolor(pxl8_gfx* gfx);
+i32 pxl8_gfx_get_height(const pxl8_gfx* gfx);
+pxl8_palette* pxl8_gfx_get_palette(pxl8_gfx* gfx);
+pxl8_pixel_mode pxl8_gfx_get_pixel_mode(pxl8_gfx* gfx);
+i32 pxl8_gfx_get_width(const pxl8_gfx* gfx);
+
+i32 pxl8_gfx_load_palette(pxl8_gfx* gfx, const char* filepath);
+void pxl8_gfx_project(pxl8_gfx* gfx, f32 left, f32 right, f32 top, f32 bottom);
+void pxl8_gfx_set_palette(pxl8_gfx* gfx, pxl8_palette* pal);
+void pxl8_gfx_set_viewport(pxl8_gfx* gfx, pxl8_viewport vp);
+pxl8_viewport pxl8_gfx_viewport(pxl8_bounds bounds, i32 width, i32 height);
+
+void pxl8_gfx_clear_textures(pxl8_gfx* gfx);
+pxl8_result pxl8_gfx_create_texture(pxl8_gfx* gfx, const u8* pixels, u32 width, u32 height);
+pxl8_result pxl8_gfx_load_font_atlas(pxl8_gfx* gfx);
+pxl8_result pxl8_gfx_load_sprite(pxl8_gfx* gfx, const char* path);
+
+bool pxl8_gfx_push_target(pxl8_gfx* gfx);
+void pxl8_gfx_pop_target(pxl8_gfx* gfx);
+
+#ifdef __cplusplus
+}
+#endif