Fix GameCube memory card slot B detection and free-space check

CARD_Mount() alone reliably reports CARD_ERROR_NOCARD for a card physically
present in slot B - unlike slot A, which the IPL polls automatically at
boot, slot B needs an explicit CARD_Probe() first (the standard pattern in
every official devkitPro CARD sample). Also fixes
saveDeviceDolphinCardHasFreeSpace() treating CARD_GetDirectory()'s
CARD_ERROR_NOFILE (a totally empty card, not an actual error) as a hard
failure, which made any card with zero existing save files - slot B's in
this case, since slot A already had leftover test data on it - get
reported as full.

Confirmed via Dolphin with slot A disabled/slot B set to a memory card:
previously reported "no save device found", now correctly detects it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

.github/workflows/test.yml

@@ -33,74 +33,3 @@ jobs:
             libssl-dev
       - name: Run tests
         run: ./scripts/test-linux.sh
-
-  # Emulator smoke tests: boot the built disc/EBOOT for a fixed window and
-  # confirm the emulator doesn't crash. Not yet verified against a real
-  # runner (no CI run has exercised these) -- continue-on-error so a
-  # flaky/broken emulator step doesn't block the required Linux test job.
-  run-tests-gamecube-dolphin:
-    runs-on: ubuntu-latest
-    continue-on-error: true
-    container:
-      image: ghcr.io/extremscorner/libogc2:latest
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install additional dependencies
-        run: |
-          apt-get install -y \
-            python3-pip python3-polib python3-pil \
-            python3-dotenv python3-pyqt5 python3-opengl xorriso \
-            dolphin-emu xvfb
-          dkp-pacman -Syu --noconfirm
-          dkp-pacman -S --needed --noconfirm \
-            gamecube-sdl2 ppc-liblzma ppc-libzip \
-            gamecube-tools ppc-libmad ppc-zlib-ng ppc-bzip2 ppc-zstd
-      - name: Build GameCube ISO and boot it in Dolphin
-        run: ./scripts/test-gamecube-dolphin.sh
-
-  run-tests-wii-dolphin:
-    runs-on: ubuntu-latest
-    continue-on-error: true
-    container:
-      image: ghcr.io/extremscorner/libogc2:latest
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install additional dependencies
-        run: |
-          apt-get install -y \
-            python3-pip python3-polib python3-pil \
-            python3-dotenv python3-pyqt5 python3-opengl xorriso \
-            dolphin-emu xvfb
-          dkp-pacman -Syu --noconfirm
-          dkp-pacman -S --needed --noconfirm \
-            gamecube-sdl2 ppc-liblzma ppc-libzip \
-            gamecube-tools ppc-libmad ppc-zlib-ng ppc-bzip2 ppc-zstd
-      - name: Build Wii ISO and boot it in Dolphin
-        run: ./scripts/test-wii-dolphin.sh
-
-  run-tests-psp-ppsspp:
-    runs-on: ubuntu-latest
-    continue-on-error: true
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Setup pspdev
-        uses: ./.github/actions/setup-pspdev
-      - name: Install PPSSPPHeadless build dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y git cmake ninja-build libsdl2-dev zlib1g-dev
-      - name: Build PPSSPPHeadless
-        run: |
-          git clone --recursive --depth 1 https://github.com/hrydgard/ppsspp.git /tmp/ppsspp
-          cmake -S /tmp/ppsspp -B /tmp/ppsspp/build -DCMAKE_BUILD_TYPE=Release
-          cmake --build /tmp/ppsspp/build --target PPSSPPHeadless -- -j$(nproc)
-          echo "PPSSPP_HEADLESS_BIN=/tmp/ppsspp/build/PPSSPPHeadless" >> "$GITHUB_ENV"
-      - name: Build PSP EBOOT and boot it in PPSSPPHeadless
-        run: ./scripts/test-psp-ppsspp.sh

CMakeLists.txt

@@ -13,7 +13,7 @@ cmake_policy(SET CMP0079 NEW)
 # set(FETCHCONTENT_UPDATES_DISCONNECTED ON)
 
 option(DUSK_BUILD_TESTS "Enable tests" OFF)
-option(DUSK_NETWORKING "Enable networking support" OFF)
+option(DUSK_NETWORK "Enable network support" ON)
 
 set(DUSK_GAME_NAME "Dusk" CACHE STRING "Game display name")
 set(DUSK_GAME_AUTHOR "YourWishes" CACHE STRING "Game author / coder")
@@ -91,9 +91,9 @@ target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME}
     DUSK_VERSION="${DUSK_VERSION}"
 )
 
-if(DUSK_NETWORKING)
+if(DUSK_NETWORK)
   target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
-    DUSK_NETWORKING
+    DUSK_NETWORK
   )
 endif()
 
@@ -123,11 +123,7 @@ if(DUSK_BUILD_TESTS)
 endif()
 
 # Build assets
-# Deliberately not CONFIGURE_DEPENDS: that reruns the full CMake configure
+file(GLOB_RECURSE DUSK_ASSET_FILES CONFIGURE_DEPENDS "${DUSK_ASSETS_DIR}/*")
-# step (which invalidates generated headers and forces a huge rebuild) on
-# every single asset edit. Re-run cmake manually when assets are added or
-# removed.
-file(GLOB_RECURSE DUSK_ASSET_FILES "${DUSK_ASSETS_DIR}/*")
 add_custom_command(
   OUTPUT "${DUSK_ASSETS_ZIP}"
   COMMAND ${CMAKE_COMMAND} -E make_directory "${DUSK_ASSETS_DIR}"

archive/dusk/ui/CMakeLists.txt

@@ -1,18 +0,0 @@
-# Copyright (c) 2026 Dominic Masters
-# 
-# This software is released under the MIT License.
-# https://opensource.org/licenses/MIT
-
-add_subdirectory(debug)
-add_subdirectory(frame)
-add_subdirectory(focus)
-add_subdirectory(overlay)
-add_subdirectory(transition)
-add_subdirectory(widget)
-
-# Sources
-target_sources(${DUSK_LIBRARY_TARGET_NAME}
-  PUBLIC
-    ui.c
-    uielement.c
-)

archive/dusk/ui/debug/uiconsole.c

@@ -1,138 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uiconsole.h"
-#include "assert/assert.h"
-#include "console/console.h"
-#include "display/screen/screen.h"
-#include "display/text/text.h"
-#include "display/spritebatch/spritebatch.h"
-#include "display/shader/shaderunlit.h"
-#include "display/mesh/mesh.h"
-#include "util/memory.h"
-
-typedef struct {
-  mesh_t mesh;
-  bool_t built;
-  meshvertex_t vertices[UI_CONSOLE_CACHE_VERTEX_MAX];
-  int32_t vertexCount;
-  int32_t cachedScanX;
-  int32_t cachedScanY;
-} uiconsolecache_t;
-
-uiconsolecache_t UI_CONSOLE_CACHE;
-
-errorret_t uiConsoleDraw(void) {
-  if(!CONSOLE.visible) errorOk();
-
-  if(
-    CONSOLE.dirty ||
-    UI_CONSOLE_CACHE.cachedScanX != SCREEN.scanX ||
-    UI_CONSOLE_CACHE.cachedScanY != SCREEN.scanY
-  ) {
-    errorChain(uiConsoleRebuild());
-  }
-
-  if(UI_CONSOLE_CACHE.vertexCount == 0) errorOk();
-
-  shadermaterial_t material = {
-    .unlit = {
-      .color = COLOR_RED,
-      .texture = FONT_DEFAULT.texture
-    }
-  };
-
-  errorChain(shaderBind(&SHADER_UNLIT));
-  errorChain(shaderSetMaterial(&SHADER_UNLIT, &material));
-  return meshDraw(&UI_CONSOLE_CACHE.mesh, 0, UI_CONSOLE_CACHE.vertexCount);
-}
-
-errorret_t uiConsoleRebuild(void) {
-  int32_t spriteCount = 0;
-  for(uint32_t i = 0; i < CONSOLE_HISTORY_MAX; i++) {
-    char_t c;
-    int32_t j = 0;
-    while((c = CONSOLE.line[i][j++]) != '\0') {
-      if(c != ' ' && c != '\n') spriteCount++;
-    }
-  }
-
-  assertTrue(
-    spriteCount <= UI_CONSOLE_CACHE_GLYPH_MAX,
-    "Console history exceeds fixed cache capacity"
-  );
-
-  const int32_t vertexCount = spriteCount * QUAD_VERTEX_COUNT;
-  UI_CONSOLE_CACHE.vertexCount = vertexCount;
-
-  if(vertexCount > 0) {
-    const float_t lineH = (float_t)FONT_DEFAULT.tileset->tileHeight;
-    const float_t charW = (float_t)FONT_DEFAULT.tileset->tileWidth;
-
-    int32_t index = 0;
-    int32_t row = 0;
-    for(uint32_t i = 0; i < CONSOLE_HISTORY_MAX; i++) {
-      float_t posX = (float_t)SCREEN.scanX;
-      float_t posY = (float_t)SCREEN.scanY + lineH * (float_t)row;
-
-      char_t c;
-      int32_t j = 0;
-      while((c = CONSOLE.line[i][j++]) != '\0') {
-        if(c == '\n') {
-          posX = (float_t)SCREEN.scanX;
-          posY += lineH;
-          row++;
-          continue;
-        }
-
-        if(c == ' ') {
-          posX += charW;
-          continue;
-        }
-
-        const spritebatchsprite_t sprite = textGetSprite(
-          (vec2){ posX, posY }, c, &FONT_DEFAULT
-        );
-        spriteBatchBufferToMesh(
-          &sprite, 1,
-          &UI_CONSOLE_CACHE.vertices[index], QUAD_VERTEX_COUNT
-        );
-
-        index += QUAD_VERTEX_COUNT;
-        posX += charW;
-      }
-
-      row++;
-    }
-
-    if(!UI_CONSOLE_CACHE.built) {
-      errorChain(meshInit(
-        &UI_CONSOLE_CACHE.mesh,
-        QUAD_PRIMITIVE_TYPE,
-        UI_CONSOLE_CACHE_VERTEX_MAX,
-        UI_CONSOLE_CACHE.vertices
-      ));
-      UI_CONSOLE_CACHE.built = true;
-    } else {
-      errorChain(meshFlush(&UI_CONSOLE_CACHE.mesh, 0, vertexCount));
-    }
-  }
-
-  UI_CONSOLE_CACHE.cachedScanX = SCREEN.scanX;
-  UI_CONSOLE_CACHE.cachedScanY = SCREEN.scanY;
-  CONSOLE.dirty = false;
-  errorOk();
-}
-
-errorret_t uiConsoleDispose(void) {
-  if(UI_CONSOLE_CACHE.built) {
-    errorChain(meshDispose(&UI_CONSOLE_CACHE.mesh));
-  }
-
-  memoryZero(&UI_CONSOLE_CACHE, sizeof(uiconsolecache_t));
-  errorOk();
-}

archive/dusk/ui/debug/uiconsole.h

@@ -1,48 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "display/mesh/quad.h"
-
-// Fixed capacity for the console's cached glyph mesh, in glyphs -- the
-// mesh/vertex buffer is sized to this once and never grown/shrunk, so
-// history producing more non-space characters than this asserts (see
-// uiConsoleRebuild) instead of reallocating.
-#define UI_CONSOLE_CACHE_GLYPH_MAX 512
-#define UI_CONSOLE_CACHE_VERTEX_MAX (\
-  UI_CONSOLE_CACHE_GLYPH_MAX * QUAD_VERTEX_COUNT \
-)
-
-/**
- * Renders the console history into the scan-safe area, drawing a mesh
- * that is only rebuilt when the history changes or the scan-safe origin
- * moves, rather than rebuffering vertices every frame. No-ops when the
- * console is not visible.
- *
- * @return Any error that occurs.
- */
-errorret_t uiConsoleDraw(void);
-
-/**
- * Rebuilds the cached mesh for the console's current history and
- * scan-safe origin. Called automatically by uiConsoleDraw() whenever
- * needed; only needs calling directly to force an immediate rebuild.
- * The underlying vertex buffer is a fixed-size array (see
- * UI_CONSOLE_CACHE_VERTEX_MAX) -- asserts if the history produces more
- * glyphs than that capacity, rather than growing it.
- *
- * @return Any error that occurs.
- */
-errorret_t uiConsoleRebuild(void);
-
-/**
- * Frees the mesh and vertex buffer built up by uiConsoleDraw().
- *
- * @return Any error that occurs.
- */
-errorret_t uiConsoleDispose(void);

archive/dusk/ui/frame/settings/CMakeLists.txt

@@ -1,13 +0,0 @@
-# Copyright (c) 2026 Dominic Masters
-#
-# This software is released under the MIT License.
-# https://opensource.org/licenses/MIT
-
-target_sources(${DUSK_LIBRARY_TARGET_NAME}
-  PUBLIC
-    uisettings.c
-    uisettingsgeneral.c
-    uisettingsinput.c
-    uisettingsdisplay.c
-    uisettingsaudio.c
-)

archive/dusk/ui/frame/settings/uisettings.c

@@ -1,248 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uisettings.h"
-#include "uisettingsgeneral.h"
-#include "uisettingsinput.h"
-#include "uisettingsdisplay.h"
-#include "uisettingsaudio.h"
-#include "ui/frame/uiframe.h"
-#include "ui/frame/uiconfirm.h"
-#include "util/memory.h"
-#include "display/text/text.h"
-#include "display/screen/screen.h"
-#include "assert/assert.h"
-#include "locale/localemanager.h"
-#include "asset/loader/locale/assetlocaleloader.h"
-
-uisettings_t UI_SETTINGS;
-
-uisettingstabdef_t UI_SETTINGS_TAB_DEFS[UI_SETTINGS_TAB_COUNT] = {
-  {
-    .localeId = "ui.settings.tabs.general",
-    .init = uiSettingsGeneralInit,
-    .menu = (uimenu_t *)&UI_SETTINGS.data,
-    .load = uiSettingsGeneralLoad,
-    .apply = uiSettingsGeneralApply,
-    .hasChanges = uiSettingsGeneralHasChanges
-  },
-
-  {
-    .localeId = "ui.settings.tabs.input",
-    .init = uiSettingsInputInit,
-    .menu = (uimenu_t *)&UI_SETTINGS.data,
-    .load = uiSettingsInputLoad,
-    .apply = uiSettingsInputApply,
-    .hasChanges = uiSettingsInputHasChanges
-  },
-
-  {
-    .localeId = "ui.settings.tabs.display",
-    .init = uiSettingsDisplayInit,
-    .menu = (uimenu_t *)&UI_SETTINGS.data,
-    .load = uiSettingsDisplayLoad,
-    .apply = uiSettingsDisplayApply,
-    .hasChanges = uiSettingsDisplayHasChanges
-  },
-
-  {
-    .localeId = "ui.settings.tabs.audio",
-    .init = uiSettingsAudioInit,
-    .menu = (uimenu_t *)&UI_SETTINGS.data,
-    .load = uiSettingsAudioLoad,
-    .apply = uiSettingsAudioApply,
-    .hasChanges = uiSettingsAudioHasChanges
-  }
-};
-
-static uisettingstabdef_t UI_SETTINGS_TOP_DEF = {
-  .menu = &UI_SETTINGS.tabsMenu,
-  .load = uiSettingsLoad,
-  .hasChanges = uiSettingsHasChanges
-};
-
-static uisettingstabdef_t *UI_SETTINGS_PENDING_DISCARD = NULL;
-static uisettingstabdef_t *UI_SETTINGS_ACTIVE_TAB = NULL;
-
-errorret_t uiSettingsActivateTab(uisettingstabdef_t *def) {
-  if(def == UI_SETTINGS_ACTIVE_TAB) errorOk();
-
-  errorChain(def->init(&UI_SETTINGS.data));
-  def->menu->user = def;
-  def->load();
-  UI_SETTINGS_ACTIVE_TAB = def;
-
-  errorOk();
-}
-
-void uiSettingsTabChanged(
-  const uimenu_t *menu,
-  const uint8_t index,
-  const uimenuitem_t *item
-) {
-  if(index >= UI_SETTINGS_TAB_COUNT) return;
-  errorCatch(uiSettingsActivateTab(&UI_SETTINGS_TAB_DEFS[index]));
-}
-
-void uiSettingsTabSelected(
-  const uimenu_t *menu,
-  const uint8_t index,
-  const uimenuitem_t *item
-) {
-  if(index >= UI_SETTINGS_TAB_COUNT) return;
-
-  uisettingstabdef_t *def = &UI_SETTINGS_TAB_DEFS[index];
-  errorCatch(uiSettingsActivateTab(def));
-  uiMenuOpen(def->menu);
-}
-
-errorret_t uiSettingsInit(void) {
-  memoryZero(&UI_SETTINGS, sizeof(uisettings_t));
-  UI_SETTINGS_ACTIVE_TAB = NULL;
-
-  for(uint8_t i = 0; i < UI_SETTINGS_TAB_COUNT; i++) {
-    errorChain(assetLocaleGetString(
-      &LOCALE.entry->data.locale,
-      UI_SETTINGS_TAB_DEFS[i].localeId,
-      0,
-      UI_SETTINGS.tabLabels[i],
-      UI_SETTINGS_TAB_LABEL_MAX
-    ));
-  }
-
-  MENU_BEGIN(
-    &UI_SETTINGS.tabsMenu, UI_SETTINGS.tabs, uiSettingsTabSelected,
-    uiSettingsDiscardMenuClosed, uiSettingsTabChanged
-  );
-  for(uint8_t i = 0; i < UI_SETTINGS_TAB_COUNT; i++) {
-    MENU_TAB(UI_SETTINGS.tabLabels[i]);
-  }
-  MENU_END(UI_SETTINGS.tabs, menuIndex);
-
-  UI_SETTINGS.tabsMenu.user = &UI_SETTINGS_TOP_DEF;
-
-  errorChain(assetLocaleGetString(
-    &LOCALE.entry->data.locale,
-    "ui.settings.apply",
-    0,
-    UI_SETTINGS.applyLabel,
-    UI_SETTINGS_APPLY_LABEL_MAX
-  ));
-
-  errorChain(uiSettingsActivateTab(&UI_SETTINGS_TAB_DEFS[0]));
-
-  errorOk();
-}
-
-errorret_t uiSettingsDraw(void) {
-  if(!uiMenuIsActive(&UI_SETTINGS.tabsMenu)) errorOk();
-
-  const float_t width = SCREEN.width;
-  const float_t height = SCREEN.height;
-  const float_t x = (float_t)SCREEN.scanX +
-    ((float_t)SCREEN.scanWidth - width) * 0.5f;
-  const float_t y = (float_t)SCREEN.scanY +
-    ((float_t)SCREEN.scanHeight - height) * 0.5f;
-
-  errorChain(uiFrameDrawCached(&UI_SETTINGS.frameCache, x, y, width, height));
-
-  const float_t contentX = x + UI_FRAME_START_X;
-  const float_t contentY = y + UI_FRAME_START_Y;
-  const float_t contentWidth = width - (UI_FRAME_START_X * 2);
-  const float_t contentHeight = height - (UI_FRAME_START_Y * 2);
-
-  errorChain(uiMenuDraw(
-    &UI_SETTINGS.tabsMenu,
-    contentX,
-    contentY,
-    contentWidth,
-    contentHeight
-  ));
-
-  const float_t tabsRowHeight = (float_t)FONT_DEFAULT.tileset->tileHeight;
-  const float_t pageY = contentY + tabsRowHeight + UI_FRAME_PADDING_Y;
-  const float_t pageHeight = contentHeight - tabsRowHeight - UI_FRAME_PADDING_Y;
-
-  if(UI_SETTINGS_ACTIVE_TAB != NULL) {
-    errorChain(uiMenuDraw(
-      UI_SETTINGS_ACTIVE_TAB->menu, contentX, pageY, contentWidth, pageHeight
-    ));
-  }
-
-  errorOk();
-}
-
-errorret_t uiSettingsUpdate(void) {
-  if(!UI_SETTINGS_PENDING_DISCARD) errorOk();
-
-  uisettingstabdef_t *def = UI_SETTINGS_PENDING_DISCARD;
-  UI_SETTINGS_PENDING_DISCARD = NULL;
-
-  return uiSettingsDiscardUpdate(def);
-}
-
-bool_t uiSettingsIsOpen(void) {
-  return uiMenuIsActive(&UI_SETTINGS.tabsMenu);
-}
-
-void uiSettingsOpen() {
-  uiSettingsLoad();
-  uiMenuOpen(&UI_SETTINGS.tabsMenu);
-}
-
-void uiSettingsClose() {
-  uiMenuClose(&UI_SETTINGS.tabsMenu);
-}
-
-errorret_t uiSettingsDispose(void) {
-  errorOk();
-}
-
-void uiSettingsLoad(void) {
-  if(UI_SETTINGS_ACTIVE_TAB != NULL) UI_SETTINGS_ACTIVE_TAB->load();
-}
-
-void uiSettingsApply(void) {
-  if(UI_SETTINGS_ACTIVE_TAB != NULL) UI_SETTINGS_ACTIVE_TAB->apply();
-}
-
-bool_t uiSettingsHasChanges(void) {
-  return UI_SETTINGS_ACTIVE_TAB != NULL && UI_SETTINGS_ACTIVE_TAB->hasChanges();
-}
-
-void uiSettingsDiscardMenuClosed(const uimenu_t *menu) {
-  uisettingstabdef_t *def = (uisettingstabdef_t *)menu->user;
-  if(def->hasChanges()) UI_SETTINGS_PENDING_DISCARD = def;
-}
-
-errorret_t uiSettingsDiscardUpdate(uisettingstabdef_t *def) {
-  #define UI_SETTINGS_DISCARD_TEXT_MAX 128
-  char_t text[UI_SETTINGS_DISCARD_TEXT_MAX];
-  errorChain(assetLocaleGetString(
-    &LOCALE.entry->data.locale,
-    "ui.confirm.discard_changes",
-    0,
-    text,
-    UI_SETTINGS_DISCARD_TEXT_MAX
-  ));
-  #undef UI_SETTINGS_DISCARD_TEXT_MAX
-
-  uiConfirmOpen(text, uiSettingsDiscardConfirmResult, def);
-
-  errorOk();
-}
-
-void uiSettingsDiscardConfirmResult(const bool_t result, void *user) {
-  uisettingstabdef_t *def = (uisettingstabdef_t *)user;
-
-  if(!result) {
-    uiMenuOpen(def->menu);
-    return;
-  }
-
-  def->load();
-}

archive/dusk/ui/frame/settings/uisettings.h

@@ -1,135 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "ui/widget/uimenu.h"
-#include "ui/frame/uiframe.h"
-#include "uisettingsdata.h"
-
-#define UI_SETTINGS_TAB_COUNT 4
-#define UI_SETTINGS_TAB_LABEL_MAX 32
-#define UI_SETTINGS_APPLY_LABEL_MAX 32
-
-typedef struct {
-  const char_t *localeId;
-  errorret_t (*init)(uisettingsdata_t *data);
-  uimenu_t *menu;
-  void (*load)(void);
-  void (*apply)(void);
-  bool_t (*hasChanges)(void);
-} uisettingstabdef_t;
-
-typedef struct {
-  uimenu_t tabsMenu;
-  uimenuitem_t tabs[UI_SETTINGS_TAB_COUNT];
-  char_t tabLabels[UI_SETTINGS_TAB_COUNT][UI_SETTINGS_TAB_LABEL_MAX];
-  char_t applyLabel[UI_SETTINGS_APPLY_LABEL_MAX];
-  uisettingsdata_t data;
-  uiframecache_t frameCache;
-} uisettings_t;
-
-extern uisettings_t UI_SETTINGS;
-extern uisettingstabdef_t UI_SETTINGS_TAB_DEFS[UI_SETTINGS_TAB_COUNT];
-
-/**
- * Menu closed callback that flags a pending discard-changes
- * confirmation if the menu's settings page/panel reports unsaved
- * changes. Pass this directly as a settings page menu's closed
- * callback. The pending def is picked up by uiSettingsUpdate on the
- * next tick.
- *
- * @param menu The menu that was just closed.
- */
-void uiSettingsDiscardMenuClosed(const uimenu_t *menu);
-
-/**
- * Shows the discard-changes confirmation dialog for def. Called once
- * by uiSettingsUpdate when uiSettingsDiscardMenuClosed has flagged a
- * pending def.
- *
- * @param def The tab/panel def to show the confirmation for.
- * @return Any error that occurs.
- */
-errorret_t uiSettingsDiscardUpdate(uisettingstabdef_t *def);
-
-/**
- * Callback passed to uiConfirmOpen by uiSettingsDiscardUpdate. Reopens
- * the menu if the user chose to keep editing, otherwise reloads the
- * widgets back to the actual engine values.
- *
- * @param result True if the user confirmed discarding changes, false
- * to keep editing.
- * @param user The uisettingstabdef_t* this confirmation belongs to.
- */
-void uiSettingsDiscardConfirmResult(const bool_t result, void *user);
-
-/**
- * Initializes the settings panel and all of its category pages.
- *
- * @return Any error that occurs.
- */
-errorret_t uiSettingsInit(void);
-
-/**
- * Draws the settings panel. No-op when not visible.
- *
- * @return Any error that occurs.
- */
-errorret_t uiSettingsDraw(void);
-
-/**
- * Updates the settings panel. Shows a discard-changes confirmation if
- * the panel was just closed with unsaved changes.
- *
- * @return Any error that occurs.
- */
-errorret_t uiSettingsUpdate(void);
-
-/**
- * Returns true when the settings panel is currently open.
- *
- * @returns True if open.
- */
-bool_t uiSettingsIsOpen(void);
-
-/**
- * Opens the settings panel. No-op when already open.
- */
-void uiSettingsOpen();
-
-/**
- * Closes the settings panel. No-op when already closed.
- */
-void uiSettingsClose();
-
-/**
- * Disposes of the settings panel.
- *
- * @return Any error that occurs.
- */
-errorret_t uiSettingsDispose(void);
-
-/**
- * Loads every category page's widgets from the current engine settings.
- * Called automatically by uiSettingsOpen.
- */
-void uiSettingsLoad(void);
-
-/**
- * Applies every category page's widget values to the engine settings.
- * Called automatically when a page's own Apply button is pressed.
- */
-void uiSettingsApply(void);
-
-/**
- * Returns whether any category page has a widget value that differs
- * from what was loaded.
- *
- * @returns True if there are unsaved changes.
- */
-bool_t uiSettingsHasChanges(void);

archive/dusk/ui/frame/settings/uisettingsaudio.c

@@ -1,47 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uisettingsaudio.h"
-#include "uisettings.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-
-void uiSettingsAudioSelected(
-  const uimenu_t *menu,
-  const uint8_t index,
-  const uimenuitem_t *item
-) {
-  if(index != UI_SETTINGS_AUDIO_INDEX_APPLY) return;
-  uiSettingsAudioApply();
-}
-
-errorret_t uiSettingsAudioInit(uisettingsdata_t *data) {
-  uisettingsaudio_t *audio = &data->audio;
-  memoryZero(audio, sizeof(uisettingsaudio_t));
-
-  MENU_BEGIN(
-    &audio->menu, audio->items,
-    uiSettingsAudioSelected, uiSettingsDiscardMenuClosed, NULL
-  );
-  MENU_LABEL("No audio settings yet");
-  MENU_BUTTON(UI_SETTINGS.applyLabel);
-
-  MENU_END(audio->items, 1);
-
-  errorOk();
-}
-
-void uiSettingsAudioLoad(void) {
-}
-
-void uiSettingsAudioApply(void) {
-  uiMenuClose(&UI_SETTINGS.data.audio.menu);
-}
-
-bool_t uiSettingsAudioHasChanges(void) {
-  return false;
-}

archive/dusk/ui/frame/settings/uisettingsaudio.h

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "uisettingsdata.h"
-
-/**
- * Initializes the audio settings page into the shared settings data
- * union.
- *
- * @param data The shared settings data union to initialize into.
- * @return Any error that occurs.
- */
-errorret_t uiSettingsAudioInit(uisettingsdata_t *data);
-
-/**
- * Loads the page's widgets from the current engine audio settings.
- */
-void uiSettingsAudioLoad(void);
-
-/**
- * Applies the page's widget values to the engine audio settings.
- */
-void uiSettingsAudioApply(void);
-
-/**
- * Returns whether any widget's value differs from what was loaded.
- *
- * @returns True if there are unsaved changes.
- */
-bool_t uiSettingsAudioHasChanges(void);

archive/dusk/ui/frame/settings/uisettingsdata.h

@@ -1,67 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "ui/widget/uimenu.h"
-
-#define UI_SETTINGS_GENERAL_ITEM_COUNT 3
-#define UI_SETTINGS_GENERAL_INDEX_LANGUAGE 0
-#define UI_SETTINGS_GENERAL_INDEX_LANGUAGE_DETAIL 1
-#define UI_SETTINGS_GENERAL_INDEX_APPLY 2
-#define UI_SETTINGS_GENERAL_LOCALE_COUNT 3
-#define UI_SETTINGS_GENERAL_LABEL_MAX 32
-#define UI_SETTINGS_GENERAL_INFO_MAX 64
-
-typedef struct {
-  uimenu_t menu;
-  uimenuitem_t items[UI_SETTINGS_GENERAL_ITEM_COUNT];
-  const char_t *localeNames[UI_SETTINGS_GENERAL_LOCALE_COUNT];
-  char_t languageLabel[UI_SETTINGS_GENERAL_LABEL_MAX];
-  char_t labelInfo[UI_SETTINGS_GENERAL_INFO_MAX];
-} uisettingsgeneral_t;
-
-#define UI_SETTINGS_INPUT_ITEM_COUNT 2
-#define UI_SETTINGS_INPUT_LABEL_MAX 32
-#define UI_SETTINGS_INPUT_INDEX_DEADZONE 0
-#define UI_SETTINGS_INPUT_INDEX_APPLY 1
-
-typedef struct {
-  uimenu_t menu;
-  uimenuitem_t items[UI_SETTINGS_INPUT_ITEM_COUNT];
-  char_t deadzoneLabel[UI_SETTINGS_INPUT_LABEL_MAX];
-} uisettingsinput_t;
-
-#define UI_SETTINGS_DISPLAY_ITEM_COUNT 2
-#define UI_SETTINGS_DISPLAY_INDEX_APPLY 1
-
-typedef struct {
-  uimenu_t menu;
-  uimenuitem_t items[UI_SETTINGS_DISPLAY_ITEM_COUNT];
-} uisettingsdisplay_t;
-
-#define UI_SETTINGS_AUDIO_ITEM_COUNT 2
-#define UI_SETTINGS_AUDIO_INDEX_APPLY 1
-
-typedef struct {
-  uimenu_t menu;
-  uimenuitem_t items[UI_SETTINGS_AUDIO_ITEM_COUNT];
-} uisettingsaudio_t;
-
-/**
- * Shared, overlapping storage for every settings tab's page data. Only
- * one member is ever live at a time -- the active tab's Init writes
- * into it, overwriting whatever the previously active tab left there.
- * This trades simultaneous access to every tab for a memory footprint
- * of only the single largest page.
- */
-typedef union {
-  uisettingsgeneral_t general;
-  uisettingsinput_t input;
-  uisettingsdisplay_t display;
-  uisettingsaudio_t audio;
-} uisettingsdata_t;

archive/dusk/ui/frame/settings/uisettingsdisplay.c

@@ -1,47 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uisettingsdisplay.h"
-#include "uisettings.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-
-void uiSettingsDisplaySelected(
-  const uimenu_t *menu,
-  const uint8_t index,
-  const uimenuitem_t *item
-) {
-  if(index != UI_SETTINGS_DISPLAY_INDEX_APPLY) return;
-  uiSettingsDisplayApply();
-}
-
-errorret_t uiSettingsDisplayInit(uisettingsdata_t *data) {
-  uisettingsdisplay_t *display = &data->display;
-  memoryZero(display, sizeof(uisettingsdisplay_t));
-
-  MENU_BEGIN(
-    &display->menu, display->items,
-    uiSettingsDisplaySelected, uiSettingsDiscardMenuClosed, NULL
-  );
-  MENU_LABEL("No display settings yet");
-  MENU_BUTTON(UI_SETTINGS.applyLabel);
-
-  MENU_END(display->items, 1);
-
-  errorOk();
-}
-
-void uiSettingsDisplayLoad(void) {
-}
-
-void uiSettingsDisplayApply(void) {
-  uiMenuClose(&UI_SETTINGS.data.display.menu);
-}
-
-bool_t uiSettingsDisplayHasChanges(void) {
-  return false;
-}

archive/dusk/ui/frame/settings/uisettingsdisplay.h

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "uisettingsdata.h"
-
-/**
- * Initializes the display settings page into the shared settings data
- * union.
- *
- * @param data The shared settings data union to initialize into.
- * @return Any error that occurs.
- */
-errorret_t uiSettingsDisplayInit(uisettingsdata_t *data);
-
-/**
- * Loads the page's widgets from the current engine display settings.
- */
-void uiSettingsDisplayLoad(void);
-
-/**
- * Applies the page's widget values to the engine display settings.
- */
-void uiSettingsDisplayApply(void);
-
-/**
- * Returns whether any widget's value differs from what was loaded.
- *
- * @returns True if there are unsaved changes.
- */
-bool_t uiSettingsDisplayHasChanges(void);

archive/dusk/ui/frame/settings/uisettingsgeneral.c

@@ -1,117 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uisettingsgeneral.h"
-#include "uisettings.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-#include "util/string.h"
-#include "locale/localemanager.h"
-#include "locale/localeinfo.h"
-#include "asset/loader/locale/assetlocaleloader.h"
-
-static const localeinfo_t *const UI_SETTINGS_GENERAL_LOCALES[
-  UI_SETTINGS_GENERAL_LOCALE_COUNT
-] = {
-  &LOCALE_EN_US,
-  &LOCALE_JP_JP,
-  &LOCALE_ES_MX
-};
-
-void uiSettingsGeneralSelected(
-  const uimenu_t *menu,
-  const uint8_t index,
-  const uimenuitem_t *item
-) {
-  switch(index) {
-    case UI_SETTINGS_GENERAL_INDEX_APPLY:
-      uiSettingsGeneralApply();
-      break;
-
-    default:
-      break;
-  }
-}
-
-errorret_t uiSettingsGeneralInit(uisettingsdata_t *data) {
-  uisettingsgeneral_t *general = &data->general;
-  memoryZero(general, sizeof(uisettingsgeneral_t));
-
-  for(uint8_t i = 0; i < UI_SETTINGS_GENERAL_LOCALE_COUNT; i++) {
-    general->localeNames[i] = UI_SETTINGS_GENERAL_LOCALES[i]->name;
-  }
-
-  errorChain(assetLocaleGetString(
-    &LOCALE.entry->data.locale,
-    "ui.settings.general.language",
-    0,
-    general->languageLabel,
-    UI_SETTINGS_GENERAL_LABEL_MAX
-  ));
-  errorChain(assetLocaleGetString(
-    &LOCALE.entry->data.locale,
-    "ui.settings.general.language_detail",
-    0,
-    general->labelInfo,
-    UI_SETTINGS_GENERAL_INFO_MAX
-  ));
-
-  MENU_BEGIN(
-    &general->menu, general->items,
-    uiSettingsGeneralSelected, uiSettingsDiscardMenuClosed, NULL
-  );
-
-  MENU_DROPDOWN(
-    general->languageLabel, general->localeNames,
-    UI_SETTINGS_GENERAL_LOCALE_COUNT, 0
-  );
-  MENU_LABEL(general->labelInfo);
-
-  MENU_BUTTON(UI_SETTINGS.applyLabel);
-  MENU_END(general->items, 1);
-
-  errorOk();
-}
-
-void uiSettingsGeneralLoad(void) {
-  uisettingsgeneral_t *general = &UI_SETTINGS.data.general;
-
-  uint8_t index = 0;
-  for(uint8_t i = 0; i < UI_SETTINGS_GENERAL_LOCALE_COUNT; i++) {
-    if(stringCompare(LOCALE.locale->file, UI_SETTINGS_GENERAL_LOCALES[i]->file) != 0) {
-      continue;
-    }
-    index = i;
-    break;
-  }
-
-  uiDropdownSetSelectedIndex(
-    &general->items[UI_SETTINGS_GENERAL_INDEX_LANGUAGE].dropdown, index
-  );
-}
-
-void uiSettingsGeneralApply(void) {
-  uisettingsgeneral_t *general = &UI_SETTINGS.data.general;
-
-  uint8_t index = uiDropdownGetSelectedIndex(
-    &general->items[UI_SETTINGS_GENERAL_INDEX_LANGUAGE].dropdown
-  );
-  errorCatch(localeManagerSetLocale(UI_SETTINGS_GENERAL_LOCALES[index]));
-
-  uiMenuClose(&general->menu);
-}
-
-bool_t uiSettingsGeneralHasChanges(void) {
-  uisettingsgeneral_t *general = &UI_SETTINGS.data.general;
-
-  uint8_t index = uiDropdownGetSelectedIndex(
-    &general->items[UI_SETTINGS_GENERAL_INDEX_LANGUAGE].dropdown
-  );
-  return stringCompare(
-    LOCALE.locale->file, UI_SETTINGS_GENERAL_LOCALES[index]->file
-  ) != 0;
-}

archive/dusk/ui/frame/settings/uisettingsgeneral.h

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "uisettingsdata.h"
-
-/**
- * Initializes the general settings page into the shared settings data
- * union.
- *
- * @param data The shared settings data union to initialize into.
- * @return Any error that occurs.
- */
-errorret_t uiSettingsGeneralInit(uisettingsdata_t *data);
-
-/**
- * Loads the page's widgets from the current engine general settings.
- */
-void uiSettingsGeneralLoad(void);
-
-/**
- * Applies the page's widget values to the engine general settings.
- */
-void uiSettingsGeneralApply(void);
-
-/**
- * Returns whether any widget's value differs from what was loaded.
- *
- * @returns True if there are unsaved changes.
- */
-bool_t uiSettingsGeneralHasChanges(void);

archive/dusk/ui/frame/settings/uisettingsinput.c

@@ -1,82 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uisettingsinput.h"
-#include "uisettings.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-#include "locale/localemanager.h"
-#include "asset/loader/locale/assetlocaleloader.h"
-#include "input/input.h"
-#include "save/savesettings.h"
-
-void uiSettingsInputSelected(
-  const uimenu_t *menu,
-  const uint8_t index,
-  const uimenuitem_t *item
-) {
-  if(index != UI_SETTINGS_INPUT_INDEX_APPLY) return;
-  uiSettingsInputApply();
-}
-
-errorret_t uiSettingsInputInit(uisettingsdata_t *data) {
-  uisettingsinput_t *input = &data->input;
-  memoryZero(input, sizeof(uisettingsinput_t));
-
-  MENU_BEGIN(
-    &input->menu, input->items,
-    uiSettingsInputSelected, uiSettingsDiscardMenuClosed, NULL
-  );
-  #ifdef DUSK_INPUT_GAMEPAD
-    errorChain(assetLocaleGetString(
-      &LOCALE.entry->data.locale,
-      "ui.settings.input.deadzone",
-      0,
-      input->deadzoneLabel,
-      UI_SETTINGS_INPUT_LABEL_MAX
-    ));
-    MENU_SLIDER_FLOAT(
-      input->deadzoneLabel, INPUT_DEADZONE_DEFAULT, 0.0f, 1.0f, 0.05f
-    );
-  #else
-    MENU_LABEL("No input settings yet");
-  #endif
-
-  MENU_BUTTON(UI_SETTINGS.applyLabel);
-  MENU_END(input->items, 1);
-
-  errorOk();
-}
-
-void uiSettingsInputLoad(void) {
-  #ifdef DUSK_INPUT_GAMEPAD
-    uiSliderSetFloat(
-      &UI_SETTINGS.data.input.items[UI_SETTINGS_INPUT_INDEX_DEADZONE].slider,
-      INPUT.deadzone
-    );
-  #endif
-}
-
-void uiSettingsInputApply(void) {
-  #ifdef DUSK_INPUT_GAMEPAD
-    INPUT.deadzone = uiSliderGetFloat(
-      &UI_SETTINGS.data.input.items[UI_SETTINGS_INPUT_INDEX_DEADZONE].slider
-    );
-  #endif
-  errorCatch(errorPrint(saveSettingsWrite()));
-  uiMenuClose(&UI_SETTINGS.data.input.menu);
-}
-
-bool_t uiSettingsInputHasChanges(void) {
-  #ifdef DUSK_INPUT_GAMEPAD
-    if(uiSliderGetFloat(
-      &UI_SETTINGS.data.input.items[UI_SETTINGS_INPUT_INDEX_DEADZONE].slider
-    ) != INPUT.deadzone) return true;
-  #endif
-
-  return false;
-}

archive/dusk/ui/frame/settings/uisettingsinput.h

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "uisettingsdata.h"
-
-/**
- * Initializes the input settings page into the shared settings data
- * union.
- *
- * @param data The shared settings data union to initialize into.
- * @return Any error that occurs.
- */
-errorret_t uiSettingsInputInit(uisettingsdata_t *data);
-
-/**
- * Loads the page's widgets from the current engine input settings.
- */
-void uiSettingsInputLoad(void);
-
-/**
- * Applies the page's widget values to the engine input settings.
- */
-void uiSettingsInputApply(void);
-
-/**
- * Returns whether any widget's value differs from what was loaded.
- *
- * @returns True if there are unsaved changes.
- */
-bool_t uiSettingsInputHasChanges(void);

archive/dusk/ui/frame/uiframe.h

@@ -1,122 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "display/texture/texture.h"
-#include "display/texture/tileset.h"
-#include "display/spritebatch/spritebatchsprite.h"
-
-#define UI_FRAME_BORDER_WIDTH 6
-#define UI_FRAME_BORDER_HEIGHT 6
-#define UI_FRAME_PADDING_X 2
-#define UI_FRAME_PADDING_Y 2
-#define UI_FRAME_START_X (UI_FRAME_BORDER_WIDTH + UI_FRAME_PADDING_X)
-#define UI_FRAME_START_Y (UI_FRAME_BORDER_HEIGHT + UI_FRAME_PADDING_Y)
-#define UI_FRAME_TILE_WIDTH 1
-#define UI_FRAME_TILE_HEIGHT 1
-#define UI_FRAME_TEXTURE_WIDTH (UI_FRAME_TILE_WIDTH * 3)
-#define UI_FRAME_TEXTURE_HEIGHT (UI_FRAME_TILE_HEIGHT * 3)
-#define UI_FRAME_TEXTURE_WIDTH_POW2 4
-#define UI_FRAME_TEXTURE_HEIGHT_POW2 4 
-
-typedef struct {
-  tileset_t tileset;
-  texture_t texture;
-  color_t pixels[UI_FRAME_BORDER_WIDTH * UI_FRAME_BORDER_HEIGHT];
-} uiframe_t;
-
-extern uiframe_t UI_FRAME;
-
-/**
- * Initializes the global UI_FRAME: builds the dummy texture and
- * configures the tileset. Call once after displayInit().
- *
- * @return Any error that occurs.
- */
-errorret_t uiFrameInit(void);
-
-/**
- * Draws UI_FRAME using 9-slice rendering from its 3x3 tileset.
- * Pushes quads to the sprite batch without flushing.
- *
- * @param x Screen x position.
- * @param y Screen y position.
- * @param width Total width of the frame.
- * @param height Total height of the frame.
- * @return Any error that occurs.
- */
-errorret_t uiFrameDraw(
-  const float_t x,
-  const float_t y,
-  const float_t width,
-  const float_t height
-);
-
-/**
- * Builds the 9 sprites for a 9-slice frame at the given rect. Used
- * internally by uiFrameDraw and uiFrameDrawCached -- call directly only
- * if you need the raw sprites instead of buffering them.
- *
- * @param sprites Destination array of exactly 9 sprites.
- * @param x Screen x position.
- * @param y Screen y position.
- * @param width Total width of the frame.
- * @param height Total height of the frame.
- */
-void uiFrameBuildSprites(
-  spritebatchsprite_t sprites[9],
-  const float_t x,
-  const float_t y,
-  const float_t width,
-  const float_t height
-);
-
-/**
- * A frame's cached 9-slice sprites, plus the rect they were built for.
- * Owned by whichever widget/screen draws a frame repeatedly (dialogs,
- * textboxes, settings panels) so uiFrameDrawCached can skip rebuilding
- * the sprites when the rect hasn't moved since the last draw.
- */
-typedef struct {
-  spritebatchsprite_t sprites[9];
-  bool_t built;
-  float_t lastX;
-  float_t lastY;
-  float_t lastWidth;
-  float_t lastHeight;
-} uiframecache_t;
-
-/**
- * Draws a 9-slice frame using a caller-owned cache, only rebuilding the
- * sprites (via uiFrameBuildSprites) when x/y/width/height differ from
- * the last call -- unlike uiFrameDraw, which rebuilds unconditionally
- * every time. Prefer this for frames redrawn every frame at a fixed or
- * rarely-changing rect (dialogs, panels); use plain uiFrameDraw for
- * genuinely one-off or per-frame-varying rects.
- *
- * @param cache Caller-owned cache, zero-initialized before first use.
- * @param x Screen x position.
- * @param y Screen y position.
- * @param width Total width of the frame.
- * @param height Total height of the frame.
- * @return Any error that occurs.
- */
-errorret_t uiFrameDrawCached(
-  uiframecache_t *cache,
-  const float_t x,
-  const float_t y,
-  const float_t width,
-  const float_t height
-);
-
-/**
- * Disposes of the global UI_FRAME, releasing its GPU texture.
- *
- * @return Any error that occurs.
- */
-errorret_t uiFrameDispose(void);

archive/dusk/ui/ui.c

@@ -1,62 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- * 
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "ui.h"
-#include "util/memory.h"
-#include "assert/assert.h"
-#include "display/spritebatch/spritebatch.h"
-#include "display/screen/screen.h"
-#include "ui/uielement.h"
-#include "ui/focus/uifocus.h"
-
-ui_t UI;
-
-errorret_t uiInit(void) {
-  memoryZero(&UI, sizeof(ui_t));
-  uiFocusInit();
-  uiElementsSort();
-
-  uielement_t *element = &UI_ELEMENTS[0];
-  while(!uiElementIsNull(element)) {
-    errorChain(uiElementInit(element));
-    element++;
-  }
-
-  errorOk();
-}
-
-errorret_t uiUpdate(void) {
-  uiFocusUpdate();
-
-  uielement_t *element = &UI_ELEMENTS[0];
-  while(!uiElementIsNull(element)) {
-    errorChain(uiElementUpdate(element));
-    element++;
-  }
-
-  errorOk();
-}
-
-errorret_t uiRender(void) {
-  const uielement_t *element = &UI_ELEMENTS[0];
-  while(!uiElementIsNull(element)) {
-    errorChain(uiElementDraw(element));
-    element++;
-  }
-
-  errorChain(spriteBatchFlush());
-  errorOk();
-}
-
-errorret_t uiDispose(void) {
-  uielement_t *element = &UI_ELEMENTS[0];
-  while(!uiElementIsNull(element)) {
-    errorChain(uiElementDispose(element));
-    element++;
-  }
-  errorOk();
-}

archive/dusk/ui/ui.h

@@ -1,41 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- * 
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-
-typedef struct {
-  void *nothing;
-} ui_t;
-
-extern ui_t UI;
-
-/**
- * Initializes the UI system.
- */
-errorret_t uiInit(void);
-
-/**
- * Updates the UI system.
- *
- * @return Any error that occurs.
- */
-errorret_t uiUpdate(void);
-
-/**
- * Renders the UI system.
- * 
- * @return Any error that occurs.
- */
-errorret_t uiRender(void);
-
-/**
- * Disposes of the UI system.
- *
- * @return Any error that occurs.
- */
-errorret_t uiDispose(void);

archive/dusk/ui/uielement.c

@@ -1,86 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uielement.h"
-#include "assert/assert.h"
-#include "util/sort.h"
-#include "ui/frame/uiframe.h"
-#include "ui/debug/uifps.h"
-#include "engine/engine.h"
-#include "ui/overlay/uifullbox.h"
-#include "ui/overlay/uiloading.h"
-#include "ui/overlay/uicrop.h"
-#include "ui/transition/uitransition.h"
-#include "ui/debug/uiconsole.h"
-#include "ui/frame/uiconfirm.h"
-
-// Priming pass: X does nothing here, so this only exists to process any
-// #include directives nested in uielementlist.h/ui/uielementgame.h at
-// file scope (each such header's own #pragma once makes it a no-op on
-// the real pass below, which happens inside UI_ELEMENTS[]'s braces,
-// where a raw #include of a declaration would be invalid).
-#define X(initFn, updateFn, drawFn, disposeFn, order) // do nothing
-#include "uielementlist.h"
-#undef X
-
-uielement_t UI_ELEMENTS[] = {
-  #define X(initFn, updateFn, drawFn, disposeFn, elementOrder) \
-    { \
-      .init = initFn, .update = updateFn, .draw = drawFn, \
-      .dispose = disposeFn, .order = elementOrder \
-    },
-  #include "uielementlist.h"
-  #undef X
-
-  { 0 } // Null terminator
-};
-
-bool_t uiElementIsNull(const uielement_t *element) {
-  return element->init == NULL &&
-    element->update == NULL &&
-    element->draw == NULL &&
-    element->dispose == NULL;
-}
-
-int_t uiElementCompareOrder(const void *a, const void *b) {
-  const uielement_t *elementA = (const uielement_t *)a;
-  const uielement_t *elementB = (const uielement_t *)b;
-  if(elementA->order < elementB->order) return -1;
-  if(elementA->order > elementB->order) return 1;
-  return 0;
-}
-
-void uiElementsSort(void) {
-  // The trailing null terminator is always the last static entry -- sort
-  // everything before it, and leave it in place.
-  const size_t count = (sizeof(UI_ELEMENTS) / sizeof(UI_ELEMENTS[0])) - 1;
-  sortBubble(UI_ELEMENTS, count, sizeof(uielement_t), uiElementCompareOrder);
-}
-
-errorret_t uiElementInit(uielement_t *element) {
-  assertNotNull(element, "element must not be NULL");
-  if(element->init != NULL) errorChain(element->init());
-  errorOk();
-}
-
-errorret_t uiElementUpdate(uielement_t *element) {
-  assertNotNull(element, "element must not be NULL");
-  if(element->update != NULL) errorChain(element->update());
-  errorOk();
-}
-
-errorret_t uiElementDraw(const uielement_t *element) {
-  assertNotNull(element, "element must not be NULL");
-  if(element->draw != NULL) errorChain(element->draw());
-  errorOk();
-}
-
-errorret_t uiElementDispose(uielement_t *element) {
-  assertNotNull(element, "element must not be NULL");
-  if(element->dispose != NULL) errorChain(element->dispose());
-  errorOk();
-}

archive/dusk/ui/uielement.h

@@ -1,84 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-
-// Built-in order tiers. Lower values update/render first; ties preserve
-// their relative UI_ELEMENTS declaration order (uiElementsSort uses a
-// stable sort). Game-specific elements can use any int32_t value -- these
-// are just the ones the engine itself relies on.
-#define UI_ELEMENT_ORDER_DEFAULT 0
-#define UI_ELEMENT_ORDER_DEBUG   1000
-
-typedef struct {
-  errorret_t (*init)();
-  errorret_t (*update)();
-  errorret_t (*draw)();
-  errorret_t (*dispose)();
-  int32_t order;
-} uielement_t;
-
-extern uielement_t UI_ELEMENTS[];
-
-/**
- * Returns true when all four callbacks on the element are NULL,
- * which marks the end of the UI_ELEMENTS array.
- *
- * @param element The element to test.
- * @returns True if the element is the null terminator.
- */
-bool_t uiElementIsNull(const uielement_t *element);
-
-/**
- * Compares two elements by their .order field, ascending. Matches
- * sortcompare_t, for use with the project's sort utilities.
- *
- * @param a First uielement_t to compare.
- * @param b Second uielement_t to compare.
- * @return Negative if a < b, zero if a == b, positive if a > b.
- */
-int_t uiElementCompareOrder(const void *a, const void *b);
-
-/**
- * Stably sorts UI_ELEMENTS in place by .order, ascending. The trailing
- * null terminator is never moved. Called once by uiInit -- element order
- * is static after that, so there's no need to re-sort every frame.
- */
-void uiElementsSort(void);
-
-/**
- * Initializes a UI element, invoking its init callback if set.
- *
- * @param element The element to initialize.
- * @return Any error that occurs.
- */
-errorret_t uiElementInit(uielement_t *element);
-
-/**
- * Updates a UI element, calling its update callback if set.
- *
- * @param element The element to update.
- * @return Any error that occurs.
- */
-errorret_t uiElementUpdate(uielement_t *element);
-
-/**
- * Draws a UI element, calling its draw callback if set.
- *
- * @param element The element to render.
- * @return Any error that occurs.
- */
-errorret_t uiElementDraw(const uielement_t *element);
-
-/**
- * Disposes of a UI element, invoking its dispose callback if set.
- *
- * @param element The element to dispose.
- * @return Any error that occurs.
- */
-errorret_t uiElementDispose(uielement_t *element);

archive/dusk/ui/uielementlist.h

@@ -1,47 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-// X(init, update, draw, dispose, order) -- pass NULL for any callback the
-// element doesn't need. order controls update/draw sequence (lower first,
-// see UI_ELEMENT_ORDER_* in uielement.h); ties preserve declaration order.
-// See uielement.c for how this expands.
-
-X(uiFrameInit, NULL, NULL, uiFrameDispose, UI_ELEMENT_ORDER_DEFAULT)
-
-// Fullbox under: above scene, below system UI.
-X(
-  uiFullboxUnderInit, uiFullboxUnderUpdate, uiFullboxUnderDraw, NULL,
-  UI_ELEMENT_ORDER_DEFAULT
-)
-
-// Text stuffs
-X(uiConfirmInit, NULL, uiConfirmDraw, uiConfirmDispose, UI_ELEMENT_ORDER_DEFAULT)
-
-X(
-  uiTransitionInit, uiTransitionUpdate, uiTransitionDraw, NULL,
-  UI_ELEMENT_ORDER_DEFAULT
-)
-
-// Fullbox over: above absolutely everything (except debug).
-X(
-  uiFullboxOverInit, uiFullboxOverUpdate, uiFullboxOverDraw, NULL,
-  UI_ELEMENT_ORDER_DEFAULT
-)
-
-X(
-  uiLoadingInit, uiLoadingUpdate, uiLoadingDraw, NULL,
-  UI_ELEMENT_ORDER_DEFAULT
-)
-
-X(uiCropInit, NULL, uiCropDraw, NULL, UI_ELEMENT_ORDER_DEFAULT)
-
-// Debug items -- always last.
-X(NULL, NULL, uiConsoleDraw, uiConsoleDispose, UI_ELEMENT_ORDER_DEBUG)
-X(uiFPSInit, NULL, uiFPSDraw, NULL, UI_ELEMENT_ORDER_DEBUG)
-
-// Game-specific UI elements (duskrpg)
-#include "ui/uielementgame.h"

archive/dusk/ui/widget/CMakeLists.txt

@@ -1,17 +0,0 @@
-# Copyright (c) 2026 Dominic Masters
-#
-# This software is released under the MIT License.
-# https://opensource.org/licenses/MIT
-
-target_sources(${DUSK_LIBRARY_TARGET_NAME}
-  PUBLIC
-    uibutton.c
-    uicheckbox.c
-    uitab.c
-    uislider.c
-    uidropdown.c
-    uiscrolling.c
-    uimenu.c
-    uilabel.c
-    uiwidgetlabel.c
-)

archive/dusk/ui/widget/uilabel.c

@@ -1,70 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uilabel.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-#include "util/string.h"
-#include "display/text/text.h"
-
-void uiLabelInit(uilabel_t *label, font_t *font) {
-  assertNotNull(label, "Label cannot be NULL");
-  assertNotNull(font, "Font cannot be NULL");
-
-  memoryZero(label, sizeof(uilabel_t));
-  label->font = font;
-  label->color = COLOR_WHITE;
-}
-
-void uiLabelSetText(uilabel_t *label, const char_t *text) {
-  assertNotNull(label, "Label cannot be NULL");
-  assertNotNull(text, "Text cannot be NULL");
-  assertStrLenMax(text, UI_LABEL_TEXT_MAX, "Label text too long");
-
-  stringCopy(label->text, text, UI_LABEL_TEXT_MAX);
-  label->spriteCount = textBuildSpriteCache(
-    label->text, label->font, label->sprites, UI_LABEL_SPRITE_COUNT_MAX,
-    &label->width, &label->height
-  );
-}
-
-void uiLabelSetColor(uilabel_t *label, const color_t color) {
-  assertNotNull(label, "Label cannot be NULL");
-  label->color = color;
-}
-
-void uiLabelGetSize(
-  const uilabel_t *label,
-  int32_t *outWidth,
-  int32_t *outHeight
-) {
-  assertNotNull(label, "Label cannot be NULL");
-  assertNotNull(outWidth, "Output width cannot be NULL");
-  assertNotNull(outHeight, "Output height cannot be NULL");
-  *outWidth = label->width;
-  *outHeight = label->height;
-}
-
-errorret_t uiLabelDraw(
-  const uilabel_t *label,
-  const float_t x,
-  const float_t y
-) {
-  assertNotNull(label, "Label cannot be NULL");
-  if(label->spriteCount == 0) errorOk();
-
-  // Cached sprites are relative to (0,0); textDrawSpriteCache translates
-  // into the requested screen position here instead of in
-  // uiLabelSetText, so a label can be repositioned every frame without
-  // rebuilding the (much more expensive) glyph/UV cache.
-  spritebatchsprite_t scratch[UI_LABEL_SPRITE_COUNT_MAX];
-  errorChain(textDrawSpriteCache(
-    label->sprites, label->spriteCount, scratch, x, y, label->color,
-    label->font->texture
-  ));
-  errorOk();
-}

archive/dusk/ui/widget/uilabel.h

@@ -1,85 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "display/text/font.h"
-#include "display/spritebatch/spritebatchsprite.h"
-#include "display/color.h"
-
-#define UI_LABEL_TEXT_MAX 256
-#define UI_LABEL_SPRITE_COUNT_MAX UI_LABEL_TEXT_MAX
-
-typedef struct {
-  char_t text[UI_LABEL_TEXT_MAX];
-  color_t color;
-  font_t *font;
-
-  spritebatchsprite_t sprites[UI_LABEL_SPRITE_COUNT_MAX];
-  uint32_t spriteCount;
-  int32_t width;
-  int32_t height;
-} uilabel_t;
-
-/**
- * Initializes a label, defaulting to white text and no text set.
- *
- * @param label The label to initialize.
- * @param font Font to use for rendering. Must outlive the label.
- */
-void uiLabelInit(uilabel_t *label, font_t *font);
-
-/**
- * Sets the label's text, rebuilding its cached sprites (glyph lookup, UV,
- * and layout) immediately. This is the only way the sprite cache gets
- * rebuilt -- uiLabelDraw never recomputes it, so call this whenever the
- * text changes rather than once up front and expecting it to stay in sync.
- *
- * @param label The label to update.
- * @param text Null-terminated string to display. Must be shorter than
- * UI_LABEL_TEXT_MAX.
- */
-void uiLabelSetText(uilabel_t *label, const char_t *text);
-
-/**
- * Sets the label's tint color. Cheap -- doesn't touch the sprite cache,
- * since color is applied via the draw material, not baked into sprites.
- *
- * @param label The label to update.
- * @param color The new tint color.
- */
-void uiLabelSetColor(uilabel_t *label, const color_t color);
-
-/**
- * Gets the measured size (in pixels) of the label's current text, cached
- * from the last uiLabelSetText call.
- *
- * @param label The label to query.
- * @param outWidth Pointer to store the width.
- * @param outHeight Pointer to store the height.
- */
-void uiLabelGetSize(
-  const uilabel_t *label,
-  int32_t *outWidth,
-  int32_t *outHeight
-);
-
-/**
- * Draws the label's cached sprites at the given screen position in a
- * single batched buffer call. Does not recompute glyph layout -- call
- * uiLabelSetText first whenever the text changes.
- *
- * @param label The label to draw.
- * @param x Screen x position.
- * @param y Screen y position.
- * @return Any error that occurs.
- */
-errorret_t uiLabelDraw(
-  const uilabel_t *label,
-  const float_t x,
-  const float_t y
-);

archive/dusk/ui/widget/uiwidgetlabel.c

@@ -1,66 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uiwidgetlabel.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-#include "util/string.h"
-#include "display/text/text.h"
-
-void uiWidgetLabelInit(uiwidgetlabel_t *label, font_t *font) {
-  assertNotNull(label, "Label cannot be NULL");
-  assertNotNull(font, "Font cannot be NULL");
-
-  memoryZero(label, sizeof(uiwidgetlabel_t));
-  label->font = font;
-  label->color = COLOR_WHITE;
-}
-
-void uiWidgetLabelSetText(uiwidgetlabel_t *label, const char_t *text) {
-  assertNotNull(label, "Label cannot be NULL");
-  assertNotNull(text, "Text cannot be NULL");
-  assertStrLenMax(text, UI_WIDGET_LABEL_TEXT_MAX, "Label text too long");
-
-  stringCopy(label->text, text, UI_WIDGET_LABEL_TEXT_MAX);
-  label->spriteCount = textBuildSpriteCache(
-    label->text, label->font, label->sprites,
-    UI_WIDGET_LABEL_SPRITE_COUNT_MAX, &label->width, &label->height
-  );
-}
-
-void uiWidgetLabelSetColor(uiwidgetlabel_t *label, const color_t color) {
-  assertNotNull(label, "Label cannot be NULL");
-  label->color = color;
-}
-
-void uiWidgetLabelGetSize(
-  const uiwidgetlabel_t *label,
-  int32_t *outWidth,
-  int32_t *outHeight
-) {
-  assertNotNull(label, "Label cannot be NULL");
-  assertNotNull(outWidth, "Output width cannot be NULL");
-  assertNotNull(outHeight, "Output height cannot be NULL");
-  *outWidth = label->width;
-  *outHeight = label->height;
-}
-
-errorret_t uiWidgetLabelDraw(
-  const uiwidgetlabel_t *label,
-  const float_t x,
-  const float_t y
-) {
-  assertNotNull(label, "Label cannot be NULL");
-  if(label->spriteCount == 0) errorOk();
-
-  spritebatchsprite_t scratch[UI_WIDGET_LABEL_SPRITE_COUNT_MAX];
-  errorChain(textDrawSpriteCache(
-    label->sprites, label->spriteCount, scratch, x, y, label->color,
-    label->font->texture
-  ));
-  errorOk();
-}

archive/dusk/ui/widget/uiwidgetlabel.h

@@ -1,90 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "display/text/font.h"
-#include "display/spritebatch/spritebatchsprite.h"
-#include "display/color.h"
-
-// A cached, cheap-to-redraw label sized for embedding directly inside
-// small widgets (buttons, checkboxes, sliders, ...) rather than
-// referencing text by pointer and re-deriving glyph geometry every
-// frame. Capacity is intentionally much smaller than uilabel_t's -- it
-// gets embedded by value in every widget instance (and inside
-// uimenuitem_t's union, which is often arrayed), so keeping it small
-// matters on memory-constrained targets. See uilabel_t for the
-// general-purpose, larger-capacity equivalent.
-#define UI_WIDGET_LABEL_TEXT_MAX 64
-#define UI_WIDGET_LABEL_SPRITE_COUNT_MAX UI_WIDGET_LABEL_TEXT_MAX
-
-typedef struct {
-  char_t text[UI_WIDGET_LABEL_TEXT_MAX];
-  color_t color;
-  font_t *font;
-
-  spritebatchsprite_t sprites[UI_WIDGET_LABEL_SPRITE_COUNT_MAX];
-  uint32_t spriteCount;
-  int32_t width;
-  int32_t height;
-} uiwidgetlabel_t;
-
-/**
- * Initializes a widget label, defaulting to white text and no text set.
- *
- * @param label The label to initialize.
- * @param font Font to use for rendering. Must outlive the label.
- */
-void uiWidgetLabelInit(uiwidgetlabel_t *label, font_t *font);
-
-/**
- * Sets the label's text, rebuilding its cached sprites immediately.
- * Call this whenever the displayed text changes -- uiWidgetLabelDraw
- * never recomputes it.
- *
- * @param label The label to update.
- * @param text Null-terminated string to display. Must be shorter than
- * UI_WIDGET_LABEL_TEXT_MAX.
- */
-void uiWidgetLabelSetText(uiwidgetlabel_t *label, const char_t *text);
-
-/**
- * Sets the label's tint color. Cheap -- doesn't touch the sprite cache.
- *
- * @param label The label to update.
- * @param color The new tint color.
- */
-void uiWidgetLabelSetColor(uiwidgetlabel_t *label, const color_t color);
-
-/**
- * Gets the measured size (in pixels) of the label's current text, cached
- * from the last uiWidgetLabelSetText call.
- *
- * @param label The label to query.
- * @param outWidth Pointer to store the width.
- * @param outHeight Pointer to store the height.
- */
-void uiWidgetLabelGetSize(
-  const uiwidgetlabel_t *label,
-  int32_t *outWidth,
-  int32_t *outHeight
-);
-
-/**
- * Draws the label's cached sprites at the given screen position in a
- * single batched buffer call. Does not recompute glyph layout.
- *
- * @param label The label to draw.
- * @param x Screen x position.
- * @param y Screen y position.
- * @return Any error that occurs.
- */
-errorret_t uiWidgetLabelDraw(
-  const uiwidgetlabel_t *label,
-  const float_t x,
-  const float_t y
-);

archive/duskrpg/ui/uitestlabel.c

@@ -1,35 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "uitestlabel.h"
-#include "ui/widget/uilabel.h"
-#include "display/text/text.h"
-#include "display/screen/screen.h"
-#include "engine/engine.h"
-
-uilabel_t UI_TEST_LABEL;
-
-errorret_t uiTestLabelInit() {
-  uiLabelInit(&UI_TEST_LABEL, &FONT_DEFAULT);
-  uiLabelSetText(&UI_TEST_LABEL, "duskrpg");
-  errorOk();
-}
-
-errorret_t uiTestLabelDraw() {
-  int32_t versionWidth, versionHeight;
-  textMeasure(ENGINE.version, &FONT_DEFAULT, &versionWidth, &versionHeight);
-
-  errorChain(uiLabelDraw(
-    &UI_TEST_LABEL,
-    (float_t)(SCREEN.scanX + SCREEN.scanWidth - UI_TEST_LABEL.width),
-    (float_t)(
-      SCREEN.scanY + SCREEN.scanHeight - versionHeight -
-      UI_TEST_LABEL.height
-    )
-  ));
-  errorOk();
-}

archive/duskrpg/ui/uitestlabel.h

@@ -1,24 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-
-/**
- * Initializes the test label, a smoke test for the duskrpg-side UI
- * element extension point (uielementgame.h).
- *
- * @return Any error that occurs.
- */
-errorret_t uiTestLabelInit();
-
-/**
- * Draws the test label above the engine's debug version number.
- *
- * @return Any error that occurs.
- */
-errorret_t uiTestLabelDraw();

archive/test/ui/test_uiframe.c

@@ -1,68 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "dusktest.h"
-#include "ui/frame/uiframe.h"
-
-static void test_uiFrameBuildSprites_layout(void **state) {
-  UI_FRAME.tileset = (tileset_t){
-    .tileWidth = 1,
-    .tileHeight = 1,
-    .tileCount = 9,
-    .columns = 3,
-    .rows = 3,
-    .uv = { 0.25f, 0.25f }
-  };
-
-  const float_t x = 100.0f;
-  const float_t y = 50.0f;
-  const float_t width = 40.0f;
-  const float_t height = 30.0f;
-  const float_t tileW = (float_t)UI_FRAME_BORDER_WIDTH;
-  const float_t tileH = (float_t)UI_FRAME_BORDER_HEIGHT;
-
-  spritebatchsprite_t sprites[9];
-  uiFrameBuildSprites(sprites, x, y, width, height);
-
-  // Top-left corner sits exactly at the rect's origin.
-  assert_float_equal(sprites[0].min[0], x, 0.0001f);
-  assert_float_equal(sprites[0].min[1], y, 0.0001f);
-  assert_float_equal(sprites[0].max[0], x + tileW, 0.0001f);
-  assert_float_equal(sprites[0].max[1], y + tileH, 0.0001f);
-  assert_float_equal(sprites[0].uvMin[0], 0.0f, 0.0001f);
-  assert_float_equal(sprites[0].uvMin[1], 0.0f, 0.0001f);
-  assert_float_equal(sprites[0].uvMax[0], 0.25f, 0.0001f);
-  assert_float_equal(sprites[0].uvMax[1], 0.25f, 0.0001f);
-
-  // Top-middle edge stretches to fill the width minus both corners.
-  assert_float_equal(sprites[1].min[0], x + tileW, 0.0001f);
-  assert_float_equal(sprites[1].max[0], x + width - tileW, 0.0001f);
-  assert_float_equal(sprites[1].max[1], y + tileH, 0.0001f);
-
-  // Center tile fills the remaining interior on both axes.
-  assert_float_equal(sprites[4].min[0], x + tileW, 0.0001f);
-  assert_float_equal(sprites[4].min[1], y + tileH, 0.0001f);
-  assert_float_equal(sprites[4].max[0], x + width - tileW, 0.0001f);
-  assert_float_equal(sprites[4].max[1], y + height - tileH, 0.0001f);
-
-  // Bottom-right corner sits exactly at the rect's far corner, sampling
-  // tileset column 2, row 2.
-  assert_float_equal(sprites[8].min[0], x + width - tileW, 0.0001f);
-  assert_float_equal(sprites[8].min[1], y + height - tileH, 0.0001f);
-  assert_float_equal(sprites[8].max[0], x + width, 0.0001f);
-  assert_float_equal(sprites[8].max[1], y + height, 0.0001f);
-  assert_float_equal(sprites[8].uvMin[0], 0.5f, 0.0001f);
-  assert_float_equal(sprites[8].uvMin[1], 0.5f, 0.0001f);
-}
-
-int main(int argc, char **argv) {
-  const struct CMUnitTest tests[] = {
-    cmocka_unit_test(test_uiFrameBuildSprites_layout),
-  };
-
-  return cmocka_run_group_tests(tests, NULL, NULL);
-}

archive/test/ui/test_uislider.c

@@ -1,114 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "dusktest.h"
-#include "ui/widget/uislider.h"
-#include "util/memory.h"
-
-// uiSliderInitFloat/InitInt require a real font (FONT_DEFAULT) to build
-// the label's glyph cache, which needs a live GL context this test binary
-// doesn't have -- see the label size caching contract for why this is
-// safe to bypass here (uiSliderRebuildGeometry only reads slider->label's
-// already-measured width/height, it never touches the font itself).
-static void sliderSetupFloat(
-  uislider_t *slider,
-  const float_t value,
-  const float_t min,
-  const float_t max,
-  const float_t step
-) {
-  memoryZero(slider, sizeof(uislider_t));
-  slider->label.width = 20;
-  slider->label.height = 10;
-  slider->type = UI_SLIDER_TYPE_FLOAT;
-  slider->min.f = min;
-  slider->max.f = max;
-  slider->step.f = step;
-  slider->value.f = value;
-}
-
-static void sliderSetupInt(
-  uislider_t *slider,
-  const int32_t value,
-  const int32_t min,
-  const int32_t max,
-  const int32_t step
-) {
-  memoryZero(slider, sizeof(uislider_t));
-  slider->label.width = 20;
-  slider->label.height = 10;
-  slider->type = UI_SLIDER_TYPE_INT;
-  slider->min.i = min;
-  slider->max.i = max;
-  slider->step.i = step;
-  slider->value.i = value;
-}
-
-static void test_uiSliderRebuildGeometry_trackPosition(void **state) {
-  uislider_t slider;
-  sliderSetupFloat(&slider, 0.0f, 0.0f, 1.0f, 0.1f);
-  uiSliderRebuildGeometry(&slider);
-
-  const float_t expectedX = (float_t)slider.label.width + UI_SLIDER_GAP;
-  const float_t expectedY =
-    ((float_t)slider.label.height - UI_SLIDER_TRACK_HEIGHT) * 0.5f;
-
-  assert_float_equal(slider.cachedTrack.min[0], expectedX, 0.0001f);
-  assert_float_equal(slider.cachedTrack.min[1], expectedY, 0.0001f);
-  assert_float_equal(
-    slider.cachedTrack.max[0], expectedX + UI_SLIDER_TRACK_WIDTH, 0.0001f
-  );
-}
-
-static void test_uiSliderRebuildGeometry_fillVisibility(void **state) {
-  uislider_t slider;
-
-  // At the minimum value, the ratio is 0 -- no fill should be visible.
-  sliderSetupFloat(&slider, 0.0f, 0.0f, 10.0f, 1.0f);
-  uiSliderRebuildGeometry(&slider);
-  assert_false(slider.cachedFillVisible);
-
-  // Halfway to max -- fill should cover half the track.
-  sliderSetupFloat(&slider, 5.0f, 0.0f, 10.0f, 1.0f);
-  uiSliderRebuildGeometry(&slider);
-  assert_true(slider.cachedFillVisible);
-  assert_float_equal(
-    slider.cachedFill.max[0] - slider.cachedFill.min[0],
-    UI_SLIDER_TRACK_WIDTH * 0.5f,
-    0.0001f
-  );
-}
-
-static void test_uiSliderRebuildGeometry_stepMarkers(void **state) {
-  uislider_t slider;
-
-  // 5 steps between 0 and 10 -- under the marker cap, so markers render.
-  sliderSetupInt(&slider, 0, 0, 10, 2);
-  uiSliderRebuildGeometry(&slider);
-  assert_int_equal(slider.cachedMarkerCount, 6);
-  assert_float_equal(
-    slider.cachedMarkers[0].min[0], slider.cachedTrack.min[0] -
-      UI_SLIDER_STEP_MARKER_WIDTH * 0.5f,
-    0.0001f
-  );
-
-  // 100 steps -- over the marker cap, so it falls back to a smooth fill
-  // with no markers.
-  sliderSetupInt(&slider, 0, 0, 100, 1);
-  uiSliderRebuildGeometry(&slider);
-  assert_int_equal(slider.cachedMarkerCount, 0);
-}
-
-int main(int argc, char **argv) {
-  const struct CMUnitTest tests[] = {
-    cmocka_unit_test(test_uiSliderRebuildGeometry_trackPosition),
-    cmocka_unit_test(test_uiSliderRebuildGeometry_fillVisibility),
-    cmocka_unit_test(test_uiSliderRebuildGeometry_stepMarkers),
-  };
-
-  return cmocka_run_group_tests(tests, NULL, NULL);
-}

archive/test/ui/test_uitab.c

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "dusktest.h"
-#include "ui/widget/uitab.h"
-#include "util/memory.h"
-
-// uiTabInit requires a real font (FONT_DEFAULT) to build the label's
-// glyph cache, which needs a live GL context this test binary doesn't
-// have. uiTabRebuildBackground only reads the label's already-measured
-// width/height, so it's safe to set those directly and exercise it here.
-static void test_uiTabRebuildBackground_matchesLabelSize(void **state) {
-  uitab_t tab;
-  memoryZero(&tab, sizeof(uitab_t));
-  tab.label.width = 42;
-  tab.label.height = 12;
-
-  uiTabRebuildBackground(&tab);
-
-  assert_float_equal(tab.cachedBackground.min[0], 0.0f, 0.0001f);
-  assert_float_equal(tab.cachedBackground.min[1], 0.0f, 0.0001f);
-  assert_float_equal(tab.cachedBackground.max[0], 42.0f, 0.0001f);
-  assert_float_equal(tab.cachedBackground.max[1], 12.0f, 0.0001f);
-}
-
-int main(int argc, char **argv) {
-  const struct CMUnitTest tests[] = {
-    cmocka_unit_test(test_uiTabRebuildBackground_matchesLabelSize),
-  };
-
-  return cmocka_run_group_tests(tests, NULL, NULL);
-}

assets/locale/en_US.po

@@ -10,6 +10,9 @@ msgid "ui.title"
 msgstr ""
 "Welcome"
 
+msgid "save.linux.mkdirp_failed"
+msgstr "Failed to create save directory, check the disk is not full or write-protected."
+
 #: src/dusk/ui/frame/settings/uisettings.c
 msgid "ui.settings.tabs.general"
 msgstr "General"
@@ -56,6 +59,130 @@ msgstr "Items"
 msgid "ui.game_menu.settings"
 msgstr "Settings"
 
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save"
+msgstr "Save"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_success"
+msgstr "Game saved."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_cancelled"
+msgstr "Save cancelled."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_unavailable"
+msgstr "Can't save - no save device found."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_temporary"
+msgstr "This session is temporary - no save device was found, so saving is disabled."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_create_confirm"
+msgstr "No save data found. Create a new save?"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_failed_format"
+msgstr "Save failed: %s"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_check_failed_format"
+msgstr "Can't save: %s"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.message"
+msgstr "No save device found. You can continue, but\nprogress will not be saved."
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.retry"
+msgstr "Retry"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.continue"
+msgstr "Continue Anyway"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.message"
+msgstr "No save data found. Create a new save?"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.yes"
+msgstr "Yes"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.no"
+msgstr "No"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.new_game"
+msgstr "New Game"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.load_game"
+msgstr "Load Game"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.options"
+msgstr "Options"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.quit"
+msgstr "Quit Game"
+
+#: src/dusk/ui/frame/uiconfirm.c
+msgid "ui.confirm.confirm"
+msgstr "Confirm"
+
+#: src/dusk/ui/frame/uiconfirm.c
+msgid "ui.confirm.cancel"
+msgstr "Cancel"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.attack"
+msgstr "Attack"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.flee"
+msgstr "Flee"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.target_format"
+msgstr "Enemy %u (%u/%u HP)"
+
+#: src/dusk/ui/frame/battle/uibattlehud.c
+msgid "ui.battle.hud.hp_format"
+msgstr "HP %u/%u"
+
+#: src/dusk/ui/frame/battle/uibattlehud.c
+msgid "ui.battle.hud.mp_format"
+msgstr "MP %u/%u"
+
+#: src/dusk/ui/frame/settings/uisettingsaudio.c
+msgid "ui.settings.audio.placeholder"
+msgstr "No audio settings yet"
+
+#: src/dusk/ui/frame/settings/uisettingsdisplay.c
+msgid "ui.settings.display.placeholder"
+msgstr "No display settings yet"
+
+#: src/dusk/ui/frame/settings/uisettingsinput.c
+msgid "ui.settings.input.placeholder"
+msgstr "No input settings yet"
+
+#: src/dusk/ui/frame/backpack/uibackpack.c
+msgid "ui.backpack.category_format"
+msgstr "Category %u"
+
+#: src/dusk/ui/overlay/uiloading.c
+msgid "ui.loading.text"
+msgstr "loading"
+
+#: src/dusk/ui/overlay/uiautosave.c
+msgid "ui.autosave.saving"
+msgstr "SAVING"
+
 msgid "item.potion.name"
 msgstr "Potion"
 

assets/locale/es_MX.po

@@ -57,6 +57,130 @@ msgstr "Objetos"
 msgid "ui.game_menu.settings"
 msgstr "Configuración"
 
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save"
+msgstr "Guardar"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_success"
+msgstr "Partida guardada."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_cancelled"
+msgstr "Guardado cancelado."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_unavailable"
+msgstr "No se puede guardar: no se encontró ningún dispositivo de guardado."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_temporary"
+msgstr "Esta sesión es temporal - no se encontró ningún dispositivo de guardado, por lo que guardar está deshabilitado."
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_create_confirm"
+msgstr "No se encontraron datos guardados. ¿Crear una partida nueva?"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_failed_format"
+msgstr "Error al guardar: %s"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_check_failed_format"
+msgstr "No se puede guardar: %s"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.message"
+msgstr "No se encontró ningún dispositivo de guardado. Puedes continuar, pero\nel progreso no se guardará."
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.retry"
+msgstr "Reintentar"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.continue"
+msgstr "Continuar de todos modos"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.message"
+msgstr "No se encontraron datos guardados. ¿Crear una partida nueva?"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.yes"
+msgstr "Sí"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.no"
+msgstr "No"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.new_game"
+msgstr "Nueva Partida"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.load_game"
+msgstr "Cargar Partida"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.options"
+msgstr "Opciones"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.quit"
+msgstr "Salir del Juego"
+
+#: src/dusk/ui/frame/uiconfirm.c
+msgid "ui.confirm.confirm"
+msgstr "Confirmar"
+
+#: src/dusk/ui/frame/uiconfirm.c
+msgid "ui.confirm.cancel"
+msgstr "Cancelar"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.attack"
+msgstr "Atacar"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.flee"
+msgstr "Huir"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.target_format"
+msgstr "Enemigo %u (%u/%u PS)"
+
+#: src/dusk/ui/frame/battle/uibattlehud.c
+msgid "ui.battle.hud.hp_format"
+msgstr "PS %u/%u"
+
+#: src/dusk/ui/frame/battle/uibattlehud.c
+msgid "ui.battle.hud.mp_format"
+msgstr "PM %u/%u"
+
+#: src/dusk/ui/frame/settings/uisettingsaudio.c
+msgid "ui.settings.audio.placeholder"
+msgstr "Aún no hay opciones de audio"
+
+#: src/dusk/ui/frame/settings/uisettingsdisplay.c
+msgid "ui.settings.display.placeholder"
+msgstr "Aún no hay opciones de pantalla"
+
+#: src/dusk/ui/frame/settings/uisettingsinput.c
+msgid "ui.settings.input.placeholder"
+msgstr "Aún no hay opciones de entrada"
+
+#: src/dusk/ui/frame/backpack/uibackpack.c
+msgid "ui.backpack.category_format"
+msgstr "Categoría %u"
+
+#: src/dusk/ui/overlay/uiloading.c
+msgid "ui.loading.text"
+msgstr "cargando"
+
+#: src/dusk/ui/overlay/uiautosave.c
+msgid "ui.autosave.saving"
+msgstr "GUARDANDO"
+
 #: src/dusk/rpg/item/item.json
 msgid "item.potion.name"
 msgstr "Poción"

assets/locale/jp_JP.po

@@ -57,6 +57,130 @@ msgstr "アイテム"
 msgid "ui.game_menu.settings"
 msgstr "設定"
 
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save"
+msgstr "セーブ"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_success"
+msgstr "セーブしました。"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_cancelled"
+msgstr "セーブをキャンセルしました。"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_unavailable"
+msgstr "セーブできません - セーブデバイスが見つかりません。"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_temporary"
+msgstr "このセッションは一時的です - セーブデバイスが見つからなかったため、セーブは無効になっています。"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_create_confirm"
+msgstr "セーブデータが見つかりません。新しいセーブを作成しますか？"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_failed_format"
+msgstr "セーブに失敗しました: %s"
+
+#: src/dusk/ui/frame/game/uigamemenu.c
+msgid "ui.game_menu.save_check_failed_format"
+msgstr "セーブできません: %s"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.message"
+msgstr "セーブデバイスが見つかりません。続行できますが、\n進行状況は保存されません。"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.retry"
+msgstr "再試行"
+
+#: src/dusk/ui/frame/initial/uiinitialnocard.c
+msgid "ui.initial.no_card.continue"
+msgstr "続行する"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.message"
+msgstr "セーブデータが見つかりません。新しいセーブを作成しますか？"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.yes"
+msgstr "はい"
+
+#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
+msgid "ui.initial.create_save.no"
+msgstr "いいえ"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.new_game"
+msgstr "ニューゲーム"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.load_game"
+msgstr "ロードゲーム"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.options"
+msgstr "オプション"
+
+#: src/dusk/ui/frame/mainmenu/uimainmenu.c
+msgid "ui.main_menu.quit"
+msgstr "ゲームを終了"
+
+#: src/dusk/ui/frame/uiconfirm.c
+msgid "ui.confirm.confirm"
+msgstr "確認"
+
+#: src/dusk/ui/frame/uiconfirm.c
+msgid "ui.confirm.cancel"
+msgstr "キャンセル"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.attack"
+msgstr "攻撃"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.flee"
+msgstr "逃げる"
+
+#: src/dusk/ui/frame/battle/uibattlemenu.c
+msgid "ui.battle.menu.target_format"
+msgstr "敵%u (%u/%u HP)"
+
+#: src/dusk/ui/frame/battle/uibattlehud.c
+msgid "ui.battle.hud.hp_format"
+msgstr "HP %u/%u"
+
+#: src/dusk/ui/frame/battle/uibattlehud.c
+msgid "ui.battle.hud.mp_format"
+msgstr "MP %u/%u"
+
+#: src/dusk/ui/frame/settings/uisettingsaudio.c
+msgid "ui.settings.audio.placeholder"
+msgstr "オーディオ設定はまだありません"
+
+#: src/dusk/ui/frame/settings/uisettingsdisplay.c
+msgid "ui.settings.display.placeholder"
+msgstr "表示設定はまだありません"
+
+#: src/dusk/ui/frame/settings/uisettingsinput.c
+msgid "ui.settings.input.placeholder"
+msgstr "入力設定はまだありません"
+
+#: src/dusk/ui/frame/backpack/uibackpack.c
+msgid "ui.backpack.category_format"
+msgstr "カテゴリー%u"
+
+#: src/dusk/ui/overlay/uiloading.c
+msgid "ui.loading.text"
+msgstr "読み込み中"
+
+#: src/dusk/ui/overlay/uiautosave.c
+msgid "ui.autosave.saving"
+msgstr "保存中"
+
 #: src/dusk/rpg/item/item.json
 msgid "item.potion.name"
 msgstr "ポーション"